NFS-e Nacional: Como Integrar no Seu Sistema até Novembro

O novo prazo da NFS-e Nacional e o que muda para sua empresa

Saber como integrar a NFS-e Nacional no meu sistema tornou-se uma prioridade técnica e operacional para prestadores de serviço e desenvolvedores. A Resolução CGSN nº 191/2026 estabeleceu o adiamento oficial do prazo de obrigatoriedade de 1º de setembro para 1º de novembro de 2026 para microempresas (ME) e empresas de pequeno porte (EPP) optantes do Simples Nacional que prestam serviços sujeitos ao ISS. Os Microempreendedores Individuais (MEIs) já utilizam o padrão obrigatoriamente desde 1º de setembro de 2023.

Essa mudança visa dar fôlego para adequação tecnológica, mas o calendário exige atenção. Entre 1º de novembro e 31 de dezembro de 2026, vigorará um período de transição: a empresa passa a emitir pelo sistema nacional, porém continua seguindo as regras de tributação do Simples Nacional, sem aplicação imediata dos novos tributos IBS e CBS. O recolhimento por IBS e CBS no Simples passará a valer a partir de 1º de janeiro de 2027, integrando o cenário de Reforma Tributária em sistemas em 2026.

A adoção do padrão simplifica a rotina de quem emite notas para diferentes municípios, pois unifica o modelo fiscal. A adesão já alcança cerca de 3.000 municípios, incluindo 19 capitais, o que representa aproximadamente 80% do volume nacional de notas fiscais de serviço.

Principais pontos

• Prazo final: 1º de novembro de 2026 para MEs e EPPs do Simples Nacional.
• Período de transição: de 1º de novembro a 31 de dezembro de 2026 (IBS/CBS valem para o Simples a partir de 1º de janeiro de 2027).
• Modalidades de emissão: Web, aplicativo mobile e integração via API REST.
• Exigências técnicas da API: TLS com mTLS, certificado ICP-Brasil (A1/A3), XML 1.0 em UTF-8 assinado em XMLDSIG e payload em GZip com Base64.

Formas de emissão: site, aplicativo ou integração via API?

A emissão de notas no padrão nacional só pode ser realizada através do Emissor Nacional fornecido pelo governo federal, em três modalidades distintas. A escolha depende diretamente do volume de vendas da empresa e da necessidade de automação dos processos operacionais.

A primeira modalidade é a aplicação web disponível no endereço oficial nfse.gov.br/EmissorNacional. A segunda opção é o aplicativo mobile oficial. Ambas são gratuitas e indicadas para baixos volumes de notas diárias, mas exigem preenchimento manual em cada transação. A terceira modalidade é a integração direta do seu ERP ou checkout via API Web, recomendada para empresas que precisam de ganho de escala e automação.

Para ajudar na tomada de decisão, confira a comparação entre as opções do panorama completo do padrão nacional:

Critério	Aplicação Web	Aplicativo Mobile	Integração via API
Volume indicado	Baixo (manual)	Baixo (manual)	Médio a Alto (automático)
Interface	Navegador desktop	Smartphone	Invisível / Integrada ao ERP
Custo de implementação	Zero	Zero	Requer desenvolvimento e certificado
Risco de erro humano	Alto	Alto	Baixo (regras validadas via código)
Agilidade	Digitação por nota	Digitação por nota	Emissão instantânea no checkout

Requisitos técnicos para integrar a API da NFS-e Nacional

Integrar o emissor diretamente no seu software exige cumprir especificações de segurança e formatação rigorosas estipuladas pela documentação oficial. O canal de comunicação é construído sobre uma arquitetura REST com envio e recebimento de dados em JSON nas requisições principais.

Para estabelecer a conexão segura com os servidores, é obrigatório utilizar o protocolo TLS com autenticação mútua (mTLS). Isso significa que a aplicação precisa apresentar um certificado digital ICP-Brasil válido (tipos A1 ou A3) vinculado ao responsável técnico do sistema durante o handshake da conexão.

O fluxo de dados do documento fiscal em si requer uma estrutura específica. O payload do serviço contém o XML 1.0 codificado em UTF-8 e assinado digitalmente no padrão XMLDSIG. Além disso, antes do envio pela API, o XML assinado deve ser compactado no formato GZip e convertido em uma string Base64.

// Exemplo conceitual do fluxo de preparação do payload para a API
import { gzipSync } from 'zlib';

function prepararPayloadNFSe(xmlAssinadoUTF8: string): string {
  // 1. Converter XML para Buffer UTF-8
  const xmlBuffer = Buffer.from(xmlAssinadoUTF8, 'utf-8');
  
  // 2. Compactar o buffer em GZip
  const gzippedBuffer = gzipSync(xmlBuffer);
  
  // 3. Converter para Base64 para envio na requisição JSON
  return gzippedBuffer.toString('base64');
}

