As atualizações de pacotes e schemas vêm gerando dúvidas. Abaixo, um resumo das versões vigentes e do cronograma, para evitar transtornos.
Contexto
No início de 2026, com a entrada do IBS/CBS, o ambiente de produção operou com as versões v1.00 e v1.01 simultaneamente. Hoje, a versão em produção é a v1.01, com suporte às NT004 e NT007 (PIS/COFINS).
Com a publicação da NT009 v1.0.1, o schema foi alterado. As mudanças estão sendo entregues em etapas (Releases), e neste momento a Release 1 está disponível em Produção Restrita.
A versão atual em produção é a v1.01 com suporte às notas técnicas NT004/NT007 PisCofins. Com o advendo da publicação da NT009 v1.01, modificou o schema e neste momento, outubro/26, está operando em produção-restrita a NT009 v1.10 Release 1 com xml mantendo v1.01, não modificou a versão, como ocorreu anteriormente de 1.00 para 1.01 quando entrou IBSCBS.
Produção: NT004/NT007 PisCofins
Suportado até 01/12/2026.
Na pasta “Documentação Técnica da NFS-e: Ambiente de Homologação/Testes (layout com grupos IBSCBS).”:
Produção-Restrita: NT009 v101 (20/10/2026):
Atenção: esta versão ainda não contempla toda a NT009, apenas o que foi entregue na Release 1. NFSe-ESQUEMAS_XSD-PRODREST-v1.01-20261020 disponível em:
Antes havia nesta pasta um schema com a mesma estrutura da NT004/NT007, mas com suporte a CNPJ alfanumérico (esquemas-nfse-rtc-v1-01-20260727.zip). Ele não aparece mais nesta página.
O que muda em cada Release:
Release 1 (resumo) em linhas gerais:
- CNPJ Alfanumérico
- Notas de Ajuste de IBS/CBS
- Reestruturação ou merge dos grupos “vDedRed” e “gReeRepRes”
- Evoluções para o Simples Nacional
- Reinserção do campo “indFinal”
- Reestruturação das Informações de Operações com Bens Imóveis
- Alteração do nome do grupo “gLocBensMoveis” para “bensMoveis”
- Criação do grupo “gPgtoVinc”
Acompanhem sempre no portal em “Notícias”
https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/rtc/nt-009-se-cgnfse-v1-0-1.pdf
Esta versão da Release 1 não aplica todas alterações da documentação, ficando com parte da NT004/NT007 atual e outros campos migrados para NT009, mas logo será trocado.
Se tentou emitir por API ou no portal Inicial, você já deve ter notado alguns campos diferentes da documentação oficial.
Release 2 (resumo) em linhas gerais:
Em homologação interna; previsão de Produção Restrita entre o fim de outubro e o início de novembro, logo será publicado para testes.
Em termos de schema, praticamente cobre toda a NT009 v1.0.1.
- Inserção do campo “verCalcIBSCBS” na NFS-e
- Inclusão de regras de validação dos endereços do Tomador/Adquirente e do Destinatário e repercussão na definição do local de incidência do ISSQN em operações com o código de tributação nacional 17.05
- Reposicionamento do campo “indDest” e do grupo “dest” para o grupo “infDPS”
- Inclusão de novos campos e atualizações do grupo de informações sobre transações entre residentes ou domiciliados no Brasil com residentes ou domiciliados no exterior (“comExt”)
- Criação do campo “vAjusteBCIBSCBSComExt”
- Atualizações no grupo de informações relativas às atividades de eventos
- Inserção do grupo de informações relativas às operações de condomínios
- Reposicionamento dos campos “CST” e “cClassTrib” e Adequação das Regras de Ocorrência dos Grupos IBS/CBS
O schema oficial ainda não foi publicado, mas há uma versão não oficial disponível para quem quiser adiantar as integrações:
Uma versão não oficial foi disponibilizada no Google drive, totalmente funcional, mas não esqueça que a Release 1 não é totalmente compatível.
O cronograma divulgado (ultima versão publicada segue como:)
Release 3 (testes começam após a liberação da Release 2):
Serão iniciados os testes quando liberada a Release 2, terá suporte a algumas validações não aplicadas na Release 2 como condomínios , fatos-geradores não publicados na versão anterior e que vocês notaram, além de pequenas melhorias e divulgadas brevemente quando autorizado, mas em Novembro estará funcional. Acompanhem em Notícias no Portal Nacional.
Visualização do schema:
Muitos tem dificuldade de navegar pelo schema. Foi desenvolvido para uso interno um diagrama da NT009v101 e foi deixada fora da área de autenticação, em servidor disponível no suporte da empresa (fora do SaaS), logo estará disponível para consulta para auxiliar quem desejar. Existem algumas notações de grupos (GN) que vocês podem desconsiderar. Grato Santiago Borges pela disponibilização.
Algumas divulgações e exemplo de diferenças no schema já havia respondido no tópico abaixo. Para evitar poluir foi aberto este novo tópico para esclarecimentos.
At.te
Emir Toktar
, brincadeira a parte, mas ficará em cima do prazo.