Sandbox
Entorno de pruebas para desarrollar y testear tu integración sin riesgo ni costo.
¿Qué es el Sandbox?
El Sandbox es un entorno aislado que simula el comportamiento de la API de producción. Podés crear facturas, consultar documentos y probar webhooks sin enviar datos reales a SUNAT ni incurrir en costos. Es el lugar ideal para desarrollar y testear tu integración antes de pasarla a producción.
Sin riesgo
Los documentos no se envían a SUNAT ni tienen validez legal.
Sin costo
El sandbox es completamente gratuito, sin límite de requests.
Idéntico a producción
Misma API, mismos endpoints, misma estructura de respuestas.
Credenciales Sandbox
Para usar el sandbox necesitás una API Key con prefijo TF_test_. Podés generarla desde el panel de configuración.
Sandbox vs Producción
| Característica | Sandbox | Producción |
|---|---|---|
| Emisión de documentos | ✓ Simulado | ✓ Real (SUNAT) |
| Validación SUNAT | Simulada (siempre OK) | Real (puede fallar) |
| Descarga de PDF | ✓ PDF de prueba | ✓ PDF oficial |
| XML firmado | ✓ XML de prueba | ✓ XML con certificado |
| Webhooks | ✓ Funcional | ✓ Funcional |
| Costo | Gratis | Según plan |
| Datos reales | No | Sí |
| API Key prefix | TF_test_ | TF_live_ |
RUCs de Prueba
Usá estos RUCs en el sandbox para simular clientes. No corresponden a empresas reales.
| RUC / DNI | Razón Social | |
|---|---|---|
| 20000000001 | EMPRESA DE PRUEBA SAC | |
| 20000000002 | COMERCIAL DEMO EIRL | |
| 20000000003 | SERVICIOS TEST SA | |
| 10000000001 | PERSONA NATURAL PRUEBA | |
| 20999999999 | CLIENTE SIMULADO SRL |
Probar API
Probá un endpoint rápidamente. Ingresá tu API Key de sandbox y seleccioná un endpoint.