Sandbox y emisor demo

Toda cuenta de Flashpi recibe un sandbox cuando su propietario verifica su correo: puede crear llaves de prueba (fp_test_...) y emitir comprobantes de prueba de inmediato con un emisor demo compartido, sin registrar un RUC ni subir un certificado de firma.

El ambiente de pruebas del SRI

Las llaves de prueba envían los comprobantes al ambiente de pruebas del SRI. Es el servicio de pruebas real del SRI, no una simulación de Flashpi:

• El SRI valida cada comprobante igual que uno de producción, y lo autoriza o rechaza con las mismas reglas.
• Los comprobantes de prueba no tienen efecto tributario. Su RIDE indica “Documento emitido en el ambiente de pruebas del SRI: no tiene validez tributaria.”, el asunto de sus correos empieza con [PRUEBAS] y el cuerpo trae un aviso, y el SRI agrega la advertencia test_environment a sus sriMessages.
• El ambiente de pruebas a veces está más lento o no disponible. Entonces los comprobantes esperan en pending_sri mientras Flashpi reintenta; consulta Ciclo de vida del comprobante.

Los datos de prueba y de producción nunca se mezclan: una llave de prueba no puede leer comprobantes de producción, ni al revés.

El emisor demo

• Es Signia Digital S.A. (RUC 0993411372001), la empresa que opera Flashpi, habilitada en el ambiente de pruebas del SRI con su propio certificado de prueba.
• Tiene el establecimiento 001 y el punto de emisión 001.
• Su ID está en el Resumen de la consola, junto a una solicitud lista para ejecutar y la cuota del día, y en Emisores, donde aparece marcado como emisor demo y no se puede modificar. GET /v1/issuers no lo lista, porque no pertenece a tu cuenta.
• Los comprobantes que emites con él pertenecen a tu cuenta: los lees, descargas su XML y su RIDE y recibes sus webhooks como cualquier otro comprobante.
• Todas las cuentas del sandbox comparten su numeración, así que tus comprobantes reciben secuenciales con saltos entre ellos.

Reglas

Regla	Qué pasa si no se cumple
Usa una llave de prueba	Una llave de producción recibe 422 validation_failed con el error de campo demo_issuer_test_only en issuerId.
Usa una llave con alcance account	Una llave de un emisor recibe 403 key_scope_mismatch.
El sandbox de la cuenta debe estar activo (el propietario verificó su correo)	403 sandbox_not_enabled
No envíes sequential	422 validation_failed con el error de campo demo_issuer_sequential_not_allowed: la numeración es compartida, así que Flashpi siempre la asigna.
Hasta 50 comprobantes al día por cuenta	429 demo_issuer_quota_exceeded, ver abajo.
El emisor demo necesita un certificado de prueba utilizable	Mientras no lo tenga, toda solicitud con él recibe 503 demo_issuer_unavailable, antes de crear nada.

La cuota diaria

Una cuenta puede emitir 50 comprobantes al día con el emisor demo. Los días siguen el calendario de Ecuador (UTC-5), así que la cuota se renueva a la medianoche de Ecuador (05:00 UTC).

• Cuenta todo comprobante creado con el emisor demo, sin importar lo que responda después el SRI (un rechazo del SRI también cuenta).
• No cuenta una solicitud que no crea nada: un error de validación, un reintento que se responde desde su Idempotency-Key o una solicitud rechazada por la propia cuota.
• El Resumen de la consola muestra cuántos usaste hoy y cuándo se renueva la cuota.

El comprobante 51 del día recibe 429 con Retry-After (los segundos que faltan para la renovación), el limit y el momento resetsAt:

{
  "type": "https://flashpi.com.ec/docs/errors/demo_issuer_quota_exceeded",
  "title": "Cuota del emisor de demostración agotada",
  "status": 429,
  "detail": "Tu cuenta ya emitió sus 50 documentos de prueba de hoy con el emisor de demostración. La cuota se renueva el 2026-10-16T05:00:00.000Z; usa tu propio emisor para emitir más.",
  "instance": "/v1/invoices",
  "code": "demo_issuer_quota_exceeded",
  "errors": [],
  "requestId": "01a1416f-0b2c-7e13-9d55-6a1c3f0e8b27",
  "limit": 50,
  "resetsAt": "2026-10-16T05:00:00.000Z"
}

Este ejemplo está en español porque la solicitud envió Accept-Language: es; consulta Errores.

Tus propios emisores en el ambiente de pruebas

La cuota solo aplica al emisor demo. Cuando creas tu propio emisor desde su certificado, las llaves de prueba emiten con tu RUC sin cuota diaria de comprobantes, igual que lo harán después las llaves de producción. Los límites de correo de los comprobantes de prueba siguen aplicando (consulta RIDE y correo).

Consejo

Usa como correo del cliente el correo con el que entras a la consola mientras pruebas: los correos de los comprobantes de prueba solo se envían a las direcciones verificadas de los miembros de tu equipo, así que te llega a ti (cuando el envío por correo esté habilitado, ver Destinatarios de los comprobantes de prueba), y ningún cliente real recibe comprobantes de prueba. A cualquier otra dirección, como las de example.com de estas guías, el correo no se envía: su entrega queda failed con el error test_recipient_not_allowed. Los rebotes de los correos de prueba también cuentan para pausar los correos del ambiente de pruebas (Correos pausados).

Del sandbox a producción

1. Crea tu emisor desde su certificado de firma .p12: Flashpi lee el RUC y el titular; revísalos y completa su perfil tributario. El emisor queda con el establecimiento 001 y el punto de emisión 001; agrega los demás que tengas.
2. Espera a que su certificado esté accepted. Sirve para pruebas y producción, así que puedes probar primero con tus datos y luego emitir con efecto tributario sin subirlo de nuevo.
3. Un propietario de la cuenta crea una llave de producción (fp_live_...) en la consola, y confirma con el código de su app de autenticación.
4. Envía las mismas solicitudes con la llave de producción y tu issuerId.