Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Suspensión y morosidad

En esta página (11)

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)#

  1. Estado local en past_due, suspended o canceled ⇒ bloquea las acciones costosas (HTTP 402). Basta con la señal local; ni siquiera consulta la central.
  2. Si no, la central udiApps con allowed: false ⇒ bloquea (suspendido → 402; sin contrato → 403).
  3. Fail-open solo cuando no hay ninguna señal: estado local no negativo (active, inactive, pending) y central sin respuesta. inactive/ pending no bloquean a propósito — es el default de un workspace nuevo/de prueba.
  4. La lectura barata nunca se bloquea (dashboard público/snapshot).
  5. 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ónHTTPMensaje (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 activo403"Workspace sin contrato activo del producto — [acción] no disponible. Habla con el área comercial."
Workspace inexistente403"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 active y 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/v1 aplica 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íntomaCausa probableQué hacer
Todo da 402suscripción atrasada/suspendida/canceladael owner regulariza en Planes
403 en acciones costosassin contrato activo del productohabla con el área comercial
El dashboard abre, pero no se actualizalectura barata ok, acción costosa bloqueadaregulariza para liberar refresh/IA/exportación
Pagué y sigue bloqueadocaché 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.

Enlaces relacionados