Open Source · MIT · Gratis

Facturación
electrónica
Argentina

Ecosistema de SDKs en TypeScript para interactuar con los Web Services de ARCA (ex AFIP). Facturación, padrón, retenciones de IVA, relaciones laborales y más, en 9 paquetes npm.

npm install @ramiidv/arca-facturacion@7.0.2
TypeScript
import { readFileSync } from "node:fs";
import { ArcaFacturacion, ArcaRechazoError, CbteTipo, IvaTipo, FileTicketStorage } from "@ramiidv/arca-facturacion";

const arca = new ArcaFacturacion({
  cuit: 20123456786,
  // certs/ en el .gitignore: nunca subas la clave
  cert: readFileSync("./certs/certificado.crt", "utf-8"),
  key: readFileSync("./certs/clave.key", "utf-8"),
  ticketStorage: new FileTicketStorage("./.arca-tickets"),
  // homologación por defecto; production: true para producción
});

try {
  const result = await arca.facturar({
    ptoVta: 1,
    cbteTipo: CbteTipo.FACTURA_B,
    items: [{ total: 1210, iva: IvaTipo.IVA_21 }], // precio final
  });
  console.log(result.cae);          // CAE autorizado
  console.log(result.cbteNro);      // Número de comprobante
  console.log(arca.urlQR(result));  // QR para la factura impresa
} catch (e) {
  if (!(e instanceof ArcaRechazoError)) throw e;
  console.error(e.observaciones);   // ARCA rechazó el comprobante
}

En común

Los SDKs de web services comparten

TypeScript nativo

Tipos estrictos, enums, errores específicos. Autocompletado completo.

Autenticación WSAA

Firma CMS/PKCS#7, cache de tokens, renovación automática y ticket persistente.

Emisión segura

Reintentos solo en consultas. Las emisiones nunca se reintentan: devuelven siempre una operación aprobada, un rechazo de ARCA lanza ArcaRechazoError y los resultados inciertos se marcan (uncertain) y, donde ARCA lo permite, se pueden recuperar.

Eventos y logging

Sistema de eventos para auth, requests, retries y errores.

Node.js 22.12+

fetch nativo, sin dependencias SOAP legacy y fallback TLS para los hosts de ARCA con DH de 1024 bits. ESM; desde CommonJS se cargan con require().

MIT y gratuito

Open source. Instalá, usá, contribuí.

Full-Stack

También como aplicación web

ARCA Server es un sistema completo de facturación con frontend React, API REST, PostgreSQL, dashboard, gestión de clientes y consultas a ARCA.

Empezá a facturar hoy

Instalá el SDK que necesites, conectá tu certificado de ARCA y arrancá en minutos. Gratis, open source, MIT.