¶ Focus NFe
A integração com a plataforma Focus NFe, possui as seguintes funcionalidades
- Emissão de NFSe
- Cancelamento de NFSe
- Geração do PDF
- Geração do XML
- Criação de Webhook via Painel HubSoft
- Remoção de Webhook via Painel HubSoft
- Notificações por Webhook / Callback
¶ Integração
O primeiro passo é realizar a abertura de uma conta na plataforma do Focus NFe (https://focusnfe.com.br/).
A equipe da Focus NFe irá fazer todo o processo de configuração da conta e depois de tudo pronto, estará disponível para realizar a integração com o HubSoft.
Importante: Sempre é necessário que ao menos 1 nota fiscal serja emitida diretamente pela FocusNFe, antes de realmente configurar a integração no HubSoft. Isso vai garantir que a comunicação entre a FocusNFe e a cidade do emissor da NFSe estejam operacionais.
¶ Painel Focus NFe
Com o acesso ao painel da FocusNFe, vá no Menu Lateral > Cadastros > Empresas., na empresa desejada, faça o envio do Certificado Digital, caso ainda não tenha sido realizado.
Em seguida vamos editar a empresa, para preenchermos os dados de acesso da prefeitura e também copiar o TOKEN de integração que será utilizado no HubSoft
Vamos até a Aba Documentos Fiscais, conforme a tela abaixo:
- Vá na Aba Documentos Fiscais
- Certifique-se que a chave NFSe está habilitada, com ela desativada, todas as NFSe enviadas pelo HubSoft serão rejeitadas.
- Certifique-se que a série e número do próximo RPS estão preenchidos e corretos.
- Certifique-se de preencher o usuário e senha de acesso ao painel da prefeitura.
Com tudo correto, clique em salvar.
Agora, iremos para a última etapa, que é copiar o TOKEN para ser utilizado no HubSoft.
Vá até a aba Tokens e copie o token do ambiente de produção. Esse token será utilizado nas configurações da integração no HubSoft.
¶ No HubSoft
Agora vamos até o HubSoft e vamos criar a integração e colar esse TOKEN que foi copiada do painel da Focus NFe.
Vamos até o menu lateral do HubSoft > Configuração > Integrações > NFSe, conforme imagem abaixo:
Clique em Adicionar e preencha os dados conforme imagem abaixo:
Feito isso, a integração já está configurada.
Importante: Na configuração da NFSe existem outros parâmetros que podem ser utilizados, como por exemplo, para solicitar que a plataforma NÃO dispare emails, entre outros. Para conferir esses parâmetros, basta clicar no ícone de interrogação dentro da tela de adição / edição da integração.
Agora basta ativarmos nas configurações da empresa.
Vamos até o Menu Lateral > Configuração > Geral > Empresa > Empresa, conforme a imagem abaixo:
Em seguida, clique na empresa que deseja ativar a integração > Ações> Editar
E vá até a Aba CONF. NFSE (ISS)
Selecione a Integração que você criou na etapa anterior e preencha os dados da sua empresa (Tipo de Tributação, Exigibilidade, Regime Tributário, etc). Na dúvida de como configurar esses campos, sujerimos que verifique com seu contador.
Clique em Salvar e a integração já estará completa, agora basta emitir uma Nota para validar o processo de comunicação com a plataforma.
¶ Webhook / Callback 🤝
O HubSoft de tempo em tempo, faz uma checagem nas notas emitidas na plataforma Focus NFe. Devido ao volume muito grade de notas, esse procedimento pode demorar para atualizar os dados no HubSoft.
Para melhorar esse processo, a Focus NFe possui a tecnologia de Webhook, isso significa que a Focus NFe é capaz de notificar o HubSoft sempre que uma nota fiscal muda de status em sua plataforma. Dessa forma ambas plataformas ficarão atualizadas, pois ao invés do HubSoft ficar consultando constantemente, ele será atualizado diretamente pela plataforma da Focus NFe.
Para ativar esse recurso, vamos até a integração que acabamos de criar no HubSoft em Configuração > Integrações > NFSe
Na integração copie a URL de Webhook / Callback que é exida na listagem e clica no botão de** Ações > Webhook**, conforme imagem abaixo.
A interface para adição / edição de Webhook, será aberta.
Clique em Adicionar Webhook, conforme imagem abaixo.
Em seguida, vamos colar essa URL que foi copiada na etapa anterior.
Feito isso, clique em Salvar e já estará pronto a comunicação de notificações entre o HubSoft e o Focus NFe 🤝.
¶ Emitindo NFSe
Esse artigo abaixo, irá instruir em todo o processo de emissão / gerenciamento da NFSe:
Clique aqui para saber tudo sobre a NFSE
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados com o FocusNFe. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ Se eu gerar a NFSE no portal da Prefeitura ou do FocusNFe, a nota vai ser autorizada no Hubsoft?
Não, se a NFSe for gerada diretamente no portal da Prefeitura ou no FocusNFe, ela não será automaticamente autorizada no HubSoft. Para que a nota fiscal seja gerenciada e acompanhada no HubSoft, é fundamental que a emissão ocorra por meio do próprio sistema HubSoft, utilizando a integração com o FocusNFe. Isso assegura que todas as informações e atualizações de status sejam sincronizadas adequadamente entre as plataformas.
¶ Posso reenviar a nota para a fila de autorização se ela for rejeitada?
Sim, quando uma nota fiscal é rejeitada, você pode corrigir os erros que causaram a rejeição e reenviá-la para a fila de autorização do FocusNFe. É importante identificar o motivo da rejeição, realizar as correções necessárias e, em seguida, submeter a nota novamente para autorização. Esse processo pode ser feito diretamente no sistema HubSoft, assegurando que a nota seja processada corretamente após as correções.