Erpworks

NT 2025.002 · Parâmetros

Parâmetros da Reforma no Protheus: MV_2500240, MV_RTC55, MV_CSTGXML e MV_250024D

Rejeição 1038, 1026 ou 321 aparecendo desde agosto? Quase sempre a explicação passa por quatro parâmetros de data e de CST. O que cada um controla, quais regras da NT 2025.002 ele liga, o valor padrão e as duas armadilhas que a própria documentação da TOTVS deixou.

Revisado tecnicamente em 29/09/2026 · Por Marcelo Scibarauskas, Gestor Executivo da Erpworks

Consultor configurando parâmetros de sistema em um monitor, com um documento estruturado no segundo monitor, à noite

Os parâmetros em uma tabela

Os quatro primeiros ficam no Protheus e são criados no configurador (SIGACFG, em Ambiente, Cadastros, Parâmetros). Os dois últimos ficam no TSS, na tabela SPED000.

ParâmetroTipoPadrão na TOTVSO que controla
MV_RTC55Data05/01/2026 (uma página diz 01/01/2026)Início da geração das tags de IBS e CBS no XML da NF-e (NT v1.30)
MV_CSTGXMLCaracter000/200/210/220/510/550/830CSTs que geram o grupo gIBSCBS na NF-e, NFS-e e NFCom
MV_2500240Data03/08/2026Início em produção das regras de validação ajustadas no pacote da v1.40
MV_250024DData01/09/2026Regra VC02-14: devolução referenciada só por item, no DFeReferenciado
MV_RTC56Data01/01/2026Tags de IBS e CBS na NFS-e
MV_NT25002 (TSS)Data05/01/2026Entrada das novas tags, como a vItem, em produção
MV_RTC130 (TSS)DataDatas conflitantes na documentaçãoRegras da v1.30 em produção

MV_2500240: quais regras ele liga

A TOTVS descreve o MV_2500240 como a data de início da obrigatoriedade das novas regras em produção e lista as regras envolvidas, mas não os códigos de rejeição. Cruzando a lista com a NT 2025.002 v1.40, o parâmetro controla estas validações:

RegraRejeiçãoAssunto
I08-1411179CFOP inválido em devolução ou retorno emitido por MEI
I08-140327CFOP inválido para devolução ou retorno
I08-144328CFOP de devolução em NF-e sem finalidade de devolução
VC02-071042Referência por item indevida em nota de crédito
VC02-101038DFeReferenciado não informado
UB18-101026Alíquota do IBS da UF
UB37-101036Alíquota do IBS do município
UB56-101037Alíquota da CBS
B25-801001Finalidade de débito ou crédito só para IBS e CBS

O mesmo pacote criou o tipo de nota de crédito 06, retorno por recusa parcial na entrega. Em homologação, a TOTVS informa que essas tags são ativadas antes das datas, sem precisar criar o parâmetro. A causa e a correção de cada código estão no guia de rejeições de IBS e CBS na NF-e.

Adiar ou antecipar: o erro nas instruções

Em sete páginas da TOTVS sobre o MV_2500240 e o MV_250024D, o texto diz que, para adiar a entrada em produção, basta usar uma data menor ou igual à data corrente. O exemplo logo abaixo faz o contrário: com a data atual em 03/08/2026, o parâmetro vai para 03/09/2026, uma data futura.

O exemplo é o que bate com a lógica dos outros parâmetros. No MV_RTC55, a data menor ou igual à atual serve para antecipar a geração das tags, e no MV_RTC56 a própria TOTVS manda usar data maior que a atual para adiar. Na leitura mais consistente, data futura adia e data passada ou atual liga a regra.

Há um limite que vale para todos eles: o parâmetro muda o comportamento do Protheus, não o cronograma da SEFAZ. Quando a regra já está em produção no ambiente nacional, adiar o parâmetro só troca uma validação local por uma rejeição na transmissão.

MV_250024D e a data que a NT mudou

O MV_250024D controla a regra VC02-14: na devolução, a referência ao documento de origem passa a ser feita só no grupo DFeReferenciado, item a item. Quando falta essa referência, a SEFAZ devolve a rejeição 321.

A TOTVS criou o parâmetro com padrão 01/09/2026, a data da NT v1.40 e v1.50. A NT 2025.002 v1.51, publicada em 04/08/2026, adiou a produção da VC02-14 para 05/10/2026 e deixou a regra mais restrita, aceitando só a referência por item. As páginas da TOTVS consultadas em 29/09/2026 ainda mostram 01/09/2026, inclusive um artigo revisado em 10/09. Para quem adiou o parâmetro manualmente, a data que vale na SEFAZ agora é 05/10/2026. O erro de nota com referência nos dois níveis ao mesmo tempo está em rejeição 1010.

Quando o grupo de IBS e CBS não sai no XML

  • IBS e CBS fora do Configurador. Se o ambiente tem só ICMS configurado, a TOTVS informa que as novas tags de IBS e CBS não são geradas. O cálculo é feito no Configurador de Tributos (FISA170).
  • MV_RTC55 ausente ou com data futura. A nota sai no modelo antigo.
  • CST fora do MV_CSTGXML. Um documento técnico da TOTVS informa que, nesse caso, o sistema gera o grupo de totais com valores zerados. Para incluir um CST, acrescente ao final da lista separando por barra, sem espaços, como no exemplo da TOTVS com o 222.
  • Pacote desatualizado. Para o pacote de 03/09/2026, a TOTVS pede o nfesefaz com data de 24/08/2026 ou posterior. As releases 12.1.2310 e 12.1.2410 só recebem com garantia estendida.

