CredonixDocs
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 con sat_status: "canceled", pero su status no 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

POSThttps://app.credonix.mx/api/v1/invoices/{invoiceId}/cfdis/{cfdiId}/cancel

Path params:

  • invoiceId — el id de la orden de cobro.
  • cfdiId — el id del CFDI, real o de prueba, obtenido en Listar CFDI.

Cancela un CFDI


Devuelve el CFDI con status: "canceled". El ejemplo cancela un CFDI de prueba.

Reglas de los campos

CampoTipoRequeridoNotas
motive02 | 03NoMotivo 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

StatusCódigoCausa
400VALIDATION_ERRORmotive no es 02 ni 03, o el cuerpo trae otros campos.
400LEGAL_ENTITY_NOT_FOUNDNo se encontró la razón social con la que se cancela el CFDI.
400LEGAL_ENTITY_NOT_CONFIGUREDCFDI de prueba cuya razón social no está configurada para CFDI de prueba.
401MISSING_API_KEY | INVALID_API_KEY | API_KEY_REVOKEDAPI key ausente, inválida o revocada.
403INSUFFICIENT_PERMISSIONSLa API key no tiene el permiso Administrar en Órdenes de cobro.
404NOT_FOUNDLa 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." }.
409CFDI_NOT_EMITTEDEl CFDI real no está en estatus emitted.
409INVOICE_HAS_PAYMENTSLa orden de cobro tiene pagos que no han sido cancelados.
409CFDI_HAS_COMPLEMENTSEl CFDI tiene complementos de pago emitidos.
502CFDI_CANCELLATION_FAILEDEl SAT o el PAC rechazaron la cancelación.
500INTERNAL_ERRORError interno.
Abrir Credonix