Tecnologia além do código.
Régys Borges da Silveira

NT 2023.001 v.1.03 do CT-e: mudanças, legado e cuidados nas integrações

Miniatura ilustrativa de caminhão, documento de transporte e integração entre arquivo legado e sistema.
Neste artigo 12 tópicos

A manutenção de um emissor de CT-e não se limita a gerar XML, assinar o documento e transmitir um lote. Ela depende da leitura cuidadosa de regras fiscais, do comportamento do autorizador e da distinção entre processos que foram descontinuados e validações que continuam relevantes para o acervo histórico ou para determinados modelos de documento. A Nota Técnica (NT) 2023.001 v.1.03 é um marco útil para essa revisão.

O documento oficial reúne alterações nas regras de validação do CT-e, do CT-e OS e da GTV-e. Para desenvolvedores Delphi, o tema alcança rotinas de montagem de dados, tratamento de retornos, cadastros e testes de homologação. Para a contabilidade, envolve a conferência do fluxo documental, a numeração e a interpretação adequada de rejeições. Neste artigo, vamos identificar o alcance da nota, detalhar as mudanças confirmadas e, sobretudo, mostrar como transformar esse conteúdo em decisões técnicas prudentes.

O que é a NT 2023.001 v.1.03 e qual é seu alcance

A Nota Técnica 2023.001, versão 1.03, é documento oficial disponibilizado pelo Portal Nacional do CT-e. A capa do PDF identifica a versão como “maio de 2023”, enquanto o aviso do Portal Nacional registra a publicação em 01/06/2023. Essas referências não precisam ser tratadas como contradição: uma informa a identificação editorial do documento; a outra, a sua disponibilização no portal.

Em síntese, a versão tratou de seis frentes: retirada da denegação no processo de autorização; eliminação do Web Service de inutilização; revogação de eventos de marcação; bloqueio de CT-e de anulação e de substituição na versão 3.00; revogação do evento de Informações da GTV em CT-e OS e ajustes de validação ligados ao transporte de valores e de pessoas; além da correção do CST no grupo ICMSSN da versão 4.00.

É importante enquadrar a nota corretamente. Ela é uma especificação técnico-fiscal de 2023, não uma garantia de que cada regra, código de rejeição ou cronograma descrito esteja hoje implementado da mesma forma em todos os autorizadores. O Portal Nacional lista notas técnicas posteriores para CT-e, inclusive em 2026, mas a pesquisa realizada não identificou um ato único que declare a NT 2023.001 v.1.03 integralmente revogada, substituída ou consolidada. Logo, há uma diferença essencial entre conhecer o conteúdo histórico do documento e assumir sua vigência operacional integral sem teste.

Fim da denegação: mudança no tratamento de irregularidades

Uma das alterações mais relevantes foi a eliminação das hipóteses de denegação no processo de autorização. Segundo a NT, a irregularidade do emitente deveria levar à rejeição 203, em vez de produzir um CT-e denegado.

Na prática de sistemas, denegação e rejeição não devem ser tratadas como sinônimos. Uma rejeição interrompe a autorização e exige correção ou regularização antes de nova transmissão. Já documentos denegados pertencem ao histórico de situações que os sistemas podem precisar reconhecer e consultar. A própria nota preserva a verificação de CT-e denegado em eventos por compatibilidade com documentos históricos.

Esse detalhe é especialmente importante em aplicações Delphi que tenham um enumerador de status, regras internas de bloqueio ou rotinas de consulta documental. Remover o fluxo de emissão denegada não significa apagar da base conceitos, registros e tratamentos ligados a documentos denegados anteriormente. Uma atualização segura separa três camadas: os retornos recebidos em transmissões atuais, os documentos armazenados no histórico e as validações aplicáveis a eventos relacionados a esse acervo.

Para a área contábil, a consequência é semelhante. Ao investigar uma pendência, é necessário identificar se o caso é uma rejeição atual por irregularidade do emitente ou uma situação histórica já gravada como denegada. Misturar essas condições pode resultar em diagnóstico incorreto, reprocessamento indevido ou falha na conciliação entre o ERP e os documentos fiscais eletrônicos.

Inutilização: serviço retirado, sequência preservada

A NT também informou que o Web Service de inutilização deixaria de existir nas datas de implantação previstas. Como efeitos possíveis, mencionou retorno HTTP 404 ou a rejeição 998. Esse ponto merece atenção porque muitos emissores mantinham telas, filas ou procedimentos internos baseados no pedido de inutilização.

