manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7)...

17
Proveedor autorizado de certificación SAT Número de aprobación: 55029 www.fel.mx 55029 Facturar en Línea Aquí podrán resolver todas sus dudas. Manual de Timbrado FEL® Le proporcionará de manara precisa los pasos y referencias del proceso de timbrado FEL®

Transcript of manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7)...

Page 1: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Proveedor autorizado de certi�cación SATNúmero de aprobación: 55029

www.fel.mx

55029

Facturar en Línea

Aquí podrán resolver todas sus dudas.

Manual de Timbrado FEL®Le proporcionará de manara precisa los pasos y referencias del proceso de timbrado FEL®

Page 2: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

ÍNDICE

1 Introducción

2 Web Service 2.1 Acceso al servicio FEL 3 Generación de CFDI 3.1 Acceso al método 3.2 Parámetros 3.3 Ejemplos de código 3.4 Respuesta FEL 3.5 Consideraciones para el Timbrado

4 Cancelación de CFDI 4.1 Acceso al método 4.2 Parámetros 4.3 Ejemplos de código 4.4 Respuesta FEL 4.5 Consideraciones para la Cancelación 5 Generación de CFDI de Prueba 5.1 Acceso al método 5.2 Parámetros 5.3 Ejemplos de código 5.4 Respuesta FEL 5.5 Consideraciones para el Timbrado de Prueba

6 Anexo A. Tablas de errores y mensajes

Page 3: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

INTRODUCCIÓN.Facturar En Línea ® como Proveedor de Servicios de Expedición de Comprobante Fiscal Digital a través de Internet (PSECFDI), ofrece sus servicio de timbrado con

los CFDi exigidas por el SAT

Digitales a través de Internet. Este servicio de conexión FEL le permitirá enviar su XML desde su propio aplicativo (ERP) y recibir el CFDI y los datos referentes al timbrado para integrarlos a su base de datos.

Para accesar a este servicio es necesario ser cliente FEL ya que se llevará a cabo un proceso de autenticación previa a la generación del comprobante.

WEB SERVICE FEL.

Acceso al servicio FEL:

La URL de acceso al Web Service es la siguiente:

• https://www.fel.mx/WS-TFD/WS-TFD.asmx

El WSDL expuesto por este servicio en el siguiente:

• https://www.fel.mx/WS-TFD/WS-TFD.asmx?WSDL

La implementación del servicio se realiza a través del protocolo https, de esta forma, se garantiza un canal de comunicaciones seguro.

El WEB Service de�ne diferentes funciones, tanto para generar Com-probantes Fiscal Digital a través de internet, así como para Cancelar y otros servicios adicionales ofrecidos por FEL.

Page 4: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

GENERACIÓN DE CFDI.

En cada llamada se puede generar un CFDI para el usuario Emisor.

Accesar al método:

TimbrarCFD(Usuario As String, Password

As String, CadenaXML As String , Referencia As

String )

Parámetros:

Usuario Password :

CadenaXML :

Referencia :

.

Esta función permite realizar el CFDi a partir de los datos recibidos. Para poder implementarla llamada, el usuario debe autenti�carse como usuario del servicio FEL y enviar el XML a sertimbrado

Contrasena de autenticación del usuario.Contenido del XML con la información del comprobante. Debe cumplir con todos los requisitos de la versión 3 del SAT.Referencia que desee asignar el cliente al CFDi timbrado que puede ser utilizado parabúsquedas posteriores de sus CFDi’s * Se recomienda que sea diferente para cada comrpobante.

Usuario FEL que va a realizar el timbrado

Page 5: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

El comprobante que se enviará contiene la información de la factura y del certi�cado del contribuyente expedido por el SAT empleado en la construcción del Sello Digital. FEL al recibir el Comprobante del contribuyente se encargará de realizar todas las validaciones exigidas por el SAT y posteriormente el realizará el proceso de certi�cación �nal e integrará al XML, el nodo Timbre Fiscal Digital.

Las validaciones realizadas al XML son las siguientes:

