How to adjust a sales document already issued in Costa Rica.

What every note has in common:

original_invoice_id is required: the Brinta ID of the document being adjusted. Brinta reports its key and date as the reference.
The original document must be created (accepted by Hacienda).
The buyer is taken from the original document. If you do not send payment_methods[], the original's first method is used.
An item with original_item_id takes CABYS, unit and name from the original line.
additional_info is the reason for the note reported to Hacienda (3 to 180 characters). If you leave it empty, Brinta sends a standard text.

02 · Nota de Débito Electrónica

document_type: "debit note", invoice_type: "debit"

reason is required: send "debit note".
Every item is required to reference a line of the original document with original_item_id.

{
  "supplier_company_id": "{{company_id}}",
  "invoice_type": "debit",
  "document_type": "debit note",
  "invoice_date": "2026-10-22",
  "invoice_serie": "1",
  "invoice_number": "2610220001",
  "currency": "CRC",
  "e_invoice": true,
  "reason": "debit note",
  "original_invoice_id": "{{original_invoice_id}}",
  "items": [
    {
      "original_item_id": "{{original_item_id}}",
      "name": "Servicio de consultoría en gestión estratégica",
      "quantity": 1,
      "unit_amount": 200,
      "amount": 200,
      "taxes": [ { "name": "IVA", "type": "VAT", "rate": 0.13, "rate_type": "percentage", "amount": 26, "taxable_amount": 200 } ]
    }
  ]
}

03 · Nota de Crédito Electrónica

document_type: "credit note", invoice_type: "credit"

original_invoice_id must be an invoice, ticket or export.
reason is required:

`reason`	Use it when	What to send in `items[]`
`void`	The original document is voided entirely	Nothing: lines are copied from the original
`return`	Some items are returned or not accepted	The returned lines, with `original_item_id`
`discount`	A discount on the amount of the original	The discounted lines, with `original_item_id`

Void:

{
  "supplier_company_id": "{{company_id}}",
  "invoice_type": "credit",
  "document_type": "credit note",
  "invoice_date": "2026-10-22",
  "invoice_serie": "1",
  "invoice_number": "2610220002",
  "currency": "CRC",
  "e_invoice": true,
  "reason": "void",
  "original_invoice_id": "{{original_invoice_id}}"
}

Partial return:

{
  "supplier_company_id": "{{company_id}}",
  "invoice_type": "credit",
  "document_type": "credit note",
  "invoice_date": "2026-10-22",
  "invoice_serie": "1",
  "invoice_number": "2610220003",
  "currency": "CRC",
  "e_invoice": true,
  "reason": "return",
  "original_invoice_id": "{{original_invoice_id}}",
  "items": [
    {
      "original_item_id": "{{original_item_id}}",
      "name": "Café verde n.c.p.",
      "quantity": 2,
      "unit_amount": 2000,
      "amount": 4000,
      "taxes": [ { "name": "IVA", "type": "VAT", "rate": 0.13, "rate_type": "percentage", "amount": 520, "taxable_amount": 4000 } ]
    }
  ]
}