É 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": "{% if buyer_phone | size != 15 %}Null{% else %}{{ buyer_phone }}{% endif %}", "federalTaxNumber": "{{ buyer_document_id | remove: '.' | remove: '-' }}" }, "warrantyDate": "{{ payment_date | 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.