Quick Payload Reference

Invoice Post Payload Example

{
    "invoice_type": "debit",
    "document_type": "invoice",
    "invoice_date": "2025-11-07",
    "invoice_due_date": "2025-12-07",
    "e_invoice": true,
    "currency": "UYU",
    "invoice_external_id": "26z6aauxuok11v",
    "supplier_company_id": {{company_id}},
    "buyer": {
        "company": {
            "legal_name": "DEMO COMPANY",
            "tax_registrations": [
                {
                    "number": "219312770023",
                    "type": "RUT",
                    "level": "country",
                    "location": "UY"
                }
            ],
            "type": "business",
            "email": "[email protected]",
            "address": {
                "country": "UY",
                "address_line_1": "Gonzalo Ramirez 1345",
                "address_line_2": "Apto 502",
                "city": "Montevideo",
                "state": "UY-MO",
                "postal_code": "11100"
            },
            "physical_address": {
                "country": "UY",
                "address_line_1": "Physical Address 1345",
                "address_line_2": "Apto 23",
                "city": "Montevideo",
                "state": "UY-MO",
                "postal_code": "11100"
            }
        }
    },
    "items": [
        {
            "item_external_id": "e8ed1yoanz5yn",
            "name": "Item 1",
            "amount": 1000,
            "quantity": 1,
            "categories": [
                {
                    "code": "Unid",
                    "list": "unit"
                }
            ],
            "taxes": [
                {
                    "amount": 220,
                    "name": "IVA",
                    "rate": 0.22,
                    "rate_type": "percentage",
                    "description": "Impuesto sobre el valor agregado",
                    "adds_to_final_amount": true
                }
            ]
        },
        {
            "item_external_id": "5gkfr5kfkde4",
            "name": "Item 2",
            "amount": 819.67,
            "taxes": [
                {
                    "amount": 180.33,
                    "name": "IVA",
                    "rate": 0.22,
                    "rate_type": "percentage",
                    "description": "Impuesto sobre el valor agregado",
                    "adds_to_final_amount": true
                }
            ]
        }
    ]
}

Export Invoice Payload Example

Only the fields that differ from the example above are shown.

{
    "invoice_type": "debit",
    "document_type": "export",
    "currency": "USD",
    "export_reason": "1",
    "items": [
        {
            "name": "Item 1",
            "amount": 1000,
            "quantity": 1,
            "categories": [
                { "code": "CIF", "list": "incoterm" },
                { "code": "sea", "list": "vehicle type" },
                { "code": "08011100", "list": "ncm" }
            ],
            "taxes": [
                {
                    "amount": 0,
                    "name": "IVA",
                    "rate": 0,
                    "rate_type": "percentage"
                }
            ]
        }
    ]
}

Field Reference

Document header (root fields)

Field	Type	Required	When to use / Impact on the issued invoice
`invoice_type`	string	Yes	Always `debit` for invoices, tickets and export invoices.
`document_type`	string	Yes	Defines which CFE is issued.
`invoice_date`	date (`YYYY-MM-DD`)	Recommended	Issue date printed on the CFE. If omitted, the date of submission is used.
`invoice_due_date`	date (`YYYY-MM-DD`)	Recommended	Defines the payment condition shown on the invoice. Send the same date as `invoice_date` for a cash sale (contado). A later date issues the invoice as a credit sale (crédito) with that due date. If omitted, the invoice is issued as a credit sale.
`currency`	string (ISO 4217)	Yes	Currency of the CFE.
`exchange_rate`	number	No	Exchange rate to UYU for non-UYU invoices.
`invoice_external_id`	string	Recommended	Your own reference for the invoice.
`supplier_company_id`	number	Yes	Brinta ID of the issuing company. It determines the issuer’s RUT, branch and electronic invoicing configuration.
`additional_info`	string	No	Free text printed as an addendum (adenda) on the CFE.
`discount`	number	No	Global discount amount applied to the whole invoice.
`export_reason`	string	Export only	Sale modality declared to DGI for export documents. See Export fields. Ignored for `invoice` and `ticket`.

Buyer (`buyer.company`)

The buyer block identifies the receiver of the CFE. For invoice and export, a complete and valid buyer is required for DGI to accept the document.

Field	Type	Required	When to use / Impact on the issued invoice
`legal_name`	string	Yes	Buyer’s legal name printed on the CFE (max. 70 characters). For an anonymous final-consumer ticket, send `CONSUMIDOR FINAL`: the e-Ticket is issued without buyer identification.
`type`	string	Yes	Buyer type, e.g. `business`.
`email`	string	No	The issued invoice is sent to this address.
`tax_registrations[]`	array	Yes (`invoice`, `export`)	Buyer’s tax ID. If several are sent, the RUT is used. See below.
`address`	object	Yes	Buyer’s fiscal address printed on the CFE. See below.
`physical_address`	object	No	Delivery location printed on the CFE. Send it only when the goods are delivered to an address other than the fiscal one.