Os endpoints disponibilizados pelo webservice cobrem todo o ciclo de vida do documento fiscal. Eles incluem emissão de NFS-e, consulta de lotes e de notas individuais, cancelamento de documentos emitidos, recebimento de eventos fiscais e a geração automática do DANFSE em formato PDF.

Credenciamento, ambiente de homologação e validação de schema

O processo de credenciamento técnico exige que o responsável pela aplicação possua um CNPJ válido e um certificado digital e-CNPJ ou e-CPF do responsável técnico. Para garantir a proteção das chaves privadas durante as operações do sistema, recomenda-se fortemente o armazenamento das credenciais em um HSM (Hardware Security Module) ou em um cofre digital seguro.

Antes de enviar requisições para o ambiente de produção, os desenvolvedores têm acesso a um ambiente de homologação separado. No Portal NFS-e, estão disponíveis arquivos Swagger e especificações em YAML para facilitar a geração de clientes de API e o roteamento de testes.

Desde 10 de dezembro de 2025, a estrutura governamental disponibiliza um ambiente restrito focado nos campos do grupo IBSCBS, alinhado à Nota Técnica 004 versão 2.0. Esse ambiente permite simular a estrutura fiscal completa que entrará em vigor nas etapas da transição tributária.

Conforme os alertas de validação de schema e documentação de API, o menor erro de layout, um campo obrigatório ausente ou um tipo de dado inválido interrompe imediatamente a operação. Dessa forma, implementar uma camada rigorosa de validação de schema XML localmente antes de disparar o pacote para o webservice é um passo indispensável para evitar bloqueios na fila de emissão.

Roteiro prático de implementação até novembro

Para garantir que o seu sistema esteja rodando sem percalços até o prazo limite de 1º de novembro de 2026, vale a pena seguir um cronograma estruturado em quatro etapas práticas:

1. Auditoria de certificados digitais: Verifique se sua empresa ou os clientes do seu software possuem certificados A1/A3 ICP-Brasil válidos e configure o cofre digital ou HSM para gerenciar as chaves de acesso mTLS.
2. Modelagem do schema e assinatura: Desenvolva os módulos de conversão para XML 1.0 UTF-8, assinatura XMLDSIG, compactação GZip e codificação Base64 dentro da sua aplicação.
3. Testes no ambiente de homologação: Consuma a documentação Swagger no Portal NFS-e e execute cenários de teste cobrindo emissão, consulta, cancelamento e geração de DANFSE em PDF.
4. Validação das regras de transição: Utilize o ambiente restrito com o grupo IBSCBS (Nota Técnica 004 v2.0) para garantir que sua estrutura de banco de dados e APIs já estejam preparadas para as mudanças fiscais futuras.

Perguntas frequentes

Qual o prazo final para MEs e EPPs adotarem a NFS-e Nacional?

O prazo final para microempresas e empresas de pequeno porte optantes do Simples Nacional é 1º de novembro de 2026. A data foi estipulada oficialmente pela Resolução CGSN nº 191/2026, alterando a obrigação inicial que era setembro de 2026.

O MEI precisa alterar o sistema de emissão em novembro de 2026?

Não, o MEI não precisa fazer alterações nessa data. Os Microempreendedores Individuais já estão obrigados a utilizar o padrão do Emissor Nacional de NFS-e desde 1º de setembro de 2023.

Quais são as exigências de segurança para conectar na API Nacional?

Conectar na API exige uso de HTTPS com TLS e autenticação mútua (mTLS), utilizando um certificado digital ICP-Brasil A1 ou A3 do responsável técnico. As requisições trafegam em JSON e exigem payloads contendo XML assinado em XMLDSIG, compactado em GZip e codificado em Base64.

Onde encontrar a documentação e o ambiente de testes da API?

A documentação oficial, os arquivos Swagger e as especificações YAML estão publicados no Portal NFS-e do governo federal. O portal disponibiliza ambiente de homologação e ambiente restrito para validações de código.

Conclusão

A migração para a NFS-e Nacional é inevitável e o prazo estendido até 1º de novembro de 2026 oferece a janela perfeita para organizar o código sem correria. Unificar a emissão sob o padrão nacional elimina a complexidade de lidar com múltiplos layouts municipais e prepara sua estrutura para as exigências fiscais dos próximos anos.

Sua recomendação prática para hoje: acesse o Portal NFS-e, baixe a especificação Swagger atualizada da API e configure o certificado digital da empresa no ambiente de homologação para realizar os primeiros disparos de teste.