Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.invopop.com/llms.txt

Use this file to discover all available pages before exploring further.

Prerequisites

Before issuing invoices, ensure you have:

Setup

Add a new workflow to your workspace for issuing invoices. You can start with the template below.

ARCA invoice workflow

This workflow issues invoices in Argentina through ARCA.
Keep the Workflow ID at hand. Youโ€™ll use it later.

Issue an invoice

1

Upload an invoice

Use the Create an entry endpoint to upload the invoice details. Include an invoice object in the data field with these required fields:
  • Add the ar-arca-v4 addon
  • series: set to your point of sale (punto de venta) number
  • Do not set code (Invopop will assign it during authorization)
Do not sign your invoice before sending it to ARCA. The workflow assigns the invoice code and signs the document automatically during the Send to ARCA step.
ARCA requires invoices to be numbered sequentially without gaps. Invopop assigns the invoice code during the Send to ARCA workflow step based on the last issued invoice number.
Choose the appropriate invoice type based on your tax classification and customer type:
Factura A is issued by registered taxpayers (Responsable Inscripto) to other registered taxpayers or monotributistas. This invoice type includes VAT broken down separately.Notice:
  • the minimal version (arca-invoice-A.min.mdx) contains only the essential fields required to create the Factura A,
  • the ar-afip-v1 addon ensures the document will be validated using the AFIP rules built into the GOBL library,
  • both supplier and customer must be registered taxpayers with valid CUIT numbers,
  • there are no totals or calculations in the minimal version; all these will be calculated automatically when running gobl build,
  • the built version (arca-invoice-A.mdx) shows the normalized document with calculated totals, line item sums, IVA breakdowns shown separately, and automatically generated fields, and,
  • the invoice will be submitted to AFIP for authorization and receive a CAE (Cรณdigo de Autorizaciรณn Electrรณnico).
{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": ["ar-arca-v4"],
  "uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
  "currency": "ARS",
  "issue_date": "2025-01-15",
  "series": "1",
  "supplier": {
    "name": "Proveedor Ejemplo S.A.",
    "tax_id": {
      "country": "AR",
      "code": "30712345671"
    },
    "addresses": [
      {
        "street": "Av. Corrientes 1234",
        "locality": "Buenos Aires",
        "region": "Ciudad Autรณnoma de Buenos Aires",
        "code": "C1043",
        "country": "AR"
      }
    ],
    "emails": [
      {
        "addr": "ventas@proveedorejemplo.com.ar"
      }
    ],
    "registration": {
      "other": "Inicio de actividades: 2016-03-01"
    }
  },
  "customer": {
    "name": "Cliente Comercial S.R.L.",
    "tax_id": {
      "country": "AR",
      "code": "30987654321"
    },
    "addresses": [
      {
        "street": "Av. Santa Fe 2500",
        "locality": "Buenos Aires",
        "region": "Ciudad Autรณnoma de Buenos Aires",
        "code": "C1123",
        "country": "AR"
      }
    ],
    "emails": [
      {
        "addr": "compras@clientecomercial.com.ar"
      }
    ]
  },
  "lines": [
    {
      "quantity": "10",
      "item": {
        "name": "Notebooks Dell Latitude",
        "price": "450000.00",
        "key": "goods"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "general"
        }
      ]
    }
  ]
}


Factura B is issued by registered taxpayers (Responsable Inscripto) to final consumers, exempt entities, non-categorized subjects, and foreign tourists. VAT is included in the total price.Notice:
  • the customer is typically a final consumer (Consumidor Final) and may not have a CUIT,
  • the minimal version contains only essential fields; gobl build handles all calculations,
  • when running gobl build, the system automatically calculates totals with IVA included in the price (not shown separately as in Factura A),
  • the built version shows the normalized document with calculated totals where VAT is included in the final amounts,
  • the ar-afip-v1 addon applies Factura B specific rules and validations, and,
  • the invoice will be submitted to AFIP for authorization and receive a CAE.
{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": ["ar-arca-v4"],
  "uuid": "4bea8c67-6ad9-5cfc-a1ce-f9f391e963b1",
  "currency": "ARS",
  "issue_date": "2025-01-16",
  "series": "2",
  "supplier": {
    "name": "Electrodomรฉsticos del Sur S.A.",
    "tax_id": {
      "country": "AR",
      "code": "30712345671"
    },
    "addresses": [
      {
        "street": "Av. Rivadavia 5000",
        "locality": "Buenos Aires",
        "region": "Ciudad Autรณnoma de Buenos Aires",
        "code": "C1424",
        "country": "AR"
      }
    ],
    "emails": [
      {
        "addr": "ventas@electrodomesticos.com.ar"
      }
    ],
    "registration": {
      "other": "Inicio de actividades: 2016-03-01"
    }
  },
  "customer": {
    "name": "Juan Pรฉrez",
    "identities": [
      {
        "code": "25123456",
        "ext": {
          "ar-arca-identity-type": "96"
        }
      }
    ]
  },
  "lines": [
    {
      "quantity": "1",
      "item": {
        "name": "Heladera Samsung 400L",
        "price": "850000.00",
        "key": "goods"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "general"
        }
      ]
    }
  ]
}
Factura C is issued by monotributistas (simplified tax regime for small businesses and freelancers) to any type of customer. This invoice type does not break down VAT separately.Notice:
  • the supplier is registered under the monotributo regime, which is a simplified tax system for small businesses,
  • the minimal version contains only essential fields; totals are calculated by gobl build,
  • when running gobl build, the system automatically calculates totals without breaking down VAT separately (VAT is included but not itemized),
  • the built version shows the normalized document with calculated totals where no VAT breakdown is shown, as monotributistas donโ€™t separately charge VAT,
  • the ar-afip-v1 addon applies Factura C specific rules and ensures compliance with monotributo requirements, and,
  • the invoice will be submitted to AFIP for authorization and receive a CAE.
{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": ["ar-arca-v4"],
  "$tags": ["monotax"],
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "currency": "ARS",
  "issue_date": "2025-01-18",
  "series": "1",
  "supplier": {
    "name": "Marรญa Garcรญa - Diseรฑo Grรกfico",
    "tax_id": {
      "country": "AR",
      "code": "20172543597"
    },
    "addresses": [
      {
        "street": "Calle Florida 500",
        "locality": "Buenos Aires",
        "region": "Ciudad Autรณnoma de Buenos Aires",
        "code": "C1005",
        "country": "AR"
      }
    ],
    "emails": [
      {
        "addr": "maria.garcia@email.com.ar"
      }
    ],
    "registration": {
      "other": "Inicio de actividades: 2016-03-01"
    }
  },
  "customer": {
    "name": "Startup Tech S.R.L.",
    "tax_id": {
      "country": "AR",
      "code": "30987654321"
    },
    "addresses": [
      {
        "street": "Av. Belgrano 1000",
        "locality": "Buenos Aires",
        "region": "Ciudad Autรณnoma de Buenos Aires",
        "code": "C1092",
        "country": "AR"
      }
    ],
    "emails": [
      {
        "addr": "admin@startuptech.com.ar"
      }
    ]
  },
  "lines": [
    {
      "quantity": "1",
      "item": {
        "name": "Diseรฑo de logotipo e identidad visual",
        "price": "150000.00",
        "key": "services"
      }
    }
  ],
  "charges": [
    {
      "key": "tax",
      "percent": "10%",
      "description": "Tributo Nacional",
      "ext": {
        "ar-arca-tax-type": "1"
      }
    }
  ],
  "ordering": {
    "period": {
      "start": "2025-01-01",
      "end": "2025-01-15"
    }
  },
  "payment": {
    "terms": {
      "due_dates": [
        {
          "date": "2025-01-25",
          "amount": "150000.00"
        }
      ]
    }
  }
}
After uploading, youโ€™ll see the document in the Invoices section with status Empty.
2

