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

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 amortiza en menos de 18 meses frente a SaaS recurrentes.

Si eres desarrollador, COO o jefe de sistemas de pyme argentina y necesitas automatizar facturación AFIP sin pagar suscripciones recurrentes, 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

Comparativa SaaS vs sistema a medida

El caso real: idempotency en transacciones distribuidas

Una distribuidora multi país con 100 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
• Trigger en app.leads on INSERT BOOKED genera fila en outbox.cierres_venta
• 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. Pagás 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. Necesitás que tu factura electrónica viva en una base de datos a tu nombre, exportable cuando quieras

Lo que antes tomaba 30 ingenieros y 18 meses lo entregamos en semanas. 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.

Catalizadora hace ese diagnóstico en una llamada de 30 minutos, sin pitch deck, conversación real sobre tu operación.

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