Quando a SEFAZ virou a chave definitiva para o CT-e versão 4.00, muitos desenvolvedores de ERPs e sistemas de gerenciamento de transporte (TMS) acharam que a atualização seria apenas uma troca de número de versão no atributo versao="4.00" do XML.
Na prática, a versão 4.00 alterou profundamente o protocolo de comunicação e o controle de estado do Conhecimento de Transporte Eletrônico: o cabeçalho SOAP (SOAPHeader) deixou de existir, o envio em lote assíncrono foi substituído pela recepção 100% síncrona (CTeRecepcaoSincV4), o CT-e de Anulação foi extinto e — a mudança que mais impactou o banco de dados dos sistemas emissores — o webservice de Inutilização de Numeração foi descontinuado.
No CT-e 4.00, como não existe mais inutilização de faixa numérica, o seu sistema precisa distinguir com precisão se uma rejeição da SEFAZ aconteceu antes da gravação da chave (permitindo reaproveitar o mesmo número nCT sem deixar buracos na sequência) ou se houve falha de rede/duplicidade (Rejeição 539), onde reutilizar o número causa colisão fiscal.
Sem inutilização no CT-e 4.00, pular número a cada erro de digitação enche a auditoria contábil de lacunas; reaproveitar número sem critério trava a fila com erro de duplicidade.
Se você está estruturando o módulo logístico do seu sistema, recomendo ler também o nosso guia pilar de integração de API CT-e e MDF-e e o artigo sobre a Rejeição 531 e a nova tag vTotDFe da Reforma Tributária no CT-e. Abaixo, compartilho como resolvemos os quatro maiores desafios técnicos do CT-e 4.00 e como você pode abstrair tudo isso via API JSON.
O fim da inutilização de numeração no CT-e 4.00: quando reaproveitar o número e quando avançar?
Na NF-e (modelo 55) e no antigo CT-e 3.00, sempre que um número ficava para trás por falha de sistema ou erro cadastral, a rotina padrão era disparar um XML de inutilização para justificar o salto na sequência junto à SEFAZ.
Com a extinção do webservice de inutilização no CT-e 4.00, a responsabilidade pelo controle sequencial passou a exigir uma máquina de estados muito mais cuidadosa no software emissor.
Ao enviar um CT-e para o autorizador estadual (como SEFAZ-SP, MG, PR, MT, MS ou SVRS), o retorno pode cair em três categorias bem diferentes:
| Categoria de Retorno SEFAZ | Exemplos de Códigos (cStat) |
O número (nCT) foi gravado na SEFAZ? |
O que o emissor deve fazer com a numeração |
|---|---|---|---|
| 1. Rejeição Pré-Persistência (Validação de Schema, Certificado ou Regra de Negócio Inicial) | 215 (Falha no schema XML), 208/210 (CNPJ/IE do destinatário inválido), 531 (vRec > vTPrest / vTotDFe), 646 a 649 (Razão social em homologação), 670 (Série não permitida) |
Não | Reaproveitar o mesmo número: a SEFAZ descartou o XML na porta de entrada. Corrija o dado e reenvie com o mesmo nCT. |
| 2. Número Já Consumido por Outra Chave | 539 (Duplicidade de CT-e, com diferença na Chave de Acesso) |
Sim (por outro CT-e) | Nunca reaproveitar: aquele número e série já foram autorizados anteriormente com outra chave. O sistema deve alocar o próximo número da sequência. |
| 3. Retorno Ambíguo, Timeout ou Duplicidade da Mesma Chave | 204 (Duplicidade de CT-e), Timeout HTTP / Queda de conexão TLS |
Pode ter sido gravado | Consultar antes de decidir: mantenha o número reservado e consulte a chave de 44 dígitos no serviço CTeConsultaV4. Se constar autorizado (cStat 100), baixe o protocolo; se retornar 217 (CT-e não consta na base da SEFAZ), libere para reemissão. |
Quando você emite através da API da Notaas (POST /api/v1/cte/emitir), não precisa programar essa árvore de decisão no seu backend. Nossa infraestrutura classifica automaticamente cada código de retorno do MOC 4.00: se o erro for de validação prévia, o número volta intacto para o seu projeto para a próxima emissão; se houver instabilidade na SEFAZ, o motor reconcilia a chave automaticamente sem gerar duplicidade.
Rejeições 646, 647, 648 e 649: a armadilha dos testes em Homologação (tpAmb = 2)
Quem começa a homologar a emissão de CT-e 4.00 quase sempre esbarra em uma sequência de quatro rejeições logo no primeiro teste com dados reais de clientes:
Rejeição 646: CT-e emitido em ambiente de homologação com Razão Social do remetente diferente deCTE EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCALRejeição 647: ...Razão Social do expedidor diferente do literal obrigatórioRejeição 648: ...Razão Social do recebedor diferente do literal obrigatórioRejeição 649: ...Razão Social do destinatário diferente do literal obrigatório
No Manual de Orientação do Contribuinte (MOC 4.00, regras G002 a G005), a SEFAZ exige que, sempre que o ambiente for de Homologação (tpAmb = 2), a tag <xNome> dos quatro participantes da carga (<rem>, <exped>, <receb> e <dest>) seja preenchida exatamente com a frase em maiúsculas e sem acentos:
<xNome>CTE EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL</xNome>
(Detalhe importante: essa exigência não se aplica à razão social do próprio transportador emitente <emit> nem ao bloco de tomador <toma4>, apenas aos quatro papéis de movimentação da carga).
Em muitos sistemas legados, o desenvolvedor é obrigado a colocar if (ambiente == 2) espalhados pelo código ou alterar o nome dos clientes no banco de testes. Na API da Notaas, quando o seu projeto está configurado em Homologação, você pode enviar a razaoSocial real do remetente e do destinatário no seu JSON normalmente: o nosso construtor aplica a substituição exigida pela SEFAZ no XML de teste de forma transparente, mantendo o seu código idêntico entre homologação e produção.
O que mudou no envelope SOAP e no XML do CT-e 4.00 (Rejeições 215 e 239)
Se você está migrando um emissor próprio do CT-e 3.00 para o 4.00 e recebendo Rejeição 215 (Falha no schema XML) ou Rejeição 239 (Versão informada não suportada), confira os três pontos onde o layout mudou:
⚡ Checklist de Compatibilidade Estrutural do CT-e 4.00:
- 1. Remoção completa do
<soap12:Header>(cteCabecMsg): No CT-e 4.00, o cabeçalho SOAP foi eliminado. Enviar o antigocteCabecMsgcomcUFeversaoDadosfaz o webserviceCTeRecepcaoSincV4recusar o envelope imediatamente.- 2. Corpo compactado em GZip + Base64 dentro de
<cteDadosMsg>: Diferente da recepção antiga em lote, o serviço síncrono recebe um único elemento<CTe xmlns="http://www.portalfiscal.inf.br/cte">assinado, compactado em GZip e codificado em Base64 dentro da tag<cteDadosMsg>.- 3. Tag
<CRT>obrigatória dentro de<emit>: O Código de Regime Tributário do transportador (1para Simples Nacional,2para Simples com excesso de sublimite,3para Regime Normal ou4para MEI) agora é obrigatório logo após<xFant>e<enderEmit>dentro do grupo<emit>. Omitir<CRT>dispara Rejeição 215 no validador de schema da SEFAZ.
Veja como fica a estrutura enxuta do grupo <emit> exigida pelo XSD 4.00:
<emit>
<CNPJ>12345678000199</CNPJ>
<IE>110042490114</IE>
<xNome>Transportadora Rapido Sudeste LTDA</xNome>
<xFant>Rapido Sudeste</xFant>
<enderEmit>
<xLgr>Rodovia Anhanguera</xLgr>
<nro>KM 25</nro>
<xBairro>Perus</xBairro>
<cMun>3550308</cMun>
<xMun>Sao Paulo</xMun>
<CEP>05275000</CEP>
<UF>SP</UF>
</enderEmit>
<CRT>3</CRT>
</emit>
Emitindo CT-e 4.00 em segundos com a API pública da Notaas
Para eliminar toda a complexidade de certificados A1, compressão GZip do envelope SOAP, controle de numeração sem inutilização e montagem do layout de impressão do DACTE, a Notaas oferece uma rota REST JSON limpa em POST https://platform.notaas.com.br/api/v1/cte/emitir.
Os dados do transportador emitente (CNPJ, Inscrição Estadual, endereço, Regime Tributário CRT, RNTRC de 8 dígitos e série padrão) ficam salvos uma única vez no cadastro do projeto — pelo painel ou via Org API Multi-CNPJ (POST /api/v1/org/projects). A cada novo frete, sua aplicação envia apenas os dados variáveis da viagem:
curl -X POST "https://platform.notaas.com.br/api/v1/cte/emitir" \
-H "x-api-key: ntaas_live_SEU_TOKEN_AQUI" \
-H "Idempotency-Key: frete-viagem-2026-00981" \
-H "Content-Type: application/json" \
-d '{
"dados": {
"cfop": "6353",
"naturezaOperacao": "Transporte rodoviario de cargas",
"origem": {
"codigoMunicipio": "3550308",
"municipio": "Sao Paulo",
"uf": "SP"
},
"destino": {
"codigoMunicipio": "3106200",
"municipio": "Belo Horizonte",
"uf": "MG"
},
"tomador": "remetente",
"remetente": {
"cnpj": "12345678000199",
"inscricaoEstadual": "110042490114",
"razaoSocial": "Atacadista Paulista de Alimentos LTDA",
"endereco": {
"logradouro": "Av. Marginal Tiete",
"numero": "4500",
"bairro": "Vila Guilherme",
"codigoMunicipio": "3550308",
"municipio": "Sao Paulo",
"cep": "02050000",
"uf": "SP"
}
},
"destinatario": {
"cnpj": "98765432000188",
"inscricaoEstadual": "0621234560088",
"razaoSocial": "Supermercados Minas Gerais S/A",
"endereco": {
"logradouro": "Av. Amazonas",
"numero": "1800",
"bairro": "Santo Agostinho",
"codigoMunicipio": "3106200",
"municipio": "Belo Horizonte",
"cep": "30180001",
"uf": "MG"
}
},
"valores": {
"valorTotal": 2400.00,
"valorReceber": 2400.00,
"componentes": [
{ "nome": "FRETE PESO", "valor": 2150.00 },
{ "nome": "GRIS", "valor": 250.00 }
]
},
"impostos": {
"icms": {
"cst": "00",
"baseCalculo": 2400.00,
"aliquota": 12.00,
"valor": 288.00
}
},
"carga": {
"valorTotal": 95000.00,
"produtoPredominante": "PRODUTOS ALIMENTICIOS",
"quantidades": [
{
"unidade": "KG",
"tipoMedida": "PESO BRUTO",
"quantidade": 8400.00
}
]
},
"documentosOriginarios": {
"tipo": "nfe",
"chaves": [
"35261112345678000199550010000004501000004509"
]
}
}
}'
E se precisar cancelar um CT-e autorizado dentro do prazo legal (desde que ele ainda não tenha um MDF-e ativo circulando na barreira fiscal — veja como encerrar o MDF-e via API antes de ser bloqueado pela Rejeição 611), basta uma chamada simples para POST /api/v1/cte/cancelar passando o invoiceId e a justificativa (15 a 255 caracteres).
Homologue seu TMS gratuitamente hoje mesmo
Na Notaas, você desenvolve e homologa a emissão de CT-e 4.00, MDF-e 3.00b, NF-e, NFC-e e NFS-e sem burocracia comercial:
- 20 documentos fiscais gratuitos por mês em produção real (1 CNPJ);
- Até 5 CNPJs simultâneos grátis em homologação via Org API para testar múltiplos transportadores e embarcadores;
- DACTE e DAMDFE em PDF gerados automaticamente com QR Code oficial da SEFAZ.
👉 Crie sua conta gratuita na Notaas ou consulte todos os endpoints de transporte em docs.notaas.com.br.

