manual de timbrado - Facturar En Línea

Transcripció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: 55029
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.2 Parámetros
4.4 Respuesta FEL
4.5 Consideraciones para la Cancelación
5
Generación de CFDI de Prueba
5.2 Parámetros
5.4 Respuesta FEL
5.5 Consideraciones para el Timbrado de Prueba
6
Anexo A. Tablas de errores y mensajes
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:
• 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.
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.
.
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
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#
WSFel. WS_TFDSoapClient ServicioFEL = New WSFel. WS_TFDSoapClient ();
WSFel. ArrayOfString Respuesta = New WSFel. WS_ ArrayOfString ();
Respuesta = ServicioFEL.TimbrarCFD(“usuario”, “password”, “cadenaXML”,
“referencia”);
-
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.
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.
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.
Respuesta = ServicioFEL.CancelarCFDI(“usuario”, “password”, “RFCEmisor”,
listaCFDI(), “Cadena del Pfx en formato Base 64”, “Password del Pfx”)
C#
WSFel. WS_TFDSoapClient ServicioFEL = New WSFel. WS_TFDSoapClien
WSFel. ArrayOfString Respuesta = New WSFel. WS_ ArrayOfString ();
Respuesta = ServicioFEL.CancelarCFDI(“usuario”, “password”, “RFCEmisor”,
listaCFDI(), “Cadena del Pfx en base 64”, “Password del Pfx”);
t();
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)
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.
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
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
Respuesta = ServicioFEL.TimbrarCFDPrueba(“usuario”, “password”, “cadenaXML”)
C#
WSFel. WS_TFDSoapClient ServicioFEL = New WSFel. WS_TFDSoapClient();
WSFel. ArrayOfString Respuesta = New WSFel. WS_ ArrayOfString();
Respuesta = ServicioFEL.TimbrarCFDPrueba(“usuario”, “password”, “cadenaXML”);
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
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)
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)
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.
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
305
306
307
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 2011.
CANCELACIÓN
201
202
203
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.
INVOCACIÓN DEL SERVICIO FEL
801
805
Mensaje
El comprobante ya fue timbrado por FEL
El comprobante contiene el nodo Addenda
806
807
808
809
811
815
816
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.
Facturar en Línea
¡Gracias!
Si continúas con dudas...
Por favor comunícate con nosotros:
SOPORTE
(222) 1 41 38 10
[email protected]
55029
www.fel .mx
Proveedor autorizado de certificación SAT
Número de aprobación: 55029

manual de timbrado - Facturar En Línea

Transcripción

Documentos relacionados

Promociones de Ventas Vigentes 2016

conexión remota y timbrado