# Vendas recebidas

> A tela Vendas > Vendas: cada comunicação do gateway, o status da venda e o efeito no acesso, a venda com erro, produtos ignorados e reprocessamento.

Em **Vendas > Vendas** fica tudo o que os gateways enviaram à sua Cademí: cada compra aprovada, cada renovação, cada cancelamento e cada reembolso. É a primeira tela a abrir quando um aluno diz que pagou e não entrou.

## A ideia em um minuto

Pense nesta tela como o rastreio de uma encomenda. Cada linha é um aviso do gateway sobre uma venda. Chamamos cada aviso de **comunicação**.

- Uma compra à vista costuma gerar uma comunicação (aprovada) e, se houver, outra depois (reembolso).
- Uma assinatura gera várias ao longo do tempo: a adesão, cada renovação, um atraso, o cancelamento. Todas têm a mesma **ID da recorrência**.

Cada linha tem dois status, lado a lado:

- **Status da venda** é o que o gateway disse: **Aprovada**, **Aguardando pagamento**, **Em atraso**, **Reembolso**, **Cancelada** e outros.
- **Status** é o que a Cademí fez com a comunicação: **Processado** (aplicou), **Na fila** (vai aplicar) ou **Com erro** (não conseguiu aplicar; o motivo está nos detalhes).

O caminho de uma comunicação, da chegada ao resultado:

```mermaid
flowchart TD
    accTitle: O caminho de uma comunicação
    accDescr: A comunicação do gateway entra na fila. Ao processar, uma venda única ainda não paga ou um produto da lista de ignorados é descartado e sai da lista. Com a entrega encontrada, fica Processado. Sem entrega, com token que não confere ou no limite de alunos, fica Com erro. Depois de corrigir, Reprocessar devolve a comunicação à fila; numa comunicação já processada, a opção é Forçar reprocessamento.
    chega["Comunicação do gateway"]
    fila["Na fila"]
    proc{"Ao processar"}
    desc["Descartada<br/>fora da lista"]
    ok["Processado"]
    erro["Com erro"]
    repro["Reprocessar"]
    chega --> fila
    fila --> proc
    proc -->|Venda única não paga<br/>ou produto ignorado| desc
    proc -->|Entrega encontrada| ok
    proc -->|Sem entrega, token<br/>ou limite de alunos| erro
    erro -->|Depois de corrigir| repro
    ok -->|Forçar reprocessamento| repro
    repro --> fila
    classDef destaque stroke:#ff005c,stroke-width:2px
    class repro destaque
```

**A regra mais importante:** só **Na fila**, **Processado** e **Com erro** aparecem na sua lista. O que é descartado não muda acesso nenhum.

## O que cada status da venda faz com o aluno

| Status da venda | O que acontece |
|---|---|
| **Aprovada**, **Trial** | O acesso começa ou volta. Se o e-mail da compra é novo, o aluno é criado. A renovação de uma assinatura reativa a mesma matrícula. As tags da entrega são aplicadas |
| **Aguardando pagamento**, **Aguardando análise**, **Expirada**, **Abandonada** | Nada. Numa venda única, a comunicação é descartada e não aparece na lista: boleto e PIX só aparecem quando a aprovação chega, numa comunicação nova. Numa assinatura, a linha aparece e não muda o acesso |
| **Em atraso** | O acesso é suspenso. Se o gateway enviou uma data de fim, o acesso continua até ela e depois para |
| **Reembolso** (inclui chargeback) | O acesso é suspenso na hora. Numa assinatura, uma data de fim programada é apagada: o período pago não sobrevive à devolução |
| **Cancelada** | Numa venda única, o acesso é removido. Numa assinatura, o aluno continua com acesso até a data que o gateway enviou em **Assinatura encerra em**. Sem essa data, o acesso para na hora |

Numa assinatura, quem decide é o **Status da assinatura** (**Ativa**, **Em atraso**, **Cancelada**), não a cobrança isolada.

Reembolso, atraso e cancelamento nunca removem as tags que o aluno recebeu na compra.

A Cademí não inventa prazo de tolerância. Ela suspende o acesso. Depois da suspensão, ela só mantém o acesso até uma data que o próprio gateway enviou.

