Guatemala
Brinta issues the electronic tax documents (DTE) you need in Guatemala under the FEL regime and has them certified with the SAT for you. What changes from one document to another is the document_type and invoice_type you send.
Certification is asynchronous: the request returns status: "received" and the document moves to created (certified) or failed. Get the result with GET /invoices/{invoice_id}.
This page covers the setup and the fields every document shares. Each document type has its own page:
- [GT] Sales Documents: Factura, Factura Cambiaria and Recibo
- [GT] Credit and Debit Notes
- [GT] Factura Especial
📮 Postman: every document type has a ready-to-send request in the Invoicing - Guatemala folder of the Brinta Testing collection.
Available document types
document_type (Brinta) | invoice_type (Brinta) | DTE | Fiscal name (SAT) | When to use | Page |
|---|---|---|---|---|---|
invoice | debit | FACT | Factura | Sale to a business with NIT or to a final consumer (CF) | Sales documents |
credit invoice | debit | FCAM | Factura Cambiaria | Credit sale paid in one or more installments | Sales documents |
ticket | debit | RECI | Recibo | Receipt. IVA is optional | Sales documents |
debit note | debit | NDEB | Nota de Débito | Increase the amount of a FACT or FCAM already certified | Credit and debit notes |
credit note | credit | NCRE | Nota de Crédito | Void, return or discount on a FACT or FCAM already certified | Credit and debit notes |
purchase invoice | purchase | FESP | Factura Especial | Purchase you document on behalf of a vendor who does not issue invoices, with ISR and IVA withheld | Factura Especial |
To cancel a certified DTE in SAT, see Cancellation in [GT] Credit and Debit Notes.
Before you start: issuing company setup
The DTE issuer is filled from the company you send in supplier_company_id. Brinta sets it up with you during onboarding. Keep this data up to date:
- NIT and IVA affiliation
- ISR regime. The one currently supported is Régimen Opcional Simplificado sobre Ingresos. Contact Brinta if your company is under another ISR regime.
- Legal name and commercial name (the establishment name printed on the DTE)
- Establishment code
- Address, with the department
Fields common to all document types
Root level
supplier_company_id
supplier_company_idUUID of the issuing company in Brinta. See Before you start above.
invoice_number and invoice_serie
invoice_number and invoice_serieDo not send them. SAT assigns the series and number when it certifies the DTE. After certification Brinta returns:
| Field | Content |
|---|---|
invoice_key | SAT authorization number (UUID), e.g. 8CF87F49-6CDA-4D2F-9053-D5811775CC63 |
invoice_serie | Series assigned by SAT, e.g. 8CF87F49 |
invoice_number | Number assigned by SAT, e.g. 1826245935 |
xml_url, pdf_url | Certified XML and PDF |
invoice_date
invoice_dateIssuance date, YYYY-MM-DD. SAT rejects a date more than 5 days in the past. Use the current date in Guatemala (UTC-6).
invoice_external_id
invoice_external_idYour internal document ID. Use a unique value per document, and do not resend a request that was already accepted: check its status with GET /invoices/{invoice_id} instead.
currency
currencyGTQfor documents in quetzales.USDfor documents in US dollars. Amounts are reported in the currency you send. You do not need to send an exchange rate.
buyer
buyer| Field | Meaning |
|---|---|
company.type | business for a buyer identified by NIT. person for a final consumer: the DTE is issued to CF (Consumidor Final) and tax_registrations are not needed. To identify an individual by NIT, send business |
company.legal_name | Buyer's legal name. Required for business. For person, defaults to CONSUMIDOR FINAL |
company.tax_registrations[] | NIT with type: "NIT", without dashes. On a purchase invoice you can also send the vendor's CUI with type: "CUI" |
company.email | Buyer's email |
company.address.address_line_1 | Buyer's address. The address object is required, also for Consumidor Final |
company.address.city | Municipality, e.g. Guatemala |
company.address.postal_code | Postal code, e.g. 01001 |
company.address.state | ISO 3166-2:GT department code, e.g. GT-01 (Guatemala), GT-09 (Quetzaltenango). Department names are not accepted |
company.address.country | GT |
items[]
items[]| Field | Meaning |
|---|---|
name | Product or service name |
description | Additional description, printed together with name |
quantity | Quantity |
unit_amount | Unit price, before taxes |
amount | quantity × unit_amount, before discount and taxes |
discount | Discount amount on the item, before taxes. Brinta subtracts it from amount |
categories[]
categories[]list | code |
|---|---|
type | Required. goods or services |
unit | Optional. Unit of measure, e.g. UNI |
taxes[]
taxes[]IVA
name | type | rate | rate_type | Meaning |
|---|---|---|---|---|
IVA | VAT | 0.12 | percentage | IVA 12% |
- Send
amounton every IVA. - IVA is the only tax supported on items.
Withholdings
Only on a purchase invoice (FESP). See [GT] Factura Especial.
Updated 4 days ago
