← Anterior: [Financeiro](https://iurru.com/manual/Financeiro) · [Manual](https://iurru.com/manual/) · Próxima: [Usuários e permissões](https://iurru.com/manual/Usuarios-e-permissoes)

# Relatórios

**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](https://iurru.com/manual/Painel-inicial) e a [Curva ABC](https://iurru.com/manual/Catalogo-apoio#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](#como-o-faturamento-é-calculado)) 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](https://iurru.com/manual/Catalogo-apoio#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](#como-o-faturamento-é-calculado) — 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](https://iurru.com/manual/Usuarios-e-permissoes#pdv) — 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](https://iurru.com/manual/Vendas#detalhe-da-venda-como-foi-vendido-e-cadastro-atual)
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](https://iurru.com/manual/Financeiro) tem em aberto agora, incluindo o fiado das
[Notas do cliente](https://iurru.com/manual/Clientes#notas) — 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](https://iurru.com/manual/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](https://iurru.com/manual/Lojas) cadastrada
— com uma loja só, tudo aparece numa única linha.

---

## Desempenho de vendedores

**Menu:** Financeiro → Desempenho de vendedores

**Ranking de vendedores** com:

| Coluna | Significado |
| --- | --- |
| **Pos.** | Posição no ranking, do maior faturamento pro menor |
| **Vendedor** | |
| **Faturamento** | Faturamento líquido do vendedor no período ([regra](#como-o-faturamento-é-calculado)), com gráfico de barras |
| **Vendas** | Quantidade de vendas concluídas com esse vendedor |
| **Ticket médio** | `Faturamento ÷ Vendas` do próprio vendedor |
| **Itens** | Peças vendidas por ele no período |
| **Comissão** | Apurada conforme a regra ativa do vendedor — ver [Comissões](https://iurru.com/manual/Comissoes#regras) pras 3 formas de cálculo (percentual sobre venda, percentual sobre margem, valor fixo por item) |

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](https://iurru.com/manual/Comissoes#regras) 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](https://iurru.com/manual/Usuarios-e-permissoes#permissões)).

---

← Anterior: [Financeiro](https://iurru.com/manual/Financeiro) · [Manual](https://iurru.com/manual/) · Próxima: [Usuários e permissões](https://iurru.com/manual/Usuarios-e-permissoes)
