How to adjust or cancel a sales document already certified in Guatemala. The setup and the fields every document shares are in [GT] Electronic Documents (FEL): Overview.

What every note has in common:

original_invoice_id is required: the Brinta ID of the FACT or FCAM being adjusted. You can send original_invoice_external_id instead.
The original document must be created (certified by SAT). SAT rejects notes against a RECI.
You do not need to send buyer: it is taken from the original document.
On each item, send original_item_id, name and taxes[].

NDEB · Nota de Débito

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

reason: "debit note" is required.

{
  "supplier_company_id": "{{company_id}}",
  "invoice_type": "debit",
  "document_type": "debit note",
  "invoice_date": "2026-10-28",
  "invoice_external_id": "ND-5001",
  "original_invoice_id": "{{original_invoice_id}}",
  "reason": "debit note",
  "currency": "GTQ",
  "e_invoice": true,
  "items": [
    {
      "original_item_id": "{{original_item_id}}",
      "name": "Ajuste de precio - consultoría",
      "quantity": 1,
      "unit_amount": 100.00,
      "amount": 100.00,
      "taxes": [ { "name": "IVA", "type": "VAT", "rate": 0.12, "rate_type": "percentage", "amount": 12.00 } ]
    }
  ]
}

NCRE · Nota de Crédito

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

reason is required:

`reason`	Use it when	`items[]`
`void`	The original document is credited in full. Only when it has no other credit notes	Do not send them: Brinta credits every item of the original
`return`	Some items are returned or not accepted	Send the returned items, with `original_item_id`, `name` and `taxes[]`
`discount`	A discount on the amount of the original document	Send the discounted items, with `original_item_id`, `name` and `taxes[]`

A credit note does not cancel the original DTE in SAT. To cancel it, use Cancellation below.

{
  "supplier_company_id": "{{company_id}}",
  "invoice_type": "credit",
  "document_type": "credit note",
  "invoice_date": "2026-10-28",
  "invoice_external_id": "NC-6001",
  "original_invoice_id": "{{original_invoice_id}}",
  "reason": "discount",
  "currency": "GTQ",
  "e_invoice": true,
  "items": [
    {
      "original_item_id": "{{original_item_id}}",
      "name": "Descuento - consultoría",
      "quantity": 1,
      "unit_amount": 100.00,
      "amount": 100.00,
      "taxes": [ { "name": "IVA", "type": "VAT", "rate": 0.12, "rate_type": "percentage", "amount": 12.00 } ]
    }
  ]
}

Full credit note (void)

{
  "supplier_company_id": "{{company_id}}",
  "invoice_type": "credit",
  "document_type": "credit note",
  "invoice_date": "2026-10-28",
  "invoice_external_id": "NC-6002",
  "original_invoice_id": "{{original_invoice_id}}",
  "reason": "void",
  "currency": "GTQ",
  "e_invoice": true
}

Cancellation (Anulación)

Cancels a certified DTE in SAT. Unlike issuing, it is synchronous: the request answers once SAT has decided.

PUT /invoices/{invoice_id}

{
  "status": "cancel process",
  "cancel_reason": "Error en los datos del documento"
}

cancel_reason is required: free text with the reason for the cancellation.
When SAT accepts it, the document is canceled.
When SAT rejects it, the request returns an error with the SAT reason and the document stays created.

SAT rules:

A DTE issued to Consumidor Final can only be cancelled on its issue date or the next day.
A DTE with active credit or debit notes cannot be cancelled.