[AR] API Invoice Payload & GET Example

Quick Payload Reference

{
  "supplier_company_id": "{{company_id}}",
  "invoice_type": "debit",
  "document_type": "invoice",
  "e_invoice": true,
  "invoice_date": "2026-04-01",
  "invoice_due_date": "2026-05-01",
  "invoice_serie": "A",
  "currency": "ARS",
  "exchange_rate": 1,
  "language": "es",
  "payment_method": {
    "type": "bank transfer"
  },
  "buyer": {
    "company": {
      "name": "CLIENTE EJEMPLO S.A.",
      "legal_name": "CLIENTE EJEMPLO S.A.",
      "type": "business",
      "address": {
        "address_line_1": "Av. Corrientes 1234",
        "city": "Buenos Aires",
        "state": "AR-C",
        "country": "AR",
        "postal_code": "C1043"
      },
      "tax_registrations": [
        {
          "type": "CUIT",
          "number": "30-12345678-9",
          "level": "country",
          "location": "AR",
          "status": "Responsable Inscripto"
        }
      ]
    }
  },
  "items": [
    {
      "name": "Monthly consulting service",
      "quantity": 1,
      "unit_amount": 100000,
      "amount": 100000,
      "taxes": [
        {
          "name": "IVA",
          "type": "VAT",
          "rate": 0.21,
          "rate_type": "percentage",
          "amount": 21000,
          "level": "country",
          "location": "AR",
          "adds_to_final_amount": true
        }
      ]
    }
  ]
}

Field Reference

Root fields

Field	Type	Required	Notes
`invoice_type`	string	Yes	`"debit"`
`document_type`	string	Yes	`"invoice"`
`e_invoice`	boolean	Yes	`true`
`invoice_date`	string	Yes	Today's date. Format: `YYYY-MM-DD`
`invoice_due_date`	string	No	Defaults to `invoice_date + 30 days` if not sent
`invoice_serie`	string	Yes	Point-of-sale code enabled in AFIP for this supplier
`currency`	string	Yes	See currency table below
`exchange_rate`	number	Yes	`1` for ARS. For foreign currencies, use the AFIP rate for the day
`language`	string	No	`"es"` or `"en"`. Controls PDF language
`payment_method.type`	string	No	`"cash"`, `"bank transfer"`, `"credit card"`, `"debit card"`, `"digital wallet"`
`discount`	number	No	Global discount (absolute value)
`additional_info`	string	No	Free text printed on the document

Invoice numbering is automatic — do not send invoice_number.

Currency table

BRINTA `currency`	AFIP code	Description
`ARS`	`PES`	Argentine Pesos
`USD`	`DOL`	US Dollars
`EUR`	`060`	Euro
`BRL`	`012`	Brazilian Real
`UYU`	`011`	Uruguayan Peso
`MXN`	`010`	Mexican Peso

Buyer (`buyer.company`)

Field	Type	Required	Notes
`name`	string	Yes
`legal_name`	string	No	Defaults to `name` if not sent
`type`	string	Yes	`"business"` or `"person"`
`email`	string	No
`address.country`	string	Yes	`"AR"`
`address.state`	string	No	See Argentina Provinces
`address.address_line_1`	string	No
`address.city`	string	No
`address.postal_code`	string	No

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

Field	Type	Required	Notes
`type`	string	Yes	`"CUIT"` for registered entities. `"DNI"` for end consumers without CUIT
`number`	string	Yes	Format: `XX-XXXXXXXX-X` or 11 digits without dashes. Use `"0"` for end consumers
`level`	string	Yes	`"country"`
`location`	string	Yes	`"AR"`
`status`	string	Yes	AFIP tax regime of the buyer (e.g. `"Responsable inscripto"`, `"Responsable monotributo"`)

Items (`items[]`)

Field	Type	Required	Notes
`name`	string	Yes	Minimum 4 characters
`quantity`	number	Yes
`amount`	number	Yes	Total excluding taxes
`unit_amount`	number	No	Unit price excluding taxes
`discount`	number	No	Absolute value
`taxes[]`	array	Yes	At least one VAT entry required

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

BRINTA `rate`	Description
`0.27`	Differential rate
`0.21`	Standard rate
`0.105`	Reduced rate
`0`	Exempt with reporting obligation

Required fields for every VAT entry:

{
  "name": "IVA",
  "type": "VAT",
  "rate": 0.21,
  "rate_type": "percentage",
  "amount": 21000,
  "level": "country",
  "location": "AR",
  "adds_to_final_amount": true
}

