Como integrar a emissão de nota fiscal ao seu sistema

Emitir nota na mão, copiando dados do sistema de vendas para o portal da prefeitura ou para um emissor gratuito, funciona até o dia em que não funciona. Basta o volume crescer um pouco para aparecer nota com valor errado, cliente cobrando a nota que não chegou e o financeiro passando a tarde nisso. Integrar a emissão ao sistema resolve, mas antes é preciso saber qual nota você emite.

Os tipos de nota

NF-e (modelo 55)

A nota fiscal eletrônica de produtos, usada na venda entre empresas e no transporte de mercadorias. É autorizada pela Secretaria da Fazenda (SEFAZ) do seu estado, com layout nacional.

NFC-e (modelo 65)

A nota do consumidor, que substituiu o cupom fiscal na maioria dos estados. É a nota da venda no balcão ou da loja virtual para pessoa física, com QR Code para consulta.

NFS-e

A nota de serviço. Por muitos anos cada município teve o próprio sistema e o próprio layout, o que tornava a integração um pesadelo para quem atende clientes em várias cidades. Com o padrão nacional da NFS-e e a reforma tributária, os municípios estão migrando para o emissor e o ambiente nacionais, o que simplifica bastante a integração. Ainda assim, vale confirmar a situação da sua prefeitura antes de começar.

Os dois jeitos de integrar

Direto com a SEFAZ ou com o ambiente nacional

O seu sistema monta o XML da nota, assina com o certificado digital da empresa e envia para o webservice do governo. Depois trata o retorno: autorizada, rejeitada (com um código de erro) ou fora do ar.

Prós: sem mensalidade de terceiros e controle total.

Contras: dá trabalho. Há dezenas de regras de validação, códigos de rejeição, notas técnicas que mudam o layout várias vezes por ano e casos como contingência (quando a SEFAZ cai) e cancelamento fora do prazo. Quem escolhe esse caminho precisa de alguém acompanhando as mudanças.

Por uma API de emissão

Empresas especializadas oferecem uma API mais simples: o seu sistema manda os dados da venda em JSON e recebe a nota pronta, com XML e PDF (o DANFE). Elas cuidam da assinatura, das mudanças de layout, da contingência e, no caso da NFS-e, das diferenças entre prefeituras.

Prós: integração muito mais rápida e manutenção quase zero do seu lado.

Contras: custo por nota ou mensalidade, e dependência do fornecedor.

Para a maioria das empresas pequenas e médias, a API de emissão é o caminho certo. A emissão direta compensa quando o volume é muito alto ou quando a nota é o produto, como em sistemas de gestão vendidos para outras empresas.

O certificado digital

Toda nota é assinada com o certificado digital da empresa (e-CNPJ). Para integração em servidor, use o tipo A1, que é um arquivo instalado no sistema e vale um ano. O A3 fica num cartão ou token físico e não serve para emissão automática em servidor.

O certificado é um dado sensível: com ele, alguém emite notas em nome da sua empresa. Ele deve ficar criptografado, com acesso restrito, e nunca no código-fonte ou em e-mail. Também precisa de um alerta antes do vencimento, porque certificado vencido para a emissão inteira.

O que muda com a reforma tributária

A reforma do consumo criou a CBS (federal) e o IBS (estados e municípios), que vão substituir aos poucos PIS, Cofins, ICMS e ISS. Desde 2026 os layouts das notas têm campos para esses tributos, num período de transição que vai até o começo da década de 2030.

Para quem integra, isso significa duas coisas. O sistema precisa calcular e informar campos novos, e o cadastro de produtos e serviços precisa estar certo (NCM, código de serviço), porque é dele que sai o tributo. Um bom motivo para usar uma API de emissão é que ela acompanha essas mudanças por você. Mesmo assim, as regras de tributação da sua empresa devem ser definidas com o seu contador, não pelo programador.

Um fluxo que funciona

1. A venda é confirmada no sistema (pagamento aprovado ou pedido faturado).
2. O sistema envia os dados para a emissão e guarda o status como "processando".
3. A resposta chega: autorizada guarda XML e PDF; rejeitada avisa alguém com o motivo.
4. O cliente recebe a nota por e-mail ou WhatsApp, automaticamente.
5. O XML fica guardado por pelo menos cinco anos, que é o prazo legal.

O passo 3 é onde a maioria das integrações malfeitas falha: a nota rejeitada fica parada sem ninguém saber. Um aviso para o financeiro resolve. Se quiser mandar a nota pelo WhatsApp, veja integração com WhatsApp, API oficial ou não oficial.