MEI na Hotmart: NFS-e automática a cada venda aprovada

Vender infoproduto na Hotmart é escalável por design — as vendas chegam 24/7, de qualquer canto do Brasil, sem você precisar estar online. O problema é que a obrigação fiscal acompanha esse ritmo: cada compra aprovada gera uma NFS-e pra emitir.

Se você é MEI e ainda está emitindo nota manualmente no portal da sua prefeitura a cada venda (ou, pior, acumulando pra emitir no fim do mês), está deixando dinheiro e tempo na mesa. A integração Hotmart → notafiscalmei automatiza isso.

O que a integração faz

Você cadastra um webhook na Hotmart apontando pro notafiscalmei. Quando a Hotmart aprova uma compra (evento `PURCHASE_APPROVED`), o notafiscalmei:

1. Valida o Hottok — um identificador único que a Hotmart gera pro seu webhook e que o nosso sistema compara com o cadastrado pra confirmar que o evento é legítimo (e não alguém fingindo ser a Hotmart).

2. Extrai dados do comprador: nome, email, CPF/CNPJ, valor da venda, nome do produto.

3. Consulta a prefeitura para sincronizar o próximo número de RPS.

4. Emite a NFS-e usando o sistema nacional (ou o portal da sua cidade, se for o caso).

5. Salva XML e PDF no seu painel e envia por email ao comprador.

O tempo médio entre a aprovação da venda e a nota pronta é de poucos segundos.

Por que precisa do Hottok

A Hotmart permite que qualquer um envie POSTs pra URL de webhook — é um endpoint público, naturalmente. Sem autenticação, alguém que descobrisse sua URL de webhook poderia forjar vendas falsas e forçar emissão de NFS-e fraudulenta em seu nome. Nota fiscal é documento com efeito tributário, então isso seria problema sério.

O Hottok resolve esse buraco: é um token gerado pela Hotmart junto com o webhook, que vem no corpo de cada evento (ou no header `X-Hotmart-Hottok`). Nosso sistema só aceita eventos cujo Hottok bate com o cadastrado. Qualquer evento sem Hottok, ou com Hottok errado, é recusado com 401.

Guardamos o Hottok criptografado com AWS KMS, amarrado ao ID da sua empresa. Nem nós conseguimos ler — a decifragem só acontece no momento de validar um evento.

Como configurar

1. Ative a integração no notafiscalmei

No painel do notafiscalmei, em Integrações, clique em Ativar no card da Hotmart. Uma URL de webhook aparece:

```

https://notafiscalmei.com/api/webhook/hotmart?empresaId=

```

Copie.

2. Cadastre o webhook na Hotmart

No painel Hotmart, vá em Ferramentas → Webhook e clique em + Cadastrar Webhook.

• No campo de URL, cole a URL do notafiscalmei
• Em Eventos, marque `PURCHASE_APPROVED` (Compra aprovada)
• Aplique aos produtos que devem emitir nota fiscal
• Salve

Após salvar, a Hotmart exibe o Hottok gerado — um identificador único daquele webhook. Copie esse valor.

3. Cole o Hottok no notafiscalmei

Volte ao painel e cole o Hottok no campo correspondente. A integração está pronta.

Quais vendas disparam a nota

Apenas eventos `PURCHASE_APPROVED`. Outros eventos da Hotmart (ex: `PURCHASE_BILLET_PRINTED`, `PURCHASE_REFUNDED`, `SUBSCRIPTION_CANCELLATION`) são ignorados por design — nota só sai quando o pagamento é de fato aprovado.

Isso tem uma implicação importante: se uma venda é estornada depois, a NFS-e já emitida permanece emitida. Você precisa cancelá-la manualmente (ou podemos implementar cancelamento automático via webhook de reembolso; se isso interessar, nos avise).

Dados do comprador

A Hotmart já coleta nome completo, email e CPF do comprador por padrão em toda venda. Esses dados chegam preenchidos no webhook e o notafiscalmei usa todos na NFS-e, sem precisar de intervenção sua.

Se o comprador for PJ, a Hotmart também captura o CNPJ — nesse caso a nota sai em nome da empresa compradora.

Dedupe por transaction ID

A Hotmart pode enviar o mesmo evento várias vezes em caso de falha de entrega. Nosso sistema deduplica pelo `transaction` ID da compra — se a mesma transação chegar duas vezes, a segunda é ignorada e nenhuma nota duplicada sai.

Códigos de serviço

Por padrão usamos o código de serviço 01.04 (Licenciamento/cessão de direitos de uso de programas de computação), que é a classificação correta para infoprodutos digitais na maioria das prefeituras brasileiras. Se a sua atividade exige outro código, nos avise que ajustamos a integração pro seu caso.

Quanto custa

Gratuito enquanto o notafiscalmei estiver em fase de crescimento. Sem limite de vendas, sem taxa por nota, sem cartão de crédito.

Vale a pena pra quem vende pouco?

Vale sim. Mesmo com 2 ou 3 vendas por semana, o tempo gasto emitindo nota manualmente (abrir portal, logar, preencher dados do tomador, confirmar, baixar PDF, enviar pro comprador) chega fácil a 5 minutos por nota. Em um mês, 20-30 vendas viram 2-3 horas de trabalho chato e propenso a erro.

A integração tira isso do seu caminho pra sempre. E, a partir do momento que funciona, você não precisa pensar nela.