Contenido

1. Generalidades 1

1.1 Introducción 1

1.2 Objetivo 1

1.3 Alcance 1

2. Descripción General de SIFEI Web Service 2

3. Métodos de SIFEI Web Service 2

3.1 getCFDI 2

3.1.1 Objetivo 2

3.1.2 Llamada 2

3.1.3 Parámetros 2

3.1.4 Petición SOAP 3

3.1.5 Respuesta SOAP 3

3.1.6 Respuesta 3

3.1.7 Código del Cliente 4

3.2 getCFDIProcesa 4

3.2.1 Objetivo 4

3.2.2 Llamada 4

3.2.3 Parámetros 4

3.2.4 Petición SOAP 5

3.2.5 Respuesta SOAP 5

3.2.6 Respuesta 5

3.3 getCFDISign 6

3.3.1 Objetivo 6

3.3.2 Llamada 6

3.3.3 Parámetros 6

3.3.4 Petición SOAP 7

3.3.5 Respuesta SOAP 7

3.3.6 Respuesta 7

3.4 getTimbreCFDI 8

3.4.1 Objetivo 8

3.4.2 Llamada 8

3.4.3 Parámetros 8

3.4.4 Petición SOAP 8

3.4.5 Respuesta SOAP 9

3.4.6 Respuesta 9

3.4.7 Código del Cliente 9

3.5 CambiaPassword 9

3.5.1 Objetivo 9

3.5.2 Llamada 10

3.5.3 Parámetros 10

3.5.4 Petición SOAP 10

3.5.5 Respuesta SOAP 10

3.5.6 Respuesta 10

3.5.7 Código del Cliente 11

3.6 CancelaCFDI 11

3.7 CancelaCFDISectorPrimario 11

3.7.1 Objetivo 11

3.7.2 Llamada 11

3.7.3 Parámetros 11

3.7.4 Petición SOAP 12

3.7.5 Respuesta SOAP 12

3.7.6 Respuesta 12

3.8 getXML 12

3.8.1 Objetivo 12

3.8.2 Llamada 13

3.8.3 Parámetros 13

3.8.4 Petición SOAP 13

3.8.5 Respuesta SOAP 13

3.8.6 Respuesta 13

3.9 getXMLProceso 14

3.9.1 Objetivo 14

3.9.2 Llamada 14

3.9.3 Parámetros 14

3.9.4 Petición SOAP 14

3.9.5 Respuesta SOAP 14

3.9.6 Respuesta 14

3.10 Timbrado para Sector Primario 15

3.10.1 Objetivo 15

3.10.2 Llamada 15

3.10.3 Addenda para Sector Primario 15

3.10.4 Respuesta 16

3.10.5 Ejemplos de XML 16

4. Métodos SIFEI Web Service para Retenciones 18

4.1 getRetencion 18

4.1.1 Objetivo 18

4.1.2 Llamada 18

4.1.3 Parámetros 18

4.1.4 Petición SOAP 18

4.1.5 Respuesta SOAP 19

4.1.6 Respuesta 19

4.2 getTimbreRetenciones 20

4.2.1 Objetivo 20

4.2.2 Llamada 20

4.2.3 Parámetros 20

4.2.4 Petición SOAP 21

4.2.5 Respuesta SOAP 21

4.2.6 Respuesta 21

4.3 getTimbrePorHash 22

4.3.1 Objetivo 22

4.3.2 Llamada 22

4.3.3 Parámetros 22

4.3.4 Petición SOAP 22

4.3.5 Respuesta SOAP 23

4.3.6 Respuesta 23

4.4 cancelaRetencion 23

4.4.1 Objetivo 23

4.4.2 Llamada 23

4.4.3 Parámetros 23

4.4.4 Petición SOAP de un UUID 24

4.4.5 Respuesta SOAP de un UUID 24

4.4.6 Petición SOAP de dos UUID 25

4.4.7 Respuesta SOAP de ID de seguimiento 25

4.5 getCancelacionPorSeguimiento 25

4.5.1 Objetivo 25

4.5.2 Llamada 26

4.5.3 Parámetros 26

4.5.4 Petición SOAP 26

4.5.5 Response SOAP 26

5. Listas de Códigos de Error 27

5.1 Códigos de Error definidos por el SAT 27

5.2 Códigos de Error de la Matriz de validaciones para CFDI versión 3.3 28

5.3 Códigos de Error definidos por SIFEI 31

5.4 Códigos de Error para Retenciones 32

6. Procedimiento de operación de Clave de Confirmación para CFDI v3.3 32

6.1 Solicitud de una Clave de Confirmación 33

6.2 Uso de la Clave de Confirmación 33

7. Anexo 1 - WSDL 34

8. Glosario de términos y acrónimos 37

9. Referencias 38

10. Información de contacto con SIFEI 39

1. Generalidades

1.1 Introducción

SIFEI Web Service está diseñado para ofrecerle al cliente una total confianza en el proceso de Certificación de sus Comprobantes Fiscales Digitales por Internet (CFDI), ya que se tienen las más estrictas validaciones para que no ocurra ningún tipo de suplantación o generación de facturas no válidas que puedan caer en alguna sanción por parte del Sistema de Administración Tributaria (SAT).

Solución Integral de Facturación Electrónica e Informática S. A. de C. V. (SIFEI) es un Proveedor Autorizado de Certificación de CFDI (PCCFDI antes PAC) con número de autorización 58355 y cumple con los requerimientos funcionales, servicios generales y niveles de servicio (SLA) exigidos por el SAT.

SIFEI Web Service, nuestro servicio de Certificación de CFDIs en su versión 3.3, cumple con las especificaciones técnicas del Anexo 20 publicado por el SAT (en su sitio oficial) en el cual se especifican todas las validaciones para la certificación de los documentos fiscales.

1.2 Objetivo