Há confirmação posterior, no contexto paulista, de que o pedido de inutilização de números não utilizados de CT-e deixou de ser necessário. A Resposta à Consulta Tributária 28214/2023 da SEFAZ-SP cita expressamente o item 2 da NT e relaciona a mudança ao Ajuste SINIEF 31/2022. A mesma manifestação ressalta que o fim do pedido não elimina a exigência de numeração sequencial por estabelecimento e série.

Portanto, a retirada da inutilização não autoriza a tratar a numeração como informação sem controle. Do ponto de vista do produto, a necessidade se desloca: em vez de implementar uma transmissão para inutilizar faixas, o sistema precisa manter rastreabilidade sólida das numerações atribuídas, dos documentos autorizados, das tentativas rejeitadas e das lacunas que eventualmente precisem ser explicadas na gestão interna.

Para CT-e OS, há uma confirmação operacional específica da SEFAZ-MS: os Web Services de inutilização foram desativados em produção e homologação em 01/06/2023. O comunicado associa esse cenário ao Ajuste SINIEF 40/2022. A distinção é relevante: para CT-e, a fonte paulista aponta o Ajuste SINIEF 31/2022; para CT-e OS, a comunicação consultada menciona o Ajuste SINIEF 40/2022.

Consequências para integrações legadas

Um conector fiscal que ainda ofereça “inutilizar CT-e” como operação automática deve ser revisto. O primeiro cuidado é evitar que o sistema transforme uma indisponibilidade esperada do serviço em falha genérica de comunicação. HTTP 404 e rejeição 998 precisam chegar à camada de negócio com mensagem compreensível, registro de auditoria e orientação compatível com a política da empresa.

O segundo cuidado é funcional. Botões, permissões, jobs agendados e procedimentos operacionais que dependiam da inutilização merecem análise. A remoção da chamada técnica sem revisar esses pontos pode deixar o usuário diante de uma funcionalidade aparentemente disponível, mas que não tem mais suporte no fluxo fiscal.

CT-e 3.00: anulação e substituição sob bloqueio específico

A versão 3.00 perdeu vigência em 31 de janeiro de 2024, às 23h59, segundo aviso da coordenação técnica do ENCAT. Os códigos 990 e 991 descritos nesta seção documentam o comportamento histórico da versão 3.00. Para emissão atual, use a versão 4.00 e confira as regras e os serviços aplicáveis ao autorizador. Aviso oficial sobre o fim da vigência da versão 3.00.

A NT estabeleceu validações específicas para a versão 3.00. Um CT-e de anulação ou de substituição nessa versão deveria receber o cStat 990. Também determinou que o grupo infCteSub não é permitido, com cStat 991. O documento afirma que a nova sistemática de substituição seria possível apenas na versão 4.00.

Essas regras exigem precisão na manutenção de aplicações que convivam com versões diferentes. Não é correto generalizar os códigos 990 e 991 para CT-e 4.00, nem concluir que qualquer rotina de substituição seja inválida em todo o ecossistema. O escopo indicado pela nota é a versão 3.00.

Em termos de desenvolvimento, a versão do documento deve participar explicitamente da regra de negócio. Em Delphi, isso pode significar condicionar a montagem do grupo infCteSub, as opções disponibilizadas na interface e os testes automatizados ao leiaute efetivamente usado. Uma regra aplicada apenas na tela, mas ignorada por integrações de importação, API interna ou reenvio de fila, não protege o processo completo.

Para profissionais de contabilidade, o ponto de controle é confirmar a versão envolvida antes de orientar correção do documento. Em registros históricos da versão 3.00, a rejeição ligada à substituição deve ser interpretada conforme as regras daquela versão. A leitura do retorno deve considerar tanto o cStat quanto o contexto técnico do emissor.

CT-e OS: transporte de valores e de pessoas

A NT ajustou as regras H045a e H025 para esclarecer que ambas se aplicam somente a CT-e normal ou de substituição. Essa delimitação orienta dois cenários distintos no CT-e OS.

No transporte de valores, a regra H045a exige o grupo infGTVe em CT-e normal ou de substituição. Quando essa condição não é atendida, a nota prevê a rejeição 927. Trata-se de uma validação diretamente ligada ao contexto do documento: não basta classificar a operação; é preciso garantir que o grupo correspondente esteja presente quando exigido.

No transporte rodoviário de pessoas, a H025 exige infFretamento em CT-e normal ou de substituição. A ausência do grupo, no cenário descrito, leva à rejeição 841. Para quem mantém cadastros de prestação de serviço, isso reforça a importância de distinguir as operações antes da geração do XML.

