NFS-e: evoluções da NT 009 chegam ao ambiente de testes
Em 20 de outubro, o Comitê Gestor da NFS-e informou que três mudanças da Nota Técnica 009, versão 1.0, já estão disponíveis na produção restrita (ambiente de testes). Municípios e contribuintes podem validar as alterações antes da entrada em produção prevista para 1º de dezembro de 2026.
O que mudou no release 1
- XML: reposicionamento dos campos CST e cClassTrib na estrutura da nota (item 2.16 da NT 009).
- API de emissão: inclusão dos fatos geradores 99.02 a 99.04 (item 2.15 da NT 009 e item 2.1.3 da NT 005).
- Base de cálculo: criação do grupo vAjusteBC, que reúne os grupos vDedRed e gReeRepRes (item 2.3 da NT 009).
Os anexos e esquemas XSD correspondentes estão disponíveis no portal para validação. O leiaute atual de produção permanece baseado na NT 004, versão 2.0, até 30 de novembro. Portanto, o novo leiaute deve ser testado em produção restrita e não deve ser tratado como vigente em produção antes de 1º de dezembro.
O CGNFS-e também indicou que versões 1.01 e posteriores da NT 009 passarão primeiro pela produção restrita. As notas de finalidade de ajuste e os eventos específicos da RTC terão cronograma divulgado posteriormente.
Impacto e encaminhamento
Municípios, equipes fiscais e fornecedores de sistemas devem iniciar testes de compatibilidade do XML, da API e da composição de ajustes de base de cálculo. Convém conferir os XSD publicados e mapear integrações que usam os campos ou grupos alterados. A mudança é uma disponibilização para teste; a produção permanece no leiaute anterior até a data indicada.
Janela desta rodada extraordinária
A varredura solicitada cobre publicações de 16 a 22 de outubro de 2026. A edição 43 já registrava o balanço do Simples publicado em 16/10 e a janela das NT 2026.004 de seis famílias de DF-e, por isso esses fatos não foram repetidos aqui. A pauta original da Reunião Participativa 8/2026 da ANTT foi publicada em 13/10, antes do corte; o ajuste de horário publicado em 19/10 não alterou o objeto nem o prazo de contribuições, e não foi tratado como novo desenvolvimento material.
Fontes oficiais
- CGNFS-e informa: release 1 das evoluções da NT 009 disponível em produção restrita (20/10/2026)
- Atualizações e implantações — Portal Nacional da NFS-e
Duas situações distintas: testes da NT 009 e produção da NT 010
O avanço mais relevante desta janela não é apenas a divulgação de outra nota técnica: é a diferença entre o que já foi disponibilizado em produção e o que ainda está em homologação. Para as NFS-e de padrão nacional sujeitas ao release 1 da NT 009, a mudança informada em 20/10 está limitada ao ambiente de produção restrita. Já a NFS-e Via teve funcionalidades da NT 010 disponibilizadas em produção em 19/10. Confundir esses ambientes pode antecipar indevidamente o uso de leiautes novos em sistemas produtivos.
A NT 009 já possuía documentação anterior e versão 1.01 aprovada pelo Ato Técnico Conjunto RFB/CGIBS nº 7, divulgado em 09/10. A novidade operacional de 20/10 é que três ajustes da versão 1.0 passaram a estar efetivamente disponíveis para ensaios no ambiente restrito, e não que todas as alterações da versão 1.01 tenham entrado em produção. O comunicado deixa claro que versões 1.01 e superiores também passarão primeiro por testes, antes da implantação prevista para 01/12.
O que cada mudança técnica pede aos desenvolvedores
Reposicionamento de CST e cClassTrib no XML (item 2.16). A mudança exige conferir o caminho dos elementos em serializadores, desserializadores, consultas XPath, assinaturas, conversores e integrações que dependem da posição dos campos. Testes devem comparar o XML resultante com os XSD oficiais e registrar a versão do leiaute utilizada; mover um campo no esquema não autoriza inferir mudança de tributação.
Novos fatos geradores 99.02 a 99.04 na API de emissão (item 2.15 da NT 009 e item 2.1.3 da NT 005). Validar os códigos nos contratos de API, regras de aceitação e mapeamentos do ERP. Preparar cenários positivos e de rejeição é recomendação de teste, não afirmação de que todos os serviços e ambientes já aceitam esses códigos em produção.
Grupo vAjusteBC (item 2.3). O novo agrupamento, derivado dos grupos vDedRed e gReeRepRes, exige revisar regras de composição da base, serialização, totalização e rastreabilidade das parcelas nos sistemas. Sem examinar os XSD e as regras atualizadas, não se deve supor que o agrupamento novo seja apenas uma troca de nome sem efeito sobre integrações.
O benefício da janela de testes é descobrir divergências técnicas antes da implantação; o risco é promover antecipadamente configurações do ambiente restrito para produção. O comunicado do Portal Nacional mantém a referência ao leiaute atual da NT 004 v2.0 até 30/11/2026, com previsão de evolução em produção em 01/12/2026.
Fonte da liberação: CGNFS-e, comunicado de 20/10, atualizado em 21/10.
NFS-e Via: NT 010 já está em produção desde 19/10
A divulgação oficial de 19/10 confirma um segundo marco, diferente da NT 009: as evoluções da NFS-e Via previstas na NT 010 foram disponibilizadas em ambiente de produção em 19/10/2026, após previsão anterior comunicada em 09/10. O subsistema é voltado à NFS-e Via e não deve ser confundido com o emissor geral de NFS-e nacional.
O Evento de Manifestação do Adquirente, versão 1.00, permite que o tomador registre sua posição sobre o serviço com duas manifestações mutuamente excludentes: aceite, quando confirma que o serviço foi prestado; ou rejeição, quando aponta divergência ou declara desconhecimento da nota. O comunicado não deve ser interpretado como autorização para registrar ambas as manifestações simultaneamente.
Também foi disponibilizado o leiaute 1.01 da NFS-e Via, com inclusão da opção 6 — Sem cobrança no campo de modalidade de pagamento modPagamento. Para integrações que tratem NFS-e Via, recomenda-se conferir o contrato do evento, o tratamento de estado da manifestação, as regras de exclusividade das alternativas e a compatibilidade do novo valor do campo com telas, validações e rotinas de conciliação.
O que mudou em relação à notícia de 09/10: a publicação anterior aprovava a documentação e anunciava o cronograma; a comunicação de 19/10 confirma a efetiva entrada em produção dessas evoluções. Para a NT 009, em contraste, o release 1 de 20/10 ainda está em produção restrita. Esta distinção define em qual ambiente testar e onde uma funcionalidade pode ser utilizada operacionalmente.
Fonte específica: Portal Nacional da NFS-e — NT 010 da NFS-e Via disponibilizada em produção (19/10, atualizada em 20/10). Contexto documental: Ato Técnico Conjunto RFB/CGIBS nº 7 — aprovação da NT 009 v1.01 e NT 010 (09/10).
Plano de ação para municípios, equipes fiscais e tecnologia
- Separar ambientes e versões. Mapear claramente qual aplicação utiliza NFS-e padrão nacional, qual utiliza NFS-e Via e qual versão do leiaute está habilitada em produção e em produção restrita. Não confundir a aprovação documental da NT 009 v1.01 com implantação integral.
- Baixar os artefatos oficiais. Obter a documentação e os esquemas XSD mais recentes na área de documentação técnica de homologação/testes ou por navegação a partir do Portal Nacional da NFS-e, identificando data, versão e ambiente de cada arquivo.
- Executar testes automatizados no ambiente restrito da NT 009. Preparar cargas representativas para o posicionamento de CST e cClassTrib, os fatos geradores 99.02 a 99.04 e o grupo vAjusteBC. Comparar XML gerado/recebido, API e cálculos derivados com o esquema efetivo, mantendo evidência dos resultados.
- Validar consumidores do XML. Revisar conectores, mensageria, mapeamento de tabelas fiscais, serviços de importação, relatórios, integrações municipais e rotinas de escrituração que dependem da estrutura anterior.
- Tratar a NT 010 conforme a realidade de produção da NFS-e Via. Onde aplicável, adaptar captura, validação e processamento da manifestação do adquirente e do valor 6 do modPagamento. Não estender essa conclusão automaticamente a outras modalidades de NFS-e.
- Definir responsabilidade e janela de implantação. Registrar equipe responsável, riscos de incompatibilidade, aceite dos testes, rollback planejado e checkpoints próximos à data prevista de 01/12. Alterações futuras das NTs exigem nova verificação documental.
- Monitorar o que ainda não está pronto. O CGNFS-e declarou que notas com finalidade de ajuste e eventos específicos da Reforma Tributária do Consumo terão cronograma próprio ainda a divulgar. Não tratá-los como componentes já liberados pelo simples fato de ter havido um release.
Agenda verificável
- 19/10/2026: disponibilização em produção das evoluções da NT 010 da NFS-e Via, confirmada pelo órgão.
- 20/10/2026: divulgação do release 1 da NT 009, versão 1.0, em produção restrita; o comunicado foi atualizado em 21/10.
- Até 30/11/2026: referência ao leiaute de produção atual da NT 004, versão 2.0, conforme comunicado da NFS-e.
- 01/12/2026: implantação em produção das alterações da NT 009 segundo o cronograma informado, ainda futura em 22/10.
- Sem data confirmada neste comunicado: notas com finalidade de ajuste e eventos específicos da RTC.
Limites e controle editorial
Confirmado nas fontes: os três ajustes específicos liberados para teste pela NT 009; a previsão informada para 01/12; e a entrada em produção das funcionalidades da NT 010 da NFS-e Via em 19/10. Recomendações técnicas editoriais: validações de XSD, cenários de integração, testes de regressão, segregação de ambientes e governança de implantação. Essas recomendações não são transcrições de obrigações normativas adicionais.
A notícia de 20/10 não demonstra que todas as funcionalidades da NT 009 v1.01 estejam em produção, nem apresenta a data de liberação dos eventos específicos da RTC. O material tampouco estabelece novas alíquotas de IBS/CBS. Detalhes de cardinalidade e rejeições devem ser confrontados com a documentação técnica e XSD correspondentes, não inferidos apenas deste comunicado.
Critério de ineditismo: balanço do Simples e adiamento de DF-e já integraram a Edição 43; aqui são preservados apenas os desenvolvimentos operacionais de NFS-e divulgados em 19 e 20/10. Os atos de 09/10 são contexto, não apresentados como notícia nova.