## Como achar uma venda

- **Últimas**, **Na Fila** e **Com erro**, acima da lista, trocam o que ela mostra. **Na Fila** e **Com erro** trazem a contagem ao lado.
- A busca escolhe o campo no próprio controle: **E-mail**, **Nome**, o documento do aluno (CPF ou o documento que a sua conta usa), **ID da venda** ou **ID da recorrência**.
- Use o e-mail do comprador como veio do gateway.
- O filtro **Gateway** recorta a lista pelos gateways que já enviaram vendas.

Cada linha mostra:

- o gateway e o número da comunicação;
- o **Cliente**: e-mail, nome e documento;
- a **Data**: quando chegou e quando foi atualizada;
- o **Status da venda** e o **Status**.

O menu da linha tem **Ver detalhes**, **Reprocessar** (ou **Forçar reprocessamento**, quando já está processada) e **Copiar #ID**.

### Detalhes da venda

Clique na linha (ou em **Ver detalhes**) para abrir **Detalhes da Venda**. A janela tem duas abas.

**Dados** mostra:

- **Recebido em**, **Status da venda**, **Gateway**, **ID da venda**;
- **Oferta**: a entrega que a venda encontrou. Se a entrega foi arquivada depois, **Oferta** mostra o nome com "(excluída)";
- **Produto**, **ID do produto no gateway**, **Valor**, **Método de pagamento**;
- **Cliente**, o documento e o **E-mail**;
- numa assinatura, também **Status da assinatura**, **ID da recorrência** e **Assinatura encerra em**.

**Payload** mostra o conteúdo bruto que o gateway enviou, como chegou. **Copiar payload** copia tudo. É o que o suporte do gateway costuma pedir.

Uma compra pode ter mais de um item (carrinho, combo, order bump). Nesse caso, a aba **Dados** lista os **Itens**. Cada item mostra o produto, os identificadores que vieram e **Oferta:** com a entrega que ele encontrou. Um item que não encontrou entrega aparece como **Sem entrega**. Um item da lista de ignorados aparece como **Ignorado**.

## O que fazer com uma venda Com erro

Uma venda **Com erro** chegou à Cademí, mas não virou acesso. Abra os detalhes. O motivo aparece em destaque no topo da aba **Dados**. Os motivos mais comuns, com o texto que a tela mostra:

| O que aparece | O que fazer |
|---|---|
| **Erro ao construir carga: Não existe nenhuma entrega configurada para o ID:** seguido do identificador que veio na venda (ou de mais de um, separados por vírgula). | Nenhuma entrega desse gateway tem o identificador. Crie a entrega em **Vendas > Entregas**, ou inclua o identificador na entrega certa, do mesmo gateway. Depois reprocesse a venda |
| A mesma mensagem numa venda com **Itens** (carrinho, combo, order bump) | O identificador citado é o do item sem entrega. A venda inteira falha, inclusive os itens que encontraram entrega. Se o item deve dar acesso, crie a entrega dele. Se não deve (um produto físico, um bônus que já está na oferta principal), ponha o identificador na lista de produtos ignorados. Depois reprocesse |
| **Erro ao construir carga: Token invalido** | O token que veio na venda não confere com o de nenhuma entrega desse gateway. Corrija o **Token** na entrega, com o valor que o gateway mostra. Depois reprocesse |
| **Erro ao processar carga: Seu limite para novos usuários foi atingido.** | A conta chegou ao limite de alunos, e o comprador era novo. Libere uma vaga ou aumente o limite da conta. Depois reprocesse |

**Atenção: é aqui que mais acontece erro.** O Rui vende um curso na Hotmart com duas ofertas. A entrega tem só o identificador do produto. A Hotmart envia o código da oferta. A venda fica **Com erro**, com o código da oferta na mensagem. Para resolver, compare o identificador da mensagem com o **ID do Produto** da entrega, letra por letra. Inclua o identificador que faltava e reprocesse.

### Lista de produtos ignorados

Alguns produtos vendidos no gateway não devem liberar nada na Cademí: um livro físico, uma mentoria, um bônus que já faz parte da oferta. Para a venda deles não ficar com erro, use a lista de produtos ignorados:

