Como habilitar a integração com o Spedy?

Entenda como automatizar a emissão de notas fiscais pelo Spedy.

O Spedy é um emissor de notas fiscais voltado para negócios digitais e pode ser usado para emitir as NFs de vendas realizadas pela Hubla.

Habilitando a integração no Spedy

Após fazer login em sua conta no Spedy, clique em "Apps" no menu lateral esquerdo e, no card da Hubla, clique no botão "Desabilitado" ou no botão "Mais Ações (três pontos) > "+ Nova Integração". 




Na tela exibida, o botão "Habilitar integração" já deverá estar ativo.

Em "Qual modelo de nota fiscal?" será definido o modelo de nota fiscal que será utilizado por padrão nas vendas. Se precisar, você poderá alterar o modelo de um item específico acessando o menu Produtos.

Já em "Quando emitir a nota fiscal?", precisará definir em que momento a nota fiscal será emitida para as vendas integradas.

⚠️ Antes de habilitar a emissão automática é necessário emitir uma nota fiscal para validação. Por isso, ao habilitar a integração, por padrão, as vendas serão integradas com o modo de emissão "Não emitir automaticamente". Posteriormente, após validar a emissão de nota, será possível habilitar a emissão automática.

Caso selecionada a opção "Na geração da venda", a emissão da nota será feita logo após o cliente gerar uma fatura na Hubla, mesmo se ela não tiver sido paga. Se a opção for "Emitir após o período de garantia", a nota será emitida automaticamente após o período de garantia da compra. Se preferir a opção "Emitir quando o pagamento for aprovado", a nota será emitida automaticamente após a aprovação do pagamento, já se a opção selecionada for "Não emitir automaticamente",  a nota precisará ser emitida manualmente na tela de vendas.

⚠️ Homologada a emissão de nota fiscal, se for preciso importar vendas retroativas, selecione a opção "Não emitir automaticamente", para evitar a emissão de nota fiscal em competência indevida. Após a integração das vendas retroativas, habilite novamente a emissão automática conforme preferência.

Abaixo, escolha se a nota fiscal deverá ser ou não enviada ao cliente, e se ela deverá ser cancelada automaticamente após um reembolso. 


Configurando o Webhook na Hubla

Nessa etapa será necessário ativar a integração via Webhook. Clique aqui para entender como fazer isso de forma descomplicada.

Uma vez ativada a integração, vá em "Configurações" e clique em "+ Adicionar regra".



Preencha os campos da seguinte forma:

  1. Nome: Spedy
  2. URL: Copie a Url exibida na tela de configurações da Hubla na Spedy e cole neste campo
  3. Produtos: Selecione um produto específico ou a opção Todos
  4. Eventos: Selecione apenas os eventos Pagamento da fatura realizado (v2) e Status da fatura atualizado (v2)

Clique em "Criar Regra" para concluir.

Com a regra criada aqui na Hubla, iremos informar agora no Spedy qual a data de início da integração, definir se a integração das vendas irá considerar ou não os juros de parcelamento e informar a quantidade de dias de garantia (caso se trabalhe com a emissão das notas "Após o período de garantia").



No campo "Data de início da integração", deve-se informar a data a partir da qual o sistema deverá importar as vendas. Este campo é utilizado quando existem vendas retroativas a serem integradas.

Por exemplo: a integração está sendo realizada no dia 07/06/2024. Contudo, existem vendas realizadas desde 01/06/2024. Logo, deverá ser informada a data 01/06/2024 para que as vendas retroativas sejam integradas.

⚠️ Aqui na Hubla ainda não é possível importar vendas retroativas via API. Se for necessário importar vendas retroativas para o Spedy, estas vendas deverão ser exportadas em nossa plataforma através do painel "Vendas" em arquivo .csv e encaminhadas ao time de contas da Spedy, para que elas possam ser adicionadas na plataforma.

No campo "Incluir juros no valor da venda?", defina se os juros de parcelamento da venda serão ou não inclusos no valor da venda.

Se for trabalhar com a emissão automática da nota fiscal "Após o período de garantia", no campo "Dias de garantia", informe a quantidade de dias. Informando os dias, o campo já será preenchido na venda e a nota fiscal será emitida automaticamente após esse período.

Por fim, clique em "Salvar" para concluir a configuração da integração da Spedy com a Hubla

A partir de agora, suas vendas na Hubla começarão a aparecer no painel de vendas da Spedy automaticamente.

Precisa de ajuda?

Caso tenha dúvidas, entre em contato com o nosso suporte e iremos te ajudar! 😉