Campos do XML da GTV-e: caminho, tamanho e valores

(raiz do arquivo)

4 campos

Campo	O que é	Ocorrência	Regras
evGTV	Schema XML de validação do evento informações da GTV 110170	Obrigatório, uma vez	—
GTVe	Guia de Trasnsporte Eletrônica	Obrigatório, uma vez	—
GTVeProc	GTV-e processada	Obrigatório, uma vez	—
retGTVe	Schema XML de validação do retorno do recibo de envio da GTV-e (Modelo 64)	Obrigatório, uma vez	—

evGTV

2 campos

Campo	O que é	Ocorrência	Regras
descEvento	Descrição do Evento - “Informações da GTV”	Obrigatório, uma vez	—
infGTV	Grupo de Informações das GTV	Obrigatório, 1 vez(es) ou mais	—

GTVe

3 campos

Campo	O que é	Ocorrência	Regras
infCte	Informações do CT-e do tipo GTV-e	Obrigatório, uma vez	—
infCTeSupl	Informações suplementares da GTV-e	Opcional, no máximo uma vez	—
versao	Versão do leiaute	Obrigatório, uma vez	—

GTVeProc

4 campos

Campo	O que é	Ocorrência	Regras
dhConexao	Data e Hora da Conexão de Origem	Opcional, no máximo uma vez	—
ipTransmissor	IP do transmissor do documento fiscal para o ambiente autorizador	Opcional, no máximo uma vez	—
nPortaCon	Porta de origem utilizada na conexão (De 0 a 65535)	Opcional, no máximo uma vez	—
protCTe	Tipo Protocolo de status resultado do processamento da GTV-e (Modelo 64)	Obrigatório, uma vez	—

evGTV/infGTV

4 campos

Campo	O que é	Ocorrência	Regras
dEmi	Data de Emissão	Obrigatório, uma vez	—
nDoc	Número da GTV	Obrigatório, uma vez	—
nDV	Número Dígito Verificador	Obrigatório, uma vez	—
subserie	Subsérie	Opcional, no máximo uma vez	—

GTVe/infCte

11 campos

Campo	O que é	Ocorrência	Regras
autXML	Autorizados para download do XML do DF-e	0 a 10 vez(es)	—
compl	Dados complementares da GTV-e para fins operacionais ou comerciais	Opcional, no máximo uma vez	—
dest	Informações do Destinatário	Obrigatório, uma vez	—
destino	Informações do endereço do destino do serviço	Opcional, no máximo uma vez	—
detGTV	Grupo de informações detalhadas da GTV-e	Obrigatório, uma vez	—
emit	Identificação do Emitente da GTV-e	Obrigatório, uma vez	—
Id	Identificador da tag a ser assinada	Obrigatório, uma vez	—
ide	Identificação da GTV-e	Obrigatório, uma vez	—
infRespTec	Informações do Responsável Técnico pela emissão do DF-e	Opcional, no máximo uma vez	—
origem	Informações do endereço da origem do serviço	Opcional, no máximo uma vez	—
rem	Informações do Remetente	Obrigatório, uma vez	—

GTVe/infCTeSupl

1 campo

Campo	O que é	Ocorrência	Regras
qrCodCTe	Texto com o QR-Code impresso no DACTE	Obrigatório, uma vez	—

GTVeProc/protCTe

2 campos

Campo	O que é	Ocorrência	Regras
infFisco	Mensagem do Fisco	Opcional, no máximo uma vez	—
infProt	Dados do protocolo de status	Obrigatório, uma vez	—

GTVe/infCte/autXML

2 campos

Campo	O que é	Ocorrência	Regras
CNPJ	CNPJ do autorizado	Obrigatório, uma vez	—
CPF	CPF do autorizado	Obrigatório, uma vez	—

GTVe/infCte/compl

6 campos

Campo	O que é	Ocorrência	Regras
ObsCont	Campo de uso livre do contribuinte	0 a 10 vez(es)	—
ObsFisco	Campo de uso livre do contribuinte	0 a 10 vez(es)	—
xCaracAd	Característica adicional do transporte	Opcional, no máximo uma vez	—
xCaracSer	Característica adicional do serviço	Opcional, no máximo uma vez	—
xEmi	Funcionário emissor da GTV-e	Opcional, no máximo uma vez	—
xObs	Observações Gerais	Opcional, no máximo uma vez	—

GTVe/infCte/dest

6 campos

