De Sandbox a Producción
La lista para pasar de tu primera factura de prueba a emitir con validez tributaria, sin sorpresas.
Tu integración funciona en Sandbox, con un negocio de práctica. Pasar a Producción no cambia tu código: cambia la clave, y el negocio con el que emites, que ahora es uno en vivo, con tu RUC real. Un negocio de Sandbox nunca pasa a Producción; para emitir de verdad, registra tu RUC como negocio en vivo. Esta lista asegura que, cuando la cambies, todo lo demás ya esté listo.
Tu integración maneja cada respuesta del SRI
Con simulate, prueba en Sandbox que tu sistema:
- guarda el comprobante al recibir
invoice.authorized; - muestra o registra
sri_messagesy corrige al recibirreturnedonot_authorized; - no se bloquea mientras un comprobante sigue en
submitted(delayed); - reintenta con el mismo
Idempotency-Keysi pierde una respuesta.
Tus webhooks verifican firmas y descartan duplicados
Registra un endpoint para Pruebas y otro para Producción. Cada uno tiene su propio secreto. Mira Webhooks.
Subiste tu certificado
Sube tu .p12 una vez: sirve para Pruebas y Producción. Anota cuándo vence (valid_until) y renuévalo antes.
Elegiste tu plan y pagaste
Completa el perfil de facturación del negocio con el RUC que recibe nuestra factura, elige su plan en Plan y uso, y paga el cobro que abre: Tu plan. Hasta que validamos tu primer pago el negocio no emite, ni en Pruebas ni en Producción (402 plan_limit, "Estamos revisando tu pago"), así que haz este paso pronto: la configuración, como subir el certificado y abrir la numeración, no espera. Por eso este paso va antes de emitir en Pruebas.
Emitiste en Pruebas
Una vez validado tu primer pago, con una clave fb_test_…, abre una numeración en un establecimiento abierto de tu RUC y emite algunos comprobantes reales: tus productos, tus impuestos, tus clientes. El ambiente de pruebas del SRI valida igual que Producción, sin consecuencias. Si el SRI devuelve algo, aquí es donde quieres descubrirlo.
Abriste tu numeración de Producción
Con una clave fb_live_…, abre las numeraciones de Producción. Si vienes de otro sistema, usa next_number para continuar tu secuencial donde lo dejaste.
Pasaste a Producción
En la plataforma, Emisores → Pasar a Producción muestra la lista de GET /v1/ec/entities/{id}/readiness: certificado vigente, una factura autorizada en Pruebas, numeración de facturas en Producción, las direcciones del RIDE y un plan pagado y al día. Cuando todo está listo, una persona con rol owner o admin escribe el nombre de la entidad para confirmar. Hasta entonces, una clave fb_live_… no emite nada para esa entidad (409 not_ready).
El paso es de una sola vía: no hay un botón ni un endpoint para volver a apagar Producción, porque los comprobantes reales consumen secuenciales del SRI y pueden estar en camino, y ninguna clave ni agente debería poder cortarlos. Pruebas sigue disponible antes y después, mientras tu negocio esté al día, para seguir probando junto a Producción; Sandbox, con sus negocios de práctica, es gratis para siempre. Si necesitas detener Producción para una entidad (cierras el negocio, se comprometió una clave), escríbenos al correo de soporte que muestra la plataforma.
El plan de cada negocio cubre una cantidad de comprobantes de Producción al mes, 10.000 con Launch y sin cuota con Scale; consulta cuántos lleva en GET /v1/usage. Pasado el límite de un plan con cuota, el comprobante se rechaza con 402 plan_limit antes de numerarse. Lo mismo pasa si un cobro vence sin pagarse: el negocio deja de emitir hasta que pagues, pero sus comprobantes y datos siguen disponibles.
Cambiaste la clave
Pon la clave fb_live_… en tu entorno de producción. Desde el siguiente request, cada comprobante autorizado tiene validez tributaria, le llega por correo a tu cliente y aparece en su portal.
Lo que no tienes que hacer
- Pedir autorización al SRI para usar Fiscalbase. En Ecuador no hay homologación de software: el ambiente de Pruebas existe para que confirmes, no para que el SRI te apruebe.
- Escribir leyendas obligatorias. El régimen RIMPE, las resoluciones de contribuyente especial, de agente de retención y de gran contribuyente y el RUC del proveedor de facturación los ponemos nosotros en cada comprobante.
- Guardar XML y RIDE. Guardamos cada archivo autorizado; descárgalo cuando lo necesites.
Si algo sale mal en Producción
- El SRI devolvió un comprobante: corrígelo y reenvíalo, con el mismo número.
- Autorizaste un comprobante con un error: anúlalo en SRI en línea hasta el día 7 del mes siguiente, o compénsalo con una nota de crédito. Mira Corregir, anular y compensar.
- El SRI no responde: no hagas nada. Reintentamos y seguimos consultando; tu comprobante no se pierde.
Fiscalbase para Shopify
Cada pedido pagado de tu tienda Shopify se convierte en una factura autorizada por el SRI, cada reembolso en una nota de crédito y, si lo activas, cada despacho en una guía de remisión.
Planes y precios
Sandbox es gratis. Cada negocio en vivo paga un plan mensual y ve siempre el precio final con IVA.