Skip to main content

Entorno de testing (homologación) en Facturear

Antes de conectar tu sistema con producción y emitir facturas reales, podés usar el entorno de homologación (testing) de ARCA. Este entorno te permite probar toda la integración sin impacto fiscal real.

¿Qué es el entorno de homologación?

ARCA ofrece un entorno de homologación (también llamado “testing”) que replica el comportamiento del webservice de facturación electrónica, pero las facturas emitidas ahí no tienen validez fiscal.
  • Los CAEs emitidos en testing son “de prueba”
  • No se informan al sistema fiscal real
  • Podés emitir tantas facturas de prueba como necesités

Configuración en Facturear

No tenés que configurar nada aparte: al conectar tu CUIT con ARCA generamos dos certificados, uno de homologación y otro de producción. Para pasar a testing, entrá a tu cuenta (tu nombre, abajo en el menú) y en Entorno prendé el Modo Testing. Es para toda la cuenta: mientras está prendido, todo se factura en el entorno de pruebas de ARCA, sin valor fiscal, incluido lo que llega por tus integraciones y por WhatsApp. Arriba de la pantalla vas a ver el aviso Modo Testing activo. Para volver, apagalo. Las facturas de prueba no cuentan para el límite mensual de tu plan.

Diferencias entre testing y producción


Cómo testear con la API de Facturear

El entorno lo define la API key que usás: tu cuenta tiene una key de testing y una de producción (en Desarrolladores → Claves API). Con la key de testing, todas las llamadas operan en homologación; el cuerpo de la factura y los endpoints son exactamente los mismos que en producción, así que pasar a producción es solo cambiar la key.
Como en producción, la factura queda encolada y el CAE de prueba aparece en el responseBody de cada ítem del lote. Ver Emitir tu primera factura.

Casos de prueba recomendados

Antes de pasar a producción, testeá al menos estos escenarios:
  • Factura C a Consumidor Final (sin datos del receptor)
  • Factura A con CUIT de receptor válido
  • Factura B con datos del receptor
  • Nota de Crédito sobre una factura existente
  • Factura con múltiples ítems y alícuotas diferentes
  • Error intencional (CUIT receptor inválido) — verificar manejo de errores
  • Lote con múltiples facturas
  • Lote con algún ítem que falla
  • Condición frente al IVA del receptor que no corresponde a la clase (por ejemplo, Factura A con condicionIVAReceptorId: 5) — debe responder 400. Ver Condición frente al IVA del receptor

Preguntas frecuentes

Nunca se mezclan con las reales. Inicio, Facturas y Reportes muestran solo el entorno en el que está tu cuenta: con el Modo Testing prendido ves solo las facturas de prueba (Inicio lo aclara con Entorno de testing: los números son de homologación), y con el modo apagado, solo las de producción. Por API, GET /api/invoices y GET /api/invoices/stats devuelven las del entorno de tu API Key.
Sí, pero con diferentes certificados. El CUIT es el mismo; lo que cambia es si usás el certificado de homologación (testing) o el de producción.
ARCA puede tener límites de velocidad en el entorno de testing, pero son generosos para desarrollo normal. No usés el entorno de testing para cargas de producción.

Recursos relacionados


Emití facturas electrónicas con Facturear

Conectate a ARCA en minutos y empezá a facturar sin complicaciones.