Validação antes da transmissão

A melhor experiência para o usuário é impedir, quando possível, que uma combinação evidentemente incompleta chegue ao autorizador. Porém, a validação local deve reproduzir apenas o que foi confirmado pela documentação aplicável. Não se deve inventar obrigatoriedades, criar grupos XML de forma indiscriminada ou presumir que um campo é exigido fora das condições descritas.

Uma abordagem consistente é centralizar a decisão em uma rotina que receba, no mínimo, a versão do CT-e, o tipo de serviço, a finalidade do documento e a presença dos grupos de dados. Essa rotina pode bloquear a geração, exibir uma pendência de cadastro e registrar a razão da interrupção. O retorno do autorizador continua indispensável, mas o sistema reduz erros previsíveis antes do envio.

Correção do CST no grupo ICMSSN

A nota registrou uma correção no preenchimento da tag CST do grupo ICMSSN para CT-e versão 4.00: o valor informado passou a ser 90 — Simples Nacional, em vez de 01. O contexto técnico dessa referência é o MOC CT-e versão 4.00, disponibilizado pelo Portal Nacional com seu Anexo I de leiaute e regras de validação.

Para desenvolvedores, esse é um exemplo clássico de mudança aparentemente pequena, mas capaz de afetar regras de serialização e tabelas internas. Um sistema pode ter a regra gravada em uma classe fiscal, em uma tabela de domínio, em um mapeamento de componente visual ou em integração com terceiros. A revisão precisa localizar todas essas fontes, e não apenas o trecho que escreve a tag no XML.

Na contabilidade, a utilidade está em reconhecer que divergências de CST podem ter origem na parametrização do emissor. Antes de atribuir uma rejeição ou inconsistência exclusivamente ao usuário, vale conferir a versão utilizada, o regime informado e a configuração efetiva do grupo tributário.

Limitações e leitura responsável da nota

A versão 1.03 trouxe cronograma com data de 26/06/2023 prevista para implantação, mas o próprio texto a qualificava como “a confirmar” e sujeita a postergação. Ela não deve ser apresentada como uma data nacional definitiva de produção.

Também há evidência de cronogramas operacionais que não são idênticos em todos os contextos. A SEFAZ-MS comunicou a desativação do serviço de inutilização de CT-e OS em 01/06/2023, enquanto a NT apresentava uma previsão posterior de implantação padronizada. Isso recomenda validar o comportamento do autorizador, do modelo documental e do ambiente antes de atualizar procedimentos internos.

Por fim, a pesquisa não abriu os arquivos do Anexo I do MOC 4.00, os schemas correspondentes nem uma relação atual de serviços por autorizador. O PDF da NT não fornece exemplos oficiais de XML e não especifica expressamente alteração de schema ou novo leiaute XML. Assim, não é seguro afirmar que a nota, por si só, introduziu um novo schema, nem publicar um XML ilustrativo como se fosse especificação oficial.

Aplicação prática

A adoção segura dessas evidências começa com um inventário, não com uma alteração direta de código. Liste quais produtos, bibliotecas Delphi, serviços internos e integrações de terceiros ainda emitem CT-e ou CT-e OS. Em seguida, identifique a versão de leiaute usada em cada fluxo e quais funcionalidades dependem de denegação, inutilização, substituição ou geração de grupos específicos.

Para o tratamento de denegação, revise os códigos de retorno e mantenha suporte de consulta ao histórico. A regra confirmada é que irregularidade do emitente passaria a resultar em rejeição 203; por isso, o sistema deve orientar a regularização e impedir que esse retorno seja interpretado como autorização denegada. Ao mesmo tempo, não elimine sem análise as rotinas que leem documentos denegados antigos ou eventos associados a eles.

No tema inutilização, localize chamadas SOAP, tarefas automáticas, botões e permissões relacionados ao serviço. Em vez de simplesmente suprimir erros, teste o comportamento do autorizador aplicável e trate HTTP 404 ou rejeição 998 de forma explícita. Preserve o controle sequencial por estabelecimento e série, pois a dispensa do pedido de inutilização não afasta essa exigência confirmada para CT-e na fonte paulista.

Nos emissores de CT-e 3.00, crie testes de regressão para tentativa de emissão de CT-e de anulação ou substituição e para presença de infCteSub. Os cenários devem esperar, respectivamente, os retornos 990 e 991 descritos na nota. Em fluxos 4.00, não reutilize essas expectativas sem conferir a documentação e o ambiente correspondente.

