Inicio · Blog · conectar afip sistema

conectar afip sistema

Cómo conectar AFIP con sistema de facturación automática

Guía 2026 para conectar AFIP con sistema de facturación automática en Argentina: WSAA, WSFEv1, WSFEX y cuándo conviene un desarrollo a medida.

Pablo Estrada · 11 de mayo de 2026 · 5 min de lectura

Conectar AFIP con un sistema de facturación automática en Argentina 2026 requiere tres piezas: certificado X.509 del CUIT, autenticación vía WSAA (Token Authorization válido 12 horas), y llamada al webservice correcto (WSFEv1 para mercado interno, WSFEX para exportación). El flujo correcto guarda los comprobantes en queue con retry exponencial para sobrevivir las caídas frecuentes de AFIP. Existen bibliotecas open source maduras (afip.ws, pyafipws, AfipManager) que cubren la parte técnica. Para una pyme argentina con más de 200 facturas al mes, un sistema a medida con código propio empieza a tener sentido frente a un SaaS que sube de plan con el volumen.

Si eres desarrollador, COO o jefe de sistemas de pyme argentina y necesitas automatizar facturación AFIP sin depender de un SaaS de facturación, esta guía te lleva paso a paso.

Paso 1: Generar certificado X.509 para tu CUIT

AFIP exige autenticación por certificado digital. El proceso una sola vez:

  1. Generas par de claves RSA 2048 (private key local, NUNCA subir a git)
  2. Generas CSR (Certificate Signing Request) con OpenSSL
  3. Entras al portal de AFIP con clave fiscal nivel 3
  4. Vas a Administrador de Relaciones de Clave Fiscal y das de alta el servicio Webservices
  5. En Administración de Certificados subes tu CSR
  6. AFIP te entrega certificado X.509 firmado, vigencia 2 años

El comando OpenSSL típico:

openssl genrsa -out private.key 2048
openssl req -new -key private.key -subj "/C=AR/O=Tu Empresa/CN=Tu Empresa/serialNumber=CUIT 20123456789" -out request.csr

Paso 2: Autenticar contra WSAA

WSAA es el Web Service de Autenticación y Autorización. Antes de cada llamada al WSFEv1 necesitas un Token Authorization (TA) válido por 12 horas. El flujo:

  1. Generas un XML con tu CUIT, timestamp y servicio que vas a usar (wsfe)
  2. Firmas el XML con tu certificado X.509 y private key (CMS PKCS7)
  3. Envías al WSAA por SOAP
  4. WSAA te devuelve Token y Sign válidos 12 horas
  5. Guardas TA en cache (Redis o archivo) hasta que expire

Bibliotecas open source que ya implementan esto:

  • pyafipws (Python) por Mariano Reingart, la más madura
  • afip.ws (PHP) usada en muchos sistemas Tango y Bejerman
  • AfipManager (Node.js) más moderno
  • Afip SDK Argentina (Go)

Paso 3: Llamar al WSFEv1 para facturar

Una vez con TA válido, el flujo de facturación electrónica típico:

  1. Llamas a FEParamGetTiposCbte para validar tipo de comprobante (Factura A es 1, Factura B es 6)
  2. Llamas a FECompUltimoAutorizado para saber el último número de comprobante autorizado
  3. Armas el comprobante con CUIT del receptor, importe total, IVA discriminado
  4. Llamas a FECAESolicitar enviando el comprobante
  5. AFIP devuelve CAE (Código de Autorización Electrónico) y fecha de vencimiento
  6. Guardas CAE en tu base de datos
  7. Generas PDF con CAE y código de barras QR para entregar al cliente

Paso 4: Manejar las caídas de AFIP

AFIP cae con frecuencia, sobre todo fin de mes y feriados. Un sistema serio:

  • No factura sincrónico en checkout: el cliente paga, recibe recibo provisorio
  • Worker asincrónico encola la solicitud de CAE
  • Retry exponencial (1s, 2s, 4s, 8s, hasta 5 minutos)
  • Si AFIP no responde en 5 minutos, queue persiste y reintenta cada 15 minutos
  • Cuando AFIP responde, genera PDF y envía por email al cliente
  • Audit log append only registra cada intento con timestamp

Tabla comparativa de webservices AFIP

Webservice Uso Volumen recomendado
WSFEv1 Factura A, B, C, M mercado interno La mayoría de pymes
WSFEX Factura E exportación Pyme con clientes exterior
WSMTXCA Factura electrónica con detalle por ítem Retail con SKU obligatorio
WSBFE Bono fiscal electrónico Casos específicos
WSCT Comprobantes de turismo Hoteles y agencias

Comparativa SaaS vs sistema a medida

Criterio SaaS (Contabilium, Tango Nube) Sistema a medida
Costo mensual 30 a 200 USD Nube a costo, según el uso
Costo inicial 0 USD Según el alcance
Dueño del código Proveedor Tú, 100 por ciento
Volumen óptimo Hasta 500 facturas al mes Más de 500 al mes
Customización Limitada al producto Total
Bloqueo Si dejas de pagar, no facturas Cero
Multi punto de venta Plan superior Incluido

