Endpoint Cancelación sin registro en DB - ML

1. Introducción

El servicio Cancelación sin registro en DB permite realizar la cancelación de un CFDI (Comprobante Fiscal Digital por Internet) cuando el comprobante no se encuentra registrado en la base de datos 1 a 1.

2. Consulta de CFDIs

2.1 Estructura general de la petición

El servicio Consulta de Cancelación permite consultar el estatus actual de cancelación de un CFDI específico, identificándolo por su UUID. La petición se realiza mediante el método HTTPS POST, enviando el parámetro uuid, total, rfcReceptor dentro del cuerpo en formato JSON.

El servicio devuelve el UUID solicitado junto con su estado de cancelación, según la información registrada en el SAT.

2.2 Parámetros requeridos

Endpoint

/<keyEmpresa>/cfdis/consultaCancelacion

Autenticación y Headers

Parámetros

2.3 Ejemplo de petición

https://10.0.0.183:9050/985408d8-64ae-48e0-b46c-473b47176205/cfdis/consultaCancelacion?

{  
    "uuid": ["3213AE58-3CB6-4711-853B-2DB15D93CC18"],
    "total": "40.09",
    "rfcReceptor": "XAXX010101000"
}

2.4 Ejemplo de respuesta

Respuesta exitosa (código 200):

[{"uuid":"3213AE58-3CB6-4711-853B-2DB15D93CC18","status":"CANCELADO_SIN_ACEPTACION"}]

2.5 Códigos de respuesta

3. Cancelación de CFDIs

3.1 Estructura general de la petición

La petición debe realizarse mediante el método HTTP POST y con cuerpo en formato JSON.

3.2 Parámetros requeridos

Endpoint

/<keyEmpresa>/cfdis/cancelarAcuseHistorico

Autenticación y Headers

Parámetros

3.3 Ejemplo de petición

Ejemplo para motivo “01” (con folio de sustitución):

https://10.0.0.183:9050/985408d8-64ae-48e0-b46c-473b47176205/cfdis/cancelarAcuseHistorico?

{
  "uuid": ["3213AE58-3CB6-4711-853B-2DB15D93CC18"],
  "motivo": "01",
  "folioSustitucion": "71BDA958-28EA-416C-846E-1746F8C2C2BA",
  "total": "40.09",
  "rfcReceptor": "XAXX010101000"
}

Ejemplo para motivo “02”, “03” o “04”:

https://10.0.0.183:9050/985408d8-64ae-48e0-b46c-473b47176205/cfdis/cancelarAcuseHistorico?

{
  "uuid": ["3213AE58-3CB6-4711-853B-2DB15D93CC18"],
  "motivo": "02",
  "total": "40.09",
  "rfcReceptor": "XAXX010101000"
}

3.4 Ejemplo de respuesta

Respuesta exitosa (código 200):

{
	"uuid":"3213AE58-3CB6-4711-853B-2DB15D93CC18",
	"URLAcuse_XML":"http://localhost:9000/20c42654-8961-11ea-ab3d-fa163e0e7f24/descargasCfdi?idCfdi=69264bcce4abe567977fa90f2ab2469ac1595fd5b9112dfa122f5d5bc972f4e9485648fb7a64f7ccd796fcefcaf438ca&representacion=ACUSE_HISTORICO",
	"URLAcuse_PDF":"http://localhost:9000/20c42654-8961-11ea-ab3d-fa163e0e7f24/descargasCfdi?idCfdi=69264bcce4abe567977fa90f2ab2469ac1595fd5b9112dfa122f5d5bc972f4e9485648fb7a64f7ccd796fcefcaf438ca&representacion=ACUSE_PDF_HISTORICO",
	"estadoFiscal":"CANCELADO_SIN_ACEPTACION",
	"codigoEstatus":"202"
}

Respuesta de error (código 400):

Content-Type: text/plain; charset=utf-8

Motivo inválido de cancelación

4. Códigos de respuesta

Motivo de Cancelación

Códigos de Cancelación

5. Estatus de la cancelación

VIGENTE
CANCELABLE_CON_ACEPTACION
CANCELABLE_SIN_ACEPTACION
NO_CANCELABLE
NO_ENCONTRADO
EN_PROCESO
CANCELADO_PLAZO_VENCIDO
CANCELADO_CON_ACEPTACIÓN
CANCELADO_SIN_ACEPTACIÓN
SOLICITUD_RECHAZADA

6. Consideraciones Técnicas

• El endpoint requiere formato JSON válido; cualquier estructura mal formada provocará error HTTP 400.

• El campo motivo debe corresponder a una clave válida conforme al catálogo del SAT.

• Si el motivo es “01”, el campo folioSustitucion es obligatorio.

• Se recomienda validar previamente que el CFDI no se encuentre ya cancelado antes de realizar la solicitud.

7. Contacto y Soporte

Para soporte técnico o dudas sobre el uso del servicio, puede comunicarse con el área de soporte técnico de Tralix vía ticket.