NeFS-e Nacional NT 009 pode transformar uma mudança aparentemente simples, como aceitar letras no CNPJ, em uma sequência de falhas no cadastro, na validação fiscal e até na autorização da nota. E essa é apenas uma das alterações que exigirão atenção dos desenvolvedores e empresas usuárias de ERP.
Afinal, com a implementação da Reforma Tributária, os sistemas fiscais precisam aprender a lidar com novas informações de IBS e CBS e notas de ajuste. Vamos ver os impactos para o desenvolvimento de software e planejamento fiscal.
Neste artigo, você vai ver o que mudou, quais estruturas precisam ser revisadas e como preparar sua aplicação para essa nova etapa da NFS-e Nacional. Acompanhe!
NFS-e Nacional NT 009: o que é, e o que muda?
NFS-e Nacional NT 009 é a Nota Técnica, versão 1.0, publicada pela Secretaria-Executiva do Comitê Gestor da NFS-e. O que ocorreu em 4 de junho de 2026 para consolidar e atualizar o layout da Declaração de Prestação de Serviços (DPS) — e da NFS-e Nacional. Isso diante as regras da Reforma Tributária do Consumo.
Antes de mais nada, a Lei Complementar nº 214/2025 regulamentou a reforma. Que também instituiu o Imposto sobre Bens e Serviços (IBS) e da Contribuição sobre Bens e Serviços (CBS), dentre outros.
A Nota Técnica 009 não trata apenas da inclusão de dois novos tributos.
Ao todo, a publicação oficial organiza as mudanças em 8 grandes tópicos de evolução, atingindo tanto a DPS enviada pelo contribuinte quanto a NFS-e gerada pelo ambiente nacional.
Entre as principais mudanças, estão:
CNPJ alfanumérico
Todos os campos de CNPJ não são mais tratados como numéricos e passam a ser do tipo caractere.
Isso é necessário porque a Receita Federal iniciará a implementação dos novos CNPJs alfanuméricos em julho de 2026. Ou seja, a Receita informou que o primeiro registro nesse formato será em 31 de julho de 2026.
Notas de ajuste de IBS e CBS
Foi criado o grupo gIBSCBSAjuste, com os campos vIBS e vCBS.
Então, esse campo passa a identificar uma NFS-e regular, uma nota de crédito ou uma nota de débito. Também foram incluídos os campos tpNFSeDebito e tpNFSeCredito.
Unificação dos ajustes de base de cálculo
Os grupos vDedRed e gReeRepRes foram reorganizados no grupo.
Logo, a intenção é centralizar as deduções, reduções, reembolsos, repasses e ressarcimentos.
Novos nomes e fórmulas
Já o campo vCalcDR passou a chamar vCalcAjusteBCISSQN.
Lembre-se, o campo específico vCalcAjusteBCLocImoveis foi criado para determinadas operações imobiliárias.
Simples Nacional
Continuando, o domínio de opSimpNac recebe a opção “4 — Optante Pendente”.
Atenção ao cronograma de implantação dessa novidade
Ainda sobre NFS-e Nacional NT 009, é preciso ter uma estratégia cuidadosa de versionamento.
Em atualização recente, publicada no Portal Nacional da NFS-e em 15 de julho de 2026, o Comitê Gestor informou que a NT 009 não estará disponível nos ambientes de Produção e Produção Restrita em agosto de 2026.
Ou seja, o cronograma específico de implantação dessa nota técnica será divulgado, em breve.
Para a obrigatoriedade dos grupos IBS/CBS prevista a partir de 3 de agosto de 2026, o layout-base indicado pelo portal é, neste momento, o da NT 004, acrescido do campo tpRetPisCofins introduzido pela NT 007.
Alterações no layout: NFS-e Nacional NT 009, como fazer os ajustes?
NFS-e Nacional NT 009 é considerada como uma migração de contrato fiscal. Ou seja, não é apenas uma alteração visual na tela de emissão.
A seguir, veja um roteiro prático para você conduzir essa adaptação no sistema:
- Separe as versões do leiaute
Você não deve iniciar a implementação apagando ou sobrescrevendo as estruturas anteriores, sobre as mudanças nessa nota técnica.
Então, crie um controle explícito de versão para que seu ERP consiga gerar diferentes payloads conforme o ambiente e o cronograma oficial.
Portanto, utilize, no mínimo, uma estrutura compatível com o leiaute atualmente aceito em produção; e uma outra estrutura destinada à NT 009;
A própria Nota Técnica foi publicada com o Anexo VI, versão 1.04.00. Onde contém o leiaute consolidado da DPS/NFS-e, e o Anexo VII, versão 1.02.00.
- Transforme o CNPJ em dado textual
Nesse sentido, a NT 009 exige que nenhum campo de CNPJ seja armazenado ou processado como número inteiro. O tipo deve ser textual em todas as camadas.
No mais, revise principalmente:
- colunas numéricas no banco de dados;
- conversões como parseInt, long, decimal ou equivalentes;
- ordenações numéricas;
- bibliotecas de validação de CNPJ;
- serializadores que removam letras ou zeros à esquerda;
- relatórios e arquivos de exportação.
Agora, é hora de conhecer sobre essa tecnologia que vem transformando os negócios.
- Crie um motor de ajustes de base de cálculo
A NT 009 concentra diferentes hipóteses no grupo vAjusteBC. Por isso, o ideal é modelar o ajuste como uma entidade própria, com tipo, valor, documento relacionado, fornecedor e repercussão tributária.
Portanto, prefira uma tabela de regras, que indique se o ajuste repercute, veja:
- na base de cálculo do ISSQN;
- na base do IBS e da CBS;
- na receita bruta do Simples Nacional.
Aproveite e conheça a nossa melhor solução, a Mercúrio App nessa área.
Como fazer outras alterações necessárias?
Vejamos abaixo, outras alterações que podem ser necessárias até agora.
Parametrize o Simples Nacional
A nota NT 009 exige que o cadastro tributário do prestador seja capaz de representar mais do que a resposta “é ou não é optante”.
Lembre-se, o ERP deverá identificar: quem é não optante; se é MEI; ou microempresa ou empresa de pequeno porte; bem como optante pendente e as alíquotas e valores de IBS/CBS calculados pelo regime.
Essa parametrização não deve ficar fixa no código-fonte.
Outros ajustes que são necessários: veja
Outros ajustes possíveis são estes:
1 Modele imóveis, bens móveis e pagamentos como coleções
NFS-e Nacional NT 009 introduz estruturas que podem repetir-se muitas vezes dentro da mesma nota.
Por isso, prepare coleções capazes de armazenar:
- até 99 unidades imobiliárias;
- até 1.000 bens móveis;
- até 99 transações de pagamento.
Nesse sentido, para o grupo gPgtoVinc, armazene o identificador da transação, o tipo de pagamento, o CNPJ do recebedor e o CNPJ-base da instituição financeira ou de pagamento.
2 Atualize os testes automatizados
Nesse cenário, é preciso entrar no pipeline de qualidade antes de chegar ao cliente final. Crie cenários de teste para, no mínimo:
- CNPJ tradicional e CNPJ alfanumérico;
- NFS-e regular;
- NFS-e de ajuste de crédito;
- rejeições por domínio, tamanho e ocorrência.
No mais, aumentar as vendas com automação pode ser importante pra você, veja sobre isso aqui
Como a Mercúrio App pode ajudar o desenvolvedor?
NFS-e Nacional NT 009 aumenta a importância da integração entre dados fiscais, vendas, pagamentos, estoque, financeiro e cadastro de clientes.
Nesse cenário, a Mercúrio App pode funcionar como uma plataforma de gestão integrada, o que reduz a fragmentação das informações que alimentam a emissão fiscal.
Para tanto, essa integração pode ajudar de diferentes maneiras, veja:
Integração por API
Antes de tudo, a referência pública à documentação de API permite que sistemas externos, aplicativos, e-commerce e módulos próprios troquem informações com o nosso ecossistema Mercúrio App .
Automação da emissão fiscal
Pois bem, um fluxo integrado pode transformar a venda ou a prestação registrada no ERP em uma emissão fiscal automatizada.
Vinculação entre recebimento e nota
Assim, a existência de informações integradas de Pix, boleto e cartão é especialmente relevante diante do novo grupo gPgtoVinc.
Porém, é importante validar diretamente com a equipe técnica da Mercúrio quais versões do leiaute da NFS-e estão atualmente disponíveis. Veja agora como funciona nossa solução e os recursos que podem ser úteis para você nesse momento.
Conclusão
Enfim, a NFS-e Nacional NT 009 representa uma transformação profunda na maneira como os sistemas de gestão deverão estruturar, calcular e transmitir informações fiscais sobre serviços.
Portanto, conte com a ajuda especializada da Mercúrio App. Fale conosco!
(51) 9 9533-4827
(51) 3756-1001
