Pular para o conteúdo
Escola Ninja WP Blog

Nota Fiscal · · 6 min de leitura

API de nota fiscal sem mensalidade: como funciona a cobrança das APIs e quando vale ter a sua

Por Flávio Henrique, CEO da Escola Ninja WP, à frente da escola desde 2009.

Resumo

As APIs de nota fiscal por assinatura cobram mensalidade, franquia de notas ou valor por nota, e o custo acompanha o seu volume. Uma API de nota fiscal sem mensalidade é um código-fonte que você instala no seu servidor e que fala direto com a SEFAZ, com pagamento único. Ela compensa quando o volume é recorrente, quando você atende várias empresas ou quando os dados fiscais precisam ficar com você.

Quem pesquisa API de nota fiscal encontra dezenas de opções, quase todas no mesmo modelo: você cria uma conta, recebe uma chave e paga mensalidade, franquia ou um valor por nota emitida. Para muita empresa, isso resolve. Para outras, a fatura vira um custo que cresce todo mês sem parar.

Neste artigo você vai entender como essas APIs cobram, como colocar o seu volume na conta e quando uma API de nota fiscal sem mensalidade, instalada no seu servidor, passa a fazer mais sentido.

Como funciona uma API de nota fiscal

Toda API de nota fiscal faz o mesmo trabalho por baixo: recebe os dados da venda em JSON, monta o XML no leiaute oficial, assina com o certificado digital da empresa, envia à SEFAZ e devolve o resultado. A diferença está em onde isso acontece e quem cobra por isso.

API por assinatura (SaaS)

O processamento acontece no servidor do fornecedor. Você manda os dados para ele, e ele fala com a SEFAZ. O certificado digital da sua empresa fica guardado lá, assim como os XML das notas.

API própria (código-fonte)

O processamento acontece no seu servidor. O seu sistema chama a sua API, e a sua API fala direto com a SEFAZ. Não existe intermediário no meio, e por isso não existe tarifa por nota.

Os modelos de cobrança das APIs de nota fiscal

Mensalidade fixa

Um valor por mês, geralmente com limite de notas ou de empresas. Simples de prever, mas você paga o mesmo valor nos meses fracos.

Franquia com excedente

O plano inclui um número de notas. Passou do limite, cada nota extra é cobrada à parte. É o modelo mais comum e o que mais surpreende na fatura de dezembro.

Valor por nota

Sem mensalidade fixa, mas cada nota emitida tem um preço. Ótimo para quem emite pouco. Para quem emite muito, vira o modelo mais caro.

Por empresa (CNPJ)

Quem atende várias empresas, como software houses e escritórios de contabilidade, muitas vezes paga por CNPJ cadastrado, além das notas. Aqui a conta cresce em duas frentes ao mesmo tempo.

Como fazer a conta com o seu volume

Pegue a cotação do fornecedor que você usa ou está avaliando e preencha:

  • N = notas emitidas por mês (some NF-e, NFC-e e NFS-e)
  • E = empresas emissoras (CNPJs)
  • M = mensalidade do plano
  • X = valor por nota excedente ou por nota emitida
  • K = valor por CNPJ, se houver

Custo mensal da assinatura ≈ M + (notas acima da franquia × X) + (E × K)

Para a API própria, sem mensalidade:

  • C = pagamento único pelo código-fonte
  • S = servidor por mês (muitas vezes você já tem um rodando o seu sistema)

Custo acumulado no mês T = C + (S × T)

Compare o acumulado dos dois modelos em 12 e em 24 meses. Lembre que, na API própria, o volume de notas não altera a conta.

Os custos que aparecem nos dois modelos

O certificado digital A1 de cada empresa e o tempo de quem integra existem em qualquer escolha. Não deixe que eles distorçam a comparação.

Os custos que só aparecem na API própria

Seja justo também do outro lado. Com a API no seu servidor, entram na conta a instalação, as atualizações quando a SEFAZ publica uma nota técnica, o monitoramento do servidor e o backup dos XML. Se você já mantém um sistema no ar, boa parte disso é rotina que a equipe já faz. Se não mantém, inclua essas horas na comparação antes de decidir.

Quando a API de nota fiscal sem mensalidade compensa

Volume recorrente

Uma loja virtual que emite nota a cada pedido, um PDV com NFC-e em todas as vendas ou uma empresa de serviços com faturamento mensal. Quanto mais notas, mais rápido o pagamento único se paga.

Várias empresas no mesmo sistema

Software houses, contadores e quem revende sistema para clientes. Aqui o custo por CNPJ some, e você pode cobrar do seu cliente pela emissão. Num caso assim, vale olhar a versão com painel multiempresa.

Dados fiscais que precisam ficar com você

