Referencia de la APIÓrdenes de cobro
Eliminar
Elimina una orden de cobro con sus conceptos, pagos y documentos.
Descripción general
Este endpoint elimina una orden de cobro de forma definitiva. Junto con ella se eliminan sus conceptos, sus pagos, sus CFDI (cancelados o de prueba), sus complementos de pago de prueba y los archivos de todos ellos. La respuesta exitosa es 204 No Content con cuerpo vacío.
No se puede eliminar una orden de cobro con un CFDI emitido o pendiente ante el SAT, ni una cuyos pagos tengan complementos de pago, aunque estén cancelados. Cancela primero el CFDI con Cancelar CFDI o, si solo quieres dejar de cobrarla, usa Cancelar orden de cobro.
Requiere el permiso Administrar en Órdenes de cobro.
Endpoint
DELETE
https://app.credonix.mx/api/v1/invoices/{invoiceId}Path param: invoiceId — el id de la orden de cobro.
Comportamiento
- Rechaza la solicitud (
409) si la orden de cobro tiene un CFDI real emitido o pendiente. - Rechaza la solicitud (
409) si alguno de sus pagos tiene complementos de pago, en cualquier estatus. - Elimina los archivos de sus CFDI (incluidos los acuses de cancelación), de sus CFDI y complementos de prueba y de la orden de cobro. Si no es posible eliminar algún archivo, responde
502y no se elimina nada. - Elimina la orden de cobro con sus conceptos, pagos, CFDI y documentos de prueba.
- Los movimientos de saldo a favor relacionados con la orden de cobro se conservan, sin la referencia a ella.
- Registra la eliminación en la actividad de la organización.
Errores
| Status | Código | Causa |
|---|---|---|
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_HAS_CFDI | La orden de cobro tiene un CFDI emitido o pendiente ante el SAT. La respuesta incluye { "message": "No es posible eliminar la orden de cobro, ya que cuenta con una factura activa o pendiente ante el SAT. Por favor, cancela la factura antes de eliminarla." }. |
409 | INVOICE_HAS_COMPLEMENTS | Alguno de sus pagos tiene complementos de pago. |
502 | FILE_DELETION_FAILED | No fue posible eliminar los archivos. No se eliminó nada; intenta de nuevo más tarde. |