Painel de Faturamento
Descrição
O Painel de Faturamento é o relatório financeiro mais completo do sistema. Ele consolida, em uma única tela, todas as informações financeiras e operacionais de um período selecionado: receitas de estadias e planos, despesas, detalhamento por modalidade de pagamento, por parceiro, por local, distribuição horária, classificação de estadias e muito mais.
O painel é gerado de forma assíncrona — o sistema executa mais de 50 consultas ao banco de dados dentro de uma única transação para garantir consistência dos dados.
Como Acessar
Permissão Necessária
RBAC: :faturamento → :index
Parâmetros de Entrada
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Data/Hora Início | DateTime | Sim | Início do período a ser analisado. Horários são interpretados no fuso horário configurado da garagem (parâmetro garagem.time_zone). |
| Data/Hora Fim | DateTime | Sim | Fim do período a ser analisado. |
Fluxo de Geração
- O operador seleciona a data/hora de início e fim e confirma
- O sistema valida as datas e inicia a geração em processo assíncrono (background)
- Enquanto processa, a interface exibe indicador de carregamento
- Todas as consultas são executadas dentro de uma única transação no PostgreSQL, garantindo que os números sejam consistentes entre si
- O fuso horário é configurado localmente na transação (
SET LOCAL timezone) para que todas as comparações de data respeitem o fuso da garagem - Ao concluir, a interface é atualizada automaticamente com todos os dados
Opções de Configuração
O comportamento do painel é controlado por dois parâmetros do sistema:
1. Incluir Plano na Carência
- Parâmetro:
configuracao.relatorio→incluir_plano_na_carencia - Padrão:
false - O que faz: Controla se estadias de clientes com contrato de plano que saíram sem faturamento são contadas como "carência".
- Quando
false(padrão): Apenas estadias de clientes rotativos (sem plano) que saíram sem pagar são contadas como carência. Estadias de clientes com plano que saíram sem faturamento são consideradas parte normal do plano. - Quando
true: Todas as estadias sem faturamento são contadas como carência, incluindo as de clientes com plano. Útil para garagens que querem visibilidade sobre quantas saídas gratuitas de plano ocorreram.
- Quando
2. Estadias Detalhadas
- Parâmetro:
painel.faturamento.estadias_detalhadas→ativo - Padrão:
false - O que faz: Controla o nível de detalhamento do resumo de estadias.
- Quando
false(padrão): Exibe um único bloco "Resumo das Estadias" com totais gerais. - Quando
true: Exibe três blocos separados: Resumo Geral, Resumo das Estadias Rotativas e Resumo das Estadias de Plano. Cada bloco mostra os números separadamente, permitindo comparar a operação rotativa com a operação de planos.
- Quando
Seções do Painel
O painel é composto pelas seguintes seções, descritas em detalhe abaixo:
- Resumo das Estadias
- Resumo Financeiro
- Classificação por Tipo de Permanência
- Documentos Fiscais
- Faturamento por Parceiro
- Faturamento por Plano
- Faturamento por Modalidade de Pagamento
- Faturamento por Local
- Distribuição Horária (Entradas e Saídas)
- Distribuição por Status da Estadia
- Utilização de Chaves Mestras
- Estadias por Parceiro
- Estadias por Plano
- Estadias com Prisma
- Entradas por Via
- Saídas por Via
1. Resumo das Estadias
Apresenta os números operacionais do período selecionado.
| Métrica | Descrição | Como é Calculada |
|---|---|---|
| Pátio Anterior | Quantidade de veículos que já estavam estacionados quando o período começou. São veículos que entraram antes da data/hora de início e ainda não tinham saído naquele momento. | Estadias onde entrada_solicitada_em < início do período E (saída_confirmada_em ≥ início do período OU saída_confirmada_em é nulo, ou seja, ainda estão lá). |
| Entradas Confirmadas | Quantidade de veículos que entraram durante o período. | Estadias onde entrada_solicitada_em está dentro do período E o status é de estadia válida (não cancelada). |
| Entradas Canceladas | Quantidade de entradas que foram canceladas durante o período. | Estadias com status de cancelamento (pelo cliente, manual ou automático) onde a solicitação de entrada ocorreu no período. |
| Saídas Confirmadas | Quantidade de veículos que saíram durante o período. | Estadias onde saída_confirmada_em está dentro do período E status = saída_confirmada. |
| Sobra de Pátio | Quantidade de veículos que permaneceram no estacionamento ao final do período. São veículos que entraram até o fim do período mas não saíram. | Estadias com status de estadia válida onde entrada_solicitada_em ≤ fim do período E (saída_confirmada_em > fim do período OU saída_confirmada_em é nulo). |
Modo Detalhado (estadias_detalhadas = true): Cada uma dessas métricas é apresentada em três blocos separados:
- Geral: Todos os veículos
- Rotativas: Apenas veículos sem contrato de plano (
entrada_plano_contrato_idé nulo) - Planos: Apenas veículos com contrato de plano (
entrada_plano_contrato_idpreenchido)
Relação com o estacionamento: Esses números permitem ao gestor entender o volume operacional — quantos veículos entraram, saíram e quantos ficaram. A fórmula de conferência é: Pátio Anterior + Entradas Confirmadas - Saídas Confirmadas = Sobra de Pátio (aproximadamente, desconsiderando cancelamentos e re-entradas).
2. Resumo Financeiro
Apresenta o resultado financeiro consolidado do período.
| Métrica | Descrição | Como é Calculada |
|---|---|---|
| Faturamento de Estadias | Receita total proveniente de pagamentos de estacionamento rotativo. | Soma de todos os EstadiaFaturamentoModalidade.valor onde registrado_em está dentro do período. Inclui pagamentos em dinheiro, cartão, PIX, etc. |
| Faturamento de Planos/Contratos | Receita total proveniente de pagamentos de mensalidades e planos. | Soma de todos os PlanoContratoFaturamentoModalidade.valor onde registrado_em está dentro do período. |
| Receitas | Receitas manuais registradas no período (ex: venda de produtos, serviços adicionais). | Soma de ReceitaDespesa.valor onde tipo = receita, status = ativo e registrado_em dentro do período. |
| Despesas | Despesas manuais registradas no período (ex: compra de materiais, manutenção). | Soma de ReceitaDespesa.valor onde tipo = despesa, status = ativo e registrado_em dentro do período. |
| Faturamento Total | Resultado financeiro geral do período. | Faturamento de Estadias + Faturamento de Planos + Receitas - Despesas |
Relação com o estacionamento: Este é o "extrato" do estacionamento. O gestor pode ver quanto entrou de receita de rotativos, quanto de mensalistas, se houve receitas extras e quais foram as despesas. O faturamento total mostra o resultado líquido operacional do período.
3. Classificação por Tipo de Permanência
Classifica as estadias que saíram no período em cinco categorias mutuamente exclusivas, permitindo entender o perfil da operação.
| Tipo | Descrição | Critério |
|---|---|---|
| Carência | Veículos que entraram e saíram sem pagar. São clientes que ficaram dentro do tempo de carência (saída sem pagamento) configurado no pátio. | Status = saída_confirmada, saída dentro do período, sem nenhum registro de faturamento vinculado à estadia. Se incluir_plano_na_carencia = false, exclui estadias de planos. |
| Planos | Veículos de clientes com contrato de plano que saíram sem cobrança adicional (dentro do coberto pelo plano). | Status = saída_confirmada, entrada_plano_contrato_id preenchido, sem faturamento OU faturamento com valor_cliente = 0. |
| Pagantes | Clientes rotativos que pagaram pelo estacionamento, sem uso de vouchers. | Faturamento com valor_cliente > 0 e vouchers = 0 (ou nulo). |
| Franqueados | Clientes que saíram gratuitamente via voucher de parceiro. O parceiro absorveu o custo total. | Faturamento com valor_cliente = 0 e vouchers > 0. Ou seja, tinha voucher que cobriu 100% do valor. |
| Excedentes | Clientes com voucher que excederam o tempo coberto e tiveram que pagar a diferença. | Faturamento com valor_cliente > 0 e vouchers > 0. Ou seja, o voucher cobriu parte, mas o cliente pagou o excedente. |
Relação com o estacionamento: Essa classificação revela o perfil da operação. Uma garagem saudável deve ter a maioria das saídas como "pagantes" ou "planos". Muitas "carências" podem indicar que o tempo de carência está muito generoso. Muitos "franqueados" significam que parceiros estão absorvendo custos significativos.
4. Documentos Fiscais
Tabela com os documentos fiscais emitidos no período, agrupados por série.
| Coluna | Descrição |
|---|---|
| Série | Código da série do documento fiscal (ex: "A", "B") |
| Quantidade | Número de documentos emitidos nesta série |
| Valor | Valor total dos documentos desta série |
| Totais | Linha de totalização com soma de todas as séries |
Relação com o estacionamento: Permite conferir a emissão fiscal. Cada terminal pode ter uma série diferente, então o gestor pode verificar se todos os terminais estão emitindo corretamente.
5. Faturamento por Parceiro
Detalha a receita de estadias rotativas agrupada por parceiro.
| Coluna | Descrição |
|---|---|
| Parceiro | Nome/identificação do parceiro |
| Quantidade | Número de faturamentos realizados para clientes deste parceiro |
| Valor Cliente | Quanto os clientes deste parceiro pagaram no total. Soma de EstadiaFaturamentoModalidade.valor para faturamentos vinculados ao parceiro. |
| Percentual | Percentual do valor cliente deste parceiro em relação ao total de todos os parceiros. Calculado como valor_cliente_parceiro / soma_total * 100. |
| Valor Parceiro | Quanto o parceiro absorveu/subsidiou para seus clientes. Soma de EstadiaFaturamentoParceiro.valor_parceiro. Representa o custo que o parceiro tem com o estacionamento de seus clientes. |
| Vouchers | Quantidade total de vouchers utilizados por clientes deste parceiro. |
Relação com o estacionamento: Mostra quanto cada parceiro gera de receita e quanto custa para o parceiro subsidiar seus clientes. É essencial para renegociar contratos com parceiros — se um parceiro gera muitas validações (vouchers) mas pouca receita, pode ser necessário rever o acordo.
6. Faturamento por Plano
Detalha a receita de contratos de plano agrupada por tipo de plano.
| Coluna | Descrição |
|---|---|
| Plano | Nome/identificação do plano |
| Quantidade | Número de faturamentos de contrato realizados para este plano |
| Valor | Receita total gerada por este plano. Soma de PlanoContratoFaturamentoModalidade.valor. |
| Percentual | Percentual deste plano no total de receita de planos. |
Relação com o estacionamento: Permite comparar a performance de cada plano. O gestor pode identificar quais planos geram mais receita e quais precisam de ajuste de preço.
7. Faturamento por Modalidade de Pagamento
Detalha os valores recebidos por cada forma de pagamento, separando em três categorias: estadias, planos e receitas manuais.
| Coluna | Descrição |
|---|---|
| Modalidade | Nome da modalidade (ex: "DINHEIRO", "CARTÃO SITEF", "PIX ADYEN") |
| Gera Doc. Fiscal | Se esta modalidade gera documento fiscal automaticamente |
| Qtd Estadias | Número de faturamentos de estadia nesta modalidade |
| Valor Estadias | Total recebido em estadias nesta modalidade |
| % Estadias | Percentual desta modalidade no total de estadias |
| Qtd Planos | Número de faturamentos de plano nesta modalidade |
| Valor Planos | Total recebido em planos nesta modalidade |
| % Planos | Percentual desta modalidade no total de planos |
| Qtd Receitas | Número de receitas manuais nesta modalidade |
| Valor Receitas | Total de receitas manuais nesta modalidade |
| % Receitas | Percentual desta modalidade no total de receitas |
Relação com o estacionamento: Revela como os clientes preferem pagar. Se a maioria paga em cartão/PIX, pode não ser necessário manter muito dinheiro em caixa. Se uma modalidade gera poucos pagamentos, pode ser desativada para simplificar a operação. Também é útil para conferência com as operadoras de cartão (conciliação).
8. Faturamento por Local
Detalha os valores faturados por terminal ou via, permitindo identificar quais pontos de atendimento geram mais receita.
| Coluna | Descrição |
|---|---|
| Local | Identificação do terminal ou via |
| Qtd Estadias | Faturamentos de estadia neste local |
| Valor Estadias | Receita de estadias neste local |
| % Estadias | Percentual deste local no total de estadias |
| Vouchers | Vouchers utilizados neste local |
| Qtd Planos | Faturamentos de plano neste local |
| Valor Planos | Receita de planos neste local |
| % Planos | Percentual deste local no total de planos |
| Qtd Receitas | Receitas manuais neste local |
| Valor Receitas | Valor de receitas neste local |
| % Receitas | Percentual deste local no total de receitas |
Relação com o estacionamento: Permite identificar quais ATMs ou caixas são mais utilizados e geram mais receita. Se um terminal processa poucos pagamentos, pode indicar problema de localização ou mau funcionamento. Também útil para dimensionar equipe por ponto de atendimento.
9. Distribuição Horária
Gráfico de barras mostrando a distribuição de entradas e saídas ao longo das 24 horas do dia.
| Dado | Descrição |
|---|---|
| Entradas por hora | Array de 24 valores, um para cada hora (0h-23h), com a contagem de veículos que entraram naquele horário durante o período selecionado |
| Saídas por hora | Array de 24 valores com a contagem de veículos que saíram por hora |
Como é calculado: Para cada hora do dia (0 a 23), conta as estadias cuja entrada_solicitada_em ou saída_confirmada_em corresponde àquela hora, dentro do período selecionado.
Relação com o estacionamento: Mostra os horários de pico de entrada e saída. Essencial para:
- Dimensionar equipe nos horários de maior movimento
- Identificar se há concentração de entradas/saídas que causa filas
- Planejar manutenções nos horários de menor movimento
- Ajustar tabelas de preço por horário (ex: criar desconto para horários ociosos)
10. Distribuição por Status
Mostra quantas estadias estão em cada status ao final do período.
| Coluna | Descrição |
|---|---|
| Status | Nome do status (ex: entrada_confirmada, saída_confirmada, etc.) |
| Quantidade | Número de estadias neste status |
| Percentual | Percentual deste status no total |
Relação com o estacionamento: Permite identificar situações anômalas. Se há muitas estadias em entrada_timeout_confirmacao, pode indicar problema nos sensores. Se há estadias em em_processo_de_pagamento antigas, pode indicar que transações ficaram travadas.
11. Utilização de Chaves Mestras
Lista o uso de chaves mestras (chaves administrativas que abrem cancelas) durante o período.
| Coluna | Descrição |
|---|---|
| Terminal | Terminal onde a chave mestra foi utilizada |
| Pessoa | Nome do funcionário responsável pela chave |
| Chave | Código da chave mestra |
| Quantidade | Número de vezes que foi utilizada |
| Percentual | Percentual de uso em relação ao total |
Relação com o estacionamento: Ferramenta de auditoria. Uso excessivo de chaves mestras pode indicar problemas operacionais (cancelas com defeito, sistema fora do ar) ou uso indevido por funcionários que abrem cancelas sem registrar pagamento.
12. Estadias por Parceiro
Distribuição das entradas por parceiro, independente de pagamento.
| Coluna | Descrição |
|---|---|
| Parceiro | Nome do parceiro |
| Quantidade | Número de entradas associadas a este parceiro |
| Percentual | Percentual deste parceiro no total de entradas |
Relação com o estacionamento: Mostra qual parceiro gera mais movimento (não necessariamente mais receita). Útil para negociação de contratos — um parceiro que gera muito volume mas pouca receita pode estar com condições muito favoráveis.
13. Estadias por Plano
Distribuição das entradas por tipo de plano.
| Coluna | Descrição |
|---|---|
| Plano | Nome do plano (ou "SEM PLANO" para rotativos) |
| Quantidade | Número de entradas deste plano |
| Percentual | Percentual deste plano no total de entradas |
Relação com o estacionamento: Mostra a proporção entre mensalistas e rotativos. Se a maioria é de planos, a garagem depende de receita recorrente. Se a maioria é rotativo, a receita varia mais com o movimento.
14. Estadias com Prisma
Mostra a proporção de veículos que receberam prisma (identificação para manobristas).
| Categoria | Descrição |
|---|---|
| COM PRISMA | Estadias onde o campo prisma está preenchido |
| SEM PRISMA | Estadias onde o campo prisma está vazio/nulo |
Relação com o estacionamento: Relevante apenas para garagens com serviço de manobrista. Permite verificar se os manobristas estão atribuindo prismas corretamente. Alta proporção sem prisma pode indicar falha operacional.
15. Entradas por Via
Distribuição de entradas por via de acesso.
| Coluna | Descrição |
|---|---|
| Via | Identificação da via de entrada |
| Quantidade | Número de entradas por esta via |
| Percentual | Percentual desta via no total de entradas |
Relação com o estacionamento: Mostra quais entradas são mais utilizadas. Útil para:
- Balancear o fluxo entre vias (sinalização, orientação)
- Identificar se alguma via está subutilizada
- Planejar manutenção de cancelas baseado no volume de uso
16. Saídas por Via
Mesma estrutura das entradas, mas para saídas.
| Coluna | Descrição |
|---|---|
| Via | Identificação da via de saída |
| Quantidade | Número de saídas por esta via |
| Percentual | Percentual desta via no total de saídas |
Relação com o estacionamento: Complementa a análise de entradas. Se uma via de saída tem uso desproporcional, pode causar filas. Permite redistribuir o fluxo ou adicionar sinalização.
Glossário de Termos do Painel
| Termo | Significado |
|---|---|
| Estadia | Uma permanência de veículo no estacionamento, desde a entrada até a saída. |
| Faturamento | Registro de pagamento vinculado a uma estadia ou contrato de plano. |
| Carência | Período de tolerância configurado no pátio dentro do qual o veículo pode sair sem pagar. |
| Rotativo | Cliente sem contrato de plano — paga por uso (avulso). |
| Mensalista/Plano | Cliente com contrato de plano — paga mensalidade/recorrência. |
| Parceiro | Empresa parceira que valida tickets dos clientes (ex: restaurante, academia). |
| Voucher | Benefício concedido por parceiro que cobre períodos de estacionamento. |
| Franqueado | Estadia 100% coberta por voucher(s) — cliente não pagou nada. |
| Excedente | Estadia parcialmente coberta por voucher — cliente pagou a diferença. |
| Prisma | Identificador físico colocado no teto do veículo para localização por manobristas. |
| Chave Mestra | Chave administrativa que abre cancelas sem registrar pagamento. |
| Modalidade | Forma de pagamento (dinheiro, cartão crédito/débito, PIX, etc.). |
| Via | Faixa de tráfego de entrada ou saída do estacionamento. |
| Pátio Anterior | Veículos que já estavam no pátio antes do início do período do relatório. |
| Sobra de Pátio | Veículos que permaneceram no pátio após o fim do período do relatório. |
Exemplo de Leitura do Painel
Suponha que o gestor gere o painel para o dia 15/03/2026:
- Pátio Anterior = 45: Às 00:00 do dia 15, havia 45 veículos estacionados (entraram antes do dia 15 e ainda não tinham saído).
- Entradas Confirmadas = 320: Durante o dia 15, 320 veículos entraram.
- Saídas Confirmadas = 310: Durante o dia 15, 310 veículos saíram.
- Sobra de Pátio = 55: Às 23:59 do dia 15, havia 55 veículos estacionados (45 + 320 - 310 = 55).
- Faturamento de Estadias = R$ 8.500,00: Rotativos pagaram R$ 8.500.
- Faturamento de Planos = R$ 3.200,00: Mensalidades de planos somaram R$ 3.200.
- Carência = 42: 42 veículos entraram e saíram sem pagar (dentro da tolerância).
- Pagantes = 195: 195 veículos pagaram pelo estacionamento.
- Franqueados = 38: 38 veículos saíram gratuitamente via voucher de parceiro.
- Excedentes = 15: 15 veículos tinham voucher mas excederam o tempo e pagaram a diferença.
- Planos = 62: 62 veículos de mensalistas saíram sem cobrança adicional.
Com esses dados, o gestor sabe que:
- O estacionamento está com tendência de crescimento de ocupação (55 sobras vs 45 anterior)
- 87% dos clientes que pagaram são rotativos (R$ 8.500 de R$ 11.700 total)
- 42 carências representam ~13% do movimento — pode ser aceitável ou excessivo dependendo da configuração
- Parceiros geraram 38 saídas gratuitas — verificar se os vouchers estão sendo bem utilizados