Apariencia
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.
| Campo | Tipo | Obligatorio | Descripción y reglas |
|---|---|---|---|
numero_documento | string | Sí | Número de la factura (por ejemplo 00000123). Coincidencia exacta. |
numero_control | string | Sí | 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"
}
}| Clave | Descripción |
|---|---|
success | true si la factura quedó anulada. |
message | Mensaje de confirmación. |
details.factura_numero | Número de la factura anulada. |
details.numero_control | Número de control de la factura anulada. |
details.url_factura | Enlace público para ver la factura en el navegador. |
details.pdf_factura | Enlace público para descargar el PDF. |
Errores
| HTTP | Mensaje (ejemplo) | Causa |
|---|---|---|
| 400 | Cuerpo JSON vacío. | No se envió cuerpo. |
| 400 | El JSON enviado es inválido o está mal formado. | El cuerpo no es JSON válido. |
| 400 | Los campos numero_documento y numero_control son obligatorios. | Falta alguno de los dos campos o está vacío. |
| 404 | La 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. |
| 400 | La factura ya se encuentra anulada. | La factura ya estaba anulada. |
| 409 | La 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. |
| 400 | La 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. |
| 400 | El comercio indicado no existe. | El negocio asociado al token no existe. |
| 401 | Token inválido o ausente. | Falta el encabezado Authorization o no tiene el formato Bearer <token>. |
| 401 | Usuario no autorizado. / ver Errores | Token inválido o expirado. |
| 500 | Error al intentar anular la factura en la base de datos. | No se pudo guardar la anulación. |
| 500 | Error 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
400conLa factura ya se encuentra anulada. - Tras anularla, la factura aparece con estado
Anuladaen Ver facturas. - Para anular comprobantes de retención usa Anular retención.
