Anular comprobante

DELETE /api/v1/facturas/{clave}

Marca un comprobante como anulado en la base de datos interna del POS. Usalo cuando necesités reflejar la anulación operativa del documento (por ejemplo, para no mostrarlo en el listado activo del cliente).

Autenticación

⚠ Comportamiento crítico

Este endpoint NO envía una nota de crédito a Hacienda. Solo marca el campo anulada=true en la base interna del POS, lo cual no tiene efecto fiscal.

Para anular fiscalmente un comprobante ya aceptado por Hacienda, debés emitir una nota de crédito (NC) con POST /api/v1/facturas:

{
  "tipo": "NotaCredito",
  "cliente": { "idCliente": 42 },
  "condicionVenta": "01",
  "medioPago": "01",
  "moneda": "CRC",
  "lineas": [ /* mismas líneas o subset */ ],
  "referencias": [
    {
      "tipoDocumento": "01",
      "numero": "50615012600310112345600100001010000000123456789012",
      "fechaEmision": "2026-05-15T15:32:11Z",
      "codigo": "01",
      "razon": "Anulación total por error en el cliente"
    }
  ]
}

Respuestas