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 API key, 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. Te avisamos por correo y en la campana antes de que venza (valid_until), para que subas el nuevo a tiempo.
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 confirmamos tu primer pago el negocio no emite, ni en Pruebas ni en Producción (402 plan_limit con el código first_payment_pending), 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 confirmado tu primer pago, con una API key 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 API key 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 consola, Negocio y luego 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 propietaria o administradora toca Cambiar a Producción y escribe el nombre de la entidad para confirmar. Hasta entonces, una API key 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 API key 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 API key), escríbenos al correo de soporte que muestra la plataforma.
El plan de cada negocio incluye 500 comprobantes de Producción al mes y, sobre ellos, cobra cada uno al precio del volumen que alcanza el mes; consulta cuántos lleva y en qué volumen está en GET /v1/usage. Solo el tope de gasto que pongas rechaza un comprobante 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 API key
Pon la API key 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 Scale, un plan mensual con 500 comprobantes incluidos y un precio por comprobante que baja con tu volumen.