Manual de Timbrado FEL

Transcripción

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

2 Í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

3 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 tim brado 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. El WEB Service define diferentes funciones, tanto para generar Comprobantes Fiscal Digital a través de internet, así como para Cancelar y otros servicios adicionales ofrecidos por FEL. Acceso al servicio FEL: La URL de acceso al Web Service es la siguiente: El WSDL expuesto por este servicio en el siguiente: La implementación del servicio se realiza a través del protocolo https, de esta forma, se garantiza un canal de comunicaciones seguro.

4 GENERACIÓN DE CFDI. Esta función permite realizar el CFDi a partir de los datos recibidos. Para poder implementar la llamada, el usuario debe autentificarse como usuario del servicio FEL y enviar el XML a ser timbrado As String, CadenaXML As String, Referencia As En cada llamada se puede generar un CFDI para el usuario Emisor. Accesar al método: TimbrarCFD(Usuario As String, Password String ) Parámetros: Usuario Password : CadenaXML : Referencia : Usuario FEL que va a realizar el timbrado 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 para búsquedas posteriores de sus CFDi s * Se recomienda que sea diferente para cada comrpobante..

5 El comprobante que se enviará contiene la información de la factura y del certificado 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 certificación final 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 especificaciones del SAT, conforme a la Resolución Miscelánea Fiscal publicada en 2010 contenida en el Anexo 20 *Se valida que el Certificado 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 firmar el Comprobante corresponda el emisor del comprobante. *Se verifica que el comprobante no haya sido certificado previamente. *Se valida que el periodo de tiempo entre fecha de emisión del Comprobante y la fecha de emisión del Certificación no sea mayor a 72 horas

6 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_TFDSoapClient Dim Respuesta As New WSFel.ArrayOfString Se recibe la respuesta Respuesta 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 respuesta Respuesta ServicioFEL.TimbrarCFD( usuario, password, cadenaxml, referencia ); -

7 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 da tos sin tener que leer el XML recibido o en caso de error, el detalle de lo ocurrido. 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) Resultado(4) Resultado(5) Resultado(6) Resultado(7) Resultado(8) Resultado(9) Resultado(10) Resultado(11) Resultado(12) "" "" "" complemento Timbre Fiscal Digital, que le comprobante enviado. Contiene la cadena original del Timbre, utilizada en la Sello del CFD enviado para timbrar. Sello del SAT. 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. Respuesta(0) Respuesta(1) Respuesta(2) enviado o a la forma de accesar el servicio. Ej. 301, 302. Mensaje del error producido. *Se recomienda validar las posiciones que van del (0) al (2), si estas NO regresan vacías se produjo un error.

8 CONSIDERACIONES PARA EL TIMBRADO. Cuando se realiza una llamada a la función se envían los datos para autenticación y el con tenido 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 en cuentren 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 String As String, password As String, RFCEmisor As String, passwordpkcs12 As String, listacfdi As As String ) Parámetros: usuario password : RFCEmisor : listacfdi : certificadopkcs12_base64 passwordpkcs12 Usuario FEL. RFC del emisor de los CFDIs. Es un arreglo que contiene un * Cadena que contiene *Pfx en formato Base64, del CSD del emisor con el que se sellaron loscomprobantes.

9 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_TFDSoapClient Dim Respuesta As New WSFel.ArrayOfString Se recibe la respuesta Respuesta 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 WSFel. ArrayOfString Respuesta New WSFel. WS_ ArrayOfString (); Se recibe la respuesta Respuesta ServicioFEL.CancelarCFDI( usuario, password, RFCEmisor, listacfdi(), Cadena del Pfx en base 64, Password del Pfx ); t();

10 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) FFA AFF-4E70-BF2E-CAE F7 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.

11 GENERACIÓN DE CFDI DE PRUEBA Esta 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: Usuario Password: CadenaXML: Usuario FEL que va a realizar el timbrado. usuario. FEL al recibir el Comprobante del contribuyente se encargará de realizar las valida ciones necesarias y posteriormente realizará el proceso de timbrado de prueba e inte grará 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 en el 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

12 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_TFDSoapClient Dim Respuesta As New WSFel.ArrayOfString Se recibe la respuesta Respuesta 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 respuesta Respuesta ServicioFEL.TimbrarCFDPrueba( usuario, password, cadenaxml );

13 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: Respuesta(0) Respuesta(1) Respuesta(2) Resultado(3) Resultado(4) Resultado(5) Resultado(6) Resultado(7) Resultado(8) Resultado(9) Resultado(10) Resultado(11) Resultado(12) "" "" "" complemento Timbre Fiscal Digital, que le comprobante enviado. Contiene la cadena original del Timbre, utilizada en la Sello del CFD enviado para timbrar. Sello del SAT. 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 validar que esto

14 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. Respuesta(0) Respuesta(1) Respuesta(2) que puede ser referente al XML enviado o a la forma de accesar el servicio. Ej. 301, 302. Mensaje del error producido. * 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 (difer ente 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.

15 ANEXO A. TABLAS DE ERRORES Y MENSAJES TIMBRADO 301 Mensaje XML mal formado El XML recibido no cumple con los estándares del SAT. 302 incorrecta. 303 Sello no corresponde a emisor o caduco 304 Certificado revocado o caduco La fecha de emisión no está dentro de la vigencia del CSD del Emisor El certificado no es de tipo CSD El CFDI contiene un timbre previo 308 Certificado no expedido por el SAT 401 Fecha y hora de generación fuera de rango 402 RFC del emisor no se encuentra en el régimen de contribuyentes La fecha de emisión no es posterior al 01 de enero 2011 RFC del emisor. vigencia. 403 El XML contiene ya contiene el complemento Timbre Fiscal Digital. SAT. fecha/hora posterior a la actual. El RFC del emisor no se encuentra en la LCO. Enero de CANCELACIÓN Mensaje UUID Cancelado UUID Previamente Cancelado UUID no corresponde al Emisor 204 UUID no aplicable para cancelación 205 UUID no existe El UUID enviado para cancelar no corresponde al RFC del emisor enviado. (caso poco probable). El UUID no existe en los registros del SAT.

16 INVOCACIÓN DEL SERVICIO FEL Mensaje El comprobante ya fue timbrado por FEL El comprobante contiene el nodo Addenda XML timbrado previamente por FEL. El XML contiene este nodo. No se debe timbrar un XML con Addenda, pero se puede agregar a su XML Alguno de los datos enviados para accesar al servicio es incorrecto. El usuario no cuenta con permiso de acceso El paquete de timbres ha expirado El RFC de usuario no corresponde al del emisor de CFDI de acceso por uso indebido del servicio. tratando de timbrar un XML de otro contribuyente. usuario por 30 minutos. del SAT para la entrega del CFDI.

17 Facturar en Línea Gracias! Si continúas con dudas... Por favor comunícate con nosotros: SOPORTE (222) soporte@facturarenlinea.com.mx Proveedor autorizado de certificación SAT Número de aprobación: 55029