Certificar CFDIs válidos de forma segura, rápida y eficaz realizando las validaciones normadas a cada tipo de documento fiscal.

1.3 Alcance

* La certificación se realiza con base al Anexo 20 y a la Matriz de Validaciones de los CFDI y complementos.

* Esta versión de SIFEI Web Service realiza la certificación de CFDIs en su versión 3.2 (hasta el 30 de noviembre de 2017).

* Esta versión de SIFEI Web Service realiza la certificación de CFDIs en su versión 3.3 (a partir del 01 de julio de 2017).

* Incluye todos los tipos de documentos actuales en la versión 3.3 (Ingreso, Egreso, Traslado, Nómina y Pagos).

* Entrega respuestas sobre los códigos de error de la Matriz de Validaciones vigente.

* Incluye las validaciones de cumplimiento de los complementos vigentes del CFDI.

* No realiza validaciones sobre Addendas.

* Realiza la entrega de los comprobantes certificados que cumplan con las validaciones.

* Administra el almacenamiento de comprobantes por 90 días (según la obligatoriedad del SAT).

* Envía copia del CFDI al SAT de manera inmediata una vez realizada la certificación del comprobante.

* Sólo certifica comprobantes de RFC Emisor que estén en la Lista de Contribuyentes con Obligación (LCO).

* Sólo certifica comprobantes de RFC Receptor que se encuentren en la Lista de RFCs Inscritos.

2. Descripción General de SIFEI Web Service

SIFEI Web Service es un servicio de certificación de CFDIs que permite la certificación accediendo a un servicio publicado en la página de SIFEI. El servicio provee un mecanismo de certificación de CFDIs cumpliendo con las disposiciones del SAT.

Este servicio realiza una serie de validaciones antes de certificar el documento, como, por ejemplo: la validez del Sello de la Factura, que el Emisor pueda facturar, que el RFC sea válido, que el Certificado corresponda al Emisor, entre otras. Todas las validaciones mencionadas se encuentran definidas en la Matriz de Validaciones proporcionada por el SAT y en caso de no aprobar alguna validación, el sistema devolverá alguno de los códigos de error que están definidos en el apartado 5.

El Web Service (WS) puede ser consumido por cualquier lenguaje de programación, ya que las peticiones se hacen con XML y actualmente todos los lenguajes de programación soportan el manejo de XML. Algunas de las pruebas realizadas para consumir el WS contemplaron el uso de los siguientes lenguajes de programación: VB .NET, C#, Java y PHP, todos con resultados satisfactorios.

Ruta de acceso al WS de Pruebas

http://devcfdi.sifei.com.mx:8080/SIFEI33/SIFEI?wsdl

Tecnología

JAX-WS

Versión de JAX-WS

2.2

3. Métodos de SIFEI Web Service

3.1 getCFDI

3.1.1 Objetivo

Firmar documentos válidos ante el SAT que contengan información correcta regresando un XML versión 3.3, y anexando el elemento TimbreFiscalDigital.

Importante: Este método está limitado a timbrar hasta 3 mil conceptos (partidas) por factura. Si la factura excede esa cantidad, obligatoriamente deberá consumir el método descrito en el apartado 3.2.

3.1.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getCFDI

Público

Byte[]

3.1.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

archivoXMLZip

Byte[]

Archivo XML en formato ZIP o únicamente los bytes del archivo XML

Serie

String

Serie del comprobante

IdEquipo

String

Id de equipo proporcionado por SIFEI

3.1.4 Petición SOAP

3.1.5 Respuesta SOAP

3.1.6 Respuesta

* Si el XML enviado aprobó todas las validaciones, el servicio devolverá un archivo en formato ZIP con el Timbre adjuntado al Comprobante Fiscal Digital.

* En caso de que haya algún error durante el proceso, el servicio devolverá una excepción con un Código de Error y un mensaje con la descripción de dicho código.

3.1.7 Código del Cliente

3.2 getCFDIProcesa

3.2.1 Objetivo

Recibir un cfdi para procesarlo posteriormente, respondiendo con un mensaje el cual indica que se recibió correctamente, así como el id de seguimiento, este CFDI será timbrado en el caso de haber sido correcto y para obtener el timbre se deberá consumir el método getXMLProceso.

3.2.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getCFDIProcesa

Público

String[]

3.2.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

archivoXMLZip

Byte[]

Archivo XML en formato ZIP o únicamente los bytes del archivo XML

Serie

String

Serie del comprobante

IdEquipo

String

Id de equipo proporcionado por SIFEI

3.2.4 Petición SOAP

3.2.5 Respuesta SOAP

3.2.6 Respuesta

* Si el zip enviado se recibió, se regresa un arreglo tipo String el cual indica lo siguiente:

En la posición cero indicará a través de un mensaje lo siguiente: CFDI en proceso de validación, verificar más tarde.

En la posición uno retornará el id de seguimiento para el cfdi que se envió el cual deberá proporcionarse en el método getXMLProceso.

* En caso de que haya algún error durante el proceso de recepción, el servicio devolverá una excepción con un Código de Error y un mensaje con la descripción de dicho código.

Nota: Este método solo procesará un CFDI por usuario y podrá ser enviado otro para su procesamiento una vez terminada la validación del primero que fue enviado por este mismo usuario.

3.3 getCFDISign

3.3.1 Objetivo

Firmar cfdi’s versión 3.3, regresando el mismo XML, y anexando el elemento TimbreFiscalDigital, se recomienda usar este método para los usuarios que envían a timbrar CFDI’s de sector primario, ya que verifica también que no se haya timbrado anteriormente el CFDI con la misma información.

Este método está limitado a timbrar hasta la cantidad de 3 mil conceptos, por lo cual si excede de esta cantidad se deberá consumir el método getCFDIProcesa; así mismo, es importante mencionar y tener presente que el consumo de folios estará directamente relacionado a la cantidad de conceptos (partidas) que tenga la factura a timbrar. A continuación, se muestra el tabulador de consumo en proporción de la cantidad de conceptos.

