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 tu clave de Sandbox (fb_sandbox_…), que encuentras en la plataforma, en Desarrollo → Claves API. No necesitas tu RUC: practicas con un negocio de Sandbox.
Crea un negocio de práctica
Inventas el nombre. Un negocio de Sandbox usa el RUC de práctica 9999999999001 y es gratis.
curl https://api.fiscalbase.io/v1/ec/entities \
-H "Authorization: Bearer fb_sandbox_…" \
-H "Content-Type: application/json" \
-d '{ "kind": "sandbox", "legal_name": "NEGOCIO DE PRÁCTICA S.A." }'La respuesta es tu negocio (entity). 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.
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 marca de agua 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.
Envíatela por correo
En Sandbox nunca le escribimos a nadie por nuestra cuenta, así que pídelo y di a dónde:
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"] }'Te llega el correo que recibirán tus clientes, con el RIDE, el XML y un enlace al portal.
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.