Límites
Solicitudes
Sección titulada «Solicitudes»| Límite | Valor |
|---|---|
| Cuerpo JSON de la solicitud | 1 MB. Un cuerpo más grande recibe 413 payload_too_large. |
| Carga del certificado | Un archivo .p12 de máximo 1 MiB y una contraseña de máximo 1024 bytes, también en el alta desde el certificado. |
| Alta desde el certificado | Se completa dentro de 6 días; después vence (409 issuer_onboarding_expired). Se elimina 30 días después de completarse, vencer o rechazarse (luego 404). |
| Tamaño de página de las listas | De 1 a 100 elementos, 20 por defecto. |
Idempotency-Key |
De 1 a 255 caracteres ASCII visibles, recordada durante 24 horas. |
X-Correlation-Id |
De 1 a 128 letras, dígitos y - _ . : / + =. |
| Espera del modo síncrono | 15 segundos por defecto, 30 como máximo. |
Comprobantes
Sección titulada «Comprobantes»| Límite | Valor |
|---|---|
| Líneas de una factura, nota de crédito o liquidación de compra | De 1 a 1000 |
| Impuestos de una línea | Un IVA, más un ICE ad valorem en facturas y notas de crédito |
Detalles adicionales de una línea (additionalDetails) |
3 |
| Pagos de un comprobante | De 1 a 50 |
| Motivos de una nota de débito | De 1 a 100 |
| Documentos de sustento de un comprobante de retención | De 1 a 50, con 1 a 20 retenciones cada uno |
| Destinatarios de una guía de remisión | De 1 a 100, con 1 a 1000 bienes cada uno |
Campos adicionales (additionalInfo) |
15 por comprobante, contando las leyendas que agrega Flashpi; 300 caracteres por valor |
| Campos de texto (descripciones, nombres, direcciones) | 300 caracteres, en una sola línea, sin emojis |
| Montos | Hasta 12 dígitos y 2 decimales |
| Cantidades y precios unitarios | Hasta 12 dígitos y 6 decimales |
| Secuencial | De 1 a 999.999.999 por serie |
| XML sin firmar | 304 KiB, para que el comprobante firmado no supere los 320 KB del SRI (422 document_too_large) |
Sandbox y correo
Sección titulada «Sandbox y correo»| Límite | Valor |
|---|---|
| Comprobantes con el emisor demo compartido | 50 al día por cuenta (429 demo_issuer_quota_exceeded) |
| Destinatarios del correo de un comprobante de prueba | Solo las direcciones verificadas de los miembros del equipo de la cuenta (409 test_recipient_not_allowed, ver Destinatarios de los comprobantes de prueba) |
| Reenvíos del correo de un comprobante de prueba | 3 al día (429 email_resend_limit_reached) |
| Correos al comprador por cuenta, comprobantes de prueba | 20 al día (429 account_email_limit_reached) |
| Reenvíos del correo de un comprobante de producción | 10 al día |
| Correos al comprador por cuenta, comprobantes de producción | 200 al día |
| Correos al comprador de toda la plataforma, todas las cuentas y ambientes juntos | Un límite diario común, sin cifra publicada (429 platform_email_limit_reached) |
| Rebotes y quejas antes de que se pausen los correos de la cuenta, por ambiente | 3 rebotes permanentes y el 3 % de los correos enviados, o 2 quejas por spam y el 0,05 %, en 7 días (Correos pausados) |
Los días siguen el calendario de Ecuador (UTC-5), así que estos conteos se reinician a la medianoche de Ecuador (05:00 UTC). Todo 429 trae Retry-After y resetsAt, y todos menos platform_email_limit_reached traen también el limit. Los límites de correo de producción por cuenta son valores por defecto que Flashpi puede aumentar para una cuenta. Consulta Sandbox y RIDE y correo.
API keys
Sección titulada «API keys»| Límite | Valor |
|---|---|
| Lista de IP permitidas de una llave | 20 direcciones IPv4 o IPv6 o rangos CIDR |
Webhooks
Sección titulada «Webhooks»| Límite | Valor |
|---|---|
| Tiempo para responder una entrega | 10 segundos |
| Reintentos de una entrega fallida | Durante 72 horas, máximo 13 intentos |
| Intentos de verificación | 4 (de inmediato, y luego a los 1, 5 y 30 minutos) |
| Tipos de evento por endpoint | De 1 a 100, o * |
| URL del endpoint | 2048 caracteres, HTTPS pública |
| Superposición del secreto anterior después de una rotación | 24 horas por defecto, de 0 a 168 |
Procesamiento en el SRI
Sección titulada «Procesamiento en el SRI»| Límite | Valor |
|---|---|
| Ventana de envío: cuánto tiempo Flashpi sigue intentando enviar un comprobante mientras el SRI no responde | 72 horas desde su creación (luego failed, sri_unavailable) |
| Ventana de autorización: cuánto tiempo Flashpi espera la decisión del SRI | 72 horas (luego failed, sri_authorization_timeout) |
Consola
Sección titulada «Consola»| Límite | Valor |
|---|---|
| Request logs | Se guardan 30 días |
| Sesión de la consola | 12 horas, y termina después de 2 horas sin actividad |