Servicio Web de Timbrado

Este documento describe la informacin relacionada para la implementacin del

Servicio Web de Timbrado

Versin documento 3.1

dotNET Desarrollo de Sistemas

01/01/2014
Contenido
Introduccin ...................................................................................................................................... 2

A quin va dirigido .......................................................................................................................... 2

Alcance ............................................................................................................................................... 2

Prerrequisitos .................................................................................................................................... 2

Recomendaciones ............................................................................................................................. 3

Web Service de Timbrado ............................................................................................................... 4

Servicio de obtencin del timbrado ....................................................................................... 5

Servicio de cancelacin del CFDI ........................................................................................... 1

Preguntas Frecuentes ................................................................................................................... 4

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 1

Introduccin
Este documento detalla la especificacin del Servicio Web de Timbrado para el esquema
CFDI Versin 3.2

El objetivo del Servicio Web de Timbrado es proveer una serie de operaciones, entre las que
se incluyen, generar el timbre fiscal digital (TFD) de los comprobantes fiscales digitales por
internet (CFDI); adems de poder solicitar la cancelacin de los mismos.

A quin va dirigido
El presente documento va dirigido al rea de desarrollo y personal de sistemas con
conocimientos en consumo de Servicios Web sin importar la plataforma o sistema
operativo.

Alcance
Se provee la informacin necesaria para el consumo del Servicio Web de Timbrado.

Prerrequisitos
Estar familiarizado con el protocolo SOAP, el lenguaje XML y los estndares establecidos
por el esquema CFDI 3.2.

IMPORTANTE: para la realizacin de comprobantes de nmina es necesario que verifique

los documentos emitidos por el SAT que contienen las especificaciones tcnicas de los datos
a incorporar en los recibos de nmina.

LINK:
http://www.sat.gob.mx/informacion_fiscal/factura_electronica/Paginas/complemento_nomin
a.aspx

Lea con detenimiento el siguiente documento, para una exitosa implementacin del servicio
de timbrado.

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 2

Recomendaciones
Es importante que para una respuesta correcta del Web Service de Timbrado, lea
detenidamente este documento. En caso de que encuentre informacin confusa que le
parezca incompleta, por favor contactarnos:

soporte@facturadorelectronico.com

01 800 272 06 46

No se confi por la sencillez del web service, y desee adquirir primero sus timbres sin haber
hecho pruebas, ya que pueden surgir detalles (quiz para usted desconocidos) en sus
pruebas, que pueden retrasarlo a usted y a su cliente.

Es importante que genere el xml conforme las especificaciones del Anexo 20(No se
confunda, en una parte de la documentacin se encuentra descrito CFD y en otra CFDI):

http://www.sat.gob.mx/sitio_internet/e_sat/comprobantes_fiscales/15_17416.html

Si esta migrando de CFD a CFDI debe repasar el Anexo 20 para ver los cambios
significativos de la nueva versin.

Se le recomienda que tenga a la mano algn editor de XML que le permita validar xmls
contra esquemas. Esto le puede facilitar la resolucin de los posibles errores que pueda
obtener del Web Service evitar los mismos.

Altova XMLspy
Notepad++ con plugin xml tools
Free xml editor

Ya que abrir un xml con algn browser o con notepad no le va ser de mucha ayuda

Puede que la estructura de su xml sea valida y haya obtenido el nodo del timbre, pero a
nivel fiscal no necesariamente este colocando los datos nodos correctos. Dudas a
nivel fiscal deber consultarlas con su departamento administrativo utilizar la lnea de
ayuda del SAT.

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 3

Web Service de Timbrado
Uno de los requisitos para el proceso de pruebas, es generar el XML CFDI 3.2, con alguno
de los certificados de prueba que se encuentran dentro de este Kit (Solo estos certificados
estn establecidos para pruebas).

Emisor GOYA780416GM0

Contrasea llave privada: 12345678a

Los datos para acceder al Web Service de timbrado son los siguientes:

URL Web Service: https://stagecfdi.facturadorelectronico.com/wstimbrado/timbrado.asmx

Usuario: test

Contrasea: TEST

Si desconoce como implementar la conexin entre su desarrollo y un web servicie, deber

consultar la documentacin de su lenguaje de programacin.

Este kit provee ejemplos en .NET y PHP.

Palabras clave:

-SOAP

-HTTP POST Web Service

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 4

Podemos acceder a la descripcin de los mtodos directamente desde la url de timbrado:

El Web Service de Timbrado contiene dos mtodos:

1. obtenerTimbrado
2. cancelarComprobante

Podemos ver los parmetros de cada mtodo dando clic directamente en el nombre del
mtodo para una lectura ms amigable podemos cargar el descriptor directamente a una
aplicacin, por ejemplo soapUI.

Servicio de obtencin del timbrado

El mtodo obtenerTimbrado requiere del XML CFDI 3.2, un usuario y contrasea como
parmetros de entrada:

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 5

Cdigo

miInstancia.obtenerTimbrado(string CFDIcliente, string Usuario, string password)

El mtodo obtener timbrado nicamente regresa el nodo del timbre del timbre

Usted debe incrustar el nodo del timbre en el nodo de complementos de su XML CFDI 3.2

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 6

Ensobretado SOAP

Para un ensobretado SOAP el xml deber enviarse con los caracteres <, >, " con sus caracteres de escape correspondientes
Respuesta del proceso de Timbrado:

