Integração da Spedy

A Spedy é o provedor fiscal que emite as NF-e do Hevea Flow. A conta Spedy pertence a você: é lá que ficam a empresa emissora, o certificado digital e a numeração; aqui você informa apenas a credencial que autoriza o Hevea Flow a emitir em seu nome.

Esta configuração é da conta — vale para todas as propriedades. O que é por propriedade (emissor, certificado, série) fica na configuração fiscal da propriedade.

Abrir a integração

Toque no seu avatar, escolha Conta e vá até a aba Integrações. A Spedy aparece na lista com o subtítulo “Emissão de notas fiscais (NF-e)” e a situação Configurada ou Não configurada.

Configurar a credencial

Escolha o ambiente.

Sandbox (testes) — ambiente de testes, sem validade jurídica. Produção — documentos reais, com validade jurídica.
Informe a API key.

Cole a API key da Spedy daquele ambiente, copiada do painel da Spedy.
Informe o ID da empresa emissora (opcional).

Se a empresa já estiver cadastrada na Spedy, informe o ID dela. Deixando em branco, ela é cadastrada depois, pela configuração fiscal da propriedade.
Salve.
Teste a conexão.

Clique em Testar conexão. Em caso de sucesso, o app informa quantas empresas estão visíveis com aquela API key.

Ao salvar a API key, o Hevea Flow registra sozinho o webhook que recebe as atualizações de situação das notas — é o que faz a nota sair de Processando sem ninguém precisar atualizar a tela.

Campos

Campo	Descrição
Ambiente	Sandbox ou Produção. Define qual par de credenciais está ativo.
API key da Spedy	Credencial do ambiente selecionado. Fica oculta; use o ícone do olho para conferir o que digitou.
ID da empresa emissora	Opcional. ID da empresa já cadastrada no painel da Spedy.

Importante: cada ambiente tem sua própria credencial. Alternar entre Sandbox e Produção troca os campos exibidos — o que você digitou em cada ambiente é preservado até salvar. Uma credencial de sandbox não funciona em produção, e vice-versa.

Importante: Testar conexão sonda a credencial já salva, não a que está na tela. Salve antes de testar, senão o teste avalia a credencial anterior.

Resultados do teste

Resultado	O que significa
”Conexão OK — N empresa(s) visível(is) com esta API key”	A credencial é válida e o Hevea Flow enxerga N empresas na conta Spedy.
”Conexão OK, mas o ID da empresa informado não foi encontrado nesta conta”	A API key é válida, mas o ID da empresa não existe naquela conta. Confira o ID no painel da Spedy.
Mensagem de erro do provedor	A credencial foi recusada. Confira se copiou a API key do ambiente certo.

Webhook de status das notas

Abaixo do teste de conexão, o bloco Webhook de status das notas mostra a situação do canal por onde a Spedy avisa o Hevea Flow de cada resposta da SEFAZ.

Situação	O que significa
”Webhook ativo desde …”	O canal está registrado e recebendo eventos. Nada a fazer.
”Webhook ainda não registrado neste ambiente”	Use Registrar webhook.
”O webhook já estava registrado e em dia”	Confirmação de que a tentativa de registro não era necessária.

Importante: o webhook é único por conta Spedy e recebe os eventos de todas as empresas — não há um por propriedade.

Nota: se a API key informada não tiver permissão para registrar webhooks (é o caso de uma chave de empresa, em vez da chave da conta), o app abre a instrução Cadastre o webhook no painel da Spedy com a URL pronta para copiar. Registre o evento indicado lá e a atualização automática volta a funcionar.

O certificado digital não é enviado aqui

O certificado A1 pertence ao emissor, e o emissor é por propriedade. Por isso ele é enviado na configuração fiscal da propriedade, não nesta tela.

Nota de segurança: a API key dá acesso à emissão de notas em seu nome. Trate-a como senha: não a compartilhe, não a envie por mensagem e gere uma nova no painel da Spedy se suspeitar de exposição.