Cantidad de

Conceptos

Folios

consumidos

3000 o menos

1

3001 – 4000

4

4001 – 5000

5

5001 – 6000

6

Y así sucesivamente.

3.3.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getCFDISign

Público

Byte[]

3.3.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

archivoXMLZip

Byte[]

Archivo XML en formato ZIP o únicamente los bytes del archivo XML

Serie

String

Serie del comprobante

IdEquipo

String

Id de equipo proporcionado por SIFEI

3.3.4 Petición SOAP

3.3.5 Respuesta SOAP

3.3.6 Respuesta

* Si el XML enviado pasó todas las validaciones, el servicio devolverá un archivo en formato ZIP con el Timbre adjuntado al Comprobante Fiscal Digital.

* En caso de que haya algún error durante el proceso, el servicio devolverá una excepción con un Código de Error y un mensaje con la descripción de dicho código.

* Si el código de error corresponde a un 307 (previamente timbrado), retornará en la excepción el xml timbrado, a continuación, se muestra un ejemplo:

3.4 getTimbreCFDI

3.4.1 Objetivo

Firmar documentos válidos ante el SAT que contengan información correcta regresando un elemento TimbreFiscalDigital.

3.4.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getTimbreCFDI

Público

Byte[]

3.4.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

archivoXMLZip

Byte[]

Archivo XML en formato ZIP o únicamente los bytes del archivo XML

IdEquipo

String

Id de equipo proporcionado por SIFEI

Serie

String

Serie del documento

3.4.4 Petición SOAP

3.4.5 Respuesta SOAP

3.4.6 Respuesta

* Si el XML enviado aprobó todas las validaciones, el servicio devolverá un archivo en formato ZIP conteniendo únicamente el nodo TimbreFiscalDigital.

* En caso de que haya algún error durante el proceso, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

3.4.7 Código del Cliente

3.5 CambiaPassword

3.5.1 Objetivo

Cambiar la contraseña de un usuario en particular; esto se realiza con el fin de evitar posibles intrusiones por personas ajenas.

3.5.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

CambiaPassword

Público

Boolean

3.5.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

NewPassword

String

Contraseña con la que se reemplazará la anterior

3.5.4 Petición SOAP

3.5.5 Respuesta SOAP

3.5.6 Respuesta

* En caso de que se haya realizado el cambio de la contraseña de una manera correcta, el servicio devolverá TRUE como resultado.

* En caso de que haya algún error durante el proceso, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

3.5.7 Código del Cliente

3.6 CancelaCFDI

Nota: Este método ha sido actualizado para el nuevo esquema de cancelación, favor de consultar el manual SIFEI Web Service - Manual técnico del nuevo servicio de cancelación disponible en la página de SIFEI.

3.7 CancelaCFDISectorPrimario

3.7.1 Objetivo

Cancelar comprobantes fiscales de sector primario timbrados, ante las instancias del SAT. El método de cancelación puede realizar esta función en uno o más comprobantes a la vez.

3.7.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

CancelaCFDISectorPrimario

Público

String

3.7.3 Parámetros

Nombre

Tipo de dato

Descripción

usuarioSIFEI

String

Usuario con el que se realizará la autenticación

passUser

String

Contraseña con la que se realizará la autenticación

rfc

String

RFC del contribuyente que cancelará el documento

UUIDS

String[]

Lista con los UUIDS a cancelar

3.7.4 Petición SOAP

3.7.5 Respuesta SOAP

3.7.6 Respuesta

* En respuesta satisfactoria regresará un String con el Acuse obtenido por el SAT.

* En caso de que haya algún error durante el proceso, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

3.8 getXML

3.8.1 Objetivo

Obtener el Timbre de un Comprobante previamente timbrado, el cual únicamente retomará el elemento timbre.

Importante: Sólo es posible recuperar los timbres de comprobantes que tengan un histórico de hasta 72 horas a partir de la certificación.

3.8.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getXML

Público

String

3.8.3 Parámetros

Nombre

Tipo de dato

Descripción

rfc

String

Usuario con el que se realizará la autenticación

pass

String

Contraseña con la que se realizará la autenticación

hash

String

Digestión generada de la cadena original, a la cual se le aplica un sha1

3.8.4 Petición SOAP

3.8.5 Respuesta SOAP

3.8.6 Respuesta

* En respuesta satisfactoria regresará un dato tipo String con el nodo timbre correspondiente al hash obtenido del comprobante.

* En caso de que ocurra algún error durante el proceso, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

3.9 getXMLProceso

3.9.1 Objetivo

Obtener el timbre de un CFDI previamente timbrado, así como la cantidad de folios que fueron descontados, y en caso de existir un error se provocará una excepción.

Importante: Sólo se podrán recuperar los timbres de comprobantes que tengan un histórico de hasta 72 horas a partir de la certificación.

3.9.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getXMLProceso

Público

String[]

3.9.3 Parámetros

Nombre

Tipo de dato

Descripción

rfc

String

Usuario con el que se realizará la autenticación

pass

String

Contraseña con la que se realizará la autenticación

hash

String

Digestión generada de la cadena original, a la cual se le aplica un sha1

3.9.4 Petición SOAP

3.9.5 Respuesta SOAP

3.9.6 Respuesta

* En caso de obtener una respuesta satisfactoria el servicio regresará un arreglo de datos de tipo String en el cual en la posición cero regresa el nodo timbre correspondiente al hash obtenido del comprobante y en la posición 1 regresa la cantidad de timbres consumidos.

* En caso de que haya algún error durante el proceso o durante la validación del CFDI, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

3.10 Timbrado para Sector Primario

3.10.1 Objetivo

