v1.0.0 · estable · producción

Facturación electrónica con ARCA. Lista para integrar en una tarde.

El módulo Node.js que resuelve WSAA, WSFEv1, certificados, PDFs y QR AFIP. Lo que tardás semanas en construir, acá lo tenés listo.

import { createArca } from 'arca-api-tordini' // listo

// el problema

Integrar ARCA desde cero es un quilombo.

WSAA, firma CMS con OpenSSL, tokens que vencen cada 12 horas, WSFEv1 con respuestas SOAP que hay que parsear a mano, WSDLs que cambian sin aviso, documentación oficial de 2009 que nadie entiende. Y si algo falla, ARCA no te dice por qué.


Pasé semanas resolviendo esto para un sistema de distribuidora real. Después lo convertí en módulo para que nadie más tenga que pasar por lo mismo.

// qué resuelve

Todo el stack de ARCA, en un solo módulo.

WSAA automático

Autenticación, renovación de tokens y caché en disco sin configuración extra.

Facturas A, B y C

Emisión completa con mapeo automático de alícuotas de IVA.

Notas de Crédito / Débito

Con validaciones Zod y tipos estrictos en TypeScript.

PDF con QR AFIP

Generado con Puppeteer, listo para imprimir o enviar al cliente.

Cero hardcodeos

EmisorProvider inyectable, sin acoplamiento a ninguna DB o framework.

78 tests pasando

Unit e integración, TypeScript strict, sin any.

Docker incluido

Dockerfile multi-stage + docker-compose listos para producción.

Homo y producción

Switch entre entornos con una variable de entorno. Cero código extra.

// por qué existe esto

Por qué existe esto.

Estaba desarrollando un sistema de gestión completo para una distribuidora: stock, ventas, clientes, cuenta corriente. Todo funcionando. Hasta que llegué a la parte de facturación electrónica con ARCA.

Ahí me encontré con algo que nadie te cuenta: no hay una solución moderna, bien hecha, en TypeScript, que resuelva todo el stack de ARCA para Node.js. Las que existen están desactualizadas, mal documentadas, o simplemente no funcionan en producción.

Tardé semanas en tener algo funcional. Cuando salió, me di cuenta de que había construido algo que cualquier dev en Argentina que tenga que tocar ARCA va a necesitar.

Así que lo hice módulo. Y acá está.

— Bautista Tordini, desarrollador

// roadmap

Lo que viene.

v1.0.0 disponible

Módulo core estable

WSAA, WSFEv1, PDF, QR, IVA, notas de crédito. 78 tests pasando. Producción-ready.

v2.0.0 próximamente

Multi-empresa + FECAEASolicitar

Lote de comprobantes, multi-CUIT, FEParamGetCache inteligente.

v3.0.0 planeado

SDK oficial + Playground

CLI interactivo, playground online, generador de código embeddable.

// comunidad

Contribuí al proyecto.

El repo público acepta contribuciones. Si encontrás un bug, querés mejorar la documentación, o tenés una implementación mejor para algún componente, las PRs son bienvenidas.

// stack

Ecosistema.

TypeScript Node.js 20+ ARCA / AFIP oficial MIT License 78 tests Docker ready GitHub Actions CI

¿Tenés que integrar ARCA
en tu proyecto?

No lo construyas desde cero. Ya está hecho.