* Se valida que la estrucutura del XML cumple con todas las especi�caciones del SAT, conforme a la Resolución Miscelánea Fiscal publicada en 2010 contenida en el Anexo 20

*Se valida que el Certi�cado de Sello Digital (CSD) del emisor haya sido emitido por el SAT.

*Que el CSD esté vigente en la fecha de generación del Comprobante.

*Que el CSD utilizando para �rmar el Comprobante corresponda el emisor del comprobante.

*Se veri�ca que el comprobante no haya sido certi�cado previamente.

*Se valida que el periodo de tiempo entre fecha de emisión del Comprobante y la fecha de emisión del Certi�cación no sea mayor a 72 horas

Facturar en Línea® - Facturación electrónica.

Page 6: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

Si el Comprobante supera las validaciones realizadas, se responderá al contribuyente devolviendo el XML con el complemento correspondiente. El complemento incluye el

así como el sello del SAT.

El servicio devuelve un arreglo de datos que contiene en una de las posiciones, el -

mación del CFDI y del complemento Timbre Fiscal Digital, así como el XML del acuse de envío al SAT.

En caso de ocurrir un error por invocación del servicio o por no superar algunas de las validaciones realizadas por FEL, se devuelve en el mismo arreglo el código de error, así como los mensajes descriptivos del error para poder ayudar a corregir la solicitud de timbrado.

Ejemplos de código para accesar al método de timbrado FEL:

Vb.Net‘ Crear instancia al WS para timbrar Dim ServicioFEL As New WSFel.WS_TFDSoapClientDim Respuesta As New WSFel.ArrayOfString

‘Se recibe la respuestaRespuesta = ServicioFEL.TimbrarCFD(“usuario”, “password”, “cadenaXML”, “referencia”)

C#‘ Crear instancia al WS para timbrar WSFel. WS_TFDSoapClient ServicioFEL = New WSFel. WS_TFDSoapClient ();WSFel. ArrayOfString Respuesta = New WSFel. WS_ ArrayOfString ();

‘Se recibe la respuestaRespuesta = ServicioFEL.TimbrarCFD(“usuario”, “password”, “cadenaXML”, “referencia”);

Page 7: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

Ejemplo de respuesta en caso de timbrado exitoso:

Es un arreglo de 13 posiciones que van del 0 al 12 que contiene los siguientes datos:

Respuesta(0) = "" Respuesta(1) = "" Respuesta(2) = "" Resultado(3) =

complemento Timbre Fiscal Digital, que le comprobante enviado.

Resultado(4) = Contiene la cadena original del Timbre, utilizada en la

Resultado(5) = Resultado(6) = Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del SAT. Resultado(11) = Resultado(12) =

del CFDI respondido por el SAT, se debe guardar el contenido, ya que es el comprobante de la autenticidad del CFDI.

* Las 3 primeras posiciones (0 a 2) se regresan vacías, por lo que se recomienda

Ejemplo de respuesta con error en el timbrado:

El arreglo de respuesta también es de 13 posiciones que van del 0 al 12, pero sólo las 3 primeras posiciones contienen valores, las demás regresan vacías.

*Se recomienda validar las posiciones que van del (0) al (2), si estas NO regresan vacías se produjo un error.

Respuesta(0) = enviado o a la forma de accesar el servicio. Ej. 301, 302.

Respuesta(1) = Mensaje del error producido. Respuesta(2) =

RESPUESTA FEL.La respuesta a la petición se devuelve en un arreglo de datos que contiene en cada posición información útil para el usuario, que le permitirán actualizar su base de datos sin tener que leer el XML recibido o en caso de error, el detalle de lo ocurrido.

Page 8: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

CONSIDERACIONES PARA EL TIMBRADO.Cuando se realiza una llamada a la función se envían los datos para autenticación y el contenido del XML para la generación del CFDI.

Para poder accesar al servicio se debe contar con un Usuario de Timbrado FEL (diferente al usuario FEL en línea o de conexión remota, si se cuenta con uno)

