NT 009 da NFS-e: o que muda no layout para integrar

Guia técnico das mudanças de campos, grupos e fórmulas que afetam quem desenvolve emissão de NFS-e, antes mesmo do cronograma de implantação.

Resumo Executivo

O que você vai entender neste post:

• A NT 009 não é um evento isolado: ela é mais um passo de uma sequência de Notas Técnicas que vêm reescrevendo o layout da NFS-e para a Reforma Tributária.
• O CNPJ alfanumérico muda o tipo de dado de todos os campos CNPJ do layout, de numérico para caractere, com efeito a partir de julho de 2026.
• Os grupos de dedução vDedRed e gReeRepRes foram unificados em vAjusteBC, o que altera o mapeamento de quem já tinha integração com versões anteriores.
• As fórmulas de base de cálculo do ISSQN e do IBS/CBS foram reescritas, com nova lógica de composição.
• O cronograma de implantação ainda não foi publicado, e essa indefinição é a informação que mais deveria orientar a sua estratégia de desenvolvimento agora.

1. O contexto: a NFS-e está em refatoração contínua

A Secretaria-Executiva do Comitê Gestor da Nota Fiscal de Serviço Eletrônica de Padrão Nacional publicou a Nota Técnica nº 009, versão 1.0, em 4 de junho de 2026. Ela complementa e ajusta o layout descrito em Notas Técnicas anteriores, no contexto da Reforma Tributária do Consumo.

Quem acompanha o tema percebe o padrão. A NFS-e nacional não recebeu uma adequação única para a Reforma. Recebeu uma sequência de Notas Técnicas ao longo de 2025 e 2026, cada uma alterando campos, grupos e regras de validação. A NT 009 é a mais recente dessa série, publicada poucas semanas depois da anterior, que tratou do documento auxiliar (DANFSe).

Para quem desenvolve, esse é o ponto central. A adequação à NFS-e da Reforma não é um projeto com começo, meio e fim. É uma esteira de manutenção fiscal sobre um alvo que se move a cada Nota Técnica. A NT 009 mexe em oito frentes do layout ao mesmo tempo, e é assim que vale lê-la: como mais uma rodada de refatoração de schema, não como um comunicado pontual.

2. CNPJ alfanumérico: a mudança de tipo que toca todo o layout

A primeira alteração da NT 009 parece pequena na descrição e é grande na prática. Todos os campos CNPJ do layout tiveram o tipo de dado alterado, de numérico (N) para caractere (C). O objetivo é contemplar o novo formato alfanumérico do Cadastro Nacional de Pessoas Jurídicas, previsto para ser implementado a partir de julho de 2026.

O ponto crítico é que isso não é uma mudança de regra de negócio. É uma mudança de contrato de dados. Qualquer validação de CNPJ que assuma apenas dígitos vai quebrar quando chegar um caractere alfabético. Isso atinge a máscara de entrada, validação de formato, persistência em banco com coluna numérica e qualquer cálculo de dígito verificador escrito para o formato antigo.

Sistemas que tratam CNPJ como inteiro em algum ponto da pilha estão expostos. A regra prática é varrer o código atrás de toda suposição de que CNPJ é numérico e tratar o campo como string em toda a cadeia, da interface ao armazenamento. Quem mapear isso agora evita uma classe inteira de bugs silenciosos quando o formato alfanumérico entra em produção.

3. O merge que reorganiza deduções: vDedRed e gReeRepRes viram vAjusteBC

A NT 009 unificou dois grupos que antes carregavam informações de ajuste das bases de cálculo. Os grupos vDedRed e gReeRepRes foram concentrados em um único grupo, agora chamado vAjusteBC. A nota descreve a mudança como busca de maior clareza e concentração de campos com o mesmo teor informacional.

Para quem nunca integrou, é só um nome novo. Para quem já tinha código rodando contra o layout anterior, é retrabalho de mapeamento. O caminho dos campos mudou, e parte dos tipos de ajuste que existiam foi descontinuada na unificação.

3.1. Tipos de ajuste descontinuados

Três tipos saíram na unificação, e a razão importa para não recriar dados redundantes. O tipo de alimentação e bebidas de frigobar foi removido porque, por conta do IBS e da CBS, esses fornecimentos já são registrados em outros documentos fiscais eletrônicos. O tipo de produção externa foi suprimido por ser redundante com o tipo de ajuste 103, que descreve melhor a operação. E o tipo de reembolso de despesas saiu porque seus casos com reflexo em IBS e CBS já estão cobertos pelos tipos 103, 104 ou 199.

