Quantos relatórios/destinatários o plano permite

Selo de estado: Preview (teto atual do produto) · Curso ACD-420 — Analista de IA: relatórios, alertas, anomalias e previsões · Aula 9 de 9 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai planejar distribuição dentro do plano — sem descobrir o teto no meio da criação de um relatório.

Vídeo#

Identificador no manifesto: acd-420-09-entitlements-de-relatorios · duração-alvo 5 min · tela do produto: /relatorios.

Roteiro de gravação (4 capítulos):

#	Minutagem-alvo	Capítulo	Tela do produto
1	0:00–0:45	Abertura: título + selo `Preview`. A diferença entre consumo (créditos) e quota (entitlement do plano).	`/relatorios`
2	0:45–2:15	A tabela por plano: relatórios com agenda ativa, destinatários por relatório, narrativa, PDF, alertas inteligentes.	`/relatorios/novo`
3	2:15–3:45	O que conta para o teto de agenda (e o que não conta); as mensagens exatas de recusa.	`/relatorios/novo`
4	3:45–5:00	Franquia mensal, recarga e guarda de custo; como planejar a distribuição. Encerramento com a checagem.	Custos / Consumo

Conteúdo#

Duas coisas diferentes: consumo e quota

Consumo é uso de recursos — BigQuery e IA — pago em créditos. Quota (ou entitlement) é um limite de recursos que o plano aplica: quantos relatórios com agenda ativa, quantos destinatários por relatório, se a narrativa de IA existe, se o PDF anexo existe. São eixos independentes: você pode ter crédito sobrando e bater no teto de destinatários, ou caber folgado nas quotas e ficar sem crédito. Entitlements são determinísticos e provados por teste.

A tabela que importa para este curso

Entitlement	Starter	Growth	Business	Scale
Relatórios com agenda ativa	1	10	ilimitado*	ilimitado*
Destinatários por relatório	3	10	50	200
Narrativa executiva por IA	—	✓	✓	✓
PDF anexo no relatório	—	—	✓	✓
Alertas inteligentes	—	—	✓	✓
Modos de atualização	batch	batch, near_rt	batch, near_rt	batch, near_rt

* "ilimitado" é um teto muito alto (999) na prática. O modo ao vivo (rt) só existe com nuvem própria (BYOC), fora do plano.

Duas leituras práticas: a narrativa das Aulas 1 e 2 começa no Growth; os alertas inteligentes da Aula 4 e o PDF anexo começam no Business. O alerta por visual no painel também é do plano Business+. Já a anomalia (Aula 6) e a previsão (Aula 7) são configuração de visualização do painel: não consomem orçamento de IA nem passam por entitlement de IA.

O que conta para o teto, e o que não conta

Este é o detalhe que decide o seu planejamento:

O teto de relatórios com agenda ativa conta apenas os relatórios que estão ativos e têm agenda. Um relatório pausado não conta. Um relatório com frequência Manual (sem agenda) não conta — você pode ter muitos deles e executá-los com Executar agora.
O teto de destinatários por relatório soma e-mail + WhatsApp. Dois e-mails e um número são três destinatários.
A verificação acontece na criação e na edição, no servidor. Não é dica de interface: é recusa.

As mensagens que você vai ver:

Situação	Mensagem
Destinatários acima do teto	"Seu plano permite até N destinatários por relatório."
Agenda acima do teto	"Seu plano permite até N relatório(s) agendado(s). Faça upgrade para agendar mais."
Alerta inteligente fora do plano	"Alertas inteligentes estão disponíveis no plano Business."

Estratégia para o plano Starter

Com 1 relatório agendado e 3 destinatários, a saída não é desistir: use um relatório semanal agendado com as consultas que importam, e mantenha os demais como Manual (sem agenda), executados sob demanda. Quem precisa dos números e não cabe nos 3 destinatários acessa o snapshot em /r/<slug>.

Consumo, franquia e guarda de custo

Além das quotas, cada execução gasta: o relatório roda consultas no BigQuery e, quando a narrativa está ligada, gasta créditos de IA.

