É possível integrar a HeroSpark com ferramentas para Emissão de Notas Fiscais com a Spedy Notas.
Passo 1 - Localizar credencial API na Spedy Notas
Em sua conta na Spedy, clique sobre o nome de usuário no canto superior direito e vá em “Minha Empresa”.
Nas configurações da Empresa, clique no botão “Credenciais da API” no final da tela, copie e guarde o código para utilizar no “Passo 3”.
Passo 2 - Selecionar a automação na HeroSpark
No menu “Piloto Automático”, selecione a automação “Pagamento confirmado”, clique em “Usar este modelo”. Na próxima tela, selecione a opção “Gerar um Webhook” e clique em “OK”.
Passo 3 - Configurar o Webhook na HeroSpark para nota fiscal NFS-e
Na tela de “Edição e visualização”, preencha os campos abaixo da seguinte forma:
A. Filtro de disparo: Aplicar em todos os produtos
B. Edição de webhook - URL: https://api.spedy.com.br/v1/orders
C. Método: Post
D. Header - Adicione as duas chaves:
Chave: Content-Type Valor: application/json
Chave: X-Api-Key Valor: Cole aqui as Credenciais API copiada no Passo 1
E. Body - Copie e cole o código abaixo:
{"date":"{{ payment_date }}","items":[{"price":"{{ offer_price | divided_by: 100.00 }}","amount":"{{ payment_value | divided_by: 100.00 }}","product":{"code":"{{ product_id }}","name":"{{ product_name }}","price":"{{ offer_price | divided_by: 100.00 }}","invoiceModel":"serviceInvoice"},"quantity":1,"description":"{{ product_name }}"}],"amount":"{{ payment_value | divided_by: 100.00 }}","status":"approved","customer":{"name":"{{ buyer_name }}","email":"{{ buyer_email }}","address":{"city":{"name":"{{ buyer_city }}","state":"{{ buyer_state | default: 'ex' }}"},"number":"{{ buyer_address_number }}","street":"{{ buyer_address_street }}","district":"{{ buyer_district }}","postalCode":"{{ buyer_zip_code }}","additionalInformation":"{{ buyer_complement }}"},"mobilePhone":"{{ buyer_phone }}","federalTaxNumber":"{{ buyer_document_id | remove: '.' | remove: '-' }}"},"warrantyDate":"{{ 'now' | date: '%s' | plus: 604800 | date: '%Y-%m-%d %H:%M:%S' }}","autoIssueMode":"afterWarrency","paymentMethod":"{% if payment_method == 'credit_card' %}creditCard{% elsif payment_method == 'bank_slip' %}billetBank{% else %}pix{% endif %}","transactionId":"{{ payment_id }}","sendEmailToCustomer":"true"}
E. Clique em “Automação ativada” e “Salvar edição”
Integração finalizada! Agora após o disparo do gatilho de Pagamento confirmado uma venda de NFS-e será criada na Spedy Notas.
Passo 4 - Configurar o Webhook na HeroSpark para nota fiscal NF-e
Para criar uma venda de NF-e, repita os passos anteriores e no campo “Body”, altere o valor da variável invoiceModel para productInvoice.
Atenção! O estorno da nota fiscal na Spedy Notas é feito de forma manual.
Problemas?
Caso você tenha problemas, entre em contato diretamente com o suporte da Spedy Notas.