A regra prática para o time: ao migrar mapeamentos antigos, não tente preservar os tipos antigos por compatibilidade. Reescreva a classificação de ajuste para o novo domínio de tipos do grupo vAjusteBC, senão você carrega lixo de dados para dentro do novo formato.

3.2. Documentos referenciados e fornecedor

O novo grupo traz uma estrutura detalhada de documentos usados no ajuste de base de cálculo. Há referência a documento fiscal eletrônico do repositório nacional, a documento fiscal fora do repositório e a documento não fiscal, além de um grupo completo de dados do fornecedor, com endereço nacional ou no exterior. Em prosa simples: o layout passou a exigir rastreabilidade de origem do ajuste, não apenas o valor.

4. As fórmulas de base de cálculo foram reescritas

Esta é a parte com efeito fiscal direto, e por isso a que mais exige atenção e validação. A NT 009 renomeou campos de cálculo e atualizou as fórmulas de base de cálculo do ISSQN e do IBS/CBS na NFS-e.

No ISSQN, o campo vCalcDR passou a se chamar vCalcAjusteBCISSQN. A mudança não é só de nome. A nota é explícita ao dizer que a fórmula evoluiu em relação à anterior, passando a considerar todas as deduções com repercussão na base de cálculo do ISSQN, somando ajuste percentual e ajuste por documentos.

No IBS e na CBS, o campo vCalcReeRepRes virou vCalcAjusteBCIBSCBS, e o campo de dedução de bens imóveis foi renomeado para vCalcAjusteBCLocImoveis. A fórmula de base de cálculo desses tributos também mudou, e tem uma particularidade temporal: até 2026, ela subtrai ISSQN, PIS e COFINS, e de 2027 até 2032 subtrai apenas o ISSQN, refletindo o cronograma de transição da Reforma.

O alerta aqui é direto. Campo de cálculo errado significa imposto calculado errado. Toda lógica de apuração que referencia os nomes ou as fórmulas antigas precisa ser revista, e essa revisão exige validação fiscal, não apenas teste de integração.

5. Simples Nacional, bens imóveis e vínculo de pagamento

A NT 009 ainda abre três frentes que ampliam o escopo do que a NFS-e representa.

5.1. Simples Nacional

O campo de situação perante o Simples Nacional ganhou a opção de optante pendente, para o prestador cuja opção ainda aguarda regularização ou julgamento. Foram criados campos para indicar o regime de apuração de IBS e CBS pelo Simples e para informar o enquadramento da atividade conforme a Lei Complementar nº 123/2006. Surgiu também o campo de receita bruta do Simples e o grupo gTribSN, que detalha alíquota e valor de IBS e CBS para os optantes. A consequência prática é que a apuração de quem está no Simples passa a ter destaque próprio no documento, com campos que antes eram obrigatórios deixando de ser em razão dessa nova estrutura.

5.2. Bens imóveis

As operações com bens imóveis, exceto obras, passaram por reestruturação. Foram criados grupos específicos para locação, cessão onerosa ou arrendamento, e para as unidades imobiliárias envolvidas, com suporte a múltiplos registros em uma mesma NFS-e quando há copropriedade. Esses grupos baseiam o cálculo de valor do serviço e dos descontos, com a particularidade de aplicar o percentual de copropriedade sobre o valor total da operação. A locação de imóvel passou a ser fato gerador formalizado por NFS-e, e isso é novo território para muitos emissores.

5.3. Vínculo com a transação de pagamento

A NT 009 criou um grupo para vincular a NFS-e à transação de pagamento que a originou, com identificação do meio de pagamento, do recebedor e da instituição financeira. Uma mesma nota pode vincular até noventa e nove transações. É um sinal de direção: o fisco está aproximando o documento fiscal do fluxo financeiro real da operação.

6. Por que o cronograma ainda aberto é a parte mais importante

A própria NT 009 informa que o cronograma de implantação das funcionalidades será publicado nas próximas semanas no portal da NFS-e. Em outras palavras: as mudanças estão especificadas, mas não há data de vigência definida nesta Nota Técnica.

Esse detalhe muda a estratégia de quem desenvolve. Não existe prazo para correr atrás, e isso é uma armadilha. Esperar o cronograma para começar a adaptar é apostar contra o histórico recente, em que as Notas Técnicas se sucedem em intervalos curtos. Há duas leituras possíveis, e a defensável é a segunda: tratar a especificação como pronta para análise de impacto desde já, mesmo sem data, e deixar a implementação pronta para ativar quando o cronograma sair.