Firmar documentos válidos ante el SAT del esquema de expedición de factura a través de los Adquirentes de Bienes y Servicios, y Sector Primario (“Sector Primario”) que contengan información correcta regresando un XML versión 3.3, y anexando un elemento TimbreFiscalDigital.

3.10.2 Llamada

El método para el timbrado de comprobantes de sector primario se hace a través del método getCFDISign (Método getCFDI).

3.10.3 Addenda para Sector Primario

Para poder realizar el timbrado de comprobantes de sector primario, se debe agregar la siguiente Addenda en el XML:

<SectorPrimarioSIFEI certificado="" key="" claveKey=""/>

XSD para generar la addenda

3.10.3.1 Descripción de los atributos de la Addenda

Atributo

Descripción

Certificado

Certificado del receptor en bytes

Key

key del receptor en bytes

claveKey

Clave del key

3.10.4 Respuesta

* Si los atributos de la Addenda son correctos y la autorización en el SAT es un resultado verdadero, se procederá a realizar el sellado con los certificados de sector primario por parte de SIFEI, para lo cual una vez sellado el comprobante, se asignan los siguientes atributos a nivel del nodo “cfdi:Comprobante”: Certificado, NoCertificado, Sello; donde los primeros 3 atributos mencionados, se obtienen a partir de los certificados de SIFEI , para el proceso de sellado y finalmente se devolverá un archivo en formato ZIP con el Timbre adjuntado al Comprobante Fiscal Digital.

* En caso de que ocurra algún error, específicamente durante el proceso de sector primario que tienen que ver con validaciones adicionales para este tipo de comprobante, el servicio devolverá una excepción con un código de error 301 el cual puede contener alguno de los errores descritos a continuación:

Código

Error

301

Error no se ha podido verificar la firma de autorización ante el SAT, para sector primario

301

No se ha encontrado el RFC del Emisor en el SAT como Proveedor Autorizado de Sector Primario

301

El servicio del SAT, para verificar la autorización de emisión de sector primario no está disponible, intentar más tarde

3.10.5 Ejemplos de XML

3.10.5.1 XML con atributos vacíos

El XML que debe generarse para enviar a timbrar debe tener los siguiente atributos vacíos para que posteriormente el servicio de timbrado llene esta información (Certificado, NoCertificado y Sello).

3.10.5.2 Ejemplo de Addenda

La siguiente imagen muestra cómo debe quedar finalmente la Addenda, la cual debe integrarse al XML.

3.10.5.3 Ejemplo de XML como respuesta

En la siguiente imagen se muestra el XML de respuesta, sólo si el proceso de validación que realiza el servicio de timbrado y el SAT son correctos.

4. Métodos SIFEI Web Service para Retenciones

4.1 getRetencion

4.1.1 Objetivo

Firmar documentos válidos de retenciones ante el SAT que contengan información correcta, regresando un XML versión 1.0 y anexando un elemento TimbreFiscalDigital.

4.1.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getRetencion

Público

String

4.1.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

archivoXMLZip

Byte[]

Archivo XML en formato ZIP o únicamente los bytes del archivo XML

Serie

String

Serie del comprobante

IdEquipo

String

Id de equipo proporcionado por SIFEI

4.1.4 Petición SOAP

4.1.5 Respuesta SOAP

4.1.6 Respuesta

* Si el XML enviado aprobó todas las validaciones, el servicio devolverá un archivo en formato ZIP con el Timbre adjuntado al Comprobante Fiscal Digital.

* En caso de que ocurra un error durante el proceso, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

4.2 getTimbreRetenciones

4.2.1 Objetivo

Firmar documentos válidos de retenciones ante el SAT que contengan información correcta regresando un elemento TimbreFiscalDigital.

4.2.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getTimbreRetenciones

Público

Byte[]

4.2.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

archivoXMLZip

Byte[]

Archivo XML en formato ZIP o únicamente los bytes del archivo XML

IdEquipo

String

Id de equipo proporcionado por SIFEI

Serie

String

Serie del documento

4.2.4 Petición SOAP

4.2.5 Respuesta SOAP

4.2.6 Respuesta

* Si el XML enviado aprobó todas las validaciones, el servicio devolverá un archivo en formato ZIP con el Timbre adjuntado al Comprobante Fiscal Digital.

* En caso de que haya algún error durante el proceso, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

4.3 getTimbrePorHash

4.3.1 Objetivo

Obtener el Timbre de un comprobante de retenciones previamente timbrado, el cual únicamente retornará el elemento timbre.

Importante: Sólo se podrán recuperar los timbres de comprobantes que tengan un histórico de hasta 72 horas a partir de la certificación.

4.3.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getTimbrePorHash

Público

String

4.3.3 Parámetros

Nombre

Tipo de dato

Descripción

rfc

String

Usuario con el que se realizará la autenticación

pass

String

Contraseña con la que se realizará la autenticación

hash

String

Digestión generada de la cadena original, a la cual se le aplica un sha1

4.3.4 Petición SOAP

4.3.5 Respuesta SOAP

4.3.6 Respuesta

* Si el XML enviado aprobó todas las validaciones, el servicio devolverá un archivo en formato ZIP con el Timbre adjuntado al Comprobante Fiscal Digital.

* En caso de que haya algún error durante el proceso, el servicio devolverá una excepción con un código de error y un mensaje con la descripción de dicho código.

4.4 cancelaRetencion

4.4.1 Objetivo

Cancelar comprobantes fiscales timbrados de retenciones, ante las instancias del SAT; si se envía más de un UUID a cancelar, se obtendrá de respuesta un ID de seguimiento para el cual debe consumirse posteriormente el método “getCancelacionPorSeguimiento”

4.4.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

cancelaRetencion

Público

String

4.4.3 Parámetros

Nombre

Tipo de dato

Descripción

usuarioSIFEI

String

Usuario con el que se realizará la autenticación

passUser

String

Contraseña con la que se realizará la autenticación

rfc

String

RFC del contribuyente que cancelará el documento

