Tecnologia

CT-e 4.00 via API: Fim da Inutilização de Numeração, Rejeições 539, 215 e 646 a 649 em Homologação

Entenda o que mudou na arquitetura do CT-e 4.00 (fim da inutilização de numeração, fim do SOAPHeader, recepção síncrona e CRT obrigatório), como evitar a Rejeição 539 sem queimar números e como resolver as Rejeições 646 a 649 em homologação via API.

Fábio Magalhães CostaAtualizado em 19/11/2026
Engenharia de transmissão do CT-e 4.00: controle de sequência sem inutilização, recepção síncrona e tratamento automático de homologação

Engenharia de transmissão do CT-e 4.00: controle de sequência sem inutilização, recepção síncrona e tratamento automático de homologação

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 de CTE EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL
  • Rejeição 647: ...Razão Social do expedidor diferente do literal obrigatório
  • Rejeição 648: ...Razão Social do recebedor diferente do literal obrigatório
  • Rejeiçã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 antigo cteCabecMsg com cUF e versaoDados faz o webservice CTeRecepcaoSincV4 recusar 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 (1 para Simples Nacional, 2 para Simples com excesso de sublimite, 3 para Regime Normal ou 4 para 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.

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em Tecnologia

Guias Pilares de Integração Fiscal