API NFSe: Qual a melhor opção para seu ERP

Ricardo Acras

Conteúdo

Neste post vamos visitar as principais preocupações na hora de escolher uma API NFSe. Se você ainda está indeciso entre integrar o seu sistema diretamente com as prefeituras para emitir NFSe, sugiro que leia este nosso artigo, em que falamos sobre as 7 principais vantagens em utilizar uma API para Nota Fiscal Eletrônica.

Se você já decidiu contratar um gateway para emissão de NFSe continue a leitura e veja como escolher a melhor opção para seu negócio.

O Que é a Nota Fiscal de Serviços Eletrônica (NFSe)

Antes de mais nada, vamos entender exatamente o que é a NFSe e por que a sua implementação pode se tornar complicada.

No Brasil temos 5.568 municípios e a tributação para prestação de serviços é de jurisdição municipal. Isto significa que cada um destes 5.568 municípios pode definir as regras para emissão de notas fiscais de serviço, e isto inclui a forma com que estes municípios recebem as notas dos prestadores de serviços.

Isto criou um cenário bastante diversificado. A ABRASF (Associação Brasileira de Secretarias de Finanças das Capitais) tentou resolver esta questão criando um padrão único para comunicação e emissão de NFSe. Porém muitos municípios não adotaram o padrão e mesmo dentre os que adotaram existem aqueles que não o fizeram completamente.

Assim temos uma infinidade de padrões e formas de comunicação. Este cenário se agrava quando percebemos que muitos municípios trocam de padrão de tempos em tempos, por que trocam o fornecedor de seus sistemas de recebimento de notas.

Então, quais são os padrões existentes?

No lado das prefeituras existem alguns fornecedores de sistemas de recebimento de NFSe, cada um com seus padrões. Mesmo entre prefeituras que usam o mesmo fornecedor o padrão pode variar. Além disso, existem prefeituras que adotam padrões próprios, desenvolvidos por equipes de TI internas.

Para conhecer mais sobre os provedores mais conhecidos das prefeituras veja este artigo.

Como escolher a melhor API para seu sistema?

Agora chegamos ao assunto central deste Post. Agora que você já decidiu fazer a emissão de notas pelo seu sistema utilizando uma API NFSe, e também já conhece o contexto geral de como a NFSe funciona, é hora de escolher um fornecedor de API. Vamos passar pelos principais pontos na escolha de um fornecedor para tentar lhe auxiliar nesta escolha.

Infraestrutura do serviço

A infraestrutura do serviço prestado tem que ser a mais refinada possível. Cito aqui alguns pontos de atenção.

Escalabilidade automática: O serviço tem que ser auto-escalável. Quem trabalha com notas fiscais sabe que existem momentos no mês em que ocorre um pico de emissões. Em outros momentos as emissões caem. A API contratada não pode ser dimensionada de maneira estática, ela deve crescer conforme a demanda.

Enfileramento das notas: Pela diversidade de tecnologias utilizadas pelos municípios e pelo fato de existirem municípios com sistemas pouco robustos, que caem com frequência, a infraestrutura da API deve ter um sistema inteligente de filas, que considera as nuances de cada município e se adapta a elas. Colocar a nota na API deve ser rápido e independente de instabilidades de cada município e a infraestrutura da API deve resolver quaisquer problemas que possam ocorrer.

Latência Mínima: A comunicação com a API NFSe que você escolher será intensa. Entre emissões, consultas, download de arquivos, etc as chamadas serão intensas. A latência não pode atrapalhar. Escolha um gateway que tenha latência baixa nas respostas. Para isso certifique-se de que os servidores estão todos alocados no Brasil.

Data Center de confiança: Os servidores do fornecedor da API NFSe devem estar alocados em um data center de confiança. O mais conhecido e confiável é a AWS, ainda existe o Google Cloud e Microsoft Azure. Outros provedores menores até podem ter qualidade, mas não terão a mesma confiabilidade que estes três.

Página de Status independente: Uma infraestrutura confiável deve ser verificada de maneira independente. Verifique se o seu fornecedor de API possui uma página de status que mostre exatamente, minuto a minuto, a disponibilidade dos serviços. Desconfie de páginas de status que não sejam totalmente independentes, ou seja, que rodem em serviços de terceiros onde os dados não podem ser manipulados.

Estrutura de comunicação e Formato dos dados

REST + JSON: Hoje em dia o padrão da internet é o padrão REST + JSON. Este formato é o mais simples e completo, e é possível ser integrado com qualquer sistema. Procure uma API NFSe que tenha estes padrões.

Formato único: Além disso, é muito importante que o padrão do JSON seja único para todas as prefeituras. O mesmo nome de campo, o mesmo formato de dados. A complexidade advinda da variedade de formatos das prefeituras deve ser absorvida pela API.

