Nota Técnica 2025.002: as 15 versões no Protheus
A NT 2025.002 da NF-e já teve 15 versões em 18 meses. O que cada uma mudou, o que ainda entra em outubro e novembro de 2026, e onde cada versão bate no Protheus: pacote, fonte e parâmetro.
Por WeePulse29 min de leitura
Se você procurou “Nota Técnica 2025.002” e chegou aqui, provavelmente está tentando responder a uma pergunta simples que ninguém responde de forma simples: qual versão está valendo, e o meu Protheus está nela?
A dificuldade tem uma causa. A NT 2025.002 não é um documento. É uma série. Entre a versão 1.00, publicada em 28 de março de 2025, e a versão 1.52, de 1º de outubro de 2026, o Portal da NF-e publicou 14 versões em 17 meses. Cada uma criou campo, alterou regra de validação, mexeu em data ou desfez algo da anterior. E cada uma delas virou, no Protheus, um pacote, um fonte ou um parâmetro.
Este artigo é o mapa dessa série, lido no documento oficial e cruzado com o que a TOTVS publicou para o Protheus. Ele existe porque a página da Central de Atendimento TOTVS sobre a NT cobre até a versão 1.40, e as duas versões seguintes têm datas de produção marcadas para 5 de outubro e 3 de novembro de 2026.
Atualização de 2 de outubro de 2026: a versão 1.52 foi publicada em 1º de outubro, no mesmo pacote de seis documentos da NF-e aprovado pelo Ato Técnico Conjunto nº 8/2026. Ela ajusta a validação de devoluções quando a nota original é de saída (regra VC02-50) e adia para 3 de novembro de 2026 a exigência de referenciar a nota de origem exclusivamente por item no grupo DFeReferenciado (regra VC02-14), que estava em produção desde 1º de setembro. A tabela abaixo e a linha do parâmetro MV_250024D já refletem a mudança.
Antes de tudo: NT 2025.002 não é IT 2025.002
Há dois documentos com o mesmo número e assuntos diferentes, e confundi-los custa caro.
| Documento | O que é | Onde bate no Protheus |
|---|---|---|
| Nota Técnica 2025.002 (NT) | Leiaute da NF-e e da NFC-e, campos de IBS, CBS e IS, regras de validação e cronograma | Pacote fiscal, fonte NFESEFAZ, schemas e RPO do TSS, parâmetros de data |
| Informe Técnico 2025.002 (IT) | As tabelas de código: cClassTrib e cCredPres | Importação no Configurador de Tributos |
Uma rejeição 1115 nasce da NT. Uma rejeição 1023 nasce de uma tabela do IT desatualizada, assunto do artigo sobre cClassTrib no Protheus. Este artigo trata só da NT.
As 15 versões, uma por uma
A tabela abaixo cruza a lista de publicação do Portal da NF-e com o “Controle de Versões” e o “Histórico de Alterações / Cronograma” da própria NT, na versão 1.51. A coluna de produção é a data em que a mudança passou, ou passa, a valer no ambiente de produção das SEFAZ.
| Versão | Publicada em | O que mudou | Produção |
|---|---|---|---|
| 1.00 | 28/03/2025 | Campos de controle e eventos para apuração do IBS, da CBS e do IS | 01/10/2025 |
| 1.01 | 15/04/2025 | Ajustes e correções | 01/10/2025 |
| 1.10 | 09/06/2025 | Schema com os campos de IBS, CBS e IS (preenchimento opcional), regras de validação e eventos | 06/10/2025 |
| 1.20 | 30/07/2025 | Detalhamento do cronograma, novas regras e ajustes | 06/10/2025 |
| 1.30 | 03/10/2025 | Novos campos e regras, alteração do cronograma; um bloco de regras só entrou em 02/02/2026 | 10/11/2025 |
| 1.31 | 11/11/2025 | Correção nas regras B25-80, B25-90, B25-100, Q01-20, S01-20, UB56-10 e VC02-30 | 17/11/2025 |
| 1.32 | 25/11/2025 | Correção nas regras B25b-20, 3BA02-10, 3BA02-70 e NA01-20 | 04/12/2025 |
| 1.33 | 02/12/2025 | Alíquota zero de CBS em áreas incentivadas (UB56-10); grupo de redução só com alíquota maior que zero; nova data para a UB12-10 | 15/12/2025 |
| 1.34 | 04/12/2025 | Desabilita UB26-15, UB45-15 e UB64-15; altera UB26-20, UB45-20 e UB64-20 | 15/12/2025 |
| 1.35 | 31/03/2026 | Posterga as regras da tributação monofásica em homologação | Não se aplica |
| 1.36 | 30/04/2026 | Regra I08-141 nova, oito regras alteradas, tipo de nota de crédito 06 (retorno por recusa parcial na entrega) | 03/08/2026 |
| 1.40 | 20/05/2026 | Campo cIndOp, Inscrição Suframa do emitente, grupo gALCZFMCBS, atualização do grupo de devolução (cashback), validações por cClassTrib por tipo de nota, ajuste no evento 211110 | 03/08/2026 |
| 1.40 | 20/05/2026 | Na devolução, referenciamento só pelo grupo DFeReferenciado (VC02-14) | 01/09/2026, adiado para 03/11/2026 pela 1.52 |
| 1.50 | 03/06/2026 | Reformulação do leiaute da tributação monofásica de combustíveis | 03/11/2026 |
| 1.51 | 04/08/2026 | Alteração de 30 regras de validação, entre elas UB13, UB18, UB37, UB40, UB45, UB56, UB64, VC02-14 e VC02-30; confirma 03/08/2026 para a UB12-10 | 05/10/2026 |
| 1.52 | 01/10/2026 | Devolução passa a considerar se a nota original é de saída (VC02-50); referenciamento só por item no DFeReferenciado (VC02-14) adiado | 03/11/2026 |
Três coisas saltam da tabela.
A versão mais nova não é a que mais importa. A 1.51 é a vigente, mas o grosso do que o seu ambiente precisa fazer hoje veio da 1.36 e da 1.40, que entraram em produção em 3 de agosto de 2026. Se o seu Protheus foi atualizado para aquela data, o que falta é o que vem depois dela.
Duas datas ainda estão no futuro. As regras alteradas pela 1.51 valem em produção a partir de 5 de outubro de 2026. O leiaute novo da monofásica de combustíveis, da 1.50, vale a partir de 3 de novembro de 2026. As duas já estão em homologação desde 1º de setembro. E a 1.52, de 1º de outubro, levou o referenciamento de devolução só por item (VC02-14) para a mesma data de 3 de novembro.
Correção é parte da série. Quatro das 15 versões, da 1.31 à 1.34, existem para corrigir a anterior. Duas delas saíram com dois dias de diferença, em dezembro de 2025. Quem parametrizou pela 1.33 e não olhou a 1.34 ficou com três regras que a SEFAZ desabilitou.
O que está valendo hoje
Em setembro de 2026, o quadro é este, pela NT 1.51 e pelos atos que a acompanham.
Para o contribuinte do Regime Normal (CRT 3), o preenchimento dos campos de IBS e CBS é obrigatório em produção desde 3 de agosto de 2026, conforme o “Detalhamento do Cronograma” da NT. Isso não mudou.
O que mudou foi a consequência de não preencher. Em 3 de agosto, o Ato Técnico Conjunto nº 01/2026 adiou, sem nova data, a rejeição por ausência dos campos. A obrigação continua, a rejeição automática não. A NT 1.51, publicada no dia seguinte, manteve 03/08/2026 como data da regra UB12-10 no cronograma, porque o adiamento vem de ato à parte, não da NT. Os dois relógios estão explicados em NF-e sem IBS e CBS no Protheus.
Já as rejeições por excesso ou por inconsistência nunca foram adiadas. A 1111, que aparece quando o grupo de devolução é enviado onde não cabe, seguiu rejeitando depois de 3 de agosto. A lista completa está no guia de rejeições da NF-e no Protheus.
Para Simples Nacional, MEI e tributação monofásica, a NT diz que as orientações virão em NT futura, porque a tributação de IBS, CBS e IS para esses contribuintes só começa em 2027, pelo art. 348 da LC 214/2025.
Onde cada versão bate no Protheus
Aqui está a parte que a maioria dos resumos da NT não cobre, e que é o motivo de existir este artigo. No Protheus, uma versão da NT não é uma coisa só. Ela se espalha por quatro camadas, e cada camada tem o seu jeito de ficar para trás.
1. O pacote e o fonte
A adequação do Protheus à NT chega por dois caminhos que precisam andar juntos: o pacote de expedição contínua e o fonte NFESEFAZ, que é quem monta o XML. A documentação da TOTVS para a NT, na versão consultada em setembro de 2026, aponta o pacote liberado em 3 de setembro de 2026, com NFESEFAZ datado de 24 de agosto de 2026.
Fonte antigo com pacote novo não resolve. É o erro mais comum de quem “já atualizou” e continua com rejeição.
| Release | Situação do pacote da NT |
|---|---|
| 12.1.2310 | Somente com garantia estendida |
| 12.1.2410 | Somente com garantia estendida |
| 12.1.2510 | Disponível (release suportada) |
| 12.1.2610 | Disponível (expedição em outubro de 2026; veja o que muda na 12.1.2610) |
Se você está na 12.1.2410 sem garantia estendida, o pacote não chega, e a própria TOTVS orienta migrar para a 12.1.2510. O caminho está em atualização de release do Protheus.
2. O TSS: schemas e RPO
A segunda camada é o TSS, que valida o XML contra os schemas antes de transmitir. A NT 1.10 criou o schema com os campos de IBS, CBS e IS; a 1.40 alterou o leiaute de novo; a 1.50 reformula o bloco de combustíveis. Cada uma dessas exige substituir os schemas na pasta do TSS e atualizar o RPO do TSS, nesta ordem, além de um schema complementar que a TOTVS distribui à parte.
Ambiente com Protheus atualizado e TSS parado em schema antigo dá erro de schema antes mesmo de chegar à SEFAZ. O passo a passo está em como atualizar o TSS sem parar a NF-e.
3. Os parâmetros de data, que carregam o número da NT no nome
A terceira camada é a menos documentada e a que mais confunde. A TOTVS controla a entrada de cada bloco de regras em produção por parâmetros do tipo data, e o nome deles guarda a pista de qual versão da NT controlam.
| Parâmetro | Onde vive | O que controla | Valor padrão |
|---|---|---|---|
MV_2500240 | Protheus (SIGACFG) | Entrada em produção das regras I08-141, I08-140, I08-144, VC02-07, VC02-10, UB18-10, UB37-10, UB56-10 e B25-80, e do tipo de nota de crédito 06 | 03/08/2026 |
MV_250024D | Protheus (SIGACFG) | Referenciamento de devolução exclusivamente pelo grupo DFeReferenciado (VC02-14) | 01/09/2026 (a NT 1.52 levou a regra para 03/11/2026; o valor precisa acompanhar) |
MV_NT25002 | Tabela SPED000 do TSS | Data de entrada das regras da NT em produção, por entidade | Definido na implantação |
MV_RTC130 | Tabela SPED000 do TSS | Habilita o envio de IBS e CBS em produção, por entidade | Definido na implantação |
MV_CSTGXML | Protheus (SIGACFG) | Para quais CST o grupo IBSCBS é gerado no XML | Lista de CST |
Repare nos nomes. MV_NT25002 é “NT 2025.002”. MV_2500240 e MV_250024D trazem “25002” seguido de “40”, e as regras que eles controlam são as que a NT data para 3 de agosto e 1º de setembro de 2026, empacotadas pela TOTVS junto com a versão 1.40. MV_RTC130 remete à Reforma Tributária do Consumo na versão 1.30, quando o envio de IBS e CBS em produção passou a ser possível. A leitura não está escrita em lugar nenhum, mas é consistente com o que cada parâmetro faz, e ajuda a saber de qual versão o seu ambiente está falando quando você abre o SIGACFG.
Dois cuidados com esses parâmetros.
O primeiro é que MV_NT25002 e MV_RTC130 são criados por entidade na SPED000 do TSS. Um ambiente com várias empresas transmitindo pode estar certo em uma e sem o parâmetro em outra, e o sintoma é o clássico “funciona em homologação, em produção as tags não vão”.
O segundo é a instrução da TOTVS para postergar a entrada em produção via MV_2500240 e MV_250024D. O texto orienta uma direção e o exemplo numérico mostra a contrária. Não assuma. Teste em homologação antes de alterar em produção.
4. O Configurador de Tributos
A quarta camada não é da NT, é do Informe Técnico, mas a NT depende dela. A regra de validação do grupo IBSCBS verifica o cClassTrib contra a tabela vigente, e a 1.40 criou validações por cClassTrib conforme o tipo de nota de débito ou de crédito. Se a tabela importada no Configurador está numa versão do IT anterior à que a SEFAZ usa, a NF-e volta com 1023 ou 1024 mesmo com pacote, fonte, TSS e parâmetros em dia. O procedimento está em como reimportar o cClassTrib.
O que a documentação da TOTVS ainda não diz
A página da Central de Atendimento TOTVS que consolida a adequação do Protheus à NT tem o título “Nota Técnica 2025.002 v.1.10, v1.20, V1.30 e V1.40”. Não há, na versão consultada, uma seção para a 1.50 nem para a 1.51. Os pacotes de setembro podem já contemplar parte delas, mas isso não está declarado na página.
Isso importa por causa das datas. A 1.51 altera 30 regras de validação com produção em 5 de outubro de 2026. Entre elas estão UB13-20, UB13-30 e UB13-40, que são as regras do grupo IBSCBS por CST, tratadas em CST do IBS e da CBS no Protheus, e UB18-10, UB37-10 e UB56-10, que são as validações de cálculo do IBS estadual, do IBS municipal e da CBS. Não são regras periféricas.
A 1.50 reformula o leiaute da tributação monofásica de combustíveis com produção em 3 de novembro de 2026. Se a sua operação não envolve combustíveis, ela não te alcança. Se envolve, é mudança de estrutura de XML, não de regra.
O que fazer com isso: abra chamado perguntando, com o número da versão, se o pacote que você aplicou contempla a 1.51 e a 1.50. E teste em homologação, onde as regras já estão ativas desde 1º de setembro, antes de esperar por outubro.
Há ainda um ponto que a NT deixou em aberto e que aparece repetidamente nos comentários da própria página da TOTVS: o DANFE com os valores de IBS e CBS. A NT 1.30 diz que as alterações no DANFE estão em estudo e serão publicadas em versão futura. Até a 1.51, isso não aconteceu. Se alguém pedir o DANFE com IBS e CBS, a resposta é que o leiaute oficial ainda não existe.
O que não é a NT 2025.002
Como a numeração das notas técnicas se parece, vale separar três documentos que aparecem nas mesmas buscas.
NT 2026.002 da NF-e (versão 1.00, maio de 2026) não é Reforma Tributária. Ela cria o DANFE Simplificado Tipo 2, permite NF-e em operações presenciais que seriam NFC-e, e introduz a autorização com alerta, com o código de status 120. Tem datas de produção em 3 de agosto e em 5 de outubro de 2026, e por isso costuma ser confundida com a 2025.002.
NT 2026.002 da SVRS é outra, para BP-e, CT-e, NF3e, NFCom e NFAg, em homologação desde 3 de agosto de 2026. Nada a ver com a NF-e modelo 55.
Informe Técnico 2025.002 é o das tabelas, tratado no início deste artigo.
Se o seu fornecedor, a sua consultoria ou um post em fórum citar “a NT” sem número de versão e sem dizer qual documento, peça o número. Metade das discordâncias sobre prazo nasce de duas pessoas falando de versões diferentes.
Checklist: em qual versão está o seu Protheus
- Anote a data do fonte
NFESEFAZcompilado no RPO. Se for anterior a 24/08/2026, o pacote de setembro não está aplicado. - Confira a release e se há garantia estendida. Na 12.1.2410 sem garantia, o pacote não existe para você.
- Confira a data dos schemas do TSS e se o schema complementar foi copiado.
- Liste os parâmetros
MV_2500240,MV_250024DeMV_CSTGXMLno SIGACFG e anote os valores. - Liste
MV_NT25002eMV_RTC130naSPED000do TSS, por entidade. - Confira a versão da tabela cClassTrib importada no Configurador contra a vigente no Portal.
- Emita em homologação uma NF-e de venda, uma de devolução com item referenciado e, se houver, uma de combustível. As regras da 1.51 e da 1.50 já estão lá.
- Registre a versão da NT que o ambiente contempla, com data. Na próxima versão, a comparação começa daí.
Perguntas frequentes
Qual é a versão vigente da Nota Técnica 2025.002?
A versão 1.51, publicada no Portal da NF-e em 4 de agosto de 2026. Ela altera 30 regras de validação com entrada em produção em 5 de outubro de 2026 e confirma 3 de agosto de 2026 como data do cronograma da regra UB12-10.
A NT 2025.002 é a mesma coisa que o Informe Técnico 2025.002?
Não. A Nota Técnica define o leiaute, os campos, as regras de validação e o cronograma da NF-e e da NFC-e. O Informe Técnico publica as tabelas de código, como o cClassTrib e o cCredPres. No Protheus, a NT entra por pacote, fonte, TSS e parâmetros; o IT entra por importação no Configurador de Tributos.
O que muda em 5 de outubro de 2026?
Entram em produção as regras de validação alteradas pela versão 1.51, entre elas as do grupo IBSCBS por CST e as de cálculo do IBS estadual, do IBS municipal e da CBS. Em homologação elas valem desde 1º de setembro de 2026.
O que muda em 3 de novembro de 2026?
Entra em produção o leiaute reformulado da tributação monofásica de combustíveis, da versão 1.50. Só alcança quem opera com combustíveis.
A NT 2026.002 substitui a 2025.002?
Não. A NT 2026.002 da NF-e trata do DANFE Simplificado Tipo 2 e da autorização com alerta, sem relação com IBS e CBS. As duas convivem.
O DANFE já mostra IBS e CBS?
Não. A NT 2025.002 diz, desde a versão 1.30, que as alterações no DANFE estão em estudo. Até a versão 1.51 não houve leiaute oficial de DANFE com os novos tributos.
Fontes
- Portal da NF-e: lista de versões da Nota Técnica 2025.002, com datas de publicação, e NT 2025.002-RTC versão 1.51, seções “Controle de Versões”, “Histórico de Alterações / Cronograma” e “Detalhamento do Cronograma”
- Portal da NF-e: Nota Técnica 2026.002, versão 1.00, maio de 2026
- Brasil: Lei Complementar nº 214/2025, art. 348
- Ato Técnico Conjunto nº 01/2026, de 3 de agosto de 2026
- TOTVS, Central de Atendimento: Cross Segmentos - Backoffice Protheus - Doc. Eletrônicos - NFE - Reforma Tributária, Nota Técnica 2025.002 v.1.10, v1.20, V1.30 e V1.40, consultado em 23/09/2026
- TOTVS, Central de Atendimento: Cross Segmentos - TSS - Reforma Tributária - Cronograma Nota Técnica 2025.002
