Hotmart: gerar a venda uma a uma (Gerar produto / Gerar serviço) e por que a venda pode sumir do ERP
O QUE É ESTE CAMINHO
Na lista de Vendas do aplicativo da Hotmart, cada linha tem uma coluna de ações com três botões: Visualizar, Gerar produto e Gerar serviço. Essa lista é fechada, não há outra ação por linha.
Gerar produto e Gerar serviço são o caminho de uma venda por vez. É a alternativa à sincronização em lote, que traz um período inteiro de uma vez só. Aqui você escolhe, naquela venda, se o infoproduto vai virar produto ou serviço no ERP. Essa escolha muda o cadastro que será criado e o documento fiscal que a venda vai permitir depois. Isso é assunto da fonte de produto x serviço do aplicativo.
O QUE O SISTEMA CONFERE ANTES DE ABRIR
Ao clicar, antes de abrir qualquer tela, duas conferências acontecem.
A primeira é se aquela venda já foi trazida para o ERP. Se já foi, o sistema recusa com "Esta venda já foi sincronizada." e não abre nada. Nessa situação a coluna Pedido daquela linha já mostra o número gerado, com link para a venda no ERP.
A segunda é se o infoproduto daquela venda já está vinculado do outro lado: você clicou em Gerar serviço e ele já está vinculado como produto, ou o contrário. Aí o sistema pergunta se você quer alterar o vínculo. O formulário só abre depois que você confirma. Se não confirmar, nada acontece, e é por isso que Gerar serviço sozinho não muda um infoproduto que já nasceu como produto.
Quando você confirma, o aplicativo cria no ERP um novo cadastro do outro tipo, copiado do cadastro atual, e passa o vínculo para ele. O cadastro antigo continua no ERP, ele apenas deixa de ser o vinculado à Hotmart.
O FORMULÁRIO É O DA VENDA DO ERP
O que abre é o mesmo formulário de venda do ERP, reaproveitado dentro do aplicativo, já preenchido com o que veio da Hotmart: comprador, item, valor, data, forma de pagamento, parcelas e situação. Ao salvar, ele grava pelo caminho normal de venda de produtos ou de venda de serviços do ERP.
A consequência prática é a mais importante desta fonte: valem as regras de venda do ERP. Desconto, alteração do valor de venda, alterar situação e vender sem pagamento obedecem às permissões de venda do seu usuário no ERP, não a permissões do aplicativo. Como preencher cada campo, o que cada permissão libera e o que a situação faz com estoque e financeiro estão nas fontes de venda do ERP. Esta fonte não repete isso.
Dois detalhes do preenchimento: a venda vem com a loja do usuário logado, e o campo Vendedor vem preenchido com o próprio usuário logado, porque a plataforma não envia vendedor e o formulário usa o padrão de venda nova. No formulário novo, campos como Vendedor, Canal de venda e Centro de custo podem estar escondidos no card "Informe os dados da venda"; eles voltam pelo botão de três linhas do canto do card ("Exibir campos").
O QUE ACONTECE AO SALVAR
A ordem é esta, e ela explica quase todos os chamados deste tema:
1. A venda é criada no ERP, pelo formulário.
2. O aplicativo então amarra essa venda ao registro da Hotmart. Nessa etapa, se ainda não houver vínculo, o cliente é criado no ERP (e as movimentações financeiras da venda passam a apontar para ele) e o item, produto ou serviço, é criado no ERP.
3. A venda é regravada com o cliente e o item corretos e, por fim, o registro do vínculo é gravado no aplicativo.
Durante o passo 3 a venda é colocada em uma situação que não lança movimentação e, logo depois, devolvida à situação definitiva. Isso é proposital, para a regravação não gerar lançamento duplicado. Um cliente atento pode ver essa troca no histórico da venda.
POR QUE A VENDA PODE SUMIR DO ERP
Se uma etapa dessa amarração falhar, o sistema apaga a venda que acabou de criar no ERP e devolve "Falha ao inserir a venda. Tente novamente ou contate o suporte.". A mensagem vem com um trecho técnico emendado no fim.
Ou seja: o cliente vê a venda nascer e sumir. Não é bug de tela, não foi exclusão feita por usuário e não é a listagem atrasada. É a própria rotina desfazendo o que criou, para não deixar venda solta e sem vínculo no ERP. Como o motivo real está naquele trecho técnico do fim da mensagem, é ele que resolve o chamado.
Duas causas confirmadas nesse ponto: o cadastro do cliente ou do item ser recusado pelo ERP, e o produto ou serviço vinculado antes ter sido excluído do ERP. No segundo caso o aplicativo ainda apaga o vínculo antigo e a mensagem traz "Falha na sincronização do item." — na próxima tentativa o cadastro é recriado.
Nem toda falha termina em venda apagada. Se a própria remoção não puder ser feita, a mensagem que chega é outra e a venda pode ficar no ERP sem vínculo com a Hotmart. Por isso, antes de mandar gerar de novo, confira se a venda existe no ERP.
Uma venda apagada assim não volta sozinha. Depois de corrigido o motivo, o caminho é gerar de novo pela lista.
O ITEM CRIADO AUTOMATICAMENTE
Quando o infoproduto ainda não tem vínculo, o cadastro é criado na hora, na loja do usuário logado, com o nome do infoproduto como nome e o código do infoproduto como código. É por isso que aparece produto com nome longo ou código estranho: é exatamente o que a plataforma envia. Ele entra sem movimentar estoque.
O custo desse cadastro é calculado a partir das comissões e da taxa da plataforma daquela venda, descontada a comissão da sua própria participação. Não é um valor digitado nem um valor padrão. Se o custo veio diferente do esperado, o ajuste é feito no cadastro do produto ou do serviço, no ERP.
SINCRONIZAR X GERAR
Sincronizar vendas processa um período inteiro em segundo plano. Nessa janela você escolhe um Tipo, produto ou serviço, e ele vale para toda a rodada; se um infoproduto já estiver vinculado no outro tipo, aquela venda não é sincronizada e o motivo aparece no aviso de conclusão da sincronização. Gerar produto ou Gerar serviço trata uma venda só, abre o formulário, deixa você conferir e ajustar antes de salvar e deixa você escolher o tipo daquela venda. Nos dois casos a venda é gravada pela rotina de venda do ERP, e os dois se recusam a trazer duas vezes a mesma venda.
O QUE COSTUMA DAR ERRADO
Venda criada e sumida no mesmo instante: é a remoção descrita acima. Não adianta procurar na lixeira nem no log de exclusão do usuário. Peça a mensagem completa.
Gerar manualmente uma venda que o lote já trouxe: o sistema recusa com "Esta venda já foi sincronizada.". Não é trava de permissão. Confira a coluna Pedido naquela linha, a venda já existe.
Esperar que Gerar serviço mude sozinho um infoproduto já vinculado como produto: sem confirmar a pergunta de alteração de vínculo, nada muda. E confirmar cria um novo cadastro do outro tipo, o antigo continua no ERP.
Achar que a situação intermediária no histórico é erro: não é, ela faz parte do processo e a venda termina na situação definitiva.
O QUE MANDAR PARA O SUPORTE
A mensagem de erro completa, inclusive o trecho técnico no fim, o código da transação da venda na Hotmart, o tipo escolhido (produto ou serviço) e o dia e a hora da tentativa.