servicio de cancelación cfdi-retenciones.
El servicio de cancelación consta de un servicio REST para cancelación de CFDIs timbrados ante el SAT, a partir del UUID del comprobante.
La siguiente guía explica cómo utilizar el servicio de cancelación, usando como ejemplo la Terminal o Linea de comandos y cURL.
Para un ambiente productivo, es indispensable contar con un CSD instalado en tu cuenta web de Conector Fiscal®.
Cancelación de un comprobante a través del servicio REST:
https://staging.diverza.com/api/v1/cancelar
encabezados
Todas las peticiones requieren los siguientes ecabezados:
x-auth-token:
Incluirá el token que nosotros te proporcionaremos para que te reconozcamos y podamos brindarte el servicio. Para propósitos de pruebas, puedes usar el valor ABCD1234 asignado al RFC Emisor AAA010101AAA.
Content-Type:
Indicará el tipo de documento que deseas procesar:
Cancelación de CFDI
- application/vnd.diverza.cancela.cfdi+xml; charset=UTF-8
Cancelación de constancia de retención
- application/vnd.diverza.cancela.retencion+xml; charset=UTF-8
Content-MD5:
Contendrá el hash del archivo enviado en tu petición, expresado como una cadena de 32 caracteres. Te recomendamos ampliamente implementar este valor, ya que te proporciona un mecanismo de certeza adicional. Para propósito de pruebas, el valor de este atributo no será validado
cancelar.
La siguiente es la estructura de la información contenida en el "body" de la petición, para el caso de uso de "Terminal", se usará un archivo XML con éste contenido.
<Cancelacion>
<rfcEmisor>AAA010101AAA</rfcEmisor>
<Folios>
<UUID>2fbac5d4-5814-42c0-b387-171d08f7c58a</UUID>
</Folios>
</Cancelacion>
Servicio
Para el siguiente ejemplo de cancelación de un comprobante timbrado, usaremos:
Servidor de prueba: https://staging.diverza.com/
Servicio: /api/v1/cancelar
Metodo HTTP: POST
Header HTTP: x-auth-token
Header HTTP: Content-Type
Header HTTP: Content-MD5
Token de prueba: ABCD1234
Content-Type: application/vnd.diverza.cancela.retencion+xml; charset=UTF-8
Content-MD5: (Es el "hash" del archivo enviado en tu petición, expresado en una cadena de 32 caracteres.)
UUID de prueba: 2fbac5d4-5814-42c0-b387-171d08f7c58a
Si lo que deseas es cancelar un CFDI, sólo deberás cambiar el Content-Type por el siguiente:
"Content-Type: application/vnd.diverza.cancela.cfdi+xml; charset=UTF-8"
Nota: Es importante que utilices el mismo token con el que timbraste el comprobante. Con él, comprobaremos que tu haces la petición y obtendremos los datos necesarios para procesar la cancelación con el SAT.
Nota: El UUID es un atributo del complemento TimbreFiscalDigital
Petición terminal
Usando la terminal o linea de comandos, ejecutar lo siguiente (ejemplo de cancelación de comprobante de retenciones y pagos):
curl -X POST https://staging.diverza.com/api/v1/cancelar --data @Cancela2.xml -H "Content-MD5: HASH/DOC" -H "Content-type: application/vnd.diverza.cancela.retencion+xml; charset=UTF-8" -H "x-auth-token: ABCD1234" -i
Nota: La dirección del ejecutable cURL puede variar entre sistemas operativos y procesos de instalación.
Si revisamos el comando prodremos ver que la petición es dirigida a la URL del servicio de cancelación, utilizando el metodo POST; como headers, el token de seguridad, el Content-Type y el Content-MD5, el token que se utiliza para el ambiende de pruebas es ABCD1234.
Respuesta
Una vez ejecutado el comando podremos observar en la respuesta:
HTTP/1.1 200 OK
Server: nginx/1.0.15
Date: Wed, 28 Jan 2015 15:13:30 GMT
Content-Type: text/xml;charset=UTF-8
Connection: keep-alive
Content-Length: 92
HTTP/1.1 0 Proceso realizado con éxito
connection: keep-alive
server: Cowboy
date: Wed, 28 Jan 2015 15:13:30 GMT
content-length: 30
cache-control: max-age=0, private, must-revalidate
Proceso realizado con éxito
El código de respuesta tambien es devuelto y debera ser 200 OK y 0 Proceso realizado con éxito cuando la petición sea exitosa, en caso contrario te invitamos a revisar la Lista de Códigos de Respuesta para cancelación, que contiene todos los posibles códigos de respuesta del servicio de timbrado y sus posibles soluciones.