pfx

Byte[]

Archivo con los certificados del emisor en formato .PFX o .PKCS12

passPfx

String

Password del PFX

UUIDS

String[]

Lista con los UUIDs a cancelar

4.4.4 Petición SOAP de un UUID

4.4.5 Respuesta SOAP de un UUID

4.4.6 Petición SOAP de dos UUID

4.4.7 Respuesta SOAP de ID de seguimiento

4.5 getCancelacionPorSeguimiento

4.5.1 Objetivo

Obtener el acuse de cancelación a través del id de seguimiento generado al cancelar más de un UUID, si el acuse existe será devuelto en la respuesta, de lo contrario se obtendrá una respuesta del estado en que se encuentra la cancelación, es decir si aún está en proceso.

4.5.2 Llamada

Nombre del método

Modificador de acceso

Tipo de dato de retorno

getCancelacionPorSeguimiento

Público

String

4.5.3 Parámetros

Nombre

Tipo de dato

Descripción

Usuario

String

Usuario con el que se realizará la autenticación

Password

String

Contraseña con la que se realizará la autenticación

IdSeguimiento

String

Id de seguimiento obtenido del método “cancelaRetencion” cuando se envían más de dos UUID a cancelar

4.5.4 Petición SOAP

4.5.5 Response SOAP

Cuando aún está en proceso la cancelación la respuesta será similar a la siguiente respuesta SOAP:

Si los comprobantes fueron cancelados correctamente mostrará una respuesta como la siguiente:

5. Listas de Códigos de Error

5.1 Códigos de Error definidos por el SAT

Código

Error

301

El comprobante no cumple con el estándar XML (Conforme al W3C) o con la estructura XML (XSD y complementos aplicables)

* El documento no es correcto sintácticamente

* El documento <referencia> no está codificado en UTF-8

302

El sello del emisor no es válido

* El documento <referencia> no está firmado

* Error al verificar la firma del documento <referencia>. El CFDI fue firmado de una manera incorrecta.

303

El CSD del emisor no corresponde al RFC que viene como emisor en el comprobante.

* El certificado <SerialRFC> del RFC <EmisorRFC> ha sido revocado según LCO

304

El CSD del emisor ha sido revocado utilizando la lista del LCO

* El certificado <SerialRFC> del RFC <EmisorRFC> ha sido revocado según LCO

305

La fecha de emisión no está dentro de la vigencia del CSD del emisor

* El certificado <SerialRFC> todavía no es válido para la fecha del documento <referencia> <fecha_documento>.

* El certificado <SerialRFC> ya no es válido para la fecha del documento <referencia> <fecha_documento>

306

La llave utilizada para sellar corresponde a una FIEL (no a un CSD)

* El certificado <SerialRFC> es de tipo FIEL, no es un CSD

307

Contiene timbre previo

* El documento <referencia> ya ha sido timbrado <hash>

* El documento <referencia> ya ha sido timbrado previamente por un PAC con UUID <uuid>

308

El CSD del emisor no ha sido firmado por un certificado de autoridad del SAT

* El certificado <SerialRfc> no ha sido expedido por el Servicio de Administración Tributaria.

401

La fecha de generación es mayor a 72 horas de la emisión del timbre

* No puede firmarse el documento <referencia> con fecha <fecha>. Han pasado más de 72 horas desde su generación

* No puede firmarse el documento <referencia> con fecha <fecha>. La fecha es posterior a la actual

402

El RFC no existe conforme al régimen autorizado (Lista de Validación del Régimen) LCO

* Error al verificar la firma del documento <referencia>. El CFDI fue firmado de manera incorrecta.

* El RFC <emisorRFC> no está autorizado para firmar según LCO

403

La fecha de emisión es anterior al 01 de enero de 2011

* La fecha de emisión del comprobante no puede ser anterior al 01 de enero de 2011

5.2 Códigos de Error de la Matriz de validaciones para CFDI versión 3.3

Código

Error

CFDI33101

El campo Fecha no cumple con el patrón requerido

CFDI33102

El resultado de la digestión debe ser igual al resultado de la desencripción del sello.

CFDI33103

Si existe el complemento para recepción de pagos el campo FormaPago no debe existir.

CFDI33104

El campo FormaPago no contiene un valor del catálogo c_FormaPago.

CFDI33105

EL certificado no cumple con alguno de los valores permitidos.

CFDI33106

El valor de este campo SubTotal excede la cantidad de decimales que soporta la moneda.

CFDI33107

El TipoDeComprobante es I, E o N, el importe registrado en el campo no es igual a la suma de los importes de los conceptos registrados.

CFDI33108

El TipoDeComprobante es T o P y el importe no es igual a 0, o cero con decimales.

CFDI33109

El valor registrado en el campo Descuento no es menor o igual que el campo Subtotal.

CFDI33110

El TipoDeComprobante no es I, E o N, y un concepto incluye el campo descuento.

CFDI33111

El valor del campo Descuento excede la cantidad de decimales que soporta la moneda.

CFDI33112

El campo Moneda no contiene un valor del catálogo c_Moneda.

CFDI33113

El campo TipoCambio no tiene el valor "1" y la moneda indicada es MXN.

CFDI33114

El campo TipoCambio se debe registrar cuando el campo Moneda tiene un valor distinto de MXN y XXX.

CFDI33115

El campo TipoCambio no se debe registrar cuando el campo Moneda tiene el valor XXX.

CFDI33116

El campo TipoCambio no cumple con el patrón requerido.

CFDI33117

Cuando el valor del campo TipoCambio se encuentre fuera de los límites establecidos, debe existir el campo Confirmacion.

CFDI33118

El campo Total no corresponde con la suma del subtotal, menos los descuentos aplicables, más las contribuciones recibidas (impuestos trasladados - federales o locales, derechos, productos, aprovechamientos, aportaciones de seguridad social, contribuciones de mejoras) menos los impuestos retenidos.

