Anular comprobante

DELETE /api/v1/facturas/{clave}

Marca un comprobante como anulado en la base de datos interna del POS. Se utiliza cuando se requiere 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, debe emitirse una nota de crédito (NC) con POST /api/v1/facturas. Debe tenerse presente el permiso: la NC requiere el scope notas:write, no facturas:write — ver Scopes.

{
  "tipo": "NotaCredito",
  "idUsuario": 7,
  "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