Manual de Timbrado FEL - Facturar en Línea
←
→
Transcripción del contenido de la página
Si su navegador no muestra la página correctamente, lea el contenido de la página a continuación
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.
55029
www.fel.mx
Proveedor autorizado de certificación SAT
Número de aprobación: 55029Facturar 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 mensajesFacturar 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 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 Com-
probantes 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:
• 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.Facturar en Línea® - Facturación electrónica.
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 Usuario FEL que va a realizar el timbrado
Password : Contrasena de autenticación del usuario.
CadenaXML : Contenido del XML con la información del comprobante.
Debe cumplir con todos los requisitos de la versión 3 del SAT.
Referencia : 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.
.Facturar en Línea® - Facturación electrónica.
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 horasFacturar 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_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”);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 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) =
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.
Respuesta(0) =
enviado o a la forma de accesar el servicio. Ej. 301, 302.
Respuesta(1) = Mensaje del error producido.
Respuesta(2) =
*Se recomienda validar las posiciones que van del (0) al (2), si estas NO regresan
vacías se produjo un error.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 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 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 loscomprobantes.
passwordPKCS12Facturar 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_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 t();
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”);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) = “ ... “ 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.
Facturar en Línea® - Facturación electrónica. 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 Usuario FEL que va a realizar el timbrado. Password: usuario. CadenaXML: 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
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_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”);
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:
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 validar que estoFacturar 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.
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) =
* 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.Facturar en Línea® - Facturación electrónica.
ANEXO A. TABLAS DE ERRORES Y MENSAJES
TIMBRADO
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 Certificado revocado o caduco
vigencia.
305 La fecha de emisión no está dentro
de la vigencia del CSD del Emisor
306 El certificado no es de tipo CSD
307 El CFDI contiene un timbre previo El XML contiene ya contiene el complemento Timbre
Fiscal Digital.
308 Certificado 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 El RFC del emisor no se encuentra en la LCO.
de contribuyentes
403 La fecha de emisión no es
posterior al 01 de enero 2011 Enero de 2011.
CANCELACIÓN
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.Facturar en Línea® - Facturación electrónica.
INVOCACIÓN DEL SERVICIO FEL
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 tratando de timbrar un XML de otro
de CFDI contribuyente.
815
usuario por 30 minutos.
816
del SAT para la entrega del CFDI.Facturar en Línea
¡Gracias!
Si continúas con dudas...
Por favor comunícate con nosotros:
SOPORTE
(222) 1 41 38 10
soporte@facturarenlinea.com.mx
55029
www.fel .mx
Proveedor autorizado de certificación SAT
Número de aprobación: 55029También puede leer