Campo	O que é	Ocorrência	Regras
email	Endereço de email	Opcional, no máximo uma vez	—
enderDest	Dados do endereço	Obrigatório, uma vez	—
fone	Telefone	Opcional, no máximo uma vez	—
IE	Inscrição Estadual	Opcional, no máximo uma vez	—
ISUF	Inscrição na SUFRAMA	Opcional, no máximo uma vez	—
xNome	Razão Social ou Nome do destinatário	Obrigatório, uma vez	—

GTVe/infCte/destino

8 campos

Campo	O que é	Ocorrência	Regras
CEP	CEP	Opcional, no máximo uma vez	—
cMun	Código do município (utilizar a tabela do IBGE)	Obrigatório, uma vez	—
nro	Número	Obrigatório, uma vez	—
UF	Sigla da UF	Obrigatório, uma vez	—
xBairro	Bairro	Obrigatório, uma vez	—
xCpl	Complemento	Opcional, no máximo uma vez	—
xLgr	Logradouro	Obrigatório, uma vez	—
xMun	Nome do município	Obrigatório, uma vez	—

GTVe/infCte/detGTV

3 campos

Campo	O que é	Ocorrência	Regras
infEspecie	Informações das Espécies transportadas	Obrigatório, 1 vez(es) ou mais	—
infVeiculo	Grupo de informações dos veículos utilizados no transporte de valores	Obrigatório, 1 vez(es) ou mais	—
qCarga	Quantidade de volumes/malotes	Obrigatório, uma vez	—

GTVe/infCte/emit

4 campos

Campo	O que é	Ocorrência	Regras
enderEmit	Endereço do emitente	Obrigatório, uma vez	—
IEST	Inscrição Estadual do Substituto Tributário	Opcional, no máximo uma vez	—
ISUFEmit	Inscrição do emitente da Suframa	Opcional, no máximo uma vez	—
xFant	Nome fantasia	Opcional, no máximo uma vez	—

GTVe/infCte/ide

26 campos

Campo	O que é	Ocorrência	Regras
cCT	Código numérico que compõe a Chave de Acesso.	Obrigatório, uma vez	—
cDV	Digito Verificador da chave de acesso da GTV-e	Obrigatório, uma vez	—
CFOP	Código Fiscal de Operações e Prestações	Obrigatório, uma vez	—
cMunEnv	Código do Município de envio da GTV-e (de onde o documento foi transmitido)	Obrigatório, uma vez	—
cUF	Código da UF do emitente da GTV-e.	Obrigatório, uma vez	—
dhChegadaDest	Data e hora de chegada no destino	Obrigatório, uma vez	—
dhCont	Data e Hora da entrada em contingência	Obrigatório, uma vez	—
dhEmi	Data e hora de emissão da GTV-e	Obrigatório, uma vez	—
dhSaidaOrig	Data e hora de saida da origem	Obrigatório, uma vez	—
indIEToma	Indicador da IE do tomador: 1 – Contribuinte ICMS; 2 – Contribuinte isento de inscrição; 9 – Não Contribuinte	Obrigatório, uma vez	—
mod	Modelo do documento fiscal	Obrigatório, uma vez	—
modal	Modal da GTV-e	Obrigatório, uma vez	—
natOp	Natureza da Operação	Obrigatório, uma vez	—
nCT	Número da GTV-e	Obrigatório, uma vez	—
serie	Série da GTV-e	Obrigatório, uma vez	—
toma	Indicador do "papel" do tomador do serviço no GT-e	Obrigatório, uma vez	—
tomaTerceiro	Indicador do "papel" do tomador do serviço no CTV-e	Obrigatório, uma vez	—
tpAmb	Tipo do Ambiente	Obrigatório, uma vez	—
tpCTe	Tipo da GTV-e	Obrigatório, uma vez	—
tpEmis	Forma de emissão da GTV-e	Obrigatório, uma vez	—
tpImp	Formato de impressão do DACTE	Obrigatório, uma vez	—
tpServ	Tipo do Serviço	Obrigatório, uma vez	—
UFEnv	Sigla da UF de envio da GTV-e (de onde o documento foi transmitido)	Obrigatório, uma vez	—
verProc	Versão do processo de emissão	Obrigatório, uma vez	—
xJust	Justificativa da entrada em contingência	Obrigatório, uma vez	—
xMunEnv	Nome do Município de envio da GTV-e (de onde o documento foi transmitido)	Obrigatório, uma vez	—

GTVe/infCte/infRespTec

3 campos

