> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexx.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> Os painéis de Vendas e Financeiro: o que cada número conta e de onde ele vem.

**Analytics**, no menu lateral, abre dois painéis: **Vendas** e
**Financeiro**, um em cada aba no topo da tela. Os números são calculados na
hora a partir dos seus pedidos, contas e lançamentos de caixa. Não há dado de
exemplo: com o workspace vazio, os cartões mostram **Sem dados no período**.

## Período

O seletor no canto direito vale para os dois painéis. Os atalhos à vista são
**Hoje**, **7D**, **14D** e **30D**; o ícone de calendário abre os outros
(**Últimos 90 dias**, **Este mês**, **Este ano**) e um calendário para
escolher qualquer intervalo de até dois anos. O painel abre nos últimos 30
dias, e o período escolhido segue com você ao trocar de aba.

O gráfico se ajusta ao tamanho do período: hora a hora num dia só, dia a dia
até um mês, semana a semana até uns quatro meses, e mês a mês acima disso.

> [!TIP]
>
> O período fica no endereço da página. Recarregar ou mandar o link para
> alguém abre o painel no mesmo intervalo.

### Comparação com o período anterior

Ao lado de vários números aparece uma porcentagem com seta. Ela compara com o
período anterior **do mesmo tamanho**: nos últimos 30 dias, os 30 dias antes
deles. Passe o mouse na porcentagem para ver as datas e o valor de lá. Verde é
bom, vermelho é ruim. Quando o período anterior ficou em zero, não há com o
que comparar, e a porcentagem não aparece.

### O que cada número quer dizer

Passe o mouse no título de um cartão, no ícone de informação: aparece a
definição exata daquele número, a mesma que está nesta página.

## Painel de Vendas

Tudo aqui conta o **pedido vendido**: o pedido de venda aprovado ou atendido,
pela **data do pedido**. Pedido em aberto ainda não vendeu e pedido cancelado
saiu. O pedido devolvido em parte continua contando; o devolvido por inteiro
sai.

> [accordion] Total de vendas
>
> A soma do valor total dos pedidos vendidos no período. O gráfico mostra
> quanto foi vendido em cada dia (ou hora, semana, mês).

> [accordion] Pedidos
>
> Quantos pedidos foram vendidos no período.

> [accordion] Ticket médio
>
> O total de vendas dividido pelo número de pedidos. No gráfico, cada ponto
> é o ticket médio daquele dia.

> [accordion] Vendas por estado
>
> Um mapa do Brasil e os cinco estados que mais venderam, com valor,
> número de pedidos e a fatia de cada um. O estado é o do endereço de
> entrega do pedido; sem ele, vale o estado do cadastro do cliente. Pedido
> sem nenhum dos dois fica fora do mapa.

> [accordion] Receita por canal
>
> O total de vendas dividido pelo canal do pedido: Mercado Livre, **Venda
> direta** (o pedido lançado no Apex) e os demais canais que você tiver.

> [accordion] Top produtos
>
> Os dez produtos que mais renderam no período, pela soma do valor dos
> itens nos pedidos vendidos.

## Painel Financeiro

O Financeiro olha o dinheiro de dois jeitos, e é normal os dois não
baterem:

* **Receita** é o que foi **vendido**, pela data do pedido.
* **Caixa** é o que de fato **entrou e saiu**, pela data do lançamento.

Um pedido de hoje pago em 30 dias é receita hoje e caixa no mês que vem.

> [accordion] Receita bruta
>
> A mesma conta do **Total de vendas** do painel de Vendas: o valor dos
> pedidos vendidos no período, pela data do pedido.

> [accordion] Receita líquida
>
> A receita bruta menos as devoluções **reembolsadas** no período, pela data
> do reembolso. A troca não entra, porque o dinheiro ficou com você. O
> pedido devolvido por inteiro já saiu da receita bruta e não é descontado
> de novo.

> [accordion] A receber
>
> O saldo das [contas a receber](https://docs.apexx.work/financeiro/contas.md) ainda não recebidas. O
> número grande é o saldo no **último dia** do período; o gráfico mostra
> como esse saldo andou dia a dia. A conta entra no saldo no dia em que foi
> cadastrada e sai no dia em que foi recebida. Conta cancelada não entra.

> [accordion] A pagar
>
> O mesmo, para as contas a pagar ainda não pagas.

> [accordion] Entradas e saídas
>
> Na seção **Fluxo de caixa**. O número grande é o **resultado**: entradas
> menos saídas. Logo abaixo, o total de cada lado, e no gráfico as barras
> das duas. Contam só os lançamentos **realizados** em
> [Caixa e bancos](https://docs.apexx.work/financeiro/caixa-e-bancos.md); o agendado ainda não
> aconteceu e fica de fora. Transferência entre as suas contas também não
> entra: é o mesmo dinheiro mudando de lugar.

> [!WARNING]
>
> A receita líquida desconta só as devoluções. Impostos sobre a venda e
> tarifas de marketplace ainda não entram, então ela não é a sua margem.

## Atualização

O painel se atualiza sozinho: quando entra uma venda, uma conta é paga ou um
lançamento é feito, o número muda na tela, e ele confere de novo a cada
minuto. O botão ao lado do período diz de quando é o número
(**Atualizado agora**, **Atualizado há 4 min**) e atualiza na hora.

## Quem vê

Cada painel é uma permissão separada na tela de
[membros](https://docs.apexx.work/workspace/membros-e-permissoes.md): **Vendas** e **Financeiro**, só
para visualizar. Quem tem só um deles entra direto nele. O membro em
**Somente próprios** vê os números calculados só com os registros que ele
mesmo criou.

## O que ainda não tem

* Não há painel de estoque ou de compras.
* Não dá para exportar o painel nem filtrar por canal, produto ou cliente: o
  único filtro é o período.
* Os números de cancelamentos e devoluções não têm cartão próprio.
* Impostos, tarifas e custo do produto não entram em nenhum número, então
  não há margem nem lucro.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.