Buyer tax ID (`buyer.company.tax_registrations[]`)

Field	Type	Required	When to use / Impact on the issued invoice
`number`	string	Yes	Tax ID number.
`type`	string	Yes	Type of document. Accepted values: `RUT`, `CI`, `PASSPORT`, `DNI`, `NIFE`. An `invoice` requires a buyer with `RUT`.
`level`	string	Yes	Always `country`.
`location`	string	Yes	ISO country code that issued the document (`UY` for RUT and CI).

Buyer address (`buyer.company.address`, `buyer.company.physical_address`)

Field	Type	Required	When to use / Impact on the issued invoice
`country`	string (ISO 3166-1 alpha-2)	Yes	Buyer’s country.
`address_line_1`	string	Recommended	Street and number. Combined with `address_line_2` into one address line.
`address_line_2`	string	No	Apartment, floor, office.
`city`	string	Recommended	City (max. 30 characters).
`state`	string	Recommended	Department (max. 30 characters), for example `UY-MO` for Montevideo.
`postal_code`	string	No	Postal code.

Items (`items[]`)

Each element is a line on the CFE.

Field	Type	Required	When to use / Impact on the issued invoice
`name`	string	Yes	Line description printed on the CFE.
`amount`	number	Yes	Line amount before taxes.
`quantity`	number	No	Defaults to `1`.
`unit_amount`	number	When `quantity` > 1	Price per unit before taxes. Always send it when `quantity` is greater than 1, so the unit price on the CFE is correct.
`item_external_id`	string	Recommended	Your own item code.
`description`	string	No	Additional detail printed under the line.
`discount`	number	No	Discount amount applied to this line.
`categories[]`	array	No (Yes for `export`)	Item attributes. See below.
`taxes[]`	array	Yes	Item taxes. Determines whether the line is taxed and at which rate. See below.

Item categories (`items[].categories[]`)

`list`	`code`	When to use / Impact on the issued invoice
`unit`	Unit of measure, e.g. `Unid`, `Kg`, `Hs`	Unit printed on the line. Defaults to `Unid`.
`ean`	EAN code	Product barcode.
`dun`	DUN code	Logistic unit code.
`gtin`	GTIN-13 code	Product GTIN.
`incoterm`	See Export fields	Export only.
`vehicle type`	See Export fields	Export only.
`ncm`	Tariff code (Código de posición arancelaria)	Export only. Required by DGI for each exported good.

Item taxes (`items[].taxes[]`)

Field	Type	Required	When to use / Impact on the issued invoice
`name`	string	Yes	`IVA`.
`rate`	number	Yes	IVA rate as a decimal. Valid values: `0.22` (basic rate), `0.10` (minimum rate), `0` (exempt).
`rate_type`	string	Yes	Always `percentage`.
`amount`	number	Recommended	Tax amount for the line. The taxes on the CFE are computed from the item amount and the rate, so this value must be consistent with them.
`description`	string	No	Informational.
`adds_to_final_amount`	boolean	No	`true` for IVA.

A line without an IVA tax is issued as exempt. If the item is taxed, always send the IVA tax with its rate.

Export fields (export only)

These fields apply only when document_type is export, credit note exports or debit note exports. They are ignored on any other document type.

Sale modality (`export_reason`)

Code	Meaning
`1`	General regime (default when omitted)
`2`	Consignment
`3`	Revisable price
`4`	Goods from customs exclaves
`80`	Tax free
`90`	General regime – export of services
`99`	Other transactions

Incoterm (`items[].categories[]` with `list: "incoterm"`)

Accepted codes: CFR, CIF, CIP, CPT, DAP, DAT, DDP, DDU, EXW, FAS, FCA, FOB, N/A. Any other value is declared as N/A. Send it once, on any item: it applies to the whole document.

Transport mode (`items[].categories[]` with `list: "vehicle type"`)

`code`	Declared as
`sea`	Maritime
`air`	Air
`road`	Road
`other`	Other

Any other value is declared as “not applicable”. Send it once, on any item: it applies to the whole document.

Quick Payload Reference

Invoice Post Payload Example

Export Invoice Payload Example

Field Reference

Document header (root fields)

Buyer (buyer.company)

Buyer tax ID (buyer.company.tax_registrations[])

Buyer address (buyer.company.address, buyer.company.physical_address)

Items (items[])

Item categories (items[].categories[])

Item taxes (items[].taxes[])