> For the complete documentation index, see [llms.txt](https://vertte-app.gitbook.io/ajuda/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vertte-app.gitbook.io/ajuda/visao-afiliados/dashboard-afiliados.md).
# Dashboard (Visão Afiliados)
A **Dashboard de Afiliados** é o painel onde você acompanha, em tempo real, todas as vendas que geraram comissão para você. Aqui, é possível visualizar o desempenho dos últimos 90 dias, com detalhes de cada pedido atribuído ao seu perfil.
***
### Entendendo os KPIs
Ao acessar seu painel, o afiliado visualiza um **resumo completo das suas comissões**, incluindo:
* **Quantidade de pedidos** comissionados **(Seção pedidos recentes)**
* **Valor total vendido (Seção pedidos recentes)**
* **Valor total de comissão (Seção pedidos recentes)**
* **Percentual de comissão** sobre as vendas
Tudo isso é baseado nos **pedidos válidos** gerados com os **cupons ou links (UTMs)** que estão vinculados ao seu perfil.
***
### Quais são os indicadores exibidos?
No seu painel inicial de afiliado você terá acesso a:
1. **Vendas Totais** é a soma do valor bruto dos pedidos comissionáveis.
2. **Transações** é a quantidade total de pedidos comissionáveis.
3. **% Comissão** é o percentual definido pela loja para calcular seu pagamento.
4. **Comissão** é o valor total em reais a receber, calculado conforme as regras da loja (com ou sem frete).
> 💡 o cálculo da comissão respeita as configurações da loja.\
> Se o frete não for considerado para comissionamento, ele não será incluído no valor total.
***
### O que é um **pedido válido**?
Um pedido é considerado válido para o painel do afiliado quando:
* Foi feito **dentro do período selecionado** no filtro de datas.
* Contém um **cupom ou link UTM vinculado ao afiliado.**
* Está com **status válido para comissionamento**, conforme definido pela loja (ex: "Pago", "Faturado", "Entregue").
* O afiliado tem um **vínculo ativo com a loja** no momento da consulta.
* A comissão do pedido está preenchida (`comissao` ou `comissao_sem_frete`).
***
### O vínculo precisa estar **ativo**. O que isso significa?
Existem dois tipos de vínculo entre afiliado e loja:
| Status do vínculo | O que significa? | Acesso ao painel |
| ----------------- | ------------------------------------------------------------------------------------- | ---------------------------------- |
| **Pendente** | O afiliado foi cadastrado ou convidado pela loja, mas ainda **não aceitou** o convite | ❌ Não vê pedidos ou resultados |
| **Ativo** | O afiliado aceitou o convite da loja e confirmou o vínculo | ✅ Tem acesso ao painel e aos dados |
***
### E os pedidos feitos **antes do convite ser aceito**?
Sim! Pedidos realizados **antes do afiliado aceitar o convite** **serão contabilizados** assim que o vínculo for ativado, desde que:
* O pedido tenha sido gerado com **cupom ou UTM vinculados** ao afiliado;
* O pedido atenda aos critérios de comissionamento da loja;
* O afiliado tenha aceitado o convite no momento em que acessa o painel.
***
### Exemplo prático 1
**📌 Situação:**
* **Dia 01/08**: Lojista envia convite e vincula o cupom `TESTE10` ao e-mail do afiliado.
* **Dia 05/08**: Um cliente realiza uma compra com o cupom `TESTE10`.
* **Dia 10/08**: O afiliado acessa a plataforma e aceita o convite.
* **Dia 15/08**: Ele acessa seu painel de resultados.
**✅ Resultado:**
O pedido de 05/08 aparecerá normalmente nos KPIs do painel, pois:
* Ele usou um cupom vinculado ao afiliado;
* O vínculo está **ativo** no momento da consulta;
* O pedido está com status comissionável e tem comissão registrada.
### Exemplo prático 2
**📌 Situação:**
#### **Pedido visível na Dashboard**
Vamos supor que a partir desse momento, você, afiliado, pode verificar o seu pedido na dashboard de **Pedidos Recentes**
Dashboard de Pedidos Recentes
* Pedido **#110090**
* Valor: **R$ 1.034,84**
* Status: **Pedido Pago**
* Comissão: **R$ 51,74**
Nesse momento, o status do pedido está **comissionável** (ex.: *Pago*), então ele aparece na Dashboard.
#### **Pedido não aparece mais na Dashboard**
Ao atualizar a página, o pedido some da listagem do afiliado.\
Por quê?\
Porque o status do pedido no e-commerce foi alterado para um **status não comissionável**.
Dashboard de Pedidos Recentes
#### **Painel da loja**
No painel do E-commerce, o pedido **#110090** aparece agora como **"Em separação"**.\
Esse status não está configurado na lista de status comissionáveis da Vertte, então o sistema não contabiliza mais o pedido para o afiliado.
Histórico do pedido na plataforma de E-commerce
#### **Histórico do pedido**
O histórico mostra que:
1. **14/08/2025 07:25** — Pedido Efetuado
2. **14/08/2025 07:25** — Pedido Pago
3. **14/08/2025 07:46** — Pedido em separação
Assim que o status foi alterado para *Em separação*, o pedido deixou de aparecer na Dashboard do afiliado.
### Como funciona no fechamento de fatura
O fechamento da fatura registra uma **"foto"** dos pedidos naquele momento.
* Se um pedido está *Pago* no momento do fechamento, ele será incluído.
* Se depois o pedido for cancelado, ele continuará na fatura já gerada.
* Isso evita que as faturas sejam alteradas retroativamente.
***
### Segurança dos dados
* Apenas afiliados **com vínculo ativo** conseguem visualizar os pedidos e resultados.
* Um afiliado **não consegue acessar dados de outra loja** com a qual não tem vínculo.
* Se o vínculo for desfeito, o painel **não exibirá mais dados dessa loja**.
***
### 💬 Dúvidas Frequentes
1. #### Como garantir que o afiliado receba suas comissões corretamente?
Certifique-se de atribuir **cupons** e **UTMs** ao afiliado correto no momento da configuração. Isso garante que as vendas sejam associadas ao perfil certo.
2. #### O afiliado não está vendo a Dashboard. O que fazer?
Verifique se ele **aceitou o convite** enviado por e-mail. Apenas após aceitar, o painel será ativado para o afiliado.
3. #### Por que alguns pedidos não aparecem como comissionáveis?
Revise as configurações da sua loja e confirme se os **status comissionáveis** estão corretos. Apenas pedidos com esses status definidos serão contabilizados na comissão.