Saltar al contenido
VeloraBlog
← Todos los artículos

12 de junio de 2026

afip.ts vs @afipsdk/afip.js — ¿cuál usar para facturar AFIP desde Node.js?

La diferencia clave es la arquitectura: @afipsdk/afip.js es una SDK que usa afipsdk.com como intermediario SaaS (tus facturas pasan por sus servidores). afip.ts (ralcorta/arcasdk) es self-hosted — firma y llama directamente a los endpoints SOAP de ARCA sin pasar por terceros. Para fiscal de producción sin dependencia externa, afip.ts/arcasdk es la opción.

La diferencia que importa: quién tiene el token

@afipsdk/afip.js funciona como SaaS: la librería se autentifica contra afipsdk.com con un access_token. Sus servidores obtienen el TA de WSAA y ejecutan las llamadas SOAP a ARCA en tu nombre. Tu código habla con la API de AfipSDK, no con ARCA directamente.

afip.ts / arcasdk (ralcorta) es self-contained: pasás tu clave privada y certificado directamente a la librería; el proceso Node firma el TRA, obtiene el TA del WSAA de ARCA, y llama a WSFEv1 desde tu propio servidor. Ningún tercero tiene acceso a tus credenciales.

Tabla comparativa

Criterio@afipsdk/afip.jsafip.ts / arcasdk
ArquitecturaSaaS intermediarioSelf-hosted directo
Quién llama a ARCAServidores de AfipSDKTu servidor
Credencialesaccess_token en AfipSDKclave privada + cert locales
Plan gratuitoSí (con límite de requests)Open source, sin costo
Soporte / docsDocs completas, n8n oficialREADME + código
LenguajeJS/TSTypeScript nativo
Firma attachedVia SaaS (opaco)Sí, en proceso
Firma detached bugNo aplica (SaaS resuelve)No tiene el bug — firma attached

Cuándo usar cada uno

Elegir @afipsdk/afip.js cuando:

  • Querés integración rápida sin gestionar certificados localmente.
  • El negocio acepta que un tercero SaaS esté en el camino fiscal.
  • Usás n8n o Make (hay nodos oficiales de AfipSDK).

Elegir afip.ts / arcasdk cuando:

  • Necesitás control total — las credenciales y el flujo de autenticación quedan en tu infraestructura.
  • Requisito de compliance o cliente que no acepta intermediarios en el flujo de facturación.
  • Self-hosted en Cloud Run, VPS, o cualquier entorno sin dependencia de terceros.