Es muy importante respetar la posición de cada uno de los parámetros enviados.

Ninguno de los parámetros es opcional.

El usuario remoto se hace responsable de incorporar correctamente todos los esquemas y requisitos al XML del comprobante de acuerdo a la versión 3 del anexo 20 del SAT.

CANCELACIÓN DE CFDI.

Esta función permite realizar la cancelación ante el SAT de una lista de UUIDs que se encuentren en los registros de envío del SAT, es decir, que sean UUIDs generados a través de un proceso de timbrado. Los UUIDs que se envíen para cancelación, deben haber sido emitidos por el mismo contribuyente y la lista no podrá ser mayor a 500.

Accesar al método:

CancelarCFDI(usuario As String , password As String , RFCEmisor As String , listaCFDI As String As String , passwordPKCS12 As String )

Parámetros:usuario Usuario FEL . password : RFCEmisor : RFC del emisor de los CFDIs. listaCFDI : Es un arreglo que contiene un * certificadoPKCS12_Base64 Cadena que contiene *Pfx en formato Base64, del CSD del emisor con el

que se sellaron los comprobantes. passwordPKCS12

Page 9: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

-

llave simétrica basada en contraseña. Es decir, es un archivo generado con la con -traseña del CSD que contiene la llave pública y la privada.

Se solicitan el Pfx y la contraseña del CSD ya que es un requisito del SAT para poder autenticar al emisor de los UUIDs que se desea cancelar.

FEL al recibir el la petición, realiza la solicitud de cancelación al SAT, el cuál responde con un acuse en formato XML que FEL se encarga de leer para facilitar la respuesta al usuario. En este acuse se recibe un mensaje para cada uno de los UUIDs enviados,

Ejemplos de código para accesar al método de cancelación de CFDI:

Vb.Net

‘ Declarar web service.Dim ServicioFEL As New WSFel.WS_TFDSoapClientDim Respuesta As New WSFel.ArrayOfString‘Se recibe la respuestaRespuesta = ServicioFEL.CancelarCFDI(“usuario”, “password”, “RFCEmisor”, listaCFDI(), “Cadena del Pfx en formato Base 64”, “Password del Pfx”) C#

‘ Crear instancia al WS para timbrar WSFel. WS_TFDSoapClient ServicioFEL = New WSFel. WS_TFDSoapClien t();WSFel. ArrayOfString Respuesta = New WSFel. WS_ ArrayOfString ();

‘Se recibe la respuestaRespuesta = ServicioFEL.CancelarCFDI(“usuario”, “password”, “RFCEmisor”, listaCFDI(), “Cadena del Pfx en base 64”, “Password del Pfx”);

Page 10: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

RESPUESTA FEL

ya que dependerá de los UUIDs que se envíen para cancelación.

Cada posición contiene 3 datos: UUID, Código y Mensaje separados por el carácter pipe |

En la última posición del arreglo siempre se enviará el contenido del XML del Acuse del SAT, por lo que es muy importante hacer esta consideración en código para poder guardar una copia del acuse.

Ejemplo de respuesta de cancelación de 2 UUIDs:

Respuesta(0) = “BADDB668-ECCE-4917-A77F-97BDFC87C7B6|201|UUID Cancelado”Respuesta(1) = “FFA23650-4AFF-4E70-BF2E-CAE8832367F7|202|UUID Previamente Cancelado”Respuesta(2) = “<?xml version=”1.0” ?> ... “

CONSIDERACIONES.

Para poder accesar al servicio se debe contar con un Usuario de Timbrado FEL (diferente al usuario FEL en línea o de conexión remota, si se cuenta con uno)Es muy importante respetar la posición de cada uno de los parámetros enviados.Ninguno de los parámetros es opcional.El usuario remoto se hace responsable de generar el Pfx del CSD del emisor.Es responsabilidad del usuario enviar los datos para un solo RFC, es decir, los UUIDs a cancelar deben pertenecer al RFC del emisor, el Pfx debe corresponder al emisor y la contraseña del Pfx debe estar correcta.Es responsabilidad del usuario guardar una copia del XML de acuse de cancelación ya que es el documento con el que se ampara la operación ante el SAT.