A franquia mensal do plano é creditada exatamente uma vez por ciclo (AAAA-MM) e é idempotente — reprocessar o mesmo ciclo não credita duas vezes. Enterprise/custom não tem franquia self-service: o contrato manda.
A recarga (Pix) soma ao saldo quando você quer folga acima da franquia. Franquia e recarga aparecem separadas no extrato.
O orçamento de IA usa um ledger atômico de reserva → liquidação: o consumo nunca "vaza" o teto, e ao acabar o crédito o recurso recusa (fail-closed) em vez de seguir no escuro. O teto mensal padrão de gasto com IA é por workspace.
A guarda de custo (maximumBytesBilled) limita os bytes por consulta — é o que evita fatura-surpresa.
Gerir créditos, recargas e plano exige papel owner; criar e editar relatório também é do dono do workspace.

O valor em reais é projeção

O BRL faturado é uma projeção: a medição de custo e de escala em nuvem ainda não foi certificada. Use o número para comparar ordens de grandeza, não para fechar contabilidade.

Exemplo Aurora

A Aurora está no Growth: até 10 relatórios agendados, 10 destinatários por relatório, narrativa de IA incluída, sem PDF anexo e sem alertas inteligentes. maria planeja assim:

Relatório	Agenda	Destinatários	Conta no teto?
Semanal Aurora	segunda, 8h	4 (3 e-mails + 1 WhatsApp)	sim
Diário de ruptura	diário, 7h	2	sim
Fechamento mensal	mensal, dia 1	6	sim
Auditoria de preços	`Manual (sem agenda)`	2	não
Trimestral do conselho	pausado	8	não

Três relatórios contam para o teto de 10 — sobra folga. Quando maria tentou colocar 12 destinatários no fechamento mensal, recebeu "Seu plano permite até 10 destinatários por relatório." e resolveu com 9 destinatários + o link /r/<slug> para o resto. E quando quis anexar o PDF, descobriu que isso é Business+.

Erros comuns

Erro	Por que é erro
Contar relatórios pausados no teto de agenda	só contam os ativos com agenda
Esquecer que WhatsApp soma no teto de destinatários	o limite é e-mail + WhatsApp somados
Descobrir o teto no fim do wizard	o contador "N de M no plano X" está na etapa de destinatários
Esperar alerta inteligente no Growth	é Business+
Tratar o BRL projetado como fatura	custo em nuvem não certificado
Esperar pro-rata ao fazer upgrade no meio do ciclo	o ciclo já concedido não recalcula
Esperar que a franquia acumule	não há expiração nem rollover: a franquia soma ao saldo único

Estado e gates

Franquia, ledger de IA e entitlements por plano são GA-candidato na matriz de capacidades — determinísticos e provados por teste. O teto do produto continua Preview: escala real (10M/100M/1B linhas) e custo faturado em BRL não foram medidos em produção. A franquia retroativa em produção é gate humano. E, somando com as aulas anteriores: a entrega real de e-mail e de WhatsApp também é gate humano.

Faça você mesmo#

Esta aula é de conhecimento: o exercício é de leitura de telas e de planejamento — nenhum passo consome orçamento de IA.

No workspace de treino Aurora Varejo, abra Custos / Consumo e identifique o plano vigente, o saldo e, no extrato, a linha de franquia do ciclo.
Abra /relatorios e conte quantos relatórios estão ativos com agenda — esse é o número que conta para o teto.
Para cada um, abra o detalhe e conte os destinatários, somando e-mail e WhatsApp.
Monte uma tabela como a do exemplo: relatório · agenda · destinatários · conta no teto?
Em /relatorios/novo, vá até a etapa Destinatários e leia o contador "N de M no plano X"; tente adicionar um a mais que o teto e anote a mensagem exata da recusa.
Na etapa Analista de IA, verifique se a narrativa e os alertas inteligentes estão disponíveis no seu plano — anote o selo "Fora do plano" quando aparecer.
Escreva o seu plano de distribuição: quais relatórios ficam agendados, quais ficam Manual (sem agenda) e quem acessa pelo snapshot /r/<slug> em vez de receber o envio.

Você terminou quando você tiver a sua tabela de relatórios com a coluna "conta no teto?" preenchida corretamente e souber dizer, sem consultar, quantos destinatários o seu plano permite por relatório.

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

administracao/consumo-e-quotas

Capacidades ensinadas#

C00.6 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".