Skip to content

Anular factura ​

POST /api/Invoice/cancel_invoice

Anula una factura emitida por el negocio del token. Solo aplica a facturas (no a notas, órdenes, guías ni retenciones) que estén activas y no pagadas. Devuelve los datos de la factura anulada y sus enlaces de consulta y PDF.

Autenticación: Authorization: Bearer <token> (cómo obtenerlo) · Content-Type: application/json

Cuerpo de la solicitud ​

Los nombres de campo no distinguen mayúsculas/minúsculas.

CampoTipoObligatorioDescripción y reglas
numero_documentostringSíNúmero de la factura (por ejemplo 00000123). Coincidencia exacta.
numero_controlstringSíNúmero de control de la factura (por ejemplo 00-00000456). Coincidencia exacta. Debe corresponder a la misma factura que numero_documento.

Ejemplo de solicitud ​

json
{
  "numero_documento": "00000123",
  "numero_control": "00-00000456"
}

Respuesta exitosa ​

HTTP 200

json
{
  "success": true,
  "message": "La factura ha sido anulada correctamente.",
  "details": {
    "factura_numero": "00000123",
    "numero_control": "00-00000456",
    "url_factura": "{{host}}readonly/invoice/view/3f2a9c0b-7e5d-41a8-a6c2-d9e0f1a2b3c4?view=true",
    "pdf_factura": "{{host}}readonly/export_pdf/3f2a9c0b-7e5d-41a8-a6c2-d9e0f1a2b3c4"
  }
}
ClaveDescripción
successtrue si la factura quedó anulada.
messageMensaje de confirmación.
details.factura_numeroNúmero de la factura anulada.
details.numero_controlNúmero de control de la factura anulada.
details.url_facturaEnlace público para ver la factura en el navegador.
details.pdf_facturaEnlace público para descargar el PDF.

Errores ​

HTTPMensaje (ejemplo)Causa
400Cuerpo JSON vacío.No se envió cuerpo.
400El JSON enviado es inválido o está mal formado.El cuerpo no es JSON válido.
400Los campos numero_documento y numero_control son obligatorios.Falta alguno de los dos campos o está vacío.
404La factura especificada no existe, los datos no coinciden, o no pertenece a su comercio.No hay una factura del negocio con ese número y ese número de control.
400La factura ya se encuentra anulada.La factura ya estaba anulada.
409La factura no puede ser anulada porque tiene notas de crédito o débito asociadas.Ya se emitió al menos una nota de crédito o de débito sobre la factura.
400La factura no puede ser anulada. Solo se pueden anular facturas activas/no pagadas (Estatus actual: 1 (Pagada)).La factura está pagada o en un estado distinto de "activa/por pagar". Para otros estados el mensaje muestra el código numérico del estado.
400El comercio indicado no existe.El negocio asociado al token no existe.
401Token inválido o ausente.Falta el encabezado Authorization o no tiene el formato Bearer <token>.
401Usuario no autorizado. / ver ErroresToken inválido o expirado.
500Error al intentar anular la factura en la base de datos.No se pudo guardar la anulación.
500Error en el servidor: ...Error interno.

Notas ​

  • La anulación no se puede revertir desde el API.
  • Repetir la misma solicitud no anula dos veces: la segunda llamada responde 400 con La factura ya se encuentra anulada.
  • Tras anularla, la factura aparece con estado Anulada en Ver facturas.
  • Para anular comprobantes de retención usa Anular retención.

API de Facturación · CG Imprenta Digital