Principal Automação / Integrações Como integrar a HeroSpark com SmartNotas

Como integrar a HeroSpark com SmartNotas

Última atualização em Jun 13, 2025

SmartNotas é um emissor de Notas Fiscais focado no mercado de infoprodutos. Com ele, entre outras coisas, você pode fazer o split de notas fiscais para casos de coprodução.

É possível integrar a HeroSpark com a SmartNotas utilizando o Piloto Automático. Basta seguir o passo-a-passo deste artigo.

 

1. Crie uma integração do tipo HeroSpark no SmartNotas com uma chave de identificação

Na interface administrativa do SmartNotas, acesse o menu "Integrações" e clique em "Gerar/Atualizar Integração".

mceclip0.png

 

Após, procure pela HeroSpark na lista e preencha o campo com uma chave que servirá para identificar ambos os sistemas. Você pode criar um chave aleatória ou mesmo usar um site para gerar uma automaticamente. Em nosso exemplo, usaremos hero-checkout1234. 

mceclip1.png

Esta chave e o link de à direita serão usados na HeroSpark para concluir a operação.

 

2. Crie uma automação na HeroSpark para emissão de nota

Na HeroSpark, acesse o Piloto Automático e crie uma automação do tipo Webhook usando o gatilho "Pagamento confirmado". Nesta automação, preencha os seguintes campos:

 

Filtro (opção padrão):

Aplicar em todos os produtos (opção padrão)

URL (a mesma copiada no SmartNotas no passo 1):

https://app.smart-notas.com/webhook-herospark/524

Método (opção padrão):

POST

Headers:

Chave: Content-Type

Valor: Application/json

Body:

{
"chave": "hero-checkout1234",
"venda": {
"status": 1,
"garantia": 7,
"codProduto": "{{ product_id }}",
"valorVenda": "{{ payment_value | divided_by: 100.00 }}",
"idTransacao": "{{ payment_id }}",
"nomeProduto": "{{ product_name }}",
"dataPagamento": "{{ payment_date }}"
},
"cliente": {
"nome": "{{ buyer_name }}",
"pais": "Brasil",
"email": "{{ buyer_email }}",
"telefone": "{{ buyer_phone }}",
"documento": "{{ buyer_document_id }}"
},
"produtor": {
"documento": "64755667000187",
"razaoSocial": "Empresa Teste LTDA"
}
}

IMPORTANTE:

Substitua o campo "chave" pela chave preenchida no SmartNotas no Passo 1. Em nosso exemplo, você deve substituir "hero-checkout1234" pelo termo que você usou.

Os campos ao final (documentorazaoSocial) fazem parte do seu cadastro no SmartNotas. Portanto, substitua-os com os dados da sua empresa.

Todo o restante são as variáveis da HeroSpark que serão substituídas pelos valores da venda.

 

Sua automação ficará assim:

hero-smartnotas.png

3. Crie as automações na HeroSpark para cancelamento da nota

Repita o passo anterior, mas desta vez crie duas automações utilizando os gatilhos "Estorno através da operadora de cartão" e "Estorno feito pelo produtor". Essas automações farão com que o uma nota seja Cancelada em caso de Chargeback ou Reembolso.

 

Note que a única diferença entre o passo anterior é que, no Body, estaremos passando o status como 4.

Filtro (opção padrão):

Aplicar em todos os produtos (opção padrão)

URL (a mesma copiada no SmartNotas no passo 1):

https://app.smart-notas.com/webhook-herospark/524

Método (opção padrão):

POST

Headers:

Chave: Content-Type

Valor: Application/json

Body:

{
"chave": "hero-checkout1234",
"venda": {
"status": 4,
"garantia": 7,
"codProduto": "{{ product_id }}",
"valorVenda": "{{ payment_value | divided_by: 100.00 }}",
"idTransacao": "{{ payment_id }}",
"nomeProduto": "{{ product_name }}",
"dataPagamento": "{{ payment_date }}"
},
"cliente": {
"nome": "{{ buyer_name }}",
"pais": "Brasil",
"email": "{{ buyer_email }}",
"telefone": "{{ buyer_phone }}",
"documento": "{{ buyer_document_id }}"
},
"produtor": {
"documento": "64755667000187",
"razaoSocial": "Empresa Teste LTDA"
}
}

 

hero-smartnotas2.png