Integración con ARCA en Distribuidora: Factura Electrónica + Percepciones

ARCA (ex-AFIP) es uno de los puntos más críticos de cualquier sistema de distribuidora argentina. Factura electrónica con todas sus particularidades + percepciones IIBB multi-jurisdicción + agentes de retención es donde más rápido se rompen sistemas mal diseñados. La integración correcta con stack + costos reales 2026.

Para contexto, leé sistema a medida para distribuidoras y la guía de software a medida en Argentina.

ARCA en distribuidora típica AR

Qué necesita cubrir

1. Tipos de comprobante: A, B, C, M (cliente del exterior), X (no fiscal)
2. Punto de venta: cada sucursal/canal puede tener su propio PV
3. Numeración consecutiva: sin saltos, sin duplicados
4. CAE (Código de Autorización Electrónico): válido y vigente
5. Conceptos: bienes, servicios, mixto
6. Subtotales por alícuota: 21%, 10.5%, 27%, 0%, exento, no gravado
7. Percepciones IIBB: por jurisdicción del cliente + régimen aplicable
8. Percepciones IVA: cuando aplica (régimen específico)
9. Retenciones: si el cliente es agente de retención
10. Notas de crédito y débito: con referencia al comprobante original

Particularidades AR

• Cada provincia tiene su régimen IIBB con tablas distintas
• Régimen de retención varía por actividad del proveedor + cliente
• Agentes de recaudación municipal sumándose seguido
• Resoluciones AFIP/ARCA cambian regularmente
• Vencimiento del CAE: 10 días desde emisión

Arquitectura de integración

Esta integración suele ser parte de un proyecto más amplio de digitalización de procesos que toca pedidos, stock y cobranzas en simultáneo.

Opción A: Integración directa con ARCA

[Sistema custom]
  ↓ XML soap request
[Webservice ARCA: WSAA + WSFEv1]
  ↓ XML soap response
[CAE + número]

Componentes:

• Certificado digital X.509 generado en ARCA
• Token con TA (Ticket de Acceso) que renueva cada 12h
• Cliente SOAP en backend
• Manejo de errores por código ARCA

Pros:

• Sin costo recurrente
• Control total
• Sin dependencia de tercero

Contras:

• Mantenimiento de schemas XML
• Updates cuando ARCA cambia API
• Manejo de errores complejo
• Testing exhaustivo necesario
• 4-8 semanas de implementación

Opción B: Partner local (recomendado para pyme)

[Sistema custom]
  ↓ REST API JSON
[Partner: Afipy, Tango, AFIP Services]
  ↓ XML soap (encapsulado)
[Webservice ARCA]

Pros:

• 2-4 semanas implementación
• API REST simple
• Mantenimiento delegado al partner
• Updates de schemas automáticos
• Soporte directo

Contras:

• Costo recurrente USD 30-150/mes según volumen
• Dependencia del partner

Recomendación: Para distribuidoras pyme con <5k facturas/mes, partner local es la opción clara.

Percepciones IIBB

Modelo

RegimenIIBB
  ├─ jurisdiccion (CABA, PBA, Córdoba, etc)
  ├─ codigo_regimen
  ├─ alicuota
  ├─ minimo_no_imponible
  ├─ vigencia_desde, vigencia_hasta
ClienteIIBB (relación cliente + régimen)
  ├─ cliente_id
  ├─ jurisdiccion
  ├─ regimen_id
  ├─ alta_fecha

Cálculo

Por cada factura:

1. Identificar jurisdicción del cliente (por domicilio fiscal)
2. Verificar régimen aplicable (por actividad del cliente + monto del comprobante)
3. Aplicar alícuota sobre subtotal gravado
4. Si supera mínimo no imponible: agregar percepción al comprobante

Mantenimiento

• Tabla de regímenes actualizada manualmente o vía partner que mantiene API
• Updates trimestrales típicos
• Alerta automática cuando cliente cambia jurisdicción

Agentes de retención

Tipos comunes

• Régimen general AFIP: empresas grandes inscriptas
• Regímenes municipales: por jurisdicción
• Agentes específicos por actividad

Workflow

1. Cliente se identifica como agente de retención (CUIT en padrón)
2. Sistema marca al cliente en alta
3. Al cobrar: cliente retiene X% antes de pagar
4. Sistema genera certificado de retención
5. Distribuidora computa la retención como pago a cuenta de IIBB/IVA según tipo

Manejo de errores ARCA

Errores típicos

• Error 10005: vencimiento CAE - reintentar con nuevo CAE
• Error 10010: mismo punto de venta + número emitido - duplicado
• Error 10015: alícuota IVA inválida - error en config
• Error 10043: mismo CUIT cliente con régimen distinto

Estrategia

• Reintentos automáticos con backoff exponencial (3 intentos, 1s/3s/9s)
• Errores no recuperables: marcar factura "pendiente revisión" + alerta
• Logs detallados para debugging
• Dashboard con estado de últimas 100 facturas

Costos típicos

Implementación

• Vía partner (recomendado): USD 1.500-3.500 incremental sobre sistema base + USD 30-150/mes recurrente
• Integración directa: USD 3.500-7.000 incremental + USD 0/mes recurrente

Mantenimiento

• Actualizaciones de regímenes IIBB: incluido en partner o ~USD 200/mes con dev interno
• Adaptación a nuevas resoluciones ARCA: 2-4 horas de dev cuando ocurre

ROI

• Eliminación de errores de carga manual (8-12% típico → <0.5%)
• Velocidad: factura emitida en <30 segundos al confirmar venta vs minutos en sistema externo
• Compliance: cero riesgo de IIBB mal calculado o agente de retención no aplicado
• Auditorías más simples

Ejemplo del mercado

Distribuidora de productos eléctricos en GBA con 4 sucursales + 6 puntos de venta.

Diagnóstico previo:

• Facturación en sistema externo Tango
• Carga manual de pedidos al Tango: 30+ minutos por factura
• Errores 8% en percepciones IIBB
• Sin integración con cobranzas

Solución:

• Integración con ARCA via Afipy (USD 80/mes)
• Tabla de regímenes IIBB para 6 jurisdicciones donde opera
• Marcado automático de clientes agentes de retención
• Generación de factura en <20 segundos al confirmar pedido

Resultado:

• Tiempo facturación: 30min → 20 segundos
• Errores percepciones: 8% → 0.3%
• 100% de facturas con CAE válido al primer intento
• Tiempo admin liberado: 4h/día

Inversión: USD 2.800 incremental + USD 80/mes Afipy + USD 250/mes mant adicional.

ROI break-even: mes 5.

Lo que importa

Integración ARCA bien hecha es uno de los pilares de un sistema de distribuidora seria. Para pymes, vía partner local (Afipy, Tango, AFIP Services) es la opción correcta: 2-4 semanas, USD 1.500-3.500, costo recurrente bajo, mantenimiento delegado.

Modelar correctamente percepciones IIBB multi-jurisdicción + agentes de retención es esencial. Distribuidoras que operan en 3+ provincias necesitan configuración por jurisdicción.

Hablamos? Otras notas útiles: sistema a medida para distribuidoras, 10 casos de automatización empresarial, la guía de software a medida en Argentina.