Referencia de la APICFDI
Cancelar
Cancela un CFDI real o de prueba de una orden de cobro.
Descripción general
Este endpoint cancela un CFDI de una orden de cobro con el motivo que indiques en motive (03 si no lo envías) y guarda su acuse de cancelación, que puedes descargar con Descargar archivos del CFDI.
- CFDI real: debe estar en estatus
emitted. No se puede cancelar mientras la orden de cobro tenga pagos activos o el CFDI tenga complementos de pago emitidos. Al cancelarlo, la orden de cobro queda consat_status: "canceled", pero sustatusno cambia; para cancelar también la orden de cobro, usa Cancelar orden de cobro. - CFDI de prueba: se cancela sin revisar pagos ni complementos, y la orden de cobro no cambia. Si ya estaba cancelado, la API lo devuelve sin cambios con
200.
El cuerpo es opcional. Requiere el permiso Administrar en Órdenes de cobro.
Endpoint
POST
https://app.credonix.mx/api/v1/invoices/{invoiceId}/cfdis/{cfdiId}/cancelPath params:
invoiceId— elidde la orden de cobro.cfdiId— eliddel CFDI, real o de prueba, obtenido en Listar CFDI.
Reglas de los campos
| Campo | Tipo | Requerido | Notas |
|---|---|---|---|
motive | 02 | 03 | No | Motivo de cancelación del SAT. 02: comprobante emitido con errores, sin relación. 03: no se llevó a cabo la operación. Por defecto 03. Para corregir un CFDI, cancélalo con 02 y emite el nuevo con replaces_cfdi_id en Emitir CFDI. |
Errores
| Status | Código | Causa |
|---|---|---|
400 | VALIDATION_ERROR | motive no es 02 ni 03, o el cuerpo trae otros campos. |
400 | LEGAL_ENTITY_NOT_FOUND | No se encontró la razón social con la que se cancela el CFDI. |
400 | LEGAL_ENTITY_NOT_CONFIGURED | CFDI de prueba cuya razón social no está configurada para CFDI de prueba. |
401 | MISSING_API_KEY | INVALID_API_KEY | API_KEY_REVOKED | API key ausente, inválida o revocada. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Administrar en Órdenes de cobro. |
404 | NOT_FOUND | La orden de cobro no existe en tu organización, no tiene razón social, o el CFDI no pertenece a esa orden de cobro. La respuesta incluye, por ejemplo, { "message": "Factura no encontrada." }. |
409 | CFDI_NOT_EMITTED | El CFDI real no está en estatus emitted. |
409 | INVOICE_HAS_PAYMENTS | La orden de cobro tiene pagos que no han sido cancelados. |
409 | CFDI_HAS_COMPLEMENTS | El CFDI tiene complementos de pago emitidos. |
502 | CFDI_CANCELLATION_FAILED | El SAT o el PAC rechazaron la cancelación. |
500 | INTERNAL_ERROR | Error interno. |