Chile — Brinta API → XML Field Mapping

Summary

This page maps each field of the Brinta POST /invoices request to the element it produces in
the XML submitted to Chile's tax authority (SII), across every document type Brinta issues in
Chile:

`document_type`	`invoice_type`	SII code	Name
`invoice`	`debit`	33	Factura Electrónica
`invoice exempt`	`debit`	34	Factura Exenta
`ticket`	`debit`	39	Boleta Electrónica
`ticket exempt`	`debit`	41	Boleta Exenta
`debit note` / `debit note ticket`	`debit`	56	Nota de Débito
`credit note` / `credit note ticket`	`credit`	61	Nota de Crédito
`export`	`debit`	110	Factura de Exportación
`debit note exports`	`debit`	111	Nota Débito Exportación
`credit note exports`	`debit`	112	Nota Crédito Exportación
`purchase invoice`	`purchase`	46	Factura de Compra

Purchase Invoice — roles don't swap. supplier_company_id always identifies your company
(the Brinta client), and buyer always represents the other party in the transaction — this
stays true for Purchase Invoice too. Since a Purchase Invoice records something your company
bought, the real-world roles are reversed from every other document type here — your company
is financially the buyer, and the party in the buyer fields is actually your real-world
supplier/vendor. The API fields keep their usual meaning regardless: don't swap
supplier_company_id and buyer when building a Purchase Invoice request.

The starting point is always Brinta's side: what field you send and whether it's required.
Required? reflects Brinta's requirement level for the field — not necessarily the SII's
requirement level for the XML element (a field can be required for Brinta to accept the request
even where the XML element it produces is optional, and some XML elements are populated
automatically with no direct API input at all).

SII's e-invoice XML schema is shared across document types by family, not by individual code —
so the same field maps to the same XML element across every document type in that family:

Standard DTE schema — Invoice, Invoice Exempt, Debit Note (both variants), Credit Note
(both variants), Export, Debit Note Export, Credit Note Export, Purchase Invoice (33, 34, 56,
61, 110, 111, 112, 46).
Boleta schema — Ticket, Ticket Exempt (39, 41). A handful of element names differ here
(called out per row below).

Legend

Tag	Meaning
Required	Brinta rejects the request without it.
Conditional	Required only for specific document types or when another field/condition applies — see Notes.
Optional	Can be omitted.

General Information

Brinta API Field	Required?	Generated XML Element	Applies to	Notes
`document_type`	Required	`TipoDTE`	All	Drives the SII code (33/34/39/41/56/61/110/111/112/46).
`invoice_type`	Required	(not mapped — Brinta-only)	All	`debit`, `credit`, or `purchase` — see table above. Doesn't produce an XML element on its own, but Brinta requires it on every request.
`invoice_date`	Required	`FchEmis`	All	Format `YYYY-MM-DD`.
`invoice_due_date`	Optional	`FmaPago`	Standard DTE schema only	`"1"` (Cash) if empty or equal to `invoice_date`; `"2"` (Credit) otherwise.
(fixed value)	—	`IndServicio`	Boleta schema only

Issuer

Resolved from supplier_company_id — Brinta resolves the whole block from the company record.
This is always your company, on every document type including Purchase Invoice.

Brinta API Field	Required?	Generated XML Element	Applies to	Notes
`supplier_company_id`	Required	(resolves Emisor block)	All	One id populates the whole issuer block.
`company.tax_registrations[type="RUT"].number`	Required	`RUTEmisor`	All	With hyphen.
`company.legal_name`	Optional	`RznSoc` (Standard) / `RznSocEmisor` (Boleta)	All
`company.category_code`	Optional	`GiroEmis` (Standard) / `GiroEmisor` (Boleta)	All	Business activity (Giro).
`company.address.address_line_1` + `address_line_2`	Optional	`DirOrigen`	All	`concat(address_line_1, " ", address_line_2)`.
`company.address.neighborhood`	Optional	`CmnaOrigen`	All
`company.address.city`	Optional	`CiudadOrigen`	All
`company.email`	Optional	`CorreoEmisor`	Standard DTE schema only
`company.phone`	Optional	`Telefono`	Standard DTE schema only

Buyer

The other party in the transaction on every document type — including Purchase Invoice, where
this is your real-world supplier/vendor (see the note above).

Brinta API Field	Required?	Generated XML Element	Applies to	Notes
`buyer.company.legal_name`	Required	`RznSocRecep`	All
`buyer.company.tax_registrations[type="RUT"].number`	Conditional	`RUTRecep`	All	With hyphen. Required when the buyer is a business; defaults to a generic RUT otherwise.
`buyer.company.category_code`	Optional	`GiroRecep`	Standard DTE schema only	Business activity (Giro).
`buyer.company.address.address_line_1` + `address_line_2`	Optional	`DirRecep`	All	`concat(address_line_1, " ", address_line_2)`.
`buyer.company.address.neighborhood`	Optional	`CmnaRecep`	All
`buyer.company.address.city`	Optional	`CiudadRecep`	All

Line Items

Brinta API Field	Required?	Generated XML Element	Applies to	Notes
`items[].name`	Required	`NmbItem`	All
`items[].description`	Optional	`DscItem`	All
`items[].quantity`	Required	`QtyItem`	All
`items[].amount`	Required	`PrcItem` (via `unit_amount`)	All	Line amount. Used directly when `unit_amount` isn't sent — see next row.
`items[].unit_amount`	Conditional	`PrcItem`	All	Send this when `quantity` > 1; if `quantity` is 1 (or not sent), Brinta uses `items[].amount` instead.
`items[].categories[list="unit"].code`	Optional	`UnmdItem`	All
`items[].external_id`	Optional	`CdgItem/VlrCodigo`	All
`items[].discount`	Optional	`DescuentoPct` + `DescuentoMonto`	All
`items[].taxes[type="VAT"].rate`	Optional	`TasaIVA`	Standard DTE schema only
`items[].taxes[type="VAT"].amount`	Optional	`IVA`	All

References

Only applies to Debit Note and Credit Note (both variants) — not used on Invoice, Ticket,
Export, or Purchase Invoice.

Brinta API Field	Required?	Generated XML Element	Applies to	Notes
`original_invoice_id`	Required	`TpoDocRef` + `FolioRef` + `FchRef`	Debit Note / Credit Note (both variants)
`original_invoice_id.reason`	Required	`RazonRef`	Debit Note / Credit Note (both variants)

Vertex API · api.brinta.com