Page 11: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

GENERACIÓN DE CFDI DE PRUEBAEsta función permite realizar el CFDI de prueba a partir de los datos recibidos.

vicio FEL y enviar el XML a ser timbrado de prueba.

Este método genera un UUID de prueba que no es válido ante los registros del SAT, pero si es útil para validar la estructura del XML.

Accesar al método:

TimbrarCFDPrueba(Usuario As String , Password As String , CadenaXML

Parámetros:

FEL al recibir el Comprobante del contribuyente se encargará de realizar las validaciones necesarias y posteriormente realizará el proceso de timbrado de prueba e integrará al XML, el nodo Timbre Fiscal Digital.

Las validaciones realizadas al XML son las siguientes:

forme a la Resolución Miscelánea Fiscal publicada en 2010 contenida enel Anexo 20.

por el SAT.

Se valida que el periodo de tiempo entre la fecha de emisión del Comprobante y la fecha

Si el Comprobante supera las validaciones realizadas, se responderá al contribuyente devolviendo el XML con el complemento correspondiente. El complemento incluye el

Usuario Usuario FEL que va a realizar el timbrado.Password: usuario. CadenaXML:

Page 12: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

El servicio devuelve un arreglo de datos que contiene en una de las posiciones, el con -

del CFDI y del complemento Timbre Fiscal Digital, así como un XML de ejemplo de acuse de envío al SAT.

En caso de ocurrir un error por invocación del servicio o por no superar algunas de las validaciones realizadas por FEL, se devuelve en el mismo arreglo el código de error, así como los mensajes descriptivos del error para poder ayudar a corregir la solicitud de timbrado.

Ejemplo de código para accesar al método de timbrado de prueba FEL:

Vb.Net

‘ Crear instancia al WS para timbrar Dim ServicioFEL As New WSFel.WS_TFDSoapClientDim Respuesta As New WSFel.ArrayOfString‘Se recibe la respuestaRespuesta = ServicioFEL.TimbrarCFDPrueba(“usuario”, “password”, “cadenaXML”)

C#‘ Crear instancia al WS para timbrar WSFel. WS_TFDSoapClient ServicioFEL = New WSFel. WS_TFDSoapClient();WSFel. ArrayOfString Respuesta = New WSFel. WS_ ArrayOfString();

‘Se recibe la respuestaRespuesta = ServicioFEL.TimbrarCFDPrueba(“usuario”, “password”, “cadenaXML”);

Page 13: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

RESPUESTA FEL:La respuesta a la petición se devuelve en un arreglo de datos que contiene en cada posición información útil para el usuario, que le permitirán actualizar su base de datos sin tener que leer el XML recibido o en caso de error, el detalle de lo ocurrido.

Ejemplo de respuesta en caso de timbrado de prueba exitoso:

Es un arreglo de 13 posiciones que van del 0 al 12 que contiene los siguientes datos:

* Las 3 primeras posiciones (0 a 2) se regresan vacías, por lo que se recomienda validar que esto

Respuesta(0) = "" Respuesta(1) = "" Respuesta(2) = "" Resultado(3) =

complemento Timbre Fiscal Digital, que le comprobante enviado.

Resultado(4) = Contiene la cadena original del Timbre, utilizada en la

Resultado(5) = Resultado(6) = Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del SAT. Resultado(11) = Resultado(12) =

del CFDI respondido por el SAT, se debe guardar el contenido, ya que es el comprobante de la autenticidad del CFDI.

Page 14: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

Ejemplo de respuesta con error en el timbrado:

El arreglo de respuesta también es de 13 posiciones que van del 0 al 12, pero sólo las 3 primeras posiciones contienen valores, las demás regresan vacías.

* Se recomienda validar las posiciones que van del (0) al (2), si estas NO regresan vacías se produjo un error.

CONSIDERACIONES PARA EL TIMBRADO DE PRUEBA.

Cuando se realiza una llamada a la función se envían los datos para autenticación y el contenido del XML para la generación del CFDI de prueba.

Para poder accesar al servicio se debe contar con un Usuario de Timbrado FEL (diferente al usuario FEL en línea o de conexión remota, si se cuenta con uno)Es muy importante respetar la posición de cada uno de los parámetros enviados.Ninguno de los parámetros es opcional.Para poder accesar al servicio se debe contar con un Usuario de Timbrado FEL (diferente al usuario FEL en línea o de conexión remota, si se cuenta con uno)Es muy importante respetar la posición de cada uno de los parámetros enviados.Ninguno de los parámetros es opcional.El usuario remoto se hace responsable de incorporar correctamente todos los esquemas y requisitos al XML del comprobante de acuerdo a la versión 3 del anexo 20 del SAT.Se realizan validaciones en cuanto a la formación correcta del XML, pero no es un pro

facilidad en las pruebas realizadas.

código para accesar al método de timbrado real.El Timbrado de Prueba FEL no realiza el envío del CFDI al SAT, por lo que no será necesario cancelar los comprobantes generados por este método.

Respuesta(0) = que puede ser referente al XML enviado o a la forma de accesar el servicio. Ej. 301, 302.

Respuesta(1) = Mensaje del error producido. Respuesta(2) =

Page 15: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

ANEXO A. TABLAS DE ERRORES Y MENSAJES

TIMBRADO

CANCELACIÓN

Mensaje 301 XML mal formado El XML recibido no cumple con los estándares del

SAT. 302

incorrecta. 303 Sello no corresponde a emisor o caduco

RFC del emisor. 304 Certi�cado revocado o caduco

vigencia. 305 La fecha de emisión no está dentro

de la vigencia del CSD del Emisor 306 El certi�cado no es de tipo CSD 307 El CFDI contiene un timbre previo El XML contiene ya contiene el complemento Timbre

Fiscal Digital. 308 Certi�cado no expedido por el SAT

SAT. 401 Fecha y hora de generación fuera de rango

fecha/hora posterior a la actual. 402 RFC del emisor no se encuentra en el régimen

de contribuyentesEl RFC del emisor no se encuentra en la LCO.

403 La fecha de emisión no esposterior al 01 de enero 2011 Enero de 2011.

Mensaje 201 UUID Cancelado 202 UUID Previamente Cancelado 203 UUID no corresponde al Emisor El UUID enviado para cancelar no corresponde al

RFC del emisor enviado. 204 UUID no aplicable para cancelación

(caso poco probable). 205 UUID no existe El UUID no existe en los registros del SAT.

Page 16: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Facturar en Línea® - Facturación electrónica.

Mensaje 801 El comprobante ya fue timbrado por FEL XML timbrado previamente por FEL. 805 El comprobante contiene el nodo Addenda El XML contiene este nodo. No se debe timbrar

un XML con Addenda, pero se puede agregar a su XML

806 Alguno de los datos enviados para accesar al servicio es incorrecto.

807 808 El usuario no cuenta con permiso de acceso

de acceso por uso indebido del servicio. 809 El paquete de timbres ha expirado 811 El RFC de usuario no corresponde al del emisor

de CFDI tratando de timbrar un XML de otro

contribuyente. 815

usuario por 30 minutos. 816

del SAT para la entrega del CFDI.

INVOCACIÓN DEL SERVICIO FEL

Page 17: manual de timbrado - Facturar En Lí · PDF fileManual de Timbrado FEL ... Resultado(7) = Resultado(8) = Sello del CFD enviado para timbrar. Resultado(9) = Resultado(10) = Sello del

Proveedor autorizado de certi�cación SATNúmero de aprobación: 55029

www.fel .mx

55029

Facturar en Línea

Por favor comunícate con nosotros:

SOPORTE(222) 1 41 38 [email protected]

¡Gracias!Si continúas con dudas...