Guía de integración — arcafactura

arcafactura emite comprobantes electrónicos de ARCA (ex AFIP) por vos: login WSAA, numeración, CAE, reintentos e idempotencia. Tu app hace un POST por comprobante y recibe el CAE.

URL base: https://api.arcafactura.com
Autenticación: Authorization: Bearer <API_KEY> (las keys se crean en el portal → API keys).
Formato: JSON. Fechas YYYY-MM-DD. Importes en la moneda del comprobante, con hasta 2 decimales.

Inicio rápido

Cuenta: registrate en el portal y confirmá tu email con el link que te mandamos (vence en 24 horas): sin confirmarlo no podés ingresar.
API key: portal → API keys → Crear key. Se muestra una sola vez: guardala como secreto de tu app.
Certificado: portal → Certificados → subí el .crt y la .key de ARCA (uno por entorno). Así tu app no maneja el certificado.
Probá en homologación ("entorno": "homologacion"): no genera comprobantes reales.

curl -X POST https://api.arcafactura.com/v1/comprobantes \
  -H "Authorization: Bearer $ARCAFACTURA_API_KEY" \
  -H "Idempotency-Key: cobro-1234" \
  -H "Content-Type: application/json" \
  -d '{
    "cuit": 20111111112, "entorno": "homologacion", "ptoVta": 1,
    "tipoComprobante": 11, "concepto": 1,
    "receptor": { "docTipo": 99, "docNro": 0, "condicionIvaId": 5 },
    "fecha": "2026-11-04", "moneda": "PES", "cotizacion": 1,
    "importes": { "neto": 1000, "total": 1000 }
  }'