Relatórios

No app: Financeiro → Relatórios / Desempenho de vendedores

Menu: Financeiro → Relatórios / Desempenho de vendedores

Todos os relatórios exigem a permissão Relatórios → Visualizar, e a geração de arquivo exige Relatórios → Exportar.

O que é esta tela, e pra que serve

Relatórios é onde os dados que já existem no sistema (vendas, custo, lançamentos financeiros, transferências) viram números agregados por período — em vez de precisar somar linha por linha em Vendas ou Financeiro pra responder "como foi o mês", a tela já entrega o total pronto, com possibilidade de exportar. Nenhum relatório aqui cria dado novo — todos são leitura agregada de tabelas que outras telas (PDV, Financeiro, Estoque) já alimentaram.

Isso importa pra saber onde corrigir um número errado: se um relatório mostra algo que parece errado, o problema quase sempre está na origem (a venda, o lançamento, a transferência), não no relatório em si — o relatório só soma o que já foi lançado.

Como o faturamento é calculado

Todo relatório que mostra faturamento ou receita — Vendas por período, Top produtos, Lucratividade, Desempenho de vendedores e metas, faturamento por loja, DRE, a Análise de vendas e o "Faturamento hoje" do Painel inicial e a Curva ABC — usa a mesma regra, então todos dão o mesmo número para o mesmo período:

• Só vendas concluídas. Orçamento, venda em aberto e venda estornada não entram.
• Líquido de desconto: o desconto de cada item e o desconto dado no total da venda. Nos relatórios por produto, o desconto da venda é dividido entre os itens na proporção do valor de cada um.
• Líquido de devolução: o valor devolvido ao cliente sai do faturamento no dia da venda, não no dia da devolução — cada venda aparece uma vez, com o que ela de fato rendeu. Se a devolução não registrou valor (dado importado), sai o valor dos itens devolvidos. A quantidade vendida também é a que ficou com o cliente.
• Data da venda: o dia em que a venda foi concluída, no fuso da máquina.
• Custo (Lucratividade, DRE): o custo do item no momento da venda, só das quantidades que ficaram vendidas.

Vendas por período

Faturamento por dia no intervalo escolhido, com ticket médio e detalhe diário. Responde "como foi a semana" sem depender de fechar o mês.

Como é calculado: faturamento líquido (regra acima) agrupado pelo dia da venda. Vendas canceladas/estornadas e orçamentos não entram na soma — só o que efetivamente ficou fechado.

Ticket médio do dia = faturamento do dia ÷ quantidade de vendas do dia

Um dia sem nenhuma venda simplesmente não aparece na lista (não é uma linha com zero) — o intervalo escolhido é quem decide quantos dias existem pra olhar.

Top produtos

Produtos ordenados por desempenho no período escolhido: quantidade vendida, receita e preço médio praticado.

Preço médio = receita do produto no período ÷ quantidade vendida do produto no período

Diferença em relação à Curva ABC: o Top produtos é um ranking do período escolhido, útil pra ver "o que vendeu mais essa semana"; a Curva ABC classifica todo o catálogo, sem recorte de data, em faixas de participação no faturamento total — são duas perguntas diferentes ("o que vendeu mais agora" vs. "o que sustenta o negócio").

Lucratividade

Por produto, no período escolhido: receita, custo total, margem bruta e margem %. Receita e custo seguem a regra do faturamento — receita com todos os descontos e devoluções abatidos, custo do item na data da venda. Os totais do topo são do período inteiro, não só dos produtos listados.

Margem bruta = receita − custo total
Margem % = (margem bruta ÷ receita) × 100    (0% se a receita do produto for zero)

Margens negativas (margem bruta < 0) aparecem destacadas em vermelho — normalmente indicam custo cadastrado desatualizado, desconto excessivo ou preço lançado abaixo do custo por erro de digitação (a menos que a permissão Pode vender abaixo do custo — ver Usuários e permissões — tenha liberado isso de propósito pra alguém).

O custo usado é o do momento da venda, não o de hoje. Se o produto foi comprado por R$ 10 em janeiro e hoje custa R$ 15, a venda de janeiro continua aparecendo com custo R$ 10 neste relatório — o preço de custo atual do produto não reescreve vendas passadas. Veja Vendas → detalhe pra ver os dois lado a lado (o que foi vendido vs. o cadastro de hoje).

AP/AR resumo

Posição consolidada de contas a pagar e a receber — total vencido, a vencer em 7 dias e a vencer em 30 dias. É o retrato do que o Financeiro tem em aberto agora, incluindo o fiado das Notas do cliente — venda fechada como fiado gera lançamento financeiro (financial_entries) automaticamente, então essas notas entram na mesma soma de contas a receber, sem precisar cruzar duas fontes separadas. Ver também Financeiro → Clientes em atraso.

Como "vencido" é decidido: o sistema não confia só no campo de status gravado no lançamento (que pode estar desatualizado) — ele recalcula na hora, comparando a data de vencimento (due_date) de cada lançamento open/partial/overdue contra a data de hoje. due_date < hoje = vencido; entre hoje e +7 dias = "a vencer em 7 dias"; entre hoje e +30 dias = "a vencer em 30 dias" (as duas últimas faixas se sobrepõem — 30 dias inclui os 7). Lançamento já quitado (status = 'paid') não entra em nenhuma das três somas.

Rede (lojas)

Para operações com mais de uma filial:

• Faturamento por loja — mesmo cálculo de Vendas por período, só que quebrado por store_id em vez de somado;
• situação das transferências — pendentes, em trânsito e recebidas.

Só existe informação útil aqui se houver mais de uma loja cadastrada — com uma loja só, tudo aparece numa única linha.

Desempenho de vendedores

Menu: Financeiro → Desempenho de vendedores

Ranking de vendedores com:

Também exibe totais: faturamento total do período, vendas concluídas no total e vendedores ativos — conta só quem teve ao menos uma venda no período escolhido, não todo mundo com role de vendedor cadastrado. Quem já foi desligado mas vendeu no período aparece normalmente — a venda aconteceu, e o total precisa bater com os outros relatórios.

Vendedor sem regra de comissão ativa aparece no ranking normalmente (faturamento, vendas, ticket) mas com Comissão = 0 — não é bug, é ausência de regra pra apurar.

Exportação

Todos os relatórios têm Exportar CSV, que respeita os filtros aplicados na tela (mesmo período, mesma loja) — não exporta "tudo", exporta exatamente o que está na tela. O arquivo abre direto em Excel, LibreOffice ou Google Sheets. Exportar exige a permissão Relatórios → Exportar, separada de Visualizar — dá pra deixar alguém ver os números na tela sem poder tirar uma planilha deles (ver Usuários e permissões).