Send the invoice to the ARCA invoice workflow

Send the invoice to your ARCA workflow using the Create a job endpoint. Use:
  • workflow_id: the Workflow ID of the ARCA Invoice workflow you created during setup
  • silo_entry_id: the Silo Entry ID of the invoice you uploaded
The invoice status will change to Sent when the workflow completes successfully.You can verify that the PDF was generated by opening the invoice and selecting the PDF from the Files tab. The PDF includes the CAE and the required QR code.
Sent invoice

FAQ

Factura A (B2B between Responsables Inscriptos), Factura B (consumers and exempt entities), Factura C (Monotributistas to anyone) and Factura E (exports). Type is determined by the issuerโ€™s tax regime and the customerโ€™s classification โ€” Invopop selects the right one automatically when both are set.
Most ARCA-cleared invoices are delivered as PDFs with the CAE printed on them, though the underlying XML is also available on request. Invopop can convert the XML into GOBL for downstream processing; PDF-only documents need OCR or manual capture.
Argentine invoices use a two-part numbering system: XXXXX-YYYYYYYY
  • Punto de Venta (POS): A 5-digit code (e.g., 00001) that identifies the point of sale or electronic invoicing method.
  • Sequential Number: An 8-digit code (e.g., 00000001) that increases by 1 with each invoice.
The sequence must be continuous with no skipped or repeated numbers. Each invoice type (A, B, C) and POS combination has its own independent sequence. For example, Factura A from POS 0001 starts at 00001-00000001, while Factura B from the same POS would also start at 00001-00000001.Invopop automatically manages sequential numbering for each punto de venta.
A Punto de Venta (POS) is a 5-digit code that identifies where invoices are issued from. In electronic invoicing, it represents the electronic invoicing method or channel (e.g., Web Service, ARCA portal).Each POS has its own independent invoice sequence for each invoice type. You must register your punto de venta with ARCA before you can issue invoices through it in production. In the sandbox environment, you can use test punto de venta numbers without registration.
No, you can use the same punto de venta for different invoice types (Factura A, B, C, etc.). However, each invoice type will have its own independent sequential numbering within that punto de venta.For example, using POS 00001:
  • Factura A: 00001-00000001, 00001-00000002, 00001-00000003โ€ฆ
  • Factura B: 00001-00000001, 00001-00000002, 00001-00000003โ€ฆ
WSFE (Web Services de Factura Electrรณnica) is ARCAโ€™s web service infrastructure for automated invoice submission. ARCA provides several web services:
  • wsfev1: For invoices A, B, C, and M without item detail
  • wsmtxca: For invoices A and B with item details
  • wsfexv1: For type E (export) invoices
Invopop integrates with these services to automatically submit your invoices to ARCA and receive CAE authorization codes in real time.
If ARCA rejects an invoice, youโ€™ll receive an error message explaining the reason for rejection. Common reasons include:
  • Invalid or unregistered CUIT
  • Missing required fields
  • Incorrect tax calculations
  • Sequential numbering errors
  • Invalid punto de venta
Review the error message, correct the issue in your GOBL document, and resubmit the invoice. The rejected invoice does not count toward your sequential numbering, so you can use the same number after correction.
See the Argentina tax regime in GOBL for tax IDs, tax categories, and AFIP/ARCA-specific extensions. The ar-arca-v1 addon documents required fields for invoice submission to ARCA.
More available in our Argentina FAQ section