Tu primera factura en 5 minutos
Crea un negocio de práctica, emite una factura en Sandbox y descarga su RIDE autorizado. Sin RUC, sin certificado y sin tocar el SRI.
Vas a emitir una factura de verdad, en el ambiente de práctica. Sandbox hace todo lo que hace Producción (numera, calcula, firma, autoriza, genera el RIDE), pero un simulador responde por el SRI y nada tiene validez tributaria.
Necesitas una API key de Sandbox (fb_sandbox_…). Cada API key es de un negocio, así que primero creas un negocio de práctica y luego su API key, los dos en la plataforma. No necesitas tu RUC.
Crea un negocio de práctica y su API key
En la plataforma, la primera vez, elige Quiero probar primero: inventas el nombre y listo. Un negocio de Sandbox usa el RUC de práctica 9999999999001 y es gratis. Ya tiene numeración 001-001 en Sandbox para los seis tipos de comprobante: no tienes que configurar nada más para emitir. Cuando emitas de verdad, registrarás tu RUC como negocio en vivo.
Después, en API, con Nueva API key y el ambiente Sandbox, crea la API key de ese negocio. Una API key no puede crear negocios: los registra una persona en la plataforma.
Emite la factura
curl https://api.fiscalbase.io/v1/ec/invoices \
-H "Authorization: Bearer fb_sandbox_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-1041" \
-d '{
"buyer": {
"identification_type": "cedula",
"identification": "1710034065",
"name": "María Robles",
"email": "maria@example.com"
},
"lines": [{
"description": "Plan mensual",
"quantity": "1",
"unit_price": "10.00",
"taxes": [{ "type": "iva", "rate": "iva_15" }]
}],
"payments": [{ "method": "sin_sistema_financiero" }],
"metadata": { "order_id": "1041" }
}'Recibes un 201 con la factura numerada (001-001-000000001), su clave de acceso de 49 dígitos, los totales calculados (subtotal 10.00, iva 1.50, total 11.50) y status: "pending".
El email del comprador es obligatorio (solo consumidor final va sin él): al autorizarse, la factura le llega por correo también en Sandbox, con [Sandbox] en el asunto. Pon una dirección que puedas leer.
Fíjate en lo que no enviaste: la fecha (siempre es hoy en Ecuador), el número, la clave de acceso ni los totales. Los calculamos nosotros para que coincidan exactamente con lo que el SRI espera.
Espera la autorización
En unos segundos, la factura pasa por submitted y llega a authorized. Consúltala:
curl https://api.fiscalbase.io/v1/ec/invoices/{id} \
-H "Authorization: Bearer fb_sandbox_…"Cuando status sea authorized, authorization trae el número y la fecha de autorización. En tu integración real no consultes en bucle: registra un webhook y te avisamos.
Descarga el RIDE y el XML
curl -o factura.pdf https://api.fiscalbase.io/v1/ec/invoices/{id}/pdf \
-H "Authorization: Bearer fb_sandbox_…"
curl -o factura.xml https://api.fiscalbase.io/v1/ec/invoices/{id}/xml \
-H "Authorization: Bearer fb_sandbox_…"El RIDE de Sandbox lleva la leyenda Sandbox, sin validez tributaria. El XML es la autorizacion del SRI con tu factura firmada adentro: el mismo archivo que descargarías del portal del SRI.
Revisa tu correo
No tienes que pedir nada: al autorizarse, la factura le llega al email del comprador, con el RIDE, el XML y un enlace al portal. Es el mismo correo que recibirán tus clientes, con [Sandbox] en el asunto.
Si quieres otra copia, o enviarla a otra dirección, pídelo:
curl https://api.fiscalbase.io/v1/ec/invoices/{id}/email \
-H "Authorization: Bearer fb_sandbox_…" \
-H "Content-Type: application/json" \
-d '{ "to": ["tu-correo@example.com"] }'Lo que acabas de ver
- La API acepta y numera al instante, y el resto pasa después: firma, envío, autorización, RIDE y correo.
- Tú mandas la venta, nosotros los detalles del SRI: fecha, número, clave de acceso, totales e IVA.
- Sandbox es el mismo producto que Producción, sin consecuencias.