Relatórios
Oito relatórios que respondem às perguntas do dia a dia da gestão. Todos com filtros, comparação com o período anterior e exportação.
Quem pode acessar
reports.view— abre o menu e o hub de relatórios.- Cada relatório tem a sua própria permissão, validada no servidor.
O hub mostra apenas os relatórios a que você tem acesso. Se você abrir um endereço direto sem permissão, a tela carrega e informa que não há acesso ao buscar os dados.
Os oito relatórios
| Relatório | Responde | Permissão | Âncora de data |
|---|---|---|---|
| Vendas e Receita | Quanto entrou, por canal e por período. | reports.revenue.view sensível | Data da compra |
| Ocupação / Check-in | Quantos ingressos foram gerados e quantos entraram. | reports.occupancy.view | Data da visita |
| Vouchers | Ingressos emitidos, por status e tipo. | reports.vouchers.view | Emissão (e ocorrência para “gerados”) |
| Comissões de Promotores | Quanto cada promotor vendeu e quanto tem a receber. | reports.promoters.view sensível | Data da compra |
| Descontos e Cortesias | Quanto foi concedido em desconto e cortesia. | reports.discounts.view | Data da compra |
| Uso de Cupons | Quais códigos foram usados e por quem. | reports.coupons.view | Data da compra |
| Caixa / Pagamentos PDV | Conferência do caixa e dos recebimentos do balcão. | reports.pos_cash.view sensível | Data do pagamento |
| Pagamentos por máquina | Conciliação por maquininha. | reports.pos_cash.view | Data do pagamento |
O relatório de Pagamentos por máquina não tem permissão própria: ele reaproveita a do relatório de Caixa. Quem enxerga um, enxerga o outro.
Estrutura comum das telas
- Seletor de período com atalhos de intervalo, guardado por empresa durante a sessão.
- Cartões de comparação: métrica no período atual × período anterior, com a variação.
- Tabela com os dados detalhados.
- Exportar: CSV, Excel e PDF, com aviso quando o volume for grande.
Como funciona a comparação de período
O sistema compara com a janela de mesmo tamanho imediatamente anterior, terminando no dia anterior ao início do período escolhido. Sete dias comparam com sete; um mês de 31 dias compara com os 31 dias anteriores. Quando o valor anterior é zero, a variação percentual aparece como “—”.
Regras de negócio dos números
Receita
- Bruto = vendas pagas, excluindo cortesias.
- Cancelado/estornado = valor das vendas canceladas e reembolsadas.
- Líquido = bruto menos cancelado. Não desconta taxa de operadora nesta fase.
- Cortesia fica fora da receita, mas aparece no relatório de Descontos e Cortesias com o valor de tabela.
Canal da venda
O canal é decidido nesta ordem: cortesia → promotor → PDV → online.
Fuso
Todas as datas de compra usam o fuso do parque (padrão America/Sao_Paulo).
Exportação
- CSV — para planilhas e importação em outros sistemas.
- Excel — mantém formatação; o relatório de Caixa exporta em várias abas, incluindo uma com todas as transações do PDV.
- PDF — para envio e arquivo.
A exportação usa exatamente as linhas já filtradas — nunca inclui dados de outra empresa.
Erros e dúvidas comuns
| Situação | Motivo | Solução |
|---|---|---|
| Relatório abre com “sem permissão” | Falta a permissão específica daquele relatório | Solicitar ao administrador |
| Receita diferente do total de vendas | Cortesias excluídas e cancelamentos descontados | Comparar bruto, cancelado e líquido separadamente |
| Ocupação não bate com o dia | O relatório usa a data da visita, não a da compra | Ajustar o período pela data de ocorrência |
| Não encontro o filtro por código de cupom | O filtro existe no servidor, mas não está exposto na tela | Exportar e filtrar na planilha |
| Exportação demorando | Volume grande de linhas | Reduzir o período |
Boas práticas
- Feche o mês sempre com o mesmo relatório, para manter o critério.
- Ao comparar temporadas, prefira o widget de comparação anual do dashboard.
- Conceda os relatórios sensíveis (receita, comissões, caixa) apenas a quem precisa.
- Guarde as exportações mensais: elas são o retrato congelado daquele fechamento.