10 Perguntas Críticas Antes de Contratar uma API ou Motor de Emissão Fiscal

Delegar a infraestrutura fiscal da sua empresa ou do seu software ERP para um parceiro de tecnologia é uma das decisões mais críticas de arquitetura. Uma escolha equivocada não resulta apenas em frustração técnica: ela gera checkout travado, expedição de mercadorias parada na logística, autuações tributárias e centenas de chamados abertos no suporte por clientes insatisfeitos.

No mercado brasileiro, muitas plataformas de emissão fiscal vendem páginas de vendas reluzentes, mas escondem armadilhas em seus contratos: bloqueio de notas rejeitadas que consomem créditos indevidamente, ausência de webhooks modernos, falta de contingência automática em momentos de pane na SEFAZ ou até a perda de acesso ao histórico de XMLs caso a assinatura seja interrompida.

Para ajudar CTOs, diretores de tecnologia e gestores operacionais a tomarem uma decisão blindada, formulamos as 10 perguntas essenciais que você deve fazer antes de assinar contrato com qualquer fornecedor de API fiscal — e como o NFER responde a cada uma delas.

1. Existe ambiente de homologação (sandbox) real e imediato sem burocracia?

Muitos emissores exigem que você fale com um vendedor, assine uma proposta comercial ou passe por dias de onboarding antes de liberar a primeira credencial de testes. Pior ainda: alguns cobram mensalidade cheia apenas para você testar se o sistema deles funciona.

2. A plataforma cobra por notas fiscais rejeitadas ou com erro da SEFAZ?

Essa é uma das maiores fontes de indignação no mercado: seu cliente erra o dígito da Inscrição Estadual, a SEFAZ devolve a Rejeição 232, e o emissor fiscal desconta aquele disparo do seu pacote de emissões como se fosse uma nota válida autorizada.

Se você retransmitir a nota 5 vezes até acertar os dados cadastrais, gastou 5 créditos em um único pedido de venda.

3. A emissão pode ser feita tanto por API REST quanto por painel web intuitivo?

Muitos provedores se posicionam como "APIs puras" e negligenciam a interface gráfica, entregando painéis confusos dos anos 2000. Isso cria um problema sério: qualquer cancelamento de emergência, carta de correção (CC-e) ou inutilização de numeração precisa ser feita por um desenvolvedor via cURL.

Por outro lado, emissores tradicionais focados apenas em tela não oferecem uma API REST robusta para os sistemas de automação do seu produto.

4. Como a plataforma notifica a autorização: Webhooks com assinatura HMAC ou Polling constante?

A autorização na SEFAZ e nas prefeituras é naturalmente assíncrona. Emissores legados exigem que o seu servidor fique fazendo requisições de consulta a cada 2 ou 3 segundos (polling), gerando desperdício brutal de banda, latência alta e risco de bloqueio por rate limit.

5. O que acontece com os arquivos XML e históricos se o contrato for encerrado?

A legislação tributária brasileira (artigo 173 do Código Tributário Nacional) exige a guarda e custódia legal de todos os documentos fiscais eletrônicos pelo prazo decadencial de 5 anos mais o ano corrente. Existem plataformas que bloqueiam sumariamente o acesso aos arquivos XML e DANFE no instante em que o cliente encerra a assinatura, transformando os dados da empresa em reféns.

6. Como o motor fiscal reage a quedas da SEFAZ estadual (Contingência)?

Quando a SEFAZ do seu estado fica indisponível ou entra em manutenção, o que acontece com a sua operação? O emissor simplesmente retorna um erro de timeout 504 e trava as vendas da sua empresa?

7. Como funciona a gestão de Certificados Digitais A1?

Para emitir em nuvem com alta disponibilidade, o Certificado Digital ICP-Brasil A1 (arquivo .pfx ou .p12) é obrigatório. Mas como o provedor protege as chaves privadas da sua empresa ou dos seus clientes?

8. Há suporte para Multi-CNPJ e múltiplos ambientes sem custos abusivos?

Se a sua empresa possui filiais em diferentes estados ou se você é uma software house atendendo dezenas de estabelecimentos emitentes, muitos fornecedores exigem a contratação de uma assinatura separada para cada CNPJ, multiplicando o custo da operação.

9. A mesma API cobre NF-e (55), NFC-e (65), NFS-e e DC-e?

Integrar três fornecedores diferentes — um para mercadorias (NF-e/NFC-e), outro para serviços de prefeituras (NFS-e) e outro para logística de transportes — cria um pesadelo de manutenção de bibliotecas, contratos paralelos e suporte fragmentado.

10. O provedor já está preparado para a Reforma Tributária (IBS, CBS e Split Payment)?

A partir de 2026, com a entrada das Notas Técnicas da Reforma Tributária (como a NT 2026.002 e o início da fase de testes do IBS e da CBS), o seu software fiscal precisa acompanhar as frequentes atualizações de layout do ENCAT e da Receita Federal. Provedores lentos ou com código legado demoram meses para lançar patches.

Resumo Comparativo: O Que Exigir no Seu Contrato