Para CT-e OS, monte uma matriz de testes com: transporte de valores normal e de substituição com infGTVe; tentativa equivalente sem o grupo; transporte rodoviário de pessoas normal e de substituição com infFretamento; e tentativa sem esse grupo. O objetivo é verificar as condições relacionadas às rejeições 927 e 841, sem extrapolá-las para finalidades não abrangidas pela regra.

Por último, revise a parametrização do Simples Nacional para CT-e 4.00. A checagem deve alcançar tabela de CST, geração da tag CST no grupo ICMSSN e testes de transmissão. Registre a versão do componente fiscal, a UF ou autorizador utilizado, a data do teste e os retornos obtidos. Esse histórico é valioso para suporte, auditoria e diálogo entre desenvolvimento e contabilidade.

Conclusão

A NT 2023.001 v.1.03 documentou mudanças relevantes na operação do CT-e, do CT-e OS e da GTV-e. Entre os pontos mais práticos estão a substituição da denegação pela rejeição 203 em caso de irregularidade do emitente, o fim do serviço de inutilização, o bloqueio de determinadas operações de anulação e substituição na versão 3.00, as validações de infGTVe e infFretamento no CT-e OS e a correção do CST no grupo ICMSSN da versão 4.00.

O aprendizado principal não é apenas técnico: integrações fiscais precisam preservar contexto. A versão do documento, o modelo emitido, o autorizador e o ambiente de teste influenciam a forma correta de aplicar uma regra. A nota é referência importante para compreender a transição iniciada em 2023, mas não substitui a verificação da documentação atual e do comportamento efetivo do ambiente utilizado pela empresa.

Para desenvolvedores Delphi e equipes contábeis, a ação mais segura é combinar revisão de código, revisão de parâmetros, testes controlados e registro dos retornos. Dessa forma, o sistema deixa de depender de suposições sobre denegação e inutilização, mantém a sequência documental sob controle e trata as rejeições com o nível de precisão que o processo fiscal exige.

Referências

MATO GROSSO DO SUL. Secretaria de Estado de Fazenda. Fim da vigência da versão 3.00 do CT-e. Disponível em: Aviso oficial sobre o fim da vigência da versão 3.00. Acesso em: 8 nov. 2026.

MATO GROSSO DO SUL. Secretaria de Estado de Fazenda. Desativação do Web Service de inutilização — Produção e Homologação. 2023. Disponível em: https://www.sefaz.ms.gov.br/desativacao-do-web-service-de-inutilizacao-producao-e-homologacao-3/. Acesso em: 7 out. 2026.

PORTAL NACIONAL DO CT-E; ENCAT. Manuais — Manual de Orientação do Contribuinte CT-e, versão 4.0. 2023. Disponível em: https://www.cte.fazenda.gov.br/portal/listaConteudo.aspx?tipoConteudo=YIi%2BH8VETH0%3D. Acesso em: 7 out. 2026.

PORTAL NACIONAL DO CT-E; ENCAT. Nota Técnica 2023.001 — versão 1.03, maio de 2023. 2023. Disponível em: https://www.cte.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=WxTUtPhfcKE=. Acesso em: 7 out. 2026.

PORTAL NACIONAL DO CT-E; ENCAT. Notas Técnicas. [s. d.]. Disponível em: https://www.cte.fazenda.gov.br/portal/listaConteudo.aspx?tipoConteudo=Y0nErnoZpsg%3D. Acesso em: 7 out. 2026.

PORTAL NACIONAL DO CT-E; ENCAT. Publicada versão 1.03 da NT 2023.001. 2023. Disponível em: https://www.cte.fazenda.gov.br/portal/informe.aspx?informe=108. Acesso em: 7 out. 2026.

SÃO PAULO (Estado). Secretaria da Fazenda e Planejamento. Resposta à Consulta Tributária 28214/2023. 2023. Disponível em: https://legislacao.fazenda.sp.gov.br/Paginas/RC28214_2023.aspx. Acesso em: 7 out. 2026.

Compartilhar por e-mail

0 comentário(s)

Participe da conversa

Seu e-mail não será publicado.

Este site utiliza o Akismet para reduzir spam. Saiba como seus dados em comentários são processados.

Um próximo passo para cada interesse.

Continue estudando com os livros, acompanhe as videoaulas ou consulte as soluções para o seu projeto.

Descubra mais sobre Régys Borges da Silveira

Assine agora mesmo para continuar lendo e ter acesso ao arquivo completo.

Continuar lendo