Referencia

Cancelación de CFDI y CFDI de Retenciones

POST /cscancelacion/v4/cancelar HTTP/1.1
Content-Type: application/json
Host: api.csfacturacion.com
Content-Length: 325

{
    "uuid": "4AA1138B-BF2E-0143-B7D0-CC2AA44E1DC2",
    "key": "",
    "cer": "",
    "keyPass": "pass",
    "tipoPeticion": "cfdi",
    "emailEmisor": "foo@bar.com",
    "emailReceptor": "foo@bar.com",
    "rfcReceptor": "XAXX010101000",
    "rfcEmisor": "AAA010101AAA",
    "total": "138132",
    "motivo": "02",
    "acuse": "SI",
    "tipoComprobante": "I"
}

{
    "codigo": 201,
    "mensaje": "Solicitud de cancelación recibida con exito",
    "acuse": "${BASE_64_ACUSE}",
    "fechaOperacion": "2023-04-13T17:03:48",
    "fechaCancelacion": "2023-04-13T17:03:48"
}

{
    "codigo": 320,
    "mensaje": "320 Certificado no estaba vigente a la fecha de cancelacion (expiracion); Certificado no es el RFC del Emisor; rfc cert=CSO1304138Z0   rfc emisor=AAA010101AAA; Certificado Apocrifo;"
}

{
    "codigo": 422,
    "mensaje": "Error de validación",
    "errores": {
        "tipoComprobante": "tipoComprobante must be in `{ \"I\", \"E\", \"P\", \"N\", \"T\" }`"
    }
}

Cuerpo de la respuesta

Verificación de estatus

Se recomienda ampliamente hacer el monitoreo de los procesos de cancelación, se hace el recordatorio de que el código 201 devuelto por la autoridad o los proveedores autorizados de certificación no garantiza que el CFDI fue cancelado con éxito, sino que, la solicitud de cancelación fue aceptada para proceder con la cancelación. Por diversos motivos la autoridad puede no proceder con la cancelación (saturación, confusión, entre otros) por lo que es recomendable monitorear su estatus después de recibir un código 201. Para llevar a cabo esta tarea, la API dispone de un endpoint para la verificación de estatus de cancelaciones: /verificar

POST /cscancelacion/v4/verificar HTTP/1.1
Content-Type: application/json
Host: api.csfacturacion.com
Content-Length: 325

{
    "rfcReceptor": "AAA010101AAA",
    "total": "1334.00",
    "rfcEmisor": "AAA010101AAA",
    "uuid": "4AA1138B-BF2E-0143-B7D0-CC2AA44E1DC2"
}

{
    "codigo": "201",
    "mensaje": "S - Comprobante obtenido satisfactoriamente.",
    "estatusCfdi": "Cancelado",
    "esCancelable": "Cancelable con aceptación",
    "estatusCancelacion": "Plazo vencido"
}

{
    "codigo": "205",
    "mensaje": "205 Uuid no existe  4AA1138B-BF2E-0143-B7D0-CC2AA44E1DC2",
    "estatusCfdi": null,
    "esCancelable": null,
    "estatusCancelacion": null
}

{
    "codigo": "400",
    "mensaje": "Error de validación",
    "errores": {
        "rfcReceptor": "RFC invalido."
    }
}

Cuerpo de la respuesta

El servicio entrega cuatro valores: estado de la consulta, estado del cfdi, estado de cancelabilidad, estado de cancelación.

codigo (estado de consulta)

Este estado está relacionado con la solicitud de información al SAT. No al CFDI.

estatusCfdi (estado del cfdi)

Este estado se debe entender como que el SAT reconoce el CFDI y su estado general.

• Vigente: El comprobante está vigente al momento de la consulta
• Cancelado: El comprobante está cancelado al momento de la consulta

esCancelable (estado de cancelabilidad)

Se refiere a que si en el momento de la consulta el CFDI se puede cancelar.

• No cancelable: No se puede cancelar, tal vez ya hay documentos relacionados.
• Cancelable sin aceptación: Se puede cancelar de inmediato.
• Cancelable con aceptación: Se puede cancelar, pero requiere aceptación por parte del receptor.

estatusCancelacion (estado de cancelación)

Se refiere al estado de la cancelación solicitada previamente.

• (ninguno/vacío): El estado vacío es que no tiene estado de cancelación, porque no fue solicitada.
• Cancelado sin aceptación: Se canceló y no fue necesaria la aceptación.
• En proceso: En espera de que el receptor o el SAT la autorice.
• Plazo vencido: Cancelado por vencimiento de plazo en que el receptor podía denegarla.
• Cancelado con aceptación: Cancelado con el consentimiento del receptor.
• Solicitud rechazada: No se realizó la cancelación por rechazo del receptor