facturas — Node.js SDK for ARCA/AFIP Electronic Invoicing

Issue electronic invoices and credit notes against ARCA/AFIP directly from Node.js. ESM-only, no proxy, no external service required.

facturas is a TypeScript SDK that connects your Node.js application directly to Argentina’s ARCA/AFIP tax authority — no proxy, no hosted service, no external database required for basic use. With a single createArcaClient() call and four environment variables, you can issue compliant electronic invoices and credit notes through WSFE or WSMTXCA, look up taxpayer data via Padrón, and handle safe retries with idempotency keys.

Introduction

Learn what facturas is, what it covers, and how it fits into your application.

Quick Start

Install the package and issue your first invoice in under five minutes.

ARCA Setup

Generate credentials with the CLI and register them in ARCA’s portal.

Configuration

Environment variables, client options, stores, logging, and timeouts.

How onboarding works

1. Install facturas

   Add the package to your project with your preferred package manager. Node.js 20 or later is required, and the package is ESM-only.

   pnpm add facturas
   
2. Register your ARCA credentials

   Use the built-in CLI to generate a private key and CSR, register them in ARCA’s portal, and save your certificate. Run npx facturas check to confirm every layer is working before you write any application code.

   npx facturas init --cuit 20123456786 --env test
   npx facturas check
   
3. Issue your first invoice

   Set the four required environment variables, create a client, and call arca.issue(). No database or external service is needed to get started.

   import { createArcaClient } from "facturas";
   
   const arca = createArcaClient();
   
   const factura = await arca.issue({
     issuer: "monotributo",
     salesPoint: 3,
     to: { condition: "consumidor_final" },
     items: [{ amount: 150_000 }], // ARS 1,500.00 in centavos (minor units)
   });
   

facturas is pre-1.0. While the version starts with 0., a minor release may change or remove parts of the public API. Pin the exact version in your package.json (e.g. "facturas": "0.11.0") and read the changelog before upgrading.