Skip to main content

​
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"
      }
    ]
  },
  "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"
      }
    ]
  },
  "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"
      }
    ]
  },
  "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