[UY] Bulk Upload Manual

This manual explains how to issue electronic documents in Uruguay by uploading a file with the Brinta bulk template. It covers the steps in the dashboard, the general rules that apply to every row, and links to one guide per document type.

Supported document types

Document	`Invoice Document Type`	`Invoice Type`	Guide
e-Factura	`invoice`	`debit`	e-Factura
e-Ticket	`ticket`	`debit`	e-Ticket
e-Factura de Exportación	`export`	`debit`	Export invoice
Credit note of e-Factura	`credit note`	`credit`	Credit and debit notes
Debit note of e-Factura	`debit note`	`debit`	Credit and debit notes
Credit note of e-Ticket	`credit note ticket`	`credit`	Credit and debit notes
Debit note of e-Ticket	`debit note ticket`	`debit`	Credit and debit notes
Credit note of export invoice	`credit note exports`	`credit`	Credit and debit notes
Debit note of export invoice	`debit note exports`	`debit`	Credit and debit notes
e-Resguardo	`withholding invoice`	`withholding`	e-Resguardo
Credit note of e-Resguardo	`credit note withholding`	`credit`	e-Resguardo

📘
Two adapters
e-Resguardos and their credit notes are uploaded with their own adapter and their own file. Do not mix them with invoices, tickets or their notes in the same file.

1. Steps to upload a file

Go to Invoicing → Outgoing → Bulk Uploads. In the left menu, expand Invoicing, then Outgoing, and click Bulk Uploads.
Click "Create Invoice". A window opens to choose the creation method.
Select "Bulk Upload". Choose the option on the left (cloud icon with an arrow). It lets you upload many documents at once from a file.
Select the adapter. In Select adapter, choose the Uruguay adapter enabled for your company (for e-Resguardos, the Uruguay withholding adapter) and click Next.
Upload the file. Upload the completed template. You can follow the result of each document in the upload detail.

2. Template

Request the Uruguay template from your Account Executive (AE) and fill it in following the format of each column.

The template has two tabs:

Template UY: the columns to fill in. Header colors tell you when a column is mandatory:
- Red: mandatory for every document.
- Blue: mandatory for export invoices.
- Green: mandatory when the file contains invoices with more than one item.
- Orange: mandatory for e-Resguardos.
- Purple: mandatory for credit and debit notes.
Guide - Reference: a short description of each column.

❗️
Clean the template before uploading
The "Template UY" tab ships with an example row, a list of sample values under some columns and a color legend below the data. Delete all of it before you add your own rows, so the file only contains your documents.

3. Rules for every row

Topic	Rule	Example
Header names	Keep the column headers exactly as in the template. Do not rename, translate or merge them.	`Buyer Legal Name`
Fixed values	Always lowercase.	`invoice`, `credit note`, `business`
Dates	`yyyy-mm-dd`. Format the cell as text so Excel does not change it.	`2026-03-31`
Amounts	Numeric cells, dot as decimal separator, no thousands separator.	`1000.75`
Rates	Decimal, not a percentage.	`0.22` for 22%
Country	ISO 3166-1 alpha-2 code.	`UY`, `AR`, `US`
Currency	ISO 4217 code.	`UYU`, `USD`, `EUR`
State	ISO 3166-2 code. See the table below.	`UY-MO`
Several items	One row per item. Rows with the same `Invoice External ID` make up one document. Repeat the document and buyer columns on each row.
Total Amount	Optional, for your reference. Totals are calculated from the item amounts and taxes.
Issuer	The issuer value given to you during onboarding. It identifies which of your companies issues the document.

Uruguay department codes

Department	Code	Department	Code
Artigas	`UY-AR`	Paysandú	`UY-PA`
Canelones	`UY-CA`	Río Negro	`UY-RN`
Cerro Largo	`UY-CL`	Rivera	`UY-RV`
Colonia	`UY-CO`	Rocha	`UY-RO`
Durazno	`UY-DU`	Salto	`UY-SA`
Flores	`UY-FS`	San José	`UY-SJ`
Florida	`UY-FD`	Soriano	`UY-SO`
Lavalleja	`UY-LA`	Tacuarembó	`UY-TA`
Maldonado	`UY-MA`	Treinta y Tres	`UY-TT`
Montevideo	`UY-MO`

For buyers abroad, use the ISO 3166-2 code of their state or province (for example US-NY, AR-C).

4. Common errors

Error	Cause	How to fix it
Value not accepted for a fixed field	`Invoice`, `Credit Note`, `Business` written with capital letters.	Use lowercase: `invoice`, `credit note`, `business`.
Wrong date	Date in `dd/mm/yyyy` or `mm/dd/yyyy`, or Excel turned it into a number.	Use `yyyy-mm-dd` and format the cell as text.
Wrong state	Department name (`Montevideo`) instead of its code.	Use the ISO code: `UY-MO`.
Wrong amount	`1.000,75` instead of `1000.75`, or the cell is formatted as text.	Dot for decimals, no thousands separator, numeric cell.
Wrong VAT	`22` instead of `0.22`, or VAT amount does not match amount × rate.	Send the rate as a decimal and check the VAT amount.
e-Factura rejected for buyer	The buyer is not identified with a RUT.	Use `RUT` for e-Facturas. Use an e-Ticket for buyers without RUT.
Extra documents or errors from empty-looking rows	Example rows or the legend were left in the file.	Delete everything except your own rows.

5. Checking the result

Go to Invoicing → Outgoing → Bulk Uploads and open the upload with the eye icon.
Download the report. The last columns show the error message for each failed row.
Fix only the failed rows and upload them again in a new file.

For questions about this process, contact the Brinta team.

Updated 1 day ago

Did this page help you?