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.2import { 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
}Ecosistema
9 paquetes, una misma base
Los SDKs de web services comparten configuración, errores tipados y eventos. arca-empleados genera el TXT de Simplificación Registral y arca-common es la base de todos. Instalá solo lo que necesitás.
Facturación
v7.0.2@ramiidv/arca-facturacion
Facturación Electrónica — WSFEv1, WSFEX, CAEA de contingencia y QR
Padrón
v0.9.1@ramiidv/arca-padron
Consulta de Contribuyentes por CUIT — Constancia de Inscripción y padrones A4, A10, A13 y A100
Empleados
v0.6.1@ramiidv/arca-empleados
Simplificación Registral — Ingreso masivo de relaciones laborales
CDC
v0.8.2@ramiidv/arca-cdc
Constatación de Comprobantes — WSCDC
FECred
v0.8.1@ramiidv/arca-fecred
Factura de Crédito Electrónica MiPyME — WSFECRED
MTXCA
v0.8.2@ramiidv/arca-mtxca
Facturación con Detalle de Artículos — WSMTXCA
Agro
v0.8.2@ramiidv/arca-agro
Servicios Agropecuarios — Carta de Porte (WSCPE) y Liquidación de Granos (WSLPG)
SIRE
v0.7.2@ramiidv/arca-sire
Certificados de Retención de IVA — SIRE (formulario C2005)
Common
v0.10.0@ramiidv/arca-common
Base compartida — Autenticación WSAA, cliente SOAP, validadores y QR
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.