A legislação obriga o emitente a guardar os XML das notas pelo prazo legal. Com a API própria, os XML ficam no seu servidor desde o primeiro minuto, e o certificado da empresa não precisa ser enviado a terceiros.

Integração com e-commerce

Se você usa WooCommerce, um plugin que manda o pedido para a sua API e emite a nota de cada venda elimina a digitação manual. Vamos detalhar esse fluxo no guia de nota fiscal no WooCommerce.

Como migrar de uma API por assinatura para a sua

Se você já emite por uma API paga, a troca pode ser feita sem parar de faturar. Um roteiro seguro:

  1. Instale a API própria no seu servidor e configure a empresa no ambiente de homologação da SEFAZ.
  2. Mapeie os campos. Compare o JSON que o seu sistema envia hoje com o formato da nova API. Em geral, destinatário, itens, impostos e pagamento têm equivalentes diretos.
  3. Emita notas de teste com os cenários reais do seu negócio: venda para CNPJ, venda para CPF, frete, desconto, devolução.
  4. Combine a numeração com o contador. A nova API precisa começar do próximo número livre da série, ou usar uma série nova. Não pode haver dois sistemas emitindo na mesma série ao mesmo tempo.
  5. Troque o endereço da API no seu sistema num dia de movimento baixo e acompanhe as primeiras notas em produção.
  6. Baixe os XML antigos do fornecedor anterior antes de cancelar o plano. A guarda é obrigação sua, não dele.
  7. Cancele a assinatura só depois de alguns dias de emissão estável.

Exemplo de chamada

Numa API própria bem feita, emitir uma nota é um POST com JSON e uma chave de idempotência, algo nesta linha:

POST /nfe
Authorization: Bearer SUA_CHAVE
Idempotency-Key: pedido-1001
Content-Type: application/json

Se a mesma requisição chegar duas vezes, por um clique duplo ou uma falha de rede, a API devolve a resposta original em vez de emitir de novo. É esse tipo de detalhe que separa um código de vitrine de um emissor pronto para produção.

Quando a assinatura ainda é a melhor escolha

Seja honesto com o seu cenário. A API por assinatura continua sendo a melhor opção quando:

  • você emite poucas notas por mês e não pretende crescer nisso;
  • não há ninguém técnico para instalar a API e renovar o certificado no servidor;
  • você precisa de uma solução sem nenhuma infraestrutura própria.

O que exigir de uma API de nota fiscal própria

Ter o código não basta: ele precisa ser bom de integrar e seguro.

  • API REST em JSON, sem obrigar você a montar XML.
  • Documentação Swagger/OpenAPI com todos os endpoints.
  • Chave de idempotência, para que uma requisição repetida não emita nota duplicada.
  • Webhooks assinados, que avisam o seu sistema quando a nota é autorizada, rejeitada ou cancelada.
  • Ciclo completo: emitir, cancelar, carta de correção, inutilizar e consultar pela chave.
  • Contingência SVC para a NF-e.
  • Certificado e senha cifrados, chave de API obrigatória e registro de auditoria.
  • Lista clara do que não faz, para você planejar sem surpresa.

Se você ainda está decidindo entre montar ou comprar, o artigo emissor de NF-e com código-fonte: comprar pronto ou montar do zero traz um roteiro de decisão em quatro perguntas.

Conclusão

API de nota fiscal sem mensalidade não é mágica nem é grátis: você troca a assinatura por um pagamento único e passa a cuidar do seu servidor. Em troca, o volume deixa de pesar na conta, os dados ficam com você e não há intermediário entre o seu sistema e a SEFAZ. Coloque o seu volume na fórmula, compare 12 e 24 meses e escolha com números na mão.

Perguntas frequentes

Existe API de nota fiscal gratuita?

Existem projetos abertos que você pode usar sem pagar licença, mas eles exigem integração, servidor e manutenção. Também há planos gratuitos limitados em APIs por assinatura. Gratuito de verdade, sem nenhum custo, não existe: alguém paga pelo servidor, pelo certificado e pela manutenção.

Uma API de nota fiscal sem mensalidade tem algum custo recorrente?

Sim, mas são custos que você já teria: o servidor onde a API roda e a renovação do certificado digital da empresa. Não há tarifa por nota nem assinatura do emissor.

A API sem mensalidade emite NFS-e também?

Depende do produto. O nosso Emissor emite NF-e, NFC-e e NFS-e pelo padrão nacional, nos municípios que aderiram a ele.

O que acontece se a SEFAZ cair usando uma API própria?

Para a NF-e existe a contingência SVC, que autoriza a nota por outro ambiente enquanto a SEFAZ do estado está fora. A API precisa suportar esse modo. No nosso Emissor, basta indicar a contingência na requisição; no Emissor Completo ela é acionada automaticamente.

Leia também