Entornos Sandbox y LIVE
Dos entornos separados, mismo contrato de API. Desarrolla en Sandbox, emite en LIVE.
VeriBai separa por completo el entorno de pruebas del de producción. El contrato de la API es idéntico en ambos: la integración que funciona en Sandbox funciona en LIVE sin cambios de código. Solo cambian la base URL y la clave.
| Sandbox | LIVE | |
|---|---|---|
| Base URL | https://sandbox.veribai.com |
https://api.veribai.com |
| Validez fiscal | Ninguna | Plena |
| Coste | Gratuito | Según plan. Ver Precios |
| Cuota mensual | 20.000 peticiones por clave | Según plan. Ver Límites |
| Límite de peticiones | 10 req/s | Según plan |
| Emisores dados de alta | 5 | Según plan |
Las facturas emitidas en Sandbox no cuentan para la facturación: el plan se mide sobre las altas aceptadas en LIVE. Los datos de Sandbox se conservan 45 días.
El identificador del entorno en la API sigue siendo test. Sandbox es el nombre del entorno; el valor que viaja en las peticiones y respuestas no cambia: el campo "entorno": "test" de la API de gestión, el argumento environment="test" del cliente de Python y el parámetro ?environment=test|live de las rutas de clientes y representación.
Qué comprobar en Sandbox
El entorno Sandbox ejecuta el pipeline completo (validación, firma, encadenado, generación de QR), por lo que sirve para verificar la integración de extremo a extremo:
- Que tus datos pasan la validación (NIF, series, importes, reglas por tipo de factura).
- Que el encadenado de registros por emisor se mantiene con tu numeración.
- Que el QR y la
urlValidacionse incorporan correctamente a tus plantillas. - Que tu manejo de respuestas cubre
avisosy los distintos estados.
Paso a producción
- Genera una clave LIVE desde el panel.
- Cambia la base URL a
api.veribai.comen tu configuración. - Verifica el alta del emisor y su numeración de series antes del primer envío real. El encadenado de producción empieza con esa primera factura.
La numeración en producción debe ser correlativa y sin huecos por serie. Si migras desde otro sistema de facturación, empieza una serie nueva para los registros emitidos con VeriBai.