Cancelar
Cancela una orden de cobro y sus CFDI emitidos.
Descripción general
Este endpoint cancela la orden de cobro: status pasa a canceled y se registra canceled_at. La orden de cobro se conserva y se puede reactivar.
Solo se puede cancelar si no tiene pagos activos: cancela o elimina primero sus pagos.
Si la orden de cobro tiene CFDI emitidos, la API cancela cada uno ante el SAT con el motivo 03, guarda su acuse de cancelación y deja sat_status en canceled. Si no tiene CFDI emitidos, sat_status no cambia. Los CFDI de prueba no se cancelan con este endpoint; usa Cancelar CFDI.
No lleva cuerpo. Requiere el permiso Administrar en Órdenes de cobro.
Endpoint
https://app.credonix.mx/api/v1/invoices/{invoiceId}/cancelPath param: invoiceId — el id de la orden de cobro.
Cancela la orden de cobro
Devuelve la orden de cobro actualizada. En el ejemplo la orden no tenía CFDI, así que sat_status se mantiene en not_required.
Errores
| Status | Código | Causa |
|---|---|---|
400 | LEGAL_ENTITY_NOT_FOUND | No se encontró la razón social de un CFDI emitido. |
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. |
409 | INVOICE_ALREADY_CANCELED | La orden de cobro ya está cancelada. |
409 | INVOICE_HAS_PAYMENTS | La orden de cobro tiene pagos que no han sido cancelados. |
502 | CFDI_CANCELLATION_FAILED | El SAT o el PAC rechazaron la cancelación de un CFDI. La respuesta incluye { "message": "Error al cancelar la factura." }. |