CFDI33119

Cuando el valor del campo Total se encuentre fuera de los límites establecidos, debe existir el campo Confirmacion.

CFDI33120

El campo TipoDeComprobante, no contiene un valor del catálogo c_TipoDeComprobante.

CFDI33121

El campo MetodoPago, no contiene un valor del catálogo c_MetodoPago.

CFDI33122

Cuando se tiene el valor PIP en el campo MetodoPago y el valor en el campo TipoDeComprobante es I E, el CFDI debe contener un complemento de recibo de pago.

CFDI33123

Se debe omitir el campo MetodoPago cuando el TipoDeComprobante es T o P.

CFDI33124

Si existe el complemento para recepción de pagos en este CFDI el campo MetodoPago no debe existir.

CFDI33125

El campo LugarExpedicion, no contiene un valor del catálogo c_CodigoPostal.

CFDI33126

El campo Confirmacion no debe existir cuando los atributos TipoCambio y/o Total están dentro del rango permitido.

CFDI33127

Número de confirmación inválido.

CFDI33128

Número de confirmación utilizado previamente.

CFDI33129

El campo TipoRelacion, no contiene un valor del catálogo c_TipoRelacion.

CFDI33130

El campo RegimenFiscal, no contiene un valor del catálogo c_RegimenFiscal.

CFDI33131

La clave del campo RegimenFiscal debe corresponder con el tipo de persona (física o moral).

CFDI33132

Este RFC del receptor no existe en la lista de RFC inscritos no cancelados del SAT.

CFDI33133

El campo ResidenciaFiscal, no contiene un valor del catálogo c_Pais.

CFDI33134

El RFC del receptor es de un RFC registrado en el SAT o un RFC genérico nacional y existe el campo ResidenciaFiscal.

CFDI33135

El valor del campo ResidenciaFiscal no puede ser MEX.

CFDI33136

Se debe registrar un valor de acuerdo con el catálogo c_Pais en el campo ResidenciaFiscal, cuando en el campo NumRegIdTrib se registre información.

CFDI33137

El valor del campo es un RFC inscrito no cancelado en el SAT o un RFC genérico nacional, y se registró el campo NumRegIdTrib.

CFDI33138

Para registrar el campo NumRegIdTrib, el CFDI debe contener el complemento de comercio exterior y el RFC del receptor debe ser un RFC genérico extranjero.

CFDI33139

El campo NumRegIdTrib no cumple con el patrón correspondiente.

CFDI33140

El campo UsoCFDI, no contiene un valor del catálogo c_UsoCFDI.

CFDI33141

La clave del campo UsoCFDI debe corresponder con el tipo de persona (física o moral).

CFDI33142

El campo ClaveProdServ, no contiene un valor del catálogo c_ClaveProdServ.

CFDI33143

No existe el complemento requerido para el valor de ClaveProdServ.

CFDI33144

No está declarado el impuesto relacionado con el valor de ClaveProdServ.

CFDI33145

El campo ClaveUnidad no contiene un valor del catálogo c_ClaveUnidad.

CFDI33146

El valor del campo ValorUnitario debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33147

El valor del campo ValorUnitario debe ser mayor que cero (0) cuando el tipo de comprobante es Ingreso, Egreso o Nomina.

CFDI33148

El valor del campo Importe debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33149

El valor del campo Importe no se encuentra entre el límite inferior y superior permitido.

CFDI33150

El valor del campo Descuento debe tener hasta la cantidad de decimales que tenga registrado el atributo importe del concepto.

CFDI33151

El valor del campo Descuento es mayor que el campo Importe.

CFDI33152

En caso de utilizar el nodo Impuestos en un concepto, se deben incluir impuestos de traslado y/o retenciones.

CFDI33153

El valor del campo Base que corresponde a Traslado debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33154

El valor del campo Base que corresponde a Traslado debe ser mayor que cero.

CFDI33155

El valor del campo Impuesto que corresponde a Traslado no contiene un valor del catálogo c_Impuesto.

CFDI33156

El valor del campo TipoFactor que corresponde a Traslado no contiene un valor del catálogo c_TipoFactor.

CFDI33157

Si el valor registrado en el campo TipoFactor que corresponde a Traslado es Exento no se deben registrar los campos TasaOCuota ni Importe.

CFDI33158

Si el valor registrado en el campo TipoFactor que corresponde a Traslado es Tasa o Cuota, se deben registrar los campos TasaOCuota e Importe.

CFDI33159

El valor del campo TasaOCuota que corresponde a Traslado no contiene un valor del catálogo c_TasaOcuota o se encuentra fuera de rango.

CFDI33160

El valor del campo Importe que corresponde a Traslado debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33161

El valor del campo Importe o que corresponde a Traslado no se encuentra entre el límite inferior y superior permitido.

CFDI33162

El valor del campo Base que corresponde a Retención debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33163

El valor del campo Base que corresponde a Retención debe ser mayor que cero.

CFDI33164

El valor del campo Impuesto que corresponde a Retención no contiene un valor del catálogo c_Impuesto.

CFDI33165

El valor del campo TipoFactor que corresponde a Retención no contiene un valor del catálogo c_TipoFactor.

CFDI33166

Si el valor registrado en el campo TipoFactor que corresponde a Retención debe ser distinto de Exento.

CFDI33167

El valor del campo TasaOCuota que corresponde a Retención, no contiene un valor del catálogo c_TasaOcuota o se encuentra fuera de rango.

CFDI33168

El valor del campo Importe que corresponde a Retención debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33169

El valor del campo Importe que corresponde a Retención no se encuentra entre el límite inferior y superior permitido.

CFDI33170

El número de pedimento es inválido.

CFDI33171

El NumeroPedimento no debe existir si se incluye el complemento de comercio exterior.

CFDI33172

