# Dashboard de Vendas

Compare vendas e devoluções por competência, com evolução, atividade diária e metas disponíveis.

Versão 1.0.0

**Dashboards → Vendas** considera vendas e devoluções aprovadas. Na visão Performance, usa a Data da venda ou Data de pagamento salva no ciclo selecionado; na visão Período, usa a Data da venda. O resumo identifica a base. Sem Data de pagamento, uma venda não entra na segunda base. Em Período, a referência inicial é o mês atual de São Paulo.

## Indicadores

| Indicador | Cálculo |
| --- | --- |
| Vendas | Soma dos valores comerciais das vendas ativas no intervalo. |
| Devoluções | Soma dos registros de devolução do intervalo. |
| Após devoluções | Vendas menos devoluções. |
| Quantidade de vendas | Número de vendas, separado das devoluções. |
| Ticket médio | Valor bruto das vendas dividido pela quantidade; indisponível sem vendas. |

Gráficos e atividade diária usam vendas antes das devoluções. A barra de composição compara valores movimentados de vendas e devoluções sobre sua soma; não é uma taxa de devolução sobre vendas.

## Evolução e comparação

A evolução agrupa intervalos longos em até 62 pontos. Dias futuros sem registro ficam indisponíveis, sem queda fictícia a zero. Registros aprovados com data futura podem integrar o período e são identificados; nesse caso, o comparativo anterior fica indisponível.

O comparativo usa o intervalo imediatamente anterior com duração equivalente aos dias decorridos do recorte. Variação percentual exige base anterior positiva. Atividade por dia da semana divide o valor pelos dias correspondentes já transcorridos, incluindo dias sem venda.

O calendário diário aparece nos intervalos compatíveis. Melhor dia e dias com venda descrevem atividade, sem substituir o total líquido. Metas diárias, quando disponíveis, seguem as regras da Performance e do alcance, não uma divisão arbitrária do valor mensal.

## Filtros, clientes e produtos

Pessoa, organização, cliente e produto refinam os registros autorizados. Opções vêm das vendas do intervalo, sem exigir que toda venda pertença a uma Performance. Dimensões desligadas deixam de oferecer seus cards e filtros.

Clientes em destaque considera vendas com cliente vinculado. Produtos considera o valor dos itens vendidos, que pode diferir do valor comercial informado no pedido. Os cards mostram até quatro destaques e a quantidade de vendas com vínculo; não inferem dados ausentes.

A tabela pagina dez registros por vez, mas o resumo considera todo o recorte. Padrão/cargo vê seu alcance pessoal; a exceção coletiva de Competição não se aplica aqui.

## Disponibilidade

Consulta disponível no web e no aplicativo com permissão e módulo habilitado. **Exportar resumo** no web exige permissão própria e exporta resumo/série agregada; não representa exportação integral da tabela paginada. Atualizar a consulta reflete os registros atuais, sem gerar operações.