[PE] Bulk Upload Manual
This manual explains how to issue electronic documents in Peru 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 |
|---|---|---|---|
| Factura Electrónica (01) | invoice | debit | Factura |
| Boleta de Venta Electrónica (03) | ticket | debit | Boleta |
| Nota de Crédito Electrónica (07) | credit note | credit | Credit and debit notes |
| Nota de Débito Electrónica (08) | debit note | debit | Credit and debit notes |
Series and numberYou send the series and the number of every document in
Invoice SerieandInvoice Number. See Series and Numbering.
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 Peru adapter enabled for your company and click Next.
- Upload the file. Upload the completed template as a CSV file. You can follow the result of each document in the upload detail.
2. Template
Request the Peru template from your Account Executive (AE) and fill it in following the format of each column.
The template has two tabs:
- Invoices: the columns to fill in. Header colors tell you when a column is mandatory:
- Dark blue: mandatory.
- Light blue: optional, or mandatory only in some cases (for example only for credit and debit notes). Each guide says which.
- Instrucciones: a short description of each column, in Spanish.
When the file is complete, save it as CSV UTF-8 (comma delimited) before uploading.
Clean the template before uploadingThe "Invoices" tab ships with example rows. Delete them 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-11-03 |
| Amounts | Numeric cells, dot as decimal separator, no thousands separator. | 1000.75 |
| Rates | Decimal, not a percentage. | 0.18 for 18% |
| Country | ISO 3166-1 alpha-2 code. | PE, US |
| Currency | PEN or USD. For any currency other than PEN, also fill in Invoice Exchange Rate. | PEN |
| State | ISO 3166-2 code. See the table below. | PE-LIM |
| Series | 4 characters. Facturas and their notes start with F. Boletas and their notes start with B. | F001, B001, FC01 |
| Number | The correlative of the document in its series, from 1 to 99999999, with no leading zeros. | 12346, not 00012346 |
| Several items | One row per item. Rows with the same Invoice External ID make up one document. Fill in the document and buyer columns on the first row of each document. | |
| Issuer | The issuer value given to you during onboarding. It identifies which of your companies issues the document. |
Peru department codes
| Department | Code | Department | Code |
|---|---|---|---|
| Amazonas | PE-AMA | Lima | PE-LIM |
| Áncash | PE-ANC | Loreto | PE-LOR |
| Apurímac | PE-APU | Madre de Dios | PE-MDD |
| Arequipa | PE-ARE | Moquegua | PE-MOQ |
| Ayacucho | PE-AYA | Pasco | PE-PAS |
| Cajamarca | PE-CAJ | Piura | PE-PIU |
| Callao | PE-CAL | Puno | PE-PUN |
| Cusco | PE-CUS | San Martín | PE-SAM |
| Huancavelica | PE-HUV | Tacna | PE-TAC |
| Huánuco | PE-HUC | Tumbes | PE-TUM |
| Ica | PE-ICA | Ucayali | PE-UCA |
| Junín | PE-JUN | ||
| La Libertad | PE-LAL | ||
| Lambayeque | PE-LAM |
For buyers abroad, use the ISO 3166-2 code of their state or province (for example US-NY).
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. |
| Date rejected by SUNAT | The issue date is more than 3 days before, or more than 2 days after, the day the document reaches SUNAT. | Use a current issue date. |
| Wrong state | Department name (Lima) instead of its code. | Use the ISO code: PE-LIM. |
| 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 IGV | 18 instead of 0.18, or the IGV amount does not match amount × rate. | Send the rate as a decimal and check the IGV amount. |
| Wrong number | Leading zeros (00012346), or a series and number already used. | Send the number with no leading zeros, and use each series and number only once. |
| Factura rejected for buyer | The buyer is not identified with a RUC, or the RUC does not exist. | Use RUC with 11 digits for facturas. Use a boleta for buyers without RUC. |
| Missing unit of measure | Item Unit Code is empty in a factura, boleta or debit note. | Fill in the unit code. See Units of Measure. |
| Extra documents or errors from empty-looking rows | Example rows 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