El caso real: idempotency en transacciones distribuidas

Una cadena de franquicias necesitaba write back desde su sistema operativo hacia un ERP central, sin perder transacciones. Catalizadora implementó el patrón outbox:

  • Outbox queue en Postgres con idempotency_key UUID por transacción
  • Un trigger en la tabla de leads genera la fila en la outbox cuando un lead queda agendado
  • Worker Python con retry exponencial (1s, 2s, 4s) llama a API destino
  • Audit log append only registra cada intento, éxito o fallo
  • CDC vía replicación lógica para histórico

Resultado: cero pérdida de transacciones, idempotency garantizada (mismo UUID nunca se procesa dos veces), reintentos automáticos sin intervención humana. Exactamente el patrón que necesita una integración AFIP seria.

Cuándo migrar de SaaS a sistema propio

Tres señales operativas:

  1. Pagas más de 100 USD al mes en SaaS de facturación y crece con tu volumen
  2. Tu SaaS no cubre un caso especial (subscriptions, bundles, descuentos por canal, marketplace)
  3. Necesitas que tu factura electrónica viva en una base de datos a tu nombre, exportable cuando quieras

Para una integración AFIP completa con WSAA, WSFEv1, queue de retries, generación de PDF con QR y panel administrativo, el tiempo real es 3 a 6 semanas dentro de un MAGIA Core.

Próximos pasos

Si recién arrancas y facturas menos de 100 al mes, un SaaS como Contabilium te cubre. Cuando ya pasaste 200 al mes y tu operación tiene reglas que ningún SaaS cubre, vale la pena revisar un sistema propio.

Ese diagnóstico se hace en una llamada con Catalizadora, revisando cómo facturas hoy.

  • MAGIA Core construye sistemas a medida con AFIP, ERP, ecommerce y dashboards en 12 semanas. Código a tu nombre.
  • Para casos donde necesitas plataforma compleja con IA, hardening y CI o CD, MAGIA Forge entrega en 12 semanas.

Cómo te ayuda Catalizadora

Construimos sistemas con IA a la medida, con el código 100% tuyo. Elige por dónde empezar:

  • Agente de IA para WhatsApp — MAGIA Solo: atiende, agenda citas y cobra con link de pago; listo en 15 días.
  • Tienda en línea con vendedor de IA — MAGIA Commerce: catálogo, carrito y cobro en tu web y en WhatsApp.
  • Agentes de IA para empresas — MAGIA Core: automatización empresarial y dashboards por rol.
  • Desarrollo de software a medida con IA — MAGIA Forge: para lo que no existe en el mercado.
  • Gratis: mide si ChatGPT y Google encuentran tu negocio — Radar
  • Ver precios · Academia de IA

Preguntas frecuentes

¿Qué webservice de AFIP debo usar para facturar?

WSFEv1 para Factura A, B, C, M (mercado interno). WSFEX para exportación. WSMTXCA para factura electrónica con detalle de productos. WSBFE para bono fiscal. La mayoría de pymes argentinas usan WSFEv1 para clientes locales y WSFEX si exportan.

¿Qué es WSAA y por qué es obligatorio?

WSAA es el Web Service de Autenticación y Autorización de AFIP. Antes de llamar a cualquier webservice de facturación necesitas pedirle a WSAA un Token y un Sign válido por 12 horas. Sin TA válido AFIP rechaza la llamada al WSFEv1.

¿Cuánto cuesta implementar facturación AFIP automática?

Si usas SaaS tipo Tango Gestión, Bejerman o Contabilium: 30 a 200 USD al mes. Vía bibliotecas open source (afip.ws en PHP, pyafipws en Python, AfipManager): solo costo de desarrollo. Sistema a medida: se cotiza según el alcance, con código a tu nombre.

¿AFIP da homologación o testing?

Sí. AFIP tiene ambiente Homologación (wswhomo) donde generas certificado de prueba y facturas test sin valor fiscal. Cualquier integración seria pasa por homologación antes de producción. AFIP tarda 1 a 3 días en habilitar producción para tu CUIT.

¿Qué pasa si AFIP cae durante una venta?

Es lo más común. AFIP cae por mantenimientos sin aviso (típicamente fin de mes y feriados). Un sistema bien hecho mantiene queue de comprobantes pendientes con retry exponencial, genera CAE asincrónicamente, y muestra al cliente recibo provisorio hasta que AFIP responda.

¿Esto aplica a tu operación?

Déjanos tu correo y te escribimos en menos de 24 horas con un diagnóstico inicial sin costo. Sin pitch, sin agenda comercial.

¿Prefieres conversar antes? Agenda 30 minutos con Pablo Estrada — sin pitch deck.

Agendar llamada →

¿Prefieres aprender a hacerlo tú? El curso completo de la Academia son 8 clases, gratis y sin tarjeta.

Entrar a la Academia →

Sigue leyendo

Asistente virtual IAE: del MBA al sistema en producción realAgente conversacional para coach de vida en Bogotá 2026IA para responder reseñas en TripAdvisor: escalar