Tu negocio en Sandbox
Tu propio negocio, con tu RUC y los datos del SRI, en un ambiente aparte y gratis para practicar y probar tu integración. Nada llega al SRI.
Sandbox es Fiscalbase en su propia dirección, sandbox.fiscalbase.io, para practicar con tu negocio de verdad antes de pagar un plan, y para probar tu integración. Todo lo que haces ahí se queda en Sandbox: un simulador responde por el SRI y nada tiene validez tributaria.
Regístrate en Sandbox
En sandbox.fiscalbase.io, crea tu cuenta con tu correo, como en la plataforma. Tu cuenta de Sandbox es solo de Sandbox: para emitir con validez tributaria te registras aparte en platform.fiscalbase.io.
Registra tu negocio con tu RUC
Escribe tu RUC y confirma lo que el SRI registra de él: tu razón social, tu nombre comercial, tu matriz, tu régimen. No te pedimos firma electrónica, plan ni pago. Con Sí, continuar tu negocio ya existe, con numeración 001-001 para los seis tipos de comprobante, y llegas a Vender.
Emite un comprobante
Con Vender o Emitir, o por API con una API key de Sandbox en https://api-sandbox.fiscalbase.io, emites una factura y el simulador responde como lo haría el SRI. Sigue Tu primera factura y, para ensayar un rechazo, simulate.
Sube comprobantes recibidos
En Recibidos, Subir archivos recibe los XML de tus compras. Por API, con una API key de Sandbox, es POST /v1/ec/imports.
Sandbox nunca consulta al SRI ni revisa la firma: entra cualquier comprobante dirigido a tu RUC, quien sea que lo haya emitido, y queda sin confirmar y sin validez tributaria. Desde una factura recibida emites su retención como en Producción. Si tienes un webhook en Sandbox, recibes received_document.created por cada uno.
Bórralo cuando quieras
En Más, Negocio, Eliminar borra tu negocio de Sandbox con todo lo que tiene: sus comprobantes, sus API keys y sus webhooks. Puedes registrarlo de nuevo cuando quieras.
Lo que cambia frente a Producción
- Nadie fuera de tu equipo recibe nada. Tus comprobantes de Sandbox llevan el nombre y el RUC reales de tu negocio, así que nunca le llegan a un comprador: el correo de cada uno va a la persona que lo emitió, o a los propietarios y administradores cuando lo emitió una API key. Los códigos del portal de Sandbox,
portal-sandbox.fiscalbase.io, también van solo a tu equipo. - Cada RIDE dice que no vale. Lleva una marca de agua grande, SIN VALIDEZ TRIBUTARIA, junto a la leyenda del simulador.
- Las API keys son de su dirección. Una API key de Sandbox (
fb_sandbox_…) funciona solo enapi-sandbox.fiscalbase.io, y una de Producción (fb_live_…) solo enapi.fiscalbase.io. Si envías una a la otra dirección, la respuesta es401con el códigoapi_key_wrong_hosty la dirección correcta. - No hay plan. Tus comprobantes de Sandbox no pagan ni cuentan en tu volumen.
Cuando quieras hacerlo con tu negocio
En el recuadro al pie del menú, Usar con mi negocio te lleva a registrarte en la plataforma. Allí registras tu RUC con tu firma electrónica y eliges tu plan. Nada de Sandbox pasa a Producción: ni tus comprobantes, ni tus API keys, ni tus webhooks.