El campo ClaveProdServ, no contiene un valor del catálogo c_ClaveProdServ.

CFDI33173

El valor del campo ValorUnitario debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33174

El valor del campo ValorUnitario debe ser mayor que cero (0).

CFDI33175

El valor del campo Importe debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33176

El valor del campo Importe no se encuentra entre el límite inferior y superior permitido.

CFDI33177

El número de pedimento es inválido.

CFDI33178

El NumeroPedimento no debe existir si se incluye el complemento de comercio exterior.

CFDI33179

Cuando el TipoDeComprobante sea T o P, el elemento Impuestos no debe existir.

CFDI33180

El valor del campo TotalImpuestosRetenidos debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33181

El valor del campo TotalImpuestosRetenidos debe ser igual a la suma de los importes registrados en el elemento hijo Retencion.

CFDI33182

El valor del campo TotalImpuestosTrasladados debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33183

El valor del campo TotalImpuestosTrasladados no es igual a la suma de los importes registrados en el elemento hijo Traslado.

CFDI33184

Debe existir el campo TotalImpuestosRetenidos.

CFDI33185

El campo Impuesto no contiene un valor del catálogo c_Impuesto.

CFDI33186

Debe haber sólo un registro por cada tipo de impuesto retenido.

CFDI33187

Debe existir el campo TotalImpuestosRetenidos.

CFDI33188

El valor del campo Importe correspondiente a Retención debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33189

El campo Importe correspondiente a Retención no es igual a la suma de los importes de los impuestos retenidos registrados en los conceptos donde el impuesto sea igual al campo Impuesto de este elemento.

CFDI33190

Debe existir el campo TotalImpuestosTrasladados.

CFDI33191

El campo Impuesto no contiene un valor del catálogo c_Impuesto.

CFDI33192

Debe haber sólo un registro con la misma combinación de impuesto, factor y tasa por cada traslado.

CFDI33193

El valor seleccionado debe corresponder a un valor del catálogo donde la columna impuesto corresponda con el campo impuesto y la columna factor corresponda con el campo TipoFactor.

CFDI33194

El valor del campo Importe correspondiente a Traslado debe tener hasta la cantidad de decimales que soporte la moneda.

CFDI33195

El campo Importe correspondiente a Traslado no es igual a la suma de los importes de los impuestos trasladados registrados en los conceptos donde el impuesto del concepto sea igual al campo impuesto de este elemento y la TasaOCuota del concepto sea igual al campo TasaOCuota de este elemento.

CFDI33196

Error no identificado.

5.3 Códigos de Error definidos por SIFEI

Código

Error

1001

El usuario no cuenta con más créditos disponibles

* No cuenta con más créditos disponibles

1002

El archivo ZIP contiene más de un archivo

* Solo se permite ingresar un XML por archivo ZIP

1003

El RFC del receptor es incorrecto

* Error en el RFC del receptor

1005

Certificado Incorrecto

* El certificado ingresado en el comprobante es inválido

1006

Comprobante no encontrado

1007

Folios insuficientes

2001

Archivo PFX Incorrecto

* El archivo enviado no es un PFX

2002

Contraseña incorrecta del PFX

* La contraseña para el archivo PFX es inválida

5.4 Códigos de Error para Retenciones

Código

Error

1201

UUID cancelado

1202

UUID previamente cancelado

1203

UUID no corresponde con el emisor

1205

UUID no existe

1300

Autenticación no válida

1301

XML mal formado

1302

Estructura de folios no válida

1303

Estructura de RFC no válida

1304

Estructura de fecha no válida

1305

Certificado no corresponde al emisor

1306

Certificado no vigente

1307

Uso de FIEL no permitido

1308

Certificado revocado o caduco

1309

Firma mal formada o inválida

6. Procedimiento de operación de Clave de Confirmación para CFDI v3.3

La Clave de Confirmación es un código compuesto de 5 caracteres alfanuméricos, que cumple con el patrón <[0-9a-zA-Z]{5}> y es otorgado por el PAC, en este caso SIFEI, a los emisores que requieran expedir un comprobante con los atributos Total y/o TipoCambio fuera del rango establecido.

En caso de que se solicite timbrar un comprobante con uno o ambos atributos fuera de rango, SIFEI Web Service validará lo siguiente:

* Que en el CFDI se incluya el atributo Confirmacion.

* Que el atributo Confirmacion tenga un valor que cumpla con el patrón especificado.

* Que el valor del atributo Confirmación se encuentre registrado en nuestra base de datos.

* Que el valor del atributo Confirmación esté asociado al comprobante con los mismos datos del comprobante que se desea emitir: RFC del Emisor, Moneda, Tipo de Cambio y Total.

* Que el valor del atributo Confirmación sea vigente: Los códigos de confirmación tienen un tiempo de vida de 24 horas a partir de su generación.

* Que el valor del atributo Confirmación no haya sido utilizado previamente en otro comprobante.

Con base en estas validaciones se puede retornar alguno de los siguientes códigos de error:

* CFDI33117

* CFDI33119

* CFDI33126

* CFDI33127

* CFDI33128

Para mayor referencia de estos errores, consulte la sección 0.

Códigos de Error de la Matriz de validaciones para CFDI versión 3.3.

Es importante señalar que el SAT determinó que el emisor debe obtener de manera no automática una clave de confirmación para ratificar que el importe es correcto e integrarla en este campo al CFDI.

6.1 Solicitud de una Clave de Confirmación

El emisor puede solicitar la creación de una clave de confirmación por medio de una solicitud de soporte mediante el levantamiento de un Ticket a Soporte Técnico de SIFEI enviando un correo electrónico a la dirección helpdesk@sifei.com.mx, indicando los siguientes datos del comprobante para el que requiere dicho código:

* RFC del Emisor

* Moneda

* Tipo de Cambio

* Total

