Consumo es el uso de recursos (procesamiento e IA), pagado en créditos. Las cuotas son los límites que aplica cada plan. Este es el panel financiero-operacional del workspace.
Conceptos#
- Créditos de uso: saldo en R$ que cubre el consumo de nube (queries en el procesamiento, egress de IA).
- Franquicia mensual: los
créditos inclusosdel plan, acreditados exactamente una vez por ciclo (YYYY-MM). - Recarga: créditos adicionales comprados (Pix), sumados al saldo.
- Entitlements: límites de recursos por plan (informes agendados, destinatarios, modos de actualización etc.).
- Guardia de costo: techo de bytes por consulta que evita factura-sorpresa.
Disponibilidad#
- Planes: todos tienen franquicia, excepto Enterprise/custom (0 créditos inclusos — contrato manda).
- Funcionamiento: franquicia, ledger y entitlements son determinísticos y están cubiertos por pruebas automáticas.
Entitlements por plan#
| Entitlement | Starter | Growth | Business | Scale | Enterprise |
|---|---|---|---|---|---|
| Informes con agenda activa | 1 | 10 | ilimitado* | ilimitado* | ilimitado* |
| Destinatarios por informe | 3 | 10 | 50 | 200 | 200 |
| Narrativa ejecutiva por IA | — | ✓ | ✓ | ✓ | ✓ |
| PDF adjunto en el informe | — | — | ✓ | ✓ | ✓ |
| Alertas inteligentes | — | — | ✓ | ✓ | ✓ |
| Modos de actualización | batch | batch | batch, near_rt | batch, near_rt | batch, near_rt |
| Cadencia de la ingesta | lote diario | lote diario | lote, micro-lote (5/15 min) | lote, micro-lote (5/15 min) | lote, micro-lote (5/15 min) |
* "ilimitado" = tope muy alto (999) en la práctica. Modo en vivo (rt) solo con
nube propia (BYOC), fuera del plan.
Permisos#
- Administrar créditos/recargas/plan exige owner (
billing.manage). - Ejecutar acciones que consumen (query, refresh, IA, export, informe) exige rol y permisos finos adecuados — ver Usuários e permissões.
Configuración#
- Acompanhe saldo e extrato em Custos / Consumo.
- La franquicia se acredita automáticamente por ciclo (webhook de pago + red de seguridad por cron diario).
- Recargue créditos vía Pix cuando quiera margen por encima de la franquicia.
- Ajuste los entitlements cambiando de plan.
Validación#
- El extracto distingue franquia (
franquia:<ws>:<ciclo>) de recarga (id del pago) y de storage — cada uno en su bucket. - La franquicia es idempotente: reprocesar el mismo ciclo no acredita dos veces.
- El ledger de IA es atómico (reserva → liquidación): el consumo nunca "fuga" el tope.
Ejemplo#
El Comercio Aurora (Growth) recibe R$ 150 de franquicia al inicio del ciclo. Al ejecutar pipelines y preguntas de IA, el consumo se debita del saldo. En un mes pico, María recarga otros R$ 300 (Pix) — el extracto muestra "Franquia mensal do plano Growth — ciclo 2026-09" y la recarga por separado.
Costo#
- Acompañar consumo/quotas: R$ 0.
- El consumo real (procesamiento/IA) debita créditos. Los valores en R$ mostrados antes de la ejecución son estimaciones; el valor cobrado es el de la factura.
- El techo de volumen por consulta limita el costo por consulta.
Seguridad#
- Ledger de IA atómico + rate limit fail-closed: sin crédito, el recurso rechaza (no funciona "a oscuras").
- Budgets por workload son advisory y fail-closed — la plataforma nunca cambia el modo de ejecución sola.
- El consumo es auditado por workspace.
Límites#
- Advisor y budgets orientan el uso en volúmenes grandes; el tiempo de respuesta depende del volumen y de la consulta.
- Sin expiración/rollover de franquicia hoy: la franquicia se suma al saldo único.
- Sin prorrateo de upgrade a mitad del ciclo (ciclo ya concedido no se recalcula).
/api/v1(REST/OData) tiene rate limit fail-closed por clave y por workspace. La API de consulta REST está en acceso anticipado y todavía no está abierta para uso externo.
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Acción costosa bloqueada | saldo de créditos de uso agotado | recargue créditos (Pix) |
| "Limite de uso de IA deste mês foi atingido" | tope mensual de IA del workspace (por defecto R$ 50/mes; en cero = sin tope) | hable con el administrador — es otro control: recargar créditos no eleva el tope, que se reinicia al cambio de mes |
| Franquicia no apareció | ciclo no procesado / plan sin créditos | espere el cron; Enterprise no tiene franquicia self-service |
| Consulta cortada por costo | alcanzó el tope de volumen por consulta | reduzca el alcance de la consulta |
| Límite de destinatarios | tope del plan por informe | actualice el plan o reduzca destinatarios |
Próximos pasos: Suspensión y morosidad.