XML do CT-e: os grupos do conhecimento de transporte e o que cada campo informa
Publicado em · Atualizado em · Por Equipe PegaXML
Resumo
O XML do CT-e é organizado em grupos: identificação, emitente, partes da operação, valores da prestação, impostos, informações da carga e dos documentos transportados, dados do modal e protocolo de autorização. A leitura correta mostra quem é o tomador, qual é o valor do frete, quais NF-e foram transportadas e em que modal. Os nomes exatos dos campos estão no MOC do CT-e.
Por que ler o XML do CT-e
O CT-e é o documento fiscal do serviço de transporte de cargas. Para quem contrata frete, o XML é a fonte para conferir o valor cobrado, apropriar créditos quando cabível e conciliar o frete com as notas transportadas. Para o contador, é a base da escrituração das prestações. Para o transportador, é o espelho do que foi declarado à Sefaz.
Este artigo segue a organização do leiaute do CT-e (modelo 57) em linhas gerais. Os nomes exatos e os tamanhos de cada campo estão no Manual de Orientação do Contribuinte (MOC) do CT-e e nas notas técnicas publicadas no Portal Nacional do CT-e. Use o manual vigente quando for montar ou validar um arquivo.
Visão geral dos grupos
| Grupo | O que informa |
|---|---|
| Identificação | Modelo, série, número, data e hora, CFOP, natureza da prestação, modal, tipo do CT-e, tipo de serviço, municípios de início e fim, tomador |
| Complemento | Observações, características do transporte e do serviço |
| Emitente | Transportador: CNPJ, inscrição estadual, endereço, regime |
| Remetente, expedidor, recebedor, destinatário | As partes da operação de transporte |
| Valores da prestação | Valor total, valor a receber, componentes do frete |
| Impostos | ICMS da prestação e, desde 2026, IBS e CBS |
| Informações do CT-e normal | Carga, documentos transportados, modal, veículos |
| Informações complementares ou de substituição | Quando o CT-e é complementar ou substituto |
| Autorizados a obter o XML | CNPJ ou CPF de terceiros com acesso ao arquivo |
| Assinatura e protocolo | Assinatura digital e protocolo de autorização |
Identificação
É o cabeçalho do documento. Os pontos que mais importam:
- Modelo 57, série e número. Junto com o CNPJ do emitente e a UF, compõem a chave de acesso de 44 dígitos.
- CFOP da prestação. No transporte, os CFOP são os do grupo 5.350 (dentro do estado) e 6.350 (para outro estado), conforme o tomador. Confira na tabela de CFOP.
- Modal: rodoviário, aéreo, aquaviário, ferroviário, dutoviário ou multimodal.
- Tipo do CT-e: normal, complementar ou substituto. O de anulação foi extinto.
- Tipo de serviço: normal, subcontratação, redespacho, redespacho intermediário ou vinculado a multimodal.
- Municípios de início e de término da prestação, que definem se o transporte é intermunicipal, interestadual ou internacional e qual ICMS se aplica.
- Tomador: um indicador aponta qual das partes paga o frete (remetente, expedidor, recebedor ou destinatário). Se for outra pessoa, ela é identificada em grupo próprio.
As partes
Cada parte (remetente, expedidor, recebedor e destinatário) tem CNPJ ou CPF, inscrição estadual quando houver, nome e endereço. Expedidor e recebedor só aparecem quando são diferentes do remetente e do destinatário:
- expedidor: quem entrega a carga ao transportador no lugar do remetente, como um armazém;
- recebedor: quem recebe a carga do transportador no lugar do destinatário, como um centro de distribuição ou outro transportador no redespacho.
A combinação dessas partes com o indicador do tomador é o que mais gera erro de preenchimento. Tomador errado tem procedimento próprio de correção no Ajuste SINIEF 09/2007 (cláusula décima sétima-A).
Valores da prestação
O grupo de valores separa:
- valor total da prestação, que é o frete;
- valor a receber, que pode ser diferente do total em casos específicos;
- componentes do valor, como frete-peso, frete-valor, pedágio, taxas e outros, cada um com nome e valor.
Esse grupo é o que o tomador confere contra a cotação. Diferença de valor depois da autorização não se corrige por carta de correção: entra no procedimento de CT-e complementar ou substituto. Veja eventos do CT-e.
Impostos
O grupo de impostos traz o ICMS da prestação, com a situação tributária (por exemplo, tributação normal, redução de base, isenção, não tributação, ICMS devido a outra UF ou regime do Simples), a base de cálculo, a alíquota e o valor. A explicação das situações tributárias do ICMS está na tabela de CST do ICMS.
Há também campos de valor aproximado dos tributos e, desde 2026, os campos de IBS e CBS da reforma, obrigatórios para fatos geradores a partir de 03/08/2026 no regime regular (Ato Conjunto RFB/CGIBS nº 4/2026), com a mesma lógica de CST e classificação tributária dos demais documentos.
Informações do CT-e normal
É o bloco mais extenso. Ele reúne:
Carga
- valor da carga, isto é, das mercadorias transportadas;
- produto predominante;
- quantidades, cada uma com unidade de medida e tipo (peso bruto, peso cubado, volumes etc.).
Documentos transportados
Em regra, a chave de acesso de cada NF-e transportada. Há também campos para outros documentos, quando a carga não é acobertada por NF-e. Esse vínculo é o que permite cruzar o CT-e com as notas e com o MDF-e da viagem.
Modal
Cada modal tem o seu grupo. No rodoviário, o principal campo é o RNTRC do transportador, o registro na ANTT. Os dados de veículos e motoristas da viagem ficam, em regra, no MDF-e.
Documentos anteriores
No redespacho e na subcontratação, o CT-e pode referenciar documentos de transporte anteriores emitidos por outros transportadores da cadeia.
Autorizados, assinatura e protocolo
O grupo de autorizados a obter o XML permite indicar CNPJ ou CPF de terceiros, como o contador, que podem baixar o arquivo. O XML termina com a assinatura digital do emitente e, na versão distribuída, com o protocolo de autorização da Sefaz. Sem protocolo, o arquivo não é um CT-e autorizado.
Roteiro de conferência para quem paga o frete
- Confira a chave e o protocolo no Portal Nacional do CT-e.
- Veja se você é o tomador indicado.
- Compare o valor da prestação e os componentes com a cotação.
- Confira as NF-e referenciadas: são as da sua carga?
- Confira municípios de início e fim e o CFOP.
- Guarde o XML pelo prazo da legislação: o tomador também tem a obrigação de guarda (cláusula décima segunda). Veja guarda do XML por 5 anos.
- Se a prestação não aconteceu como descrito, registre o evento de prestação em desacordo.
Perguntas frequentes
Como saber quem é o tomador no XML do CT-e?
Pelo grupo do tomador na identificação. Ele aponta se o tomador é o remetente, o expedidor, o recebedor ou o destinatário, ou traz os dados de outro tomador quando nenhum desses paga o frete.
Onde ficam as notas fiscais transportadas?
No grupo de documentos da carga, em regra pela chave de acesso de cada NF-e. É por esse vínculo que o fisco cruza o frete com a mercadoria.
O valor da carga é o valor do frete?
Não. O valor da carga (mercadorias transportadas) fica nas informações da carga. O valor da prestação, que é o frete, fica no grupo de valores, com os componentes do frete.
Qual campo do XML vale se o DACTE estiver diferente?
O XML autorizado. O DACTE é só a representação dele.