For exempt and not-subject items set adds_to_final_amount: false.

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

Send as additional tax entries with withholding_type: "perception":

Perception	`name`	`location`
IVA general	`"IVA"`	`"AR"`
IVA RG 2408	`"2408"`	`"AR"`
IVA RG 5329	`"5329"`	`"AR"`
IIBB CABA	`"IIBB"`	`"AR-C"`
IIBB Buenos Aires	`"IIBB"`	`"AR-B"`
IIBB Córdoba	`"IIBB"`	`"AR-X"`
Impuesto País	`"Pais"`	`"AR"`

For all other IIBB provinces see Argentina Provinces.

{
  "name": "IIBB",
  "type": "VAT",
  "rate": 0.025,
  "rate_type": "percentage",
  "amount": 2500,
  "level": "state",
  "location": "AR-B",
  "adds_to_final_amount": false,
  "withholding_type": "perception"
}

Common Mistakes

Mistake	Fix
`invoice_date` is not today	Must match the current date
`exchange_rate` ≠ 1 for ARS	Always `1` for ARS
Sending `invoice_number`	Remove it — numbering is automatic
`adds_to_final_amount: true` on exempt items	Use `false` for exempt and not-subject VAT
Malformed CUIT	Use `XX-XXXXXXXX-X` or 11 digits without dashes

API GET Example

{
  "id": "36bc8191-3011-41ec-8e0b-2c00462ad955",
  "created_at": "2025-11-05T16:33:28.284Z",
  "invoice_number": "144528",
  "invoice_serie": "2",
  "invoice_external_id": "53987482cdvjb48h",
  "document_type_alt": "FACTURA A",
  "status": "created",
  "base_type": "issued",
  "status_description": "The invoice is created.",
  "invoice_type": "debit",
  "invoice_date": "2025-10-31T03:00:00.000Z",
  "dueDate": "2025-11-30T06:00:00.000Z",
  "entry_date": "2025-11-05T16:33:28.270Z",
  "document_type": "invoice",
  "amount": 5701491.74,
  "final_amount": 6927312.47,
  "currency": "ARS",
  "invoice_key": "75452644088340",
  "pdf_url": "https://brinta-prod-bucket.s3.amazonaws.com/invoice/34555/2025-10-31/invoice-36bc5961-3011-41ec-8e0b-2c00462ad955.pdf?AWSAccessKeyId=AKIA4NSDDDSMNXRGD7JTKPOD&Expires=1723990474&Signature=tzSl9D9vnw7rpRqQLMvuFWy1UVo%3D",
  "buyer": {
    "tax_registrations": [
      {
        "id": "472866f1-53c2-4820-9767-2e717d4f05cb",
        "type": "CUIT",
        "number": "30790655033",
        "level": "country",
        "location": "AR",
        "status": "Responsable inscripto"
      }
    ],
    "name": "Brinta Demo Test",
    "legal_name": "BRINTA DEMO S. A.",
    "type": "business",
    "address": {
      "id": "f315071a-ad42-48fa-9c97-2e8acfa3d5de",
      "address_line_1": "MANSO 557",
      "address_line_2": "",
      "city": "",
      "municipality_code": "",
      "state": "AR-C",
      "postal_code": "1107",
      "neighborhood": "",
      "country": "AR"
    }
  },
  "items": [
    {
      "id": "465dd3f9-37fb-4eea-864d-bc1c47ac668d",
      "amount": 5701491.74,
      "final_amount": 6927312.47,
      "name": "Septiembre 2025",
      "taxes": [
        {
          "id": "868d2165-5ba0-49e9-a5e0-aeb10523499b",
          "amount": 1197313.2654,
          "name": "IVA",
          "rate": 0.21,
          "rate_type": "percentage",
          "adds_to_final_amount": true,
          "location": "AR",
          "taxable_amount": 5701491.74
        },
        {
          "id": "7f055a98-d65a-48b1-9c8e-5c501c2f0b1c",
          "amount": 28507.46,
          "name": "Percepciones IIBB CABA",
          "rate": 0.005,
          "rate_type": "percentage",
          "type": "GIT",
          "withholding_type": "perception",
          "adds_to_final_amount": true,
          "location": "AR-C",
          "taxable_amount": 5701491.74
        }
      ],
      "categories": [
        {
          "code": "subscriptions",
          "list": "services"
        }
      ]
    }
  ]
}

Updated 7 days ago

Did this page help you?