Webhooks: A API escolhida deve permitir notificações por Webhooks além da consulta das notas. Isso traz uma facilidade enorme para desenvolvedores web e mostra que o fornecedor está atualizado com as boas práticas do mercado.

Suporte técnico… Realmente técnico

Independente da qualidade da API NFSe escolhida, em algum momento você vai precisar chamar o suporte técnico. Não existe sensação pior do que ser jogado de um lado para outro e ter a sensação de que ninguém resolve seu problema. Separamos algumas perguntas que devem ser feitas aos fornecedores de gateways de nota fiscal:

Qual é o nível técnico dos operadores de suporte: Quem vai receber o seu chamado sabe o que é um JSON? Tem capacidade de usar o Postman para testar a emissão de uma NFSe? Conhece programação? Um suporte técnico destinado a desenvolvedores não pode ser composto por pessoas totalmente leigas, é crucial que já no primeiro nível você tenha acesso a pessoas tecnicamente capacitadas.

Tempo de resposta médio: Qual é o tempo de primeira resposta e o tempo médio para solução dos problemas? Nota Fiscal é assunto sério. Se o usuário do seu sistema não puder emitir uma nota e você receber respostas de seu suporte técnico depois de várias horas ou dias seu negócio como um todo pode ser comprometido.

Acesso aos desenvolvedores: A equipe de suporte técnico da empresa que vai lhe atender precisa ter acesso aos desenvolvedores do gateway. Só assim problemas mais graves ou BUGs podem ser resolvidos rapidamente e as notas de seus usuários podem sair no tempo certo, mesmo quando houver falhas graves.

Picture of Ricardo Acras

Ricardo Acras

20+ anos de experiência como desenvolvedor. Fundador e atual CEO do Focus NFe.

Inscreva-se em nossa newsletter​

Receba nossos conteúdos exclusivos em primeira mão.

Explore outros conteúdos:

nota-tecnica-2024-002
Notas Técnicas
Douglas Pinheiro

Nota Técnica 2024.002: mudanças no leiaute de CT-e Simplificado

A Nota Técnica 2024.002 introduz uma novidade quando se trata do < a href="https://focusnfe.com.br/blog/cte/" target="_blan">Conhecimento de Transporte Eletrônico (CT-e). Tal mudança visa otimizar e desburocratizar a emissão e a gestão do documento, com ênfase na agilidade e na praticidade para as empresas.

Mas a mudança mais importante trazida com a nota técnica é a criação do CT-e simplificado. Trata-se de uma versão enxuta do documento original, direcionada a operações de transporte menos complexas. Seu layout é mais conciso, exclui campos não essenciais e facilita o preenchimento das informações.

Para emissores, as principais vantagens são: menos tempo para emissão do documento e menor índice de erros. Para as empresas, por sua vez, há maior agilidade na conferência de dados e melhorar a comunicação entre documentos fiscais eletrônicos.

Leia mais »
NT 2023.002 - v1.00: Emissão de NFC-e para produtor rural pessoa física com IE
NFe
Ludmila Ferreira

Nota Técnica 2020.004: NF-e e DANFE Simplificado

A Nota Técnica 2020.004 trouxe atualizações essenciais para a emissão da Nota Fiscal eletrônica (NFe) e do Documento Auxiliar da Nota Fiscal eletrônica (DANFE). Com a padronização de campos obrigatórios e a proposta de destacar informações relevantes, essas mudanças visam tornar os processos mais eficientes e objetivos.

Essa evolução foi impulsionada pelo crescimento exponencial do comércio eletrônico. Com vendas realizadas cada vez mais fora de lojas físicas, como em marketplaces e pelo telemarketing, a simplificação dos processos fiscais tornou-se indispensável.

Nesse contexto, o DANFE Simplificado – Etiqueta foi introduzido como uma solução prática para otimizar a entrega de mercadorias e facilitar a rotina de empresas e transportadores.

Continue lendo e entenda melhor esta NT e o que propõe suas versões.

Leia mais »
Entenda o que é SaaS, como utilizar e como calcular as métricas SaaS para avaliar sua empresa e analisar os resultados de forma efetiva.
SaaS
Ricardo Acras

Métricas SaaS: como calcular e avaliar seu negócio?

As métricas SaaS são fundamentais para a análise de dados que contribuem tanto com a otimização de serviços, como para uma boa gestão de negócios.

Afinal, esse mercado exige constante evolução e validação. Seja para manter seu produto vivo e superar concorrentes, como para manter clientes engajados e as assinaturas ativas.

Manter os indicadores de desempenho (KPIs) aprimorados e conectados com a real situação do SaaS, possibilita correções e atualizações constantes do produto, norteando as atividades de melhoria contínua do software.

Pensando nisso, no artigo de hoje separamos as principais métricas a serem analisadas para que gestores e times permaneçam atentos tanto às demandas do público quanto da organização. Confira!

Leia mais »