Void with NC

When you need to invalidate an FE that Hacienda (Costa Rica’s tax authority) has already accepted, you must issue a Credit Note (NC) that references the original document. Hacienda uses the NC as the formal instrument of voidance, so it isn’t enough to “delete” the invoice from the integrator’s system.

The following payload fully voids the original FE. The reference’s numero field must be replaced with the 50-digit key of the invoice you want to void.

{
  "tipo": "NotaCredito",
  "idUsuario": 7,
  "cliente": { "idCliente": 42 },
  "condicionVenta": "01",
  "medioPago": "01",
  "moneda": "CRC",
  "lineas": [
    { "idProducto": 100, "cantidad": 2 }
  ],
  "referencias": [
    {
      "tipoDocumento": "01",
      "numero": "50615012600310112345600100001010000000123456789012",
      "fechaEmision": "2026-05-10T10:00:00Z",
      "codigo": "01",
      "razon": "Anulación total por cliente equivocado"
    }
  ]
}

The NC must replicate the same lines as the original FE so the totals match. For a partial void, include only the lines or amounts you want to reverse.

See also: issue a document and correct with NC when the error is only in the data, not the amounts.