Qué pasa cuando la suscripción queda atrasada, y por qué. La regla vive en un solo lugar (la verificación central de acceso) y es predecible: las acciones costosas se bloquean, la lectura barata continúa.
Conceptos#
- Acción costosa: consume dinero/recursos. Son cinco: actualización manual
(
refresh_manual), ejecución/envío de informes (report_run), consultas vía API (api_query), exportación (export) y recursos de IA (ia). - Lectura barata: ver un dashboard/snapshot ya materializado — nunca se bloquea (sirve datos listos, sin costo de procesamiento para el dueño).
- Dos señales de cobro: el estado local (del proveedor de pagos) y la central udiApps (contrato del producto).
Cómo decide la verificación (orden)#
- Estado local en
past_due,suspendedocanceled⇒ bloquea las acciones costosas (HTTP 402). Basta con la señal local; ni siquiera consulta la central. - Si no, la central udiApps con
allowed: false⇒ bloquea (suspendido → 402; sin contrato → 403). - Fail-open solo cuando no hay ninguna señal: estado local no negativo
(
active,inactive,pending) y central sin respuesta.inactive/pendingno bloquean a propósito — es el default de un workspace nuevo/de prueba. - La lectura barata nunca se bloquea (dashboard público/snapshot).
- La navegación en la app continúa: el moroso necesita navegar hasta Planes para pagar — por eso la navegación no se corta; solo las acciones costosas quedan bloqueadas en cada punto de ejecución.
Disponibilidad#
- Planes: todos (la verificación es núcleo de seguridad y cobro).
- Funcionamiento: fail-closed, cubierto por pruebas automáticas.
Permisos#
- Regularizar el pago (acceder a Planes, pagar) exige el owner
(
billing.manage). - El bloqueo de acciones costosas vale para todos los miembros del workspace, sin importar el rol.
Mensajes que ve el usuario (se muestran en portugués de Brasil; aquí traducidos)#
| Situación | HTTP | Mensaje (resumen) |
|---|---|---|
Pago atrasado (past_due) | 402 | "Suscripción con pago atrasado — [acción] bloqueada hasta regularizar. Accede a Planes." |
Suspendida (suspended) | 402 | "Suscripción suspendida — [acción] bloqueada hasta regularizar." |
Cancelada (canceled) | 402 | "Suscripción cancelada — [acción] bloqueada. Accede a Planes para reactivarla." |
| Sin contrato activo | 403 | "Workspace sin contrato activo del producto — [acción] no disponible. Habla con el área comercial." |
| Workspace inexistente | 403 | "Workspace no encontrado — acceso denegado." |
Validación#
- Las acciones costosas devuelven 402/403 con un mensaje listo; la lectura del dashboard sigue en el aire.
- La pantalla de regularización (Planes) sigue accesible incluso con atraso.
- Después de pagar, el estado vuelve a
activey las acciones costosas se liberan (la central tiene una caché de ~60 s).
Ejemplo#
Comércio Aurora entra en past_due. Maria y el equipo todavía ven los
dashboards existentes (snapshot), pero no consiguen: ejecutar el refresh manual,
enviar informes, exportar, usar IA ni consultar vía API — cada intento
devuelve 402 con el enlace a Planes. Maria (owner) accede a Planes, paga por Pix y
en segundos todo vuelve a funcionar.
Costo#
- La verificación en sí no consume recursos: R$ 0.
- El objetivo es justamente contener el costo cuando la cuenta no está al día.
Seguridad#
- Regla única y fail-closed: un id de workspace inválido nunca "pasa por error".
- La API
/api/v1aplica un rate limit fail-closed (por clave y por workspace) y la verificación de suscripción antes de tocar el datalake pago. - Separar la lectura barata de las acciones costosas evita "tumbar" a quien solo consume.
Límites#
- La API de consulta REST (
/api/v1) está en acceso anticipado y todavía no está abierta para uso externo — no la uses como ruta de producción. - El fail-open es intencional y restringido al caso "ninguna señal negativa" (workspace nuevo/de prueba); no es un bypass.
- La reactivación depende de que el proveedor de pagos confirme el pago.
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Todo da 402 | suscripción atrasada/suspendida/cancelada | el owner regulariza en Planes |
| 403 en acciones costosas | sin contrato activo del producto | habla con el área comercial |
| El dashboard abre, pero no se actualiza | lectura barata ok, acción costosa bloqueada | regulariza para liberar refresh/IA/exportación |
| Pagué y sigue bloqueado | caché de la central (~60 s) | espera e intenta de nuevo |
Próximos pasos: vuelve al índice de Administración o revisa Planes y Consumo y cuotas.