Há ainda um ponto que a nota deixa explícito e que pede cautela. Algumas regras relacionadas às notas de ajuste foram inseridas no material, porém tachadas, porque ainda estão em evolução e devem mudar. A regra prática é não construir lógica definitiva sobre o que a própria fonte sinaliza como provisório. Mapeie, mas não congele.

Mapear o impacto agora e modular a implementação por frente, do CNPJ alfanumérico às fórmulas de cálculo, é o que separa quem vai ativar a adequação com um deploy de quem vai descobrir o tamanho do problema quando o relógio começar a correr.

7. Perguntas Frequentes

1. A NT 009 da NFS-e já está em vigor?

A NT 009 foi publicada em 4 de junho de 2026, mas a própria Nota Técnica informa que o cronograma de implantação das funcionalidades será publicado depois, no portal da NFS-e. Não há, nesta NT, uma data de vigência definida para as mudanças de layout.

2. O que muda na prática para quem desenvolve emissão de NFS-e?

As mudanças são de layout e de cálculo: tipo de dado do CNPJ alterado para caractere, unificação dos grupos de dedução em vAjusteBC, renomeação de campos de cálculo e novas fórmulas de base de cálculo do ISSQN e do IBS/CBS, além de novos grupos para Simples Nacional, bens imóveis e vínculo de pagamento.

3. Por que o CNPJ alfanumérico exige atenção mesmo sendo uma mudança de formato?

Porque ele altera o contrato de dados. Todo campo CNPJ deixa de ser numérico e passa a ser caractere. Validações, máscaras, persistência e cálculo de dígito verificador que assumam apenas números precisam ser revistos para aceitar caracteres alfabéticos a partir de julho de 2026.

4. Os tipos de dedução antigos continuam válidos?

Não na forma anterior. A unificação em vAjusteBC descontinuou tipos como alimentação e bebidas de frigobar, produção externa e reembolso de despesas, por redundância ou por estarem cobertos por outros tipos de ajuste. A recomendação é remapear a classificação para o novo domínio, sem preservar os tipos antigos.

5. A mudança nas fórmulas de cálculo pode gerar imposto errado?

Sim, se a lógica de apuração continuar referenciando os campos ou as fórmulas antigas. A NT 009 renomeou campos e alterou a composição da base de cálculo do ISSQN e do IBS/CBS, inclusive com diferença entre o período até 2026 e o período de 2027 a 2032. A revisão pede validação fiscal, não apenas teste de integração.

6. Vale começar a adaptar antes do cronograma sair?

Pela frequência das Notas Técnicas recentes, esperar o cronograma para iniciar tende a ser arriscado. O caminho mais seguro é fazer a análise de impacto agora e deixar a implementação pronta para ativar quando a data de vigência for publicada, evitando que a parte ainda em evolução seja tratada como definitiva.

Migrate ao seu lado na adequação da NFS-e

Cada Nota Técnica da NFS-e adiciona campos, muda fórmulas e move o alvo da sua integração. Acompanhar essa esteira, interpretar cada mudança de layout e refletir tudo no emissor é trabalho contínuo, e tira o foco do que faz o seu software crescer.

É exatamente aí que a Migrate atua. Com grandes empresas de software integradas à plataforma InvoiCy e mais de duas décadas de mercado em documentos fiscais eletrônicos, absorvemos a complexidade de layout da NFS-e para que a sua equipe foque no produto. Quando uma NT como a 009 chega, a adequação é nossa parceria, não a sua dor de plantão. Se a sua software house emite ou pretende emitir NFS-e, vale uma conversa técnica para ver como integrar.

Fale com um especialista Migrate

Referências

BRASIL. SE/CGNFS-e. Nota Técnica nº 009, versão 1.0, de 4 de junho de 2026. Projeto Reforma Tributária do Consumo, Adequações NFS-e. Portal Nacional da NFS-e.

https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/rtc/nt-009-se-cgnfse-v1-0-1.pdf

BRASIL. SE/CGNFS-e. Documentação Técnica da NFS-e padrão nacional. Portal Nacional da NFS-e.

https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/rtc

BRASIL. Lei Complementar nº 214, de 16 de janeiro de 2025. Institui o IBS, a CBS e regulamenta a Reforma Tributária do Consumo.