1. Abra **Vendas > Vendas > Com erro**.
2. Clique em **Lista de produtos ignorados**.
3. Em **IDs de produto a ignorar**, digite os identificadores. Separe com Enter ou vírgula; dá para colar uma lista inteira.
4. Clique em **Salvar**.

Atalho: nos detalhes de uma venda com erro, cada identificador vira um botão. Clicar nele abre a lista com o identificador já incluído. Você só confirma.

A lista vale para a conta inteira e para as vendas que chegarem depois:

- uma venda em que todos os itens estão na lista é descartada sem erro e não aparece na sua lista de vendas;
- um item ignorado dentro de um carrinho é pulado, e os outros itens seguem.

## Reprocessar

**Reprocessar** devolve a comunicação para a fila. A Cademí lê de novo o que o gateway enviou, procura as entregas de novo e aplica o resultado. Use depois de corrigir a entrega, o token ou a lista de ignorados.

- Numa venda já **Processado**, a opção se chama **Forçar reprocessamento**. Ela faz a mesma coisa.
- O botão **Reprocessar**, no topo da tela, reprocessa em lote. **Com erro** devolve à fila as vendas com erro. **Na Fila** não muda nada: o que está na fila já vai ser processado.

Reprocessar não duplica matrícula e não soma um segundo período. A Cademí encontra a matrícula daquela venda ou daquela assinatura, em vez de criar outra. Reprocessar uma venda **Aguardando pagamento** continua não liberando nada.

**Atenção:** reprocesse a comunicação que deve valer. Reprocessar uma aprovação antiga depois de um reembolso ou cancelamento devolve o acesso ao aluno, porque aquela comunicação é uma aprovação.

## Bom saber

- **A mesma comunicação repetida conta uma vez.** Se o gateway reenvia a mesma venda com o mesmo status, a Cademí não cria uma segunda matrícula.
- **O comprador é encontrado pelo e-mail.** Se o e-mail é novo e a conta confere documento, a venda vai para o aluno mais antigo que já tem aquele documento. A Cademí nunca junta dois cadastros.
- **Boleto cancelado antes de pago é descartado.** Ele não aparece na lista e não mexe em acesso nenhum. O cancelamento só remove acesso quando existe um acesso daquela venda.
- **Acesso dado à mão.** Uma compra avulsa criada em **Adicionar entrega**, no perfil do aluno, é assumida por uma venda real da mesma entrega. Daí em diante, o gateway controla a matrícula, e um reembolso pode suspendê-la.
- **A entrega mostra se as vendas estão chegando.** Em **Vendas > Entregas**, o bloco **Conexão com o gateway** diz **Última venda recebida** ou **Nenhuma venda recebida ainda**. Se nada chega, o problema está na configuração do postback no gateway, não na Cademí.

## Perguntas frequentes

**A venda está Processado e o aluno diz que não tem acesso. E agora?** Siga o roteiro de [O aluno pagou e não tem acesso](https://help.cademi.cloud/pt/vendas/pagou-e-nao-tem-acesso.md). Confira a entrega que a venda encontrou, a matrícula no perfil do aluno e o e-mail que ele está usando.

**Cancelei a assinatura de um aluno no gateway e ele continua acessando. Está certo?** Está, se o gateway enviou uma data em **Assinatura encerra em**. O aluno continua com acesso até o fim do período que já pagou. Sem a data, o acesso para na hora do cancelamento.

**O que é a Oferta nos detalhes da venda?** É o nome da entrega que a venda encontrou. Sem entrega, a venda fica com erro.

**O gateway diz que a venda está aprovada e ela não aparece aqui. Por quê?** A comunicação de aprovação ainda não chegou, ou chegou e está **Na Fila**. Numa venda única, as comunicações de pagamento pendente (boleto, PIX) não entram na lista: só a aprovação entra. Procure pelo **ID da venda** para ver todas as comunicações dela.

**Corrigi a entrega. Preciso fazer mais alguma coisa?** Sim. Reprocesse a venda com erro. A correção da entrega vale para as vendas novas; a venda que já falhou só muda quando você reprocessa.