Se obtiene un XML de respuesta con la siguiente estructura:

Dato Tipo de Longitud Descripcin

dato
obtenerTimbradoResult xml Xml que contiene la respuesta del
Web Service de Timbrado.

La obtencin del timbre es exitosa cuando se obtiene la respuesta del Web Service de
Timbrado con la siguiente estructura:
Ejemplo de respuesta correcta:

Nota: En caso de desconocer como manejar (insertar nodos, eliminar nodos, etc) XMLs, deber consultar la documentacin de su
lenguaje de programacin. Estos debern proveerle opciones como Xpath Clases incluidas dentro del propio lenguaje, que faciliten
el manejo de XMLs.
Caso contrario, la respuesta es la siguiente:

Ejemplo:

<obtenerTimbradoResponse xmlns="http://facturadorelectronico.com/timbrado/">
<obtenerTimbradoResult>
<timbre esValido="False" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<errores>
<Error codigo="306" mensaje="El certificado utilizado no es de Sello Digital" />
</errores>
</timbre>
</obtenerTimbradoResult>
</obtenerTimbradoResponse>

Se muestra el error que surgi durante el proceso de la obtencin del timbre fiscal digital,
mediante un cdigo de error.

Para ms informacin acerca de los errores, consultar el documento Manejo de Errores

de Timbrado
Servicio de cancelacin del CFDI

El mtodo cancelarComprobante requiere como parmetros un Xml de cancelacin, un

usuario y contrasea.

El XML de cancelacin debe contener la siguiente estructura:

Nota: Las cancelaciones nicamente aplican para los comprobantes timbrados con
nuestro Web Service.

miInstancia.cancelarComprobante(string xmlCancelacion, string usuario, string

password)

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 1

La respuesta de Cancelacin contiene la siguiente estructura:

Devuelve esValido=True nicamente para indicar que la peticin al Web Service se

llevo acabo correctamente (Esto no indica que su comprobante se cancel).

Dentro de esta respuesta se encuentra el UUID con su correspondiente status. Los

estatus se describen a continuacin:

Estatus Descripcin
201 El folio UUID del CFDI ha sido exitosamente cancelado.
202 El folio UUID del CFDI ha sido previamente cancelado.
203 El folio UUID del CFDI no fue encontrado
204 El folio UUID no es aplicable para ser cancelado
205 El folio UUID del CFDI aun no ha sido enviado al SAT

NOTA: El error 205 en pruebas es tomado como una prueba con xito.

Si existe algn error en la peticin de cancelacin, se muestra el cdigo de error, con su

correspondiente descripcin.

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 2

<solicitud esValido="False" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<errores>
<Error codigo="025" mensaje="Error al solicitar la cancelacin al SAT: Sintaxis no vlida en lnea 4
- 'Se esperaba el carcter >'." />
</errores>
</solicitud>

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 3

Preguntas Frecuentes

1. Soy nuev@ en estos temas, pero deseo que mi sistema genere facturacin
electrnica, por donde puedo empezar? Para el servicio de timbrado, se
recomienda consultar informacin para la generacin de conexines con web
services mediante el lenguaje de programacin que estn utilizando, tambin
conocer que es XML y lo ms importante consultar la pgina del SAT Anexo 20, en
el cual se encuentran el documento con las especificaciones para la generacin de
CFDI 3.2

2. Aun no he realizado pruebas pero ya quiero contratar, es recomendable? Para

evitar errores a futuro en produccin, el desperdicio de timbres y la perdida de
tiempo, se requiere que primero se lleven acabo todas las pruebas necesarias con
este Kit.

3. Cuanto tiempo se tardan en implementar el servicio de timbrado, en produccin?

Mucho depende del proceso de pruebas por parte del cliente, ya que el proceso de
contratacin no lleva ms de 24hrs.

4. No tengo tiempo para generar el CFDI 3.2, requiero que mi cliente ya genere
facturacin, que puedo hacer? Pueden consultar nuestra alternativa de Interfaz
ERP.

5. Ustedes adems del timbrado regresan el cdigo bidimensional? El web service

nicamente (en caso de que todo el proceso se lleve acabo correctamente),
responder con otro Xml que contiene el nodo de timbrado.

6. Para hacer uso del Kit de pruebas necesito adquirir algn paquete de timbres?
No, la nica indicacin en pruebas, es evitar las pruebas de stress y crear el XML
con los datos del Emisor de pruebas GOYA.

7. Que datos deben ir en el XML? Deben consultar el documento del SAT, anexo 20
correspondiente a CFDI 3.2.

8. Tienen modo de generar el xml desde mi base de datos? Pueden consultar

nuestra alternativa de Interfaz ERP.

9. Cuando envo una cancelacin se me descuentan timbres (Produccin)?

nicamente con el mtodo obtenertimbrado se descuentan timbres.

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 4

10. Puedo cancelar mis comprobantes timbrados con otro PAC? En el servicio de
cancelacin, nicamente se pueden cancelar comprobantes timbrados con nuestro
Web Service.

11. Puedo generar el Xml de pruebas con los archivos de certificado digital de mi
cliente? Para pruebas los nicos certificados que se pueden usar son los que se
encuentran en este Kit.

dotNET Desarrollo de Sistemas | Manual de referencia para el desarrollador 5