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:
Carregando diagrama…
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:
- Abra Vendas → Vendas → Com erro.
- Clique em Lista de produtos ignorados.
- Em IDs de produto a ignorar, digite os identificadores. Separe com Enter ou vírgula; dá para colar uma lista inteira.
- 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. 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.
Entregas
O que uma entrega concede a quem compra: produtos, tempo de acesso, programação de liberação e tags. Criar, duplicar e arquivar em Vendas > Entregas.
O aluno pagou e não tem acesso
Roteiro em ordem para quem pagou e não entra: a venda chegou, veio com erro, a entrega tem o identificador, a matrícula existe, o e-mail é o da compra.