Un Agente de Soporte Técnico de SIFEI revisará la solicitud y en su caso generará la clave de confirmación asociada a la solicitud, respondiendo a dicho ticket mediante un correo electrónico que incluirá la clave de confirmación asignada.

6.2 Uso de la Clave de Confirmación

Una vez recibida la clave de confirmación, el emisor deberá integrarla en su comprobante en el atributo Confirmacion del nodo Comprobante del CFDI. En caso de que el comprobante haya sido sellado previamente, el emisor deberá realizar nuevamente el proceso de sellado del comprobante ya que el atributo Confirmación se integra a la Cadena Original para generar el Sello.

Posteriormente, únicamente deberá volver a enviar a timbrar su comprobante ya con la clave de confirmación integrada y el nuevo sello. SIFEI Web Service realizará las validaciones y marcará la clave de confirmación como “UTILIZADO”, para evitar su uso en otro comprobante.

7. Anexo 1 - WSDL

8.

Glosario de términos y acrónimos

XML. Extensible Markup Language. Es el lenguaje de programación utilizado para crear facturas electrónicas y en realdad se utiliza para distintos tipos de documentos informáticos.

UUID. Identificador único universal. En factura electrónica se utiliza como folio para poder identificar de manera única a un comprobante.

COMPROBANTES FISCALES. Documentos que amparan transacciones comerciales, que pueden estar generados en forma electrónica o en papel.

CFDI. Comprobantes Fiscales Digitales a través de Internet. Éste es el nuevo mecanismo de comprobación fiscal, actualmente en su versión 3.3. Añade un timbrado a los XML generados por los emisores que sellan los PAC para asegurar su estructura principal y brindar legitimidad al comprobante.

LCO. Lista de Contribuyentes Obligados.

PFX. Un archivo de Personal Information Exchange (.pfx, Intercambio de Información Personal) se utiliza para almacenar las claves privadas y públicas de un Software Publisher Certificate (SPC, Certificado de Editor de Software) para liberar una firma.

SIFEI. Solución Integral de Facturación Electrónica e Informática SIFEI S. A. de C. V.

SOAP. Simple Object Access Protocol, es un protocolo estándar que define como dos objetos en diferentes procesos pueden comunicarse por medio de intercambio de datos XML.

UUID. Universally Unique IDentifier (Identificador Único Universal) código identificador estándar empleado en el proceso de construcción de software. Se utiliza como Folio Fiscal para identificar de manera única un CFDI. XML eXtensible Markup Language (Lenguaje de Marcado Extensible) es un meta-lenguaje que permite definir lenguajes de marcas utilizado para almacenar datos en forma legible.

XSD. XML (Definition) Schema es un lenguaje de esquema utilizado para describir la estructura y las restricciones de los contenidos de los documentos XML de una forma muy precisa.

WSDL. Web Services Description Language, es un formato XML que se utiliza para describir servicios Web

9. Referencias

ESTÁNDAR TÉCNICO DEL COMPLEMENTO DE RECEPCIÓN DE PAGOS

http://omawww.sat.gob.mx/tramitesyservicios/Paginas/documentos/Pagos10.pdf

GUÍA DE LLENADO DEL COMPLEMENTO DE RECEPCIÓN DE PAGOS

http://omawww.sat.gob.mx/tramitesyservicios/Paginas/documentos/Guia_comple_pagos.pdf

ANEXO 20

http://omawww.sat.gob.mx/tramitesyservicios/Paginas/documentos/cfdv33.pdf

GUÍA DE LLENADO

http://omawww.sat.gob.mx/tramitesyservicios/Paginas/documentos/GuiaAnexo20.pdf

CATÁLOGOS

http://omawww.sat.gob.mx/tramitesyservicios/Paginas/documentos/catCFDI.xls

FORMATO DE FACTURA (ANEXO 20)

http://omawww.sat.gob.mx/tramitesyservicios/Paginas/anexo_20_version3-3.htm

ENVIO DE SOLICITUD PARA TRAMITAR CSD (SAT)

https://www.sat.gob.mx/tramites/17507/envia-la-solicitud-para-tu-certificado-de-sello-digital-para-emitir-facturas-electronicas

10. Información de contacto con SIFEI

CENTRO DE SOPORTE TÉCNICO SIFEI

Acceso a recursos de Soporte Técnico de los productos y servicios de SIFEI, Preguntas Frecuentes, Manuales de Usuario, Manuales Técnicos, Notas Técnicas, entre otros.

Dirección electrónica

Centro de Soporte Técnico SIFEI

TELÉFONOS DE CONTACTO

Orizaba, Ver.

01 (272) 726 6999

CDMX

(55) 4624 0146

Puebla, Pue.

01 (222) 211 6156

con 10 líneas

ATENCIÓN A INCIDENTES

La atención a incidentes se realizará mediante una herramienta de gestión de incidentes y la comunicación se realizará mediante correo electrónico.

Correo Electrónico

soporte@sifei.com.mx

HORARIO DE ATENCIÓN

El horario de atención a clientes y de Soporte Técnico para para preguntas, dudas o problemas de la aplicación es:

Lunes a viernes

De 09:00 a 19:00 hrs.

PÁGINAS OFICIALES DE SIFEI

Sitio web

http://www.sifei.com.mx/

Facebook

http://www.facebook.com/sifeimexico

Twitter

http://twitter.com/#!/SIFEIMexico

YouTube

https://www.youtube.com/channel/UCDSLHrFOg2tGvG3AruHNmaw

LinkedIn

https://www.linkedin.com/company/18265037/

UBICACIÓN DE OFICINA MATRIZ

Primera Privada de Oriente 17 No. 32

Col. Centro, Orizaba, Veracruz, México

CP 94300

MANUAL TÉCNICO DE SIFEI WEB SERVICE

Página iii de v Agosto 2019

MANUAL TÉCNICO DE SIFEI WEB SERVICE

Página 38 de 39 Agosto 2019