A TOTVS também recomenda validar CST e cClassTrib com a SEFAZ, porque as tabelas vêm sendo atualizadas com frequência. O caminho da classificação está em cClassTrib, NCM e NBS no Protheus.

Parâmetros do TSS e da NFS-e

O MV_NT25002 define quando as novas tags, como a vItem, entram em produção. O valor global é criado sozinho com o pacote, e a configuração por entidade tem prioridade sobre ele. Os artigos da TOTVS sobre o erro de schema 225 e a rejeição 1094 mandam configurá-lo por entidade. O MV_RTC130 aplica as regras da v1.30 e aparece com datas diferentes em páginas diferentes da TOTVS, então vale conferir o valor gravado no seu TSS.

Na NFS-e, o MV_RTC56 faz o papel do MV_RTC55 e também depende de IBS e CBS no Configurador. Para a NFS-e Nacional é preciso usar a versão 1.01 do layout, e no município de São Paulo ele trabalha junto com os parâmetros MV_RTCNFSE e MV_RTHNFSE do TSS.

Como conferir no seu ambiente

  • Abra o SIGACFG e confira se MV_RTC55, MV_CSTGXML, MV_2500240 e MV_250024D existem, com o tipo e a filial corretos.
  • Compare as datas gravadas com o cronograma da NT em vigor, e não só com o padrão da TOTVS.
  • Confira no TSS o MV_NT25002 e o MV_RTC130, no global e por entidade.
  • Veja a data do nfesefaz e se o TSS está atualizado.
  • Emita uma nota de cada cenário em homologação e leia o XML: grupo gIBSCBS, CST, cClassTrib e referências de devolução.

Em resumo

  • MV_RTC55, MV_CSTGXML, MV_2500240 e MV_250024D são parâmetros do Protheus; MV_NT25002 e MV_RTC130 ficam no TSS.
  • O MV_2500240 liga as regras das rejeições 1179, 327, 328, 1042, 1038, 1026, 1036, 1037 e 1001.
  • Nas instruções da TOTVS, o texto para adiar contradiz o exemplo; data futura adia e data passada liga.
  • A NT v1.51 adiou a regra do MV_250024D para 05/10/2026, e a TOTVS ainda mostra 01/09/2026.

Próximo passo: conferir os valores gravados no Protheus e no TSS contra o cronograma atual da NT e testar cada cenário em homologação antes de mexer em produção.

Fontes e referências

  1. TDN: implantação da NT 2025.002 v1.40 (MV_2500240 e MV_250024D).
  2. Central TOTVS: pacote da NT 2025.002 e parâmetros.
  3. TDN: controle de liberação das tags da NT v1.30 (MV_RTC55).
  4. TDN: RTC, transmissão de documentos eletrônicos.
  5. TDN: geração do grupo de totais por CST (MV_CSTGXML).
  6. TDN: MV_NT25002 no TSS.
  7. Central TOTVS: NFS-e Nacional e MV_RTC56.
  8. Central TOTVS: rejeição 321 e MV_250024D.
  9. Portal NF-e: NT 2025.002 v1.40.
  10. Portal NF-e: NT 2025.002 v1.51.

Perguntas frequentes

Principais dúvidas sobre o tema

Para que serve o MV_2500240 no Protheus?

É o parâmetro de data que liga em produção as regras de validação ajustadas no pacote da NT 2025.002 v1.40, como as das rejeições 1038, 1026, 1036, 1037 e 1001. O padrão é 03/08/2026.

Como adiar as regras do MV_2500240?

Pelos exemplos da TOTVS, com uma data futura. O texto das instruções fala em data menor ou igual à atual, mas contradiz o exemplo. Adiar só muda o Protheus: se a regra já vale na SEFAZ, a nota será rejeitada na transmissão.

Por que o XML não gera o grupo de IBS e CBS?

As causas documentadas são IBS e CBS fora do Configurador de Tributos, MV_RTC55 ausente ou com data futura, CST fora da lista do MV_CSTGXML e pacote desatualizado.

Qual o valor padrão do MV_CSTGXML?

000/200/210/220/510/550/830. Para incluir outro CST, acrescente ao final separando por barra, sem espaços.

O MV_250024D precisa ser alterado depois da NT v1.51?

A NT v1.51 adiou a regra VC02-14 para 05/10/2026, enquanto o padrão da TOTVS continua 01/09/2026. Quem adiou o parâmetro manualmente precisa considerar a nova data da SEFAZ.

Nota: este conteúdo tem finalidade informativa. Questões contratuais, tributárias ou jurídicas devem ser validadas com os responsáveis da sua empresa.

Próximo passo

Parâmetros da Reforma travando a emissão?

A Erpworks confere parâmetros, pacotes, TSS e Configurador do seu Protheus e resolve as rejeições de IBS e CBS na origem.

Falar com um especialista