Hotmart: trazer as vendas de infoproduto para o sistema — visão geral e índice
A Hotmart é a plataforma onde muita gente vende curso, e-book, mentoria e outros produtos digitais. A integração traz essas vendas para dentro do sistema, para que você tenha o comprador cadastrado como cliente, o infoproduto cadastrado como produto ou serviço e a venda lançada, sem redigitar nada. Lançada a venda no ERP, a nota sai pelo caminho normal do ERP.
Esta fonte é a visão geral. Ela diz o que a integração faz, em que ordem as coisas acontecem e qual fonte responde cada assunto. O detalhe de cada tela está nas outras fontes desta pasta.
PARA QUEM SERVE
Para quem vende na Hotmart e precisa emitir nota, controlar o financeiro e ter o histórico do comprador no mesmo lugar do resto do negócio. Quem só vende produto físico não usa esta integração.
ONDE FICA
É um aplicativo, aberto por Meus aplicativos › Hotmart. Dentro dele o menu tem: Início, Clientes, Produtos, Serviços, Vendas, Configurações (Situações, Formas de pagamento, Integração e Usuários), Relatórios (de clientes, de produtos, de serviços e de vendas) e Sistema ERP, que volta ao sistema.
Se o aplicativo não aparece para ninguém, nem para o usuário master, não é permissão: ele ainda não está liberado para a empresa. Isso, e todas as caixas de permissão, se resolvem pela fonte de permissões do Hotmart.
A ORDEM QUE FUNCIONA
A maior parte dos chamados desta integração é alguém tentando o passo três sem ter feito o passo um. A ordem é esta.
1. Ligar a conta da Hotmart. É a tela de Integração, dentro do aplicativo, em Configurações, com Client ID, Client Secret e Basic Auth gerados na Hotmart. Sem isso as telas do aplicativo não abrem. Tem fonte própria, que explica também o que se perde ao remover a integração.
2. Fazer o de-para. Toda venda chega com uma situação e um meio de pagamento no vocabulário da Hotmart, que o ERP não conhece. Você traduz cada um para uma situação de venda e uma forma de pagamento do seu ERP, nas telas Situações e Formas de pagamento do aplicativo.
3. Trazer as vendas. Aí sim.
O DE-PARA NÃO É OPCIONAL
Este é o ponto que mais se entende errado. Sem tradução, a venda não entra torta: ela não entra. A sincronização automática para naquela venda e registra "Forma de pagamento do pedido não foi mapeada para o ERP" ou "Situação do pedido não foi mapeada para o ERP", e nada é gravado — nem cliente, nem venda, nem parcela.
Existe uma exceção que confunde: sem de-para, o sistema ainda tenta casar sozinho pelo nome, procurando no ERP uma situação ou uma forma de pagamento com o nome exatamente igual ao rótulo da Hotmart. É por isso que a mesma integração funciona numa empresa e falha em outra sem ninguém ter mudado nada. O de-para é o que torna isso previsível.
DOIS CAMINHOS PARA A VENDA CHEGAR NO ERP
São dois, e a lista é fechada. Os dois ficam na tela de Vendas do aplicativo.
O primeiro é sincronizar em lote. Você escolhe um Tipo — venda de produtos ou venda de serviços — e um período, e o sistema traz em segundo plano todas as vendas daquele intervalo que ainda não estão no ERP.
O segundo é gerar uma venda por vez, pelos botões Gerar produto e Gerar serviço da linha. Abre o formulário de venda do ERP já preenchido, você confere e salva.
Nos dois casos a venda só é criada quando entra pelo caminho normal de venda do ERP. E nos dois, venda que já está no ERP não é trazida de novo: não existe reimportação nem atualização de venda já sincronizada. Correção em venda já lançada se faz na venda, dentro do ERP.
PRODUTO OU SERVIÇO: A DECISÃO QUE PESA
Cada infoproduto fica amarrado a um lado só: ou a um produto do ERP, ou a um serviço. Nunca aos dois. Essa escolha define o tipo da venda no ERP e, por consequência, qual documento fiscal você emite depois. É uma decisão sua com o seu contador; o suporte não escolhe por você. Trocar depois não converte o cadastro antigo — cria um novo. Tem fonte própria, e vale ler antes de clicar.
O QUE O APLICATIVO NÃO FAZ
Não emite documento fiscal. A tela de apresentação da integração cita emissão de notas fiscais, e o que isso quer dizer é que a venda importada fica pronta para virar nota no módulo fiscal do ERP.
Não cadastra, não edita e não exclui cliente, produto, serviço ou venda pelas telas dele. As listas do aplicativo são listas de vínculo: mostram o que já foi trazido e a qual registro do ERP cada um está amarrado. Editar e excluir é no ERP.
Não traz o histórico inteiro sozinho, não reprocessa venda que falhou e não tem prazo prometido de sincronização.
ONDE CADA COISA SE RESPONDE
Ligar a conta, credenciais, remover a integração e o efeito de remover: fonte de autorização da Hotmart.
Permissão, o aplicativo não aparecer e as caixas de cada bloco: fonte de permissões da Hotmart.
Sincronizar em lote, as recusas antes de começar, o andamento e as vendas com erro: fonte de sincronização de vendas.
Gerar produto e Gerar serviço, e a venda que aparece e some do ERP: fonte de gerar a venda uma a uma.
Traduzir situação e meio de pagamento, as duas listas fechadas da Hotmart e o efeito nas parcelas: fonte de de-para.
Produto ou serviço, alterar vínculo e o cadastro duplicado: fonte de produto x serviço.
Listas de Clientes, Produtos e Serviços, os quatro relatórios e o que some quando você exclui no ERP: fonte de listas e relatórios.
Cadastro de cliente, de produto, de forma de pagamento, situação de venda, lançamento financeiro, venda e nota fiscal são conceitos do ERP e se respondem pelas fontes do ERP. Esta integração só entrega a venda até lá.
Configuração dentro da plataforma Hotmart — checkout, webhooks, dados do comprador, geração de credenciais — é com o suporte da Hotmart.