¶ Notazz
A integração com a plataforma Notazz, possui as seguintes funcionalidades
- Emissão de NFSe
- Cancelamento de NFSe
- Geração do PDF
- Geração do XML
- Notificações por Webhook / Callback
¶ Integração
O primeiro passo é realizar a abertura de uma conta na plataforma do Notazz (https://notazz.com/).
A equipe do Notazz 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.
¶ Painel Notazz
Com o acesso ao painel do Notazz, vá no Menu Lateral > Configurações > Empresas., na empresa desejada, clique no botão API KEY conforme a imagem abaixo:
Será aberto uma interface com as credenciais, conforme abaixo:
¶ No HubSoft
Agora vamos até o HubSoft e vamos criar a integração e colar essa API KEY que foi copiada do painel do Notazz.
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:
Todos parâmetros:
token: (Obrigatório) Token fornecido pela Plataforma
cnpj: (Obrigatório) CNPJ da Empresa que utilizará a integração. Preencha apenas números.
enviar_email: (Opcional) Indica se deve enviar ou não o email do cliente para plataforma. Valores Aceitos: (true/false)
competencia_retroativa: (Opcional) Indica se o sistema deve controlar a competencia com base na data que a nota foi gerada. EX: Se um nota for gerada em 30/11 às 23:55 e for enviada para a plataforma só no dia 01/12 o sistema por padrão vai enviar com a competência do mês 12 (Dezembro). Porém se estiver com a competência retroativa, o sistema irá respeitar a data da geração enviando a competência do mês 11 (Novembro). Valores Aceitos: (true/false)
metodo_consulta: (Opcional) Indica qual método deverá ser utilizado para consultar as NFSe emitidas. Essa função será útil para cidades que trabalham com o modelo da Nota 55 (produtos/serviços) para a NFSe, como por exemplo a cidade de Brasília/DF. Nessas cidades, o atributo a ser utilizado deverá ser: consult_nfe_55
intervalo_transmissao: (Opcional) Indica de quanto em quantos segundos o sistem enviar uma nota para a plataforma. Essa função deve ser utilizada apenas em cidades, onde a prefeitura faz controle de RPS e Numeração sequencial. EX: Se quiser preencer um intervalo de 2 minutos entre uma nota e outro, preencher esse atributo com o valor 120 (segundos)
maximo_dias_cancelar_apos_periodo: (Opcional) Indica a quantidade de dias após fechar um período, para que a NFSe seja cancelada. Por exemplo, uma NFe gerada em 15/02/2022 irá pertencer ao período 02/2022, que se encerra em 28/02/2022. Caso essa regra seja preenchido com o valor 5 (ou seja 5 dias), então até o dia 05/03/2022 os usuários do sistema ainda conseguirão cancelar as NFSe. Caso esse campo não seja preenchido, o sistema permitirá cancelamento somente dentro do período de emissão
exibir_caracteres_especiais: (Opcional) Indica se no demonstrativo da nota fiscal (descrições), devem ser exibidos usando caracteres especiais, como por exemplo acentuações, ou se o sistema deve remover esses caracteres, mantendo apenas letras e números. OBS: Algumas prefeituras não aceitam caracteres especiais na integração. Valore aceitos: (true/false). Padrão do sistema (false)
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 imagem abaixo:
Em seguida, clique na empresa que deseja ativar a integração > 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, 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 Notazz. Devido ao volume muito grade de notas, esse procedimento pode demorar para atualizar os dados no HubSoft.
Para melhorar esse processo, o Notazz possui a tecnologia de Webhook, isso significa que o Notazz é 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 do Notazz.
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 Notazz 🤝.
¶ Emitindo NFSe
Esse artigo abaixo, irá instruir em todo o processo de emissão / gerenciamento da NFSe:
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados com o Notazz. 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.
¶ Quais funcionalidades estão disponíveis com a integração do Notazz?
A integração com a plataforma Notazz oferece as seguintes funcionalidades:
- Emissão de NFSe: Permite emitir Notas Fiscais de Serviço Eletrônicas diretamente no sistema.
- Cancelamento de NFSe: Facilita o cancelamento de notas fiscais emitidas quando necessário.
- Geração de PDF: Cria automaticamente o PDF da nota fiscal para visualização e armazenamento simplificados.
- Geração de XML: Produz o arquivo XML da nota fiscal, que é o formato padrão para transmissão e arquivamento de documentos fiscais eletrônicos.
- Notificações via Webhook/Callback: Implementa tecnologia de Webhook para notificar o HubSoft sempre que uma nota fiscal altera seu status na plataforma Notazz, garantindo que ambas as plataformas estejam sincronizadas.
Essas funcionalidades têm como objetivo otimizar e automatizar a gestão de notas fiscais, tornando o processo mais eficiente e menos suscetível a erros.
¶ Se eu gerar a NFSE no portal da Prefeitura ou do Notazz, a nota vai ser autorizada no Hubsoft?
Não, se a NFSe for gerada diretamente no portal da Prefeitura ou no Notazz, 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 Notazz. 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 Notazz. É 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.