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 03 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.
No lleva cuerpo. 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.
Errores
| Status | Código | Causa |
|---|---|---|
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. |