Campo	O que é	Ocorrência	Regras
hashCSRT	Hash do token do código de segurança do responsável técnico	Obrigatório, uma vez	868
idCSRT	Identificador do código de segurança do responsável técnico	Obrigatório, uma vez	868
xContato	Nome da pessoa a ser contatada	Obrigatório, uma vez	—

GTVe/infCte/rem

1 campo

Campo	O que é	Ocorrência	Regras
enderReme	Dados do endereço	Obrigatório, uma vez	—

GTVeProc/protCTe/infFisco

2 campos

Campo	O que é	Ocorrência	Regras
cMsg	Código do status da mensagem do fisco	Obrigatório, uma vez	—
xMsg	Mensagem do Fisco	Obrigatório, uma vez	—

GTVeProc/protCTe/infProt

7 campos

Campo	O que é	Ocorrência	Regras
chCTe	Chaves de acesso da CT-e	Obrigatório, uma vez	—
cStat	Código do status da GTV-e.	Obrigatório, uma vez	—
dhRecbto	Data e hora de processamento, no formato AAAA-MM-DDTHH:MM:SS TZD.	Obrigatório, uma vez	—
digVal	Digest Value da GTV-e processado. Utilizado para conferir a integridade da GTV-e original.	Opcional, no máximo uma vez	—
nProt	Número do Protocolo de Status da GTV-e	Opcional, no máximo uma vez	—
verAplic	Versão do Aplicativo que processou a GTV-e	Obrigatório, uma vez	—
xMotivo	Descrição literal do status da GTV-e.	Obrigatório, uma vez	—

GTVe/infCte/compl/ObsCont

2 campos

Campo	O que é	Ocorrência	Regras
xCampo	Identificação do campo	Obrigatório, uma vez	—
xTexto	Conteúdo do campo	Obrigatório, uma vez	—

GTVe/infCte/dest/enderDest

2 campos

Campo	O que é	Ocorrência	Regras
cPais	Código do país	Opcional, no máximo uma vez	—
xPais	Nome do país	Opcional, no máximo uma vez	—

GTVe/infCte/detGTV/infEspecie

4 campos

Campo	O que é	Ocorrência	Regras
tpEspecie	Tipo da Espécie	Obrigatório, uma vez	—
tpNumerario	Nacionalidade do Numerário	Obrigatório, uma vez	—
vEspecie	Valor Transportada em Espécie indicada	Obrigatório, uma vez	—
xMoedaEstr	Nome da Moeda	Opcional, no máximo uma vez	—

GTVe/infCte/detGTV/infVeiculo

2 campos

Campo	O que é	Ocorrência	Regras
placa	Placa do veículo	Obrigatório, uma vez	—
RNTRC	RNTRC do transportador	Opcional, no máximo uma vez	—

GTVe/infCte/ide/tomaTerceiro

1 campo

Campo	O que é	Ocorrência	Regras
enderToma	Dados do endereço	Obrigatório, uma vez	—

Perguntas frequentes

Quantos campos tem o XML da GTV-e?

O esquema oficial (PL_CTe_400_NT2026.004_RTC_1.00_Correcao), lido pelo Buscador NCM, declara 110 nomes de tag distintos, em 392 posições — a mesma tag aparece em mais de um lugar do arquivo, e cada posição tem ocorrência própria. Deste total, 342 posições estão no documento em si; as demais são de evento, consulta e retorno do web service.

Onde fica cada tag no XML da GTV-e?

No caminho completo a partir do elemento raiz, reconstruído caminhando pela árvore do esquema oficial — não por tabela de manual. O Buscador NCM agrupa os campos pelo grupo em que eles ficam, na ordem em que o arquivo é montado, e a ficha de cada tag mostra todas as posições dela.

O campo da GTV-e é o mesmo campo da NF-e?

Não necessariamente, e essa confusão custa caro. O mesmo nome de tag existe em vários documentos fiscais com regras e sentidos diferentes: uTrib na NF-e não é o uTrib do CT-e. Cada ficha lista o mesmo nome nos outros documentos, com a redação e o caminho de cada um — justamente para que a regra de um não seja aplicada ao outro.

Todo campo que aparece no pacote de esquemas da GTV-e é um campo da GTV-e?

Não. O pacote traz um arquivo de tipos COMPARTILHADO entre os documentos fiscais, e nele viajam grupos que pertencem a outros documentos. O critério do Buscador NCM é alcance: só entra a tag que o caminho alcança a partir do elemento raiz do documento. Tag declarada no pacote e não alcançada não é campo do leiaute dele.