ar-arca-v4
Support for the Argentina ARCA v4 standard for electronic invoicing.
Sources
Correction Definitions
Auto-generation of corrective invoices or credit and debit notes is supported.Invoice Types
The types of invoices that can be created with a preceding definition:-
credit-note -
debit-note
Extension Keys
One or all of the following extensions may be required as part of the correction options. See the Extensions section for possible values.-
ar-arca-doc-type
Extensions
Argentina ARCA Document Type
Code used to identify the type of document being issued. This can always be set directly. If not provided, GOBL will automatically determine it during normalization based on the following rules: Type C (Simplified Tax Scheme / Monotributo supplier): If the invoice has themonotax tag set, the document type will be 11 (Invoice C), 13 (Credit Note C),
or 12 (Debit Note C).
Type A (B2B with VAT-registered customers): If the customer’s ar-arca-vat-status extension
is one of 1 (Registered Company), 6 (Monotributo Responsible), 13 (Social Monotributista),
or 16 (Promoted Independent Worker), the document type will be 1 (Invoice A), 3 (Credit
Note A), or 2 (Debit Note A).
Type B (B2C or other scenarios): For all other cases (final consumers, foreign customers,
exempt entities, or when no customer is provided), the document type will be 6 (Invoice B),
8 (Credit Note B), or 7 (Debit Note B).
For other document types the value must be set manually.
ar-arca-doc-type
ar-arca-doc-type
| Code | Name |
|---|---|
1 | Invoice A |
2 | Debit Note A |
3 | Credit Note A |
4 | Receipt A |
5 | Cash Sales Note A |
6 | Invoice B |
7 | Debit Note B |
8 | Credit Note B |
9 | Receipt B |
10 | Cash Sales Note B |
11 | Invoice C |
12 | Debit Note C |
13 | Credit Note C |
15 | Receipt C |
34 | Invoices A per Annex I, Section A, subsection f), R.G. No. 1415 |
35 | Vouchers B per Annex I, Section A, subsection f), R.G. No. 1415 |
39 | Other Vouchers A compliant with R.G. No. 1415 |
40 | Other Vouchers B compliant with R.G. No. 1415 |
49 | Used Goods Purchase Invoice to Final Consumer |
51 | Invoice A with Legend ‘Subject to Withholding’ |
52 | Debit Note A with Legend ‘Subject to Withholding’ |
53 | Credit Note A with Legend ‘Subject to Withholding’ |
54 | Receipt A with Legend ‘Subject to Withholding’ |
60 | Sales Account and Product Settlement A |
61 | Sales Account and Product Settlement B |
63 | Settlement A |
64 | Settlement B |
201 | MiPyMEs Electronic Credit Invoice (FCE) A |
202 | MiPyMEs Electronic Debit Note (FCE) A |
203 | MiPyMEs Electronic Credit Note (FCE) A |
206 | MiPyMEs Electronic Credit Invoice (FCE) B |
207 | MiPyMEs Electronic Debit Note (FCE) B |
208 | MiPyMEs Electronic Credit Note (FCE) B |
211 | MiPyMEs Electronic Credit Invoice (FCE) C |
212 | MiPyMEs Electronic Debit Note (FCE) C |
213 | MiPyMEs Electronic Credit Note (FCE) C |
Argentina ARCA Concept (Goods, services, or both)
Code used to identify the invoice concept, indicating whether the invoice covers goods, services, or both. This extension is automatically determined by GOBL based on thekey field of each
line item:
1(Products): All line items havekeyset togoods.2(Services): All line items havekeyempty, unset, or set to any value other thangoods.3(Products and Services): The invoice contains a mix of both goods and services.
2 (Services) or 3 (Products and Services), the invoice must
include an ordering period and payment terms with due dates.
ar-arca-concept
ar-arca-concept
| Code | Name |
|---|---|
1 | Goods |
2 | Services |
3 | Goods and services |
Argentina ARCA Tax Type
Code used to identify the type of tax applied as a charge. This is used for taxes other than VAT that need to be included in the invoice (national taxes, provincial taxes, withholdings, etc.). These taxes must be added as invoice charges (not in line items) with the chargekey set
to tax, a percent value (required, amounts are not accepted), and this extension to
specify the tax type.
Example - Tax applied to invoice total:
- When a charge has
key: tax, this extension is required. - The
percentfield is required when this extension is present. - When using code
99(Other), the chargereasonfield is required to describe the tax.
ar-arca-tax-type
ar-arca-tax-type
| Code | Name |
|---|---|
1 | National Taxes |
2 | Provincial Taxes |
3 | Municipal Taxes |
4 | Internal Taxes |
5 | Gross Income Tax |
6 | VAT Prepayment |
7 | Gross Income Tax Prepayment |
8 | Municipal Taxes Prepayment |
9 | Other Prepayments |
13 | VAT Not Categorized Prepayment |
99 | Other |
Argentina ARCA VAT Rate
Code used to identify the VAT rate applied to line items. This extension is automatically determined by GOBL based on the tax rate key defined in the Argentine tax regime:zerorate (0%) → code3reducedrate (10.5%) → code4standardrate (21%) → code5increasedrate (27%) → code6
- 5% → code
8 - 2.5% → code
9
ar-arca-vat-rate
ar-arca-vat-rate
| Code | Name |
|---|---|
3 | 0% |
4 | 10.5% |
5 | 21% |
6 | 27% |
8 | 5% |
9 | 2.5% |
Argentina ARCA Customer Identity Type
Code used to identify the type of identity document in the customer’sidentities field.
This extension is typically only needed for B2C operations where the customer needs to
provide an identification number but does not have a tax ID. Common examples include
DNI (code 96), passport, or provincial identity cards.
When the customer has a CUIT, CUIL, or a valid foreign tax identification number,
these should be included in the tax_id field instead, and this extension is not required.
Example usage for a final consumer with DNI:
ar-arca-identity-type
ar-arca-identity-type
| Code | Name |
|---|---|
00 | CI Capital Federal |
01 | CI Buenos Aires |
02 | CI Catamarca |
03 | CI Córdoba |
04 | CI Corrientes |
05 | CI Entre Ríos |
06 | CI Jujuy |
07 | CI Mendoza |
08 | CI La Rioja |
09 | CI Salta |
10 | CI San Juan |
11 | CI San Luis |
12 | CI Santa Fe |
13 | CI Santiago del Estero |
14 | CI Tucumán |
16 | CI Chaco |
17 | CI Chubut |
18 | CI Formosa |
19 | CI Misiones |
20 | CI Neuquén |
21 | CI La Pampa |
22 | CI Río Negro |
23 | CI Santa Cruz |
24 | CI Tierra del Fuego |
80 | CUIT (Unique Tax Identification Number) |
86 | CUIL (Unique Labor Identification Number) |
87 | CDI |
89 | LE |
90 | LC |
91 | Foreign CI |
92 | In Process |
93 | Birth Certificate |
94 | Passport |
95 | CI Bs. As. RNP |
96 | DNI |
99 | Final Consumer |
Customer VAT Status
Code used to identify the VAT status of the customer. This extension must be included in the customer’sext field when the customer is required.
GOBL will automatically normalize this value based on the customer’s tax identification:
Customer without tax ID (final consumers): Defaults to 5 (Final Consumer). Also
accepts 4 (Exempt Subject), 7 (Uncategorized), 10 (VAT Exempt Law 19640),
or 15 (VAT Not Applicable).
Customer with foreign tax ID: Defaults to 9 (Foreign Customer). Also accepts
8 (Foreign Supplier).
Customer with Argentine tax ID (CUIT/CUIL): Defaults to 1 (Registered VAT Company).
Also accepts 6 (Monotributo), 13 (Social Monotributista), 16 (Promoted Independent
Worker), 4 (Exempt Subject), 7 (Uncategorized), 10 (VAT Exempt Law 19640),
or 15 (VAT Not Applicable).
The VAT status is validated against the document type:
- Type A documents (
1,2,3, etc.): Require VAT status1,6,13, or16. - Type B documents (
6,7,8, etc.): Cannot have VAT status1,6,13, or16. - Document type
49(Used Goods Purchase Invoice): Requires VAT status5(Final Consumer).
ar-arca-vat-status
ar-arca-vat-status
| Code | Name |
|---|---|
1 | Registered VAT Company |
4 | VAT Exempt Subject |
5 | Final Consumer |
6 | Monotributo Responsible |
7 | Uncategorized Subject |
8 | Foreign Supplier |
9 | Foreign Customer |
10 | VAT Exempt - Law N° 19.640 |
13 | Social Monotributista |
15 | VAT Not Applicable |
16 | Promoted Independent Worker Monotributista |