Conteúdo: Relatório (PDF / Excel)

O bloco de Relatório exporta um conjunto detalhado de dados como PDF ou planilha Excel (.xlsx), anexado à entrega do alerta. É a opção certa quando o destinatário precisa auditar, filtrar manualmente ou trabalhar em cima dos dados.

TIP

Pense em Relatório como a "versão para impressão" do alerta: cabe nuance, tabela detalhada, granularidade que não dá pra mostrar inline numa mensagem.

---

Estrutura do Bloco

Campo	Descrição
Aplicação	Aplicação de onde vêm os dados
Campos	Colunas a incluir no relatório (escolhidas no seletor)
Filtros	Editor de filtros para segmentar as linhas
Ordenação	Coluna(s) de ordenação + direção (Crescente/Decrescente)
Enviar como PDF	Checkbox
Enviar como XLSX	Checkbox
Esconder filtros aplicados	Checkbox: não mostra a seção "Filtros Aplicados" no PDF

Você pode marcar PDF e XLSX ao mesmo tempo, o destinatário recebe os dois anexos.

---

Campos (Colunas)

Para cada campo, você escolhe:

• A coluna (selecionada no seletor de colunas da aplicação)
• A agregação quando aplicável (Soma, Média, Contagem, Máximo, Mínimo, Contagem Distinta)
• A granularidade para colunas de data (Dia, Mês, Ano, etc.)

Exemplo: "Vendas por cliente, agregado por dia"

Campo	Tipo
Data	Granularidade: Dia
Cliente	Dimensão
Valor	Soma
Margem	Média

Resultado: tabela com 1 linha por (data, cliente) com soma de valor e média de margem.

---

Filtros

Mesmo editor de filtros usado em dashboards e bookmarks. Filtros condicionam o que entra na tabela.

Exemplo de filtros possíveis:

• "Data está entre Ontem e Ontem"
• "Vendedor é um de: João, Maria"
• "Margem é maior que zero"

Os filtros são montados visualmente, sem código.

---

Ordenação

Múltiplas colunas com direção independente:

• 1ª: Valor (Soma), Decrescente (maior valor primeiro)
• 2ª: Cliente, Crescente (alfabético como desempate)

---

Formato PDF

Quando "Enviar como PDF" está marcado:

• Cabeçalho com nome do alerta e data/hora do disparo
• (opcional) Seção "Filtros Aplicados", que pode ser escondida com "Esconder filtros aplicados"
• Tabela com até N páginas (depende do volume)
• Rodapé com numeração de página

WARNING

Relatórios com milhares de linhas geram PDFs grandes. Considere usar filtros mais restritivos ou exportar apenas em XLSX (melhor para análise).

---

Formato XLSX

Quando "Enviar como XLSX" está marcado:

• Uma planilha única com cabeçalho + linhas de dados
• Cada coluna tipada (números como número, datas como data) para facilitar filtros/pivot do destinatário
• Sem limite explícito de linhas a nível de formato (limite real é o de processamento do servidor)

---

Esconder Filtros Aplicados

Em alguns cenários, mostrar a lista de filtros aplicados no topo do PDF é redundante (o destinatário já sabe o contexto pelo título do alerta) ou confidencial (filtros revelam regras internas).

Marcando "Esconder filtros aplicados":

• PDF não mostra a seção de filtros
• Conteúdo da tabela é o mesmo

---

Cenários Comuns

Fechamento Diário de Vendas

Campos: filial, vendedor, valor (Soma), ticket médio (Média)
Filtros: data = Ontem
Ordenação: valor (Soma), Decrescente
PDF: sim
XLSX: sim

PDF pra impressão + XLSX pro time financeiro filtrar/pivotar.

Top Clientes do Mês

Campos: cliente, valor (Soma), quantidade de pedidos (Contagem)
Filtros: data = Mês Atual
Ordenação: valor (Soma), Decrescente
PDF: sim
XLSX: não

Só PDF, relatório executivo direto.

Auditoria de Estorno

Campos: data (Dia), vendedor, motivo, valor (Soma)
Filtros: tipo = "estorno", data entre Últimos 7 dias
Ordenação: data, Decrescente
XLSX: sim
PDF: não
Esconder filtros aplicados: sim

Só XLSX, auditor vai filtrar/agrupar do jeito que precisa. "Esconder filtros aplicados" evita mostrar a regra de estorno no cabeçalho.

---

Limites

Limite	Valor
Linhas por relatório	Sem cap explícito, processamento pode demorar para mais de 100.000 linhas
Tamanho de anexo (PDF/XLSX)	100 MB (WhatsApp/Telegram), Email depende do SMTP
Geração paralela	Workers de exportação processam em fila, picos podem atrasar entrega

NOTE

Se o relatório está demorando muito, verifique se você está usando agregações (Soma, Média) em vez de pegar a tabela bruta. Granularidade alta + sem agregação = volume de linhas explodindo.

---

Quando Usar (e Quando Não)

✅ Use Relatório quando:

• Destinatário precisa manipular os números (filtrar, somar diferente, copiar pra outra ferramenta)
• O volume de dados não cabe num texto
• Auditoria/compliance exige documento estruturado e rastreável
• O canal suporta anexo (Email, WhatsApp, Telegram, Webhook URL)

❌ Não use quando:

• O valor pode ser passado num texto curto. Use Texto com variável.
• O destinatário quer ver visualmente. Use Gráfico ou ative gráficos nos prompts da IA.
• Você quer interpretação, não dados crus. Use IA.

---

Próximos Passos

• Combine com Texto introdutório ou IA analítica
• Configure os canais de entrega que suportam anexo