Campos do XML do CT-e OS: caminho, tamanho e valores

(raiz do arquivo)

4 campos

Campo	O que é	Ocorrência	Regras
CTeOS	Conhecimento de Transporte Eletrônico Outros Serviços	Obrigatório, uma vez	—
cteOSProc	CT-e OS processado	Obrigatório, uma vez	—
retCTeOS	Schema XML de validação do retorno do recibo de envio do CT-e OS (Modelo 67)	Obrigatório, uma vez	—
rodoOS	Informações do modal Rodoviário	Obrigatório, uma vez	—

CTeOS

3 campos

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

cteOSProc

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 do CT-e OS (Modelo 67)	Obrigatório, uma vez	—

rodoOS

4 campos

Campo	O que é	Ocorrência	Regras
infFretamento	Dados do fretamento (apenas para Transporte de Pessoas)	Opcional, no máximo uma vez	—
NroRegEstadual	Número do Registro Estadual	Obrigatório, uma vez	—
TAF	Termo de Autorização de Fretamento – TAF	Obrigatório, uma vez	—
veic	Dados do Veículo	Opcional, no máximo uma vez	—

CTeOS/infCte

12 campos

Campo	O que é	Ocorrência	Regras
autXML	Autorizados para download do XML do DF-e	0 a 10 vez(es)	—
compl	Dados complementares do CT-e para fins operacionais ou comerciais	Opcional, no máximo uma vez	—
emit	Identificação do Emitente do CT-e OS	Obrigatório, uma vez	—
Id	Identificador da tag a ser assinada	Obrigatório, uma vez	—
ide	Identificação do CT-e Outros Serviços	Obrigatório, uma vez	—
imp	Informações relativas aos Impostos	Obrigatório, uma vez	—
infCteComp	Detalhamento do CT-e complementado	1 a 10 vez(es)	—
infCTeNorm	Grupo de informações do CT-e OS Normal	Obrigatório, uma vez	—
infRespTec	Informações do Responsável Técnico pela emissão do DF-e	Opcional, no máximo uma vez	—
pgtoVinc	Grupo de informações da vínculação com a transação de pagamento	Opcional, no máximo uma vez	—
toma	Informações do Tomador/Usuário do Serviço	Opcional, no máximo uma vez	—
vPrest	Valores da Prestação de Serviço	Obrigatório, uma vez	—

CTeOS/infCTeSupl

1 campo

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

cteOSProc/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	—

rodoOS/infFretamento

2 campos

Campo	O que é	Ocorrência	Regras
dhViagem	Data e hora da viagem (Apenas para fretamento eventual)	Opcional, no máximo uma vez	—
tpFretamento	Tipo Fretamento	Obrigatório, uma vez	—

rodoOS/veic

4 campos

Campo	O que é	Ocorrência	Regras
placa	Placa do veículo	Obrigatório, uma vez	—
prop	Proprietário ou possuidor do Veículo. Só preenchido quando o veículo não pertencer à empresa emitente do CT-e OS	Opcional, no máximo uma vez	—
RENAVAM	RENAVAM do veículo	Opcional, no máximo uma vez	—
UF	UF em que veículo está licenciado	Opcional, no máximo uma vez	—

CTeOS/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	—

CTeOS/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 do CTe	Opcional, no máximo uma vez	—
xObs	Observações Gerais	Opcional, no máximo uma vez	—

CTeOS/infCte/emit

7 campos

Campo	O que é	Ocorrência	Regras
CRT	Código do Regime Tributário	Obrigatório, uma vez	—
enderEmit	Endereço do emitente	Obrigatório, uma vez	—
IE	Inscrição Estadual 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	—
xNome	Razão social ou Nome do emitente	Obrigatório, uma vez	—

CTeOS/infCte/ide

33 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 do CT-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 do CT-e (de onde o documento foi transmitido)	Obrigatório, uma vez	—
cMunFim	Código do Município de término da prestação	Opcional, no máximo uma vez	—
cMunIni	Código do Município de início da prestação	Opcional, no máximo uma vez	—
cUF	Código da UF do emitente do CT-e.	Obrigatório, uma vez	—
dhCont	Data e Hora da entrada em contingência	Obrigatório, uma vez	—
dhEmi	Data e hora de emissão do CT-e OS	Obrigatório, uma vez	—
gCompraGov	Grupo de Compras Governamentais	Opcional, no máximo uma vez	—
gPagAntecipado	Grupo de antecipação de pagamento	Opcional, no máximo 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	—
infPercurso	Informações do Percurso do CT-e Outros Serviços	0 a 25 vez(es)	—
mod	Modelo do documento fiscal	Obrigatório, uma vez	—
modal	Modal do CT-e OS	Obrigatório, uma vez	—
natOp	Natureza da Operação	Obrigatório, uma vez	—
nCT	Número do CT-e OS	Obrigatório, uma vez	—
procEmi	Identificador do processo de emissão do CTe OS	Obrigatório, uma vez	—
serie	Série do CT-e OS	Obrigatório, uma vez	—
tpAmb	Tipo do Ambiente	Obrigatório, uma vez	—
tpCTe	Tipo do CT-e OS	Obrigatório, uma vez	—
tpEmis	Forma de emissão do CT-e	Obrigatório, uma vez	—
tpImp	Formato de impressão do DACTE OS	Obrigatório, uma vez	—
tpPagAnt	Tipo Pagamento ou Pagamento Antecipado	Opcional, no máximo uma vez	—
tpServ	Tipo do Serviço	Obrigatório, uma vez	—
UFEnv	Sigla da UF de envio do CT-e (de onde o documento foi transmitido)	Obrigatório, uma vez	—
UFFim	UF do término da prestação	Opcional, no máximo uma vez	—
UFIni	UF do início da prestação	Opcional, no máximo 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 do CT-e (de onde o documento foi transmitido)	Obrigatório, uma vez	—
xMunFim	Nome do Município do término da prestação	Opcional, no máximo uma vez	—
xMunIni	Nome do Município do início da prestação	Opcional, no máximo uma vez	—

CTeOS/infCte/imp

7 campos

Campo	O que é	Ocorrência	Regras
IBSCBS	Grupo de informações do IBS e CBS	Opcional, no máximo uma vez	—
ICMS	Informações relativas ao ICMS	Obrigatório, uma vez	—
ICMSUFFim	Informações do ICMS de partilha com a UF de término do serviço de transporte na operação interestadual	Opcional, no máximo uma vez	—
infAdFisco	Informações adicionais de interesse do Fisco	Opcional, no máximo uma vez	—
infTribFed	Informações dos tributos federais	Opcional, no máximo uma vez	—
vTotDFe	Valor total do documento fiscal (vTPrest + total do IBS + total da CBS)	Opcional, no máximo uma vez	—
vTotTrib	Valor Total dos Tributos	Opcional, no máximo uma vez	—

CTeOS/infCte/infCteComp

1 campo

Campo	O que é	Ocorrência	Regras
chCTe	Chave do CT-e complementado	Obrigatório, uma vez	—

CTeOS/infCte/infCTeNorm

8 campos

Campo	O que é	Ocorrência	Regras
cobr	Dados da cobrança do CT-e	Opcional, no máximo uma vez	—
infCteSub	Informações do CT-e de substituição	Opcional, no máximo uma vez	—
infDocRef	Informações dos documentos referenciados	Opcional, quantas vezes precisar	—
infGTVe	Informações das GTV-e relacionadas ao CT-e OS	Opcional, quantas vezes precisar	—
infModal	Informações do modal Obrigatório para Pessoas e Bagagem	Opcional, no máximo uma vez	—
infServico	Informações da Prestação do Serviço	Obrigatório, uma vez	—
refCTeCanc	Chave de acesso do CT-e Cancelado Somente para Transporte de Valores	Opcional, no máximo uma vez	—
seg	Informações de Seguro da Carga	Opcional, quantas vezes precisar	—

CTeOS/infCte/infRespTec

5 campos

Campo	O que é	Ocorrência	Regras
email	Email da pessoa jurídica a ser contatada	Obrigatório, uma vez	—
fone	Telefone da pessoa jurídica a ser contatada	Obrigatório, uma vez	—
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	—

CTeOS/infCte/pgtoVinc

1 campo

Campo	O que é	Ocorrência	Regras
pgto	Dados de cada pagamento previsto	1 a 99 vez(es)	—

CTeOS/infCte/toma

1 campo

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

CTeOS/infCte/vPrest

3 campos

Campo	O que é	Ocorrência	Regras
Comp	Componentes do Valor da Prestação	Opcional, quantas vezes precisar	—
vRec	Valor a Receber	Obrigatório, uma vez	—
vTPrest	Valor Total da Prestação do Serviço	Obrigatório, uma vez	—

cteOSProc/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	—

cteOSProc/protCTe/infProt

6 campos

Campo	O que é	Ocorrência	Regras
cStat	Código do status do CT-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 CT-e processado. Utilizado para conferir a integridade do CT-e original.	Opcional, no máximo uma vez	—
nProt	Número do Protocolo de Status do CT-e.	Opcional, no máximo uma vez	—
verAplic	Versão do Aplicativo que processou o CT-e	Obrigatório, uma vez	—
xMotivo	Descrição literal do status do CT-e.	Obrigatório, uma vez	—

rodoOS/veic/prop

1 campo

Campo	O que é	Ocorrência	Regras
tpProp	Tipo Proprietário ou possuidor	Obrigatório, uma vez	—

CTeOS/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	—

CTeOS/infCte/emit/enderEmit

7 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	—
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	—

CTeOS/infCte/ide/gCompraGov

4 campos

Campo	O que é	Ocorrência	Regras
pRedutor	Percentual de redução de aliquota em compra governamental	Obrigatório, uma vez	—
refDFeAnt	Chave de acesso do documento fiscal anterior. Deverá ser informado para tpOperGov 2 e 3 e vedado para os tipos 1 e 4. No caso do tpOperGov 2 aceitará…	0 a 99 vez(es)	—
tpEnteGov	Para administração pública direta e suas autarquias e fundações: 1=União 2=Estados 3=Distrito Federal 4=Municípios 5=Consórcio Público 6=Comitê…	Obrigatório, uma vez	—
tpOperGov	Tipo da operação com ente governamental: 1 – Fornecimento com pagamento posterior; 2 - Recebimento do pagamento com fornecimento já realizado; 3 –…	Obrigatório, uma vez	—

CTeOS/infCte/ide/gPagAntecipado

1 campo

Campo	O que é	Ocorrência	Regras
chDFePagAnt	Chave de acesso do CTe de antecipação de pagamento	Obrigatório, uma vez	—

CTeOS/infCte/ide/infPercurso

1 campo

Campo	O que é	Ocorrência	Regras
UFPer	Sigla das Unidades da Federação do percurso do veículo.	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS

5 campos

Campo	O que é	Ocorrência	Regras
cClassTrib	Código de Classificação Tributária do IBS e da CBS	Obrigatório, uma vez	—
CST	Código Situação Tributária do IBS/CBS	Obrigatório, uma vez	—
gEstornoCred	Informado conforme indicador no cClassTrib	Opcional, no máximo uma vez	—
gIBSCBS	Tipo CBS IBS Completo	Opcional, no máximo uma vez	—
indDoacao	Tipo Indicador de Doação	Opcional, no máximo uma vez	—

CTeOS/infCte/imp/ICMS

6 campos

Campo	O que é	Ocorrência	Regras
ICMS00	Prestação sujeito à tributação normal do ICMS	Obrigatório, uma vez	—
ICMS20	Prestação sujeito à tributação com redução de BC do ICMS	Obrigatório, uma vez	—
ICMS45	ICMS Isento, não Tributado ou diferido	Obrigatório, uma vez	—
ICMS90	ICMS Outros	Obrigatório, uma vez	—
ICMSOutraUF	ICMS devido à UF de origem da prestação, quando diferente da UF do emitente	Obrigatório, uma vez	—
ICMSSN	Simples Nacional	Obrigatório, uma vez	—

CTeOS/infCte/imp/ICMSUFFim

7 campos

Campo	O que é	Ocorrência	Regras
pFCPUFFim	Percentual do ICMS relativo ao Fundo de Combate à pobreza (FCP) na UF de término da prestação do serviço de transporte	Obrigatório, uma vez	—
pICMSInter	Alíquota interestadual das UF envolvidas	Obrigatório, uma vez	—
pICMSUFFim	Alíquota interna da UF de término da prestação do serviço de transporte	Obrigatório, uma vez	—
vBCUFFim	Valor da BC do ICMS na UF de término da prestação do serviço de transporte	Obrigatório, uma vez	—
vFCPUFFim	Valor do ICMS relativo ao Fundo de Combate á Pobreza (FCP) da UF de término da prestação	Obrigatório, uma vez	—
vICMSUFFim	Valor do ICMS de partilha para a UF de término da prestação do serviço de transporte	Obrigatório, uma vez	—
vICMSUFIni	Valor do ICMS de partilha para a UF de início da prestação do serviço de transporte	Obrigatório, uma vez	—

CTeOS/infCte/imp/infTribFed

5 campos

Campo	O que é	Ocorrência	Regras
vCOFINS	Valor COFINS	Opcional, no máximo uma vez	—
vCSLL	Valor do CSLL	Opcional, no máximo uma vez	—
vINSS	Valor do INSS	Opcional, no máximo uma vez	—
vIR	Valor de Imposto de Renda	Opcional, no máximo uma vez	—
vPIS	Valor do PIS	Opcional, no máximo uma vez	—

CTeOS/infCte/infCTeNorm/cobr

2 campos

Campo	O que é	Ocorrência	Regras
dup	Dados das duplicatas	Opcional, quantas vezes precisar	—
fat	Dados da fatura	Opcional, no máximo uma vez	—

CTeOS/infCte/infCTeNorm/infDocRef

5 campos

Campo	O que é	Ocorrência	Regras
chBPe	Chave de acesso do BP-e que possui eventos excesso de bagagem	Obrigatório, uma vez	—
dEmi	Data de Emissão	Obrigatório, uma vez	—
nDoc	Número	Obrigatório, uma vez	—
subserie	Subsérie	Opcional, no máximo uma vez	—
vDoc	Valor Transportado	Opcional, no máximo uma vez	—

CTeOS/infCte/infCTeNorm/infModal

1 campo

Campo	O que é	Ocorrência	Regras
versaoModal	Versão do leiaute específico para o Modal	Obrigatório, uma vez	—

CTeOS/infCte/infCTeNorm/infServico

2 campos

Campo	O que é	Ocorrência	Regras
infQ	Informações de quantidades da Carga do CT-e	Opcional, no máximo uma vez	—
xDescServ	Descrição do Serviço prestado	Obrigatório, uma vez	—

CTeOS/infCte/infCTeNorm/seg

3 campos

Campo	O que é	Ocorrência	Regras
nApol	Número da Apólice	Opcional, no máximo uma vez	—
respSeg	Responsável pelo seguro	Obrigatório, uma vez	—
xSeg	Nome da Seguradora	Opcional, no máximo uma vez	—

CTeOS/infCte/pgtoVinc/pgto

5 campos

Campo	O que é	Ocorrência	Regras
CNPJBasePSP	CNPJ base da instituição financeira ou de pagamento	Obrigatório, uma vez	—
CNPJReceb	CNPJ do recebedor do pagamento	Obrigatório, uma vez	—
idTransacao	ID específico da transação financeira conforme o meio de pagamento	Obrigatório, uma vez	—
nPag	Número sequencial do pagamento	Obrigatório, uma vez	—
tpMeioPgto	Código do meio de pagamento (ver IT DFe 2026.001)	Obrigatório, uma vez	—

CTeOS/infCte/toma/enderToma

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	—

CTeOS/infCte/vPrest/Comp

1 campo

Campo	O que é	Ocorrência	Regras
vComp	Valor do componente	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gEstornoCred

2 campos

Campo	O que é	Ocorrência	Regras
vCBSEstCred	Valor da CBS a ser estornada	Obrigatório, uma vez	—
vIBSEstCred	Valor do IBS a ser estornado	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS

7 campos

Campo	O que é	Ocorrência	Regras
gCBS	Grupo de Tributação da CBS	Obrigatório, uma vez	—
gIBSMun	Grupo de Informações do IBS no Município	Obrigatório, uma vez	—
gIBSUF	Grupo de informações do IBS na UF	Obrigatório, uma vez	—
gTribCompraGov	Grupo de informações da composição do valor do IBS e da CBS em compras governamental	Opcional, no máximo uma vez	—
gTribRegular	Grupo de informações da Tributação Regular. Informar como seria a tributação caso não cumprida a condição resolutória/suspensiva. Exemplo 1: Art.…	Opcional, no máximo uma vez	—
vBC	Valor do BC	Obrigatório, uma vez	—
vIBS	Valor do IBS	Obrigatório, uma vez	—

CTeOS/infCte/imp/ICMS/ICMS00

2 campos

Campo	O que é	Ocorrência	Regras
pICMS	Alíquota do ICMS	Obrigatório, uma vez	—
vICMS	Valor do ICMS	Obrigatório, uma vez	—

CTeOS/infCte/imp/ICMS/ICMS20

3 campos

Campo	O que é	Ocorrência	Regras
cBenef	Código de Benefício Fiscal na UF	Obrigatório, uma vez	—
pRedBC	Percentual de redução da BC	Obrigatório, uma vez	—
vICMSDeson	Valor do ICMS de desoneração	Obrigatório, uma vez	—

CTeOS/infCte/imp/ICMS/ICMS90

1 campo

Campo	O que é	Ocorrência	Regras
vCred	Valor do Crédito Outorgado/Presumido	Opcional, no máximo uma vez	—

CTeOS/infCte/imp/ICMS/ICMSOutraUF

4 campos

Campo	O que é	Ocorrência	Regras
pICMSOutraUF	Alíquota do ICMS	Obrigatório, uma vez	—
pRedBCOutraUF	Percentual de redução da BC	Opcional, no máximo uma vez	—
vBCOutraUF	Valor da BC do ICMS	Obrigatório, uma vez	—
vICMSOutraUF	Valor do ICMS devido outra UF	Obrigatório, uma vez	—

CTeOS/infCte/imp/ICMS/ICMSSN

1 campo

Campo	O que é	Ocorrência	Regras
indSN	Indica se o contribuinte é Simples Nacional 1=Sim	Obrigatório, uma vez	—

CTeOS/infCte/infCTeNorm/cobr/dup

3 campos

Campo	O que é	Ocorrência	Regras
dVenc	Data de vencimento da duplicata (AAAA-MM-DD)	Opcional, no máximo uma vez	—
nDup	Número da duplicata	Opcional, no máximo uma vez	—
vDup	Valor da duplicata	Opcional, no máximo uma vez	—

CTeOS/infCte/infCTeNorm/cobr/fat

4 campos

Campo	O que é	Ocorrência	Regras
nFat	Número da fatura	Opcional, no máximo uma vez	—
vDesc	Valor do desconto da fatura	Opcional, no máximo uma vez	—
vLiq	Valor líquido da fatura	Opcional, no máximo uma vez	—
vOrig	Valor original da fatura	Opcional, no máximo uma vez	—

CTeOS/infCte/infCTeNorm/infGTVe/Comp

2 campos

Campo	O que é	Ocorrência	Regras
tpComp	Tipo do Componente	Obrigatório, uma vez	—
xComp	Nome do componente (informar apenas para outros)	Opcional, no máximo uma vez	—

CTeOS/infCte/infCTeNorm/infServico/infQ

1 campo

Campo	O que é	Ocorrência	Regras
qCarga	Quantidade	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gCBS

6 campos

Campo	O que é	Ocorrência	Regras
gALCZFMCBS	Grupo de operações em áreas incentivadas (ALC/ZFM) - CBS (alíquota zero)	Opcional, no máximo uma vez	—
gDevTrib	Grupo de Informações da devolução de tributos	Opcional, no máximo uma vez	—
gDif	Grupo de campos do Diferimento	Opcional, no máximo uma vez	—
gRed	Grupo de campos da redução de aliquota	Opcional, no máximo uma vez	—
pCBS	Aliquota da CBS (em percentual)	Obrigatório, uma vez	—
vCBS	Valor da CBS	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gIBSMun

2 campos

Campo	O que é	Ocorrência	Regras
pIBSMun	Aliquota do IBS Municipal (em percentual)	Obrigatório, uma vez	—
vIBSMun	Valor do IBS Municipal	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gIBSUF

2 campos

Campo	O que é	Ocorrência	Regras
pIBSUF	Aliquota do IBS de competência das UF (em percentual)	Obrigatório, uma vez	—
vIBSUF	Valor do IBS de competência das UF	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gTribCompraGov

6 campos

Campo	O que é	Ocorrência	Regras
pAliqCBS	Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais	Obrigatório, uma vez	—
pAliqIBSMun	Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais	Obrigatório, uma vez	—
pAliqIBSUF	Tipo Decimal com até 3 dígitos inteiros, podendo ter de 2 até 4 decimais	Obrigatório, uma vez	—
vTribCBS	Valor que seria devido a CBS, sem aplicação do Art. 473. da LC 214/2025	Obrigatório, uma vez	—
vTribIBSMun	Valor que seria devido ao município, sem aplicação do Art. 473. da LC 214/2025	Obrigatório, uma vez	—
vTribIBSUF	Valor que seria devido a UF, sem aplicação do Art. 473. da LC 214/2025	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gTribRegular

8 campos

Campo	O que é	Ocorrência	Regras
cClassTribReg	Informar qual seria o cClassTrib caso não cumprida a condição resolutória/suspensiva	Obrigatório, uma vez	—
CSTReg	Código da Situação Tributária do IBS e CBS	Obrigatório, uma vez	—
pAliqEfetRegCBS	Alíquota da CBS	Obrigatório, uma vez	—
pAliqEfetRegIBSMun	Alíquota do IBS do Município	Obrigatório, uma vez	—
pAliqEfetRegIBSUF	Alíquota do IBS da UF	Obrigatório, uma vez	—
vTribRegCBS	Valor da CBS	Obrigatório, uma vez	—
vTribRegIBSMun	Valor do IBS do Município	Obrigatório, uma vez	—
vTribRegIBSUF	Valor do IBS da UF	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gCBS/gDevTrib

2 campos

Campo	O que é	Ocorrência	Regras
pDevTrib	Percentual de devolução do tributo, conforme LC 214/25 art. 118.	Opcional, no máximo uma vez	—
vDevTrib	Valor do tributo devolvido ("cashback" de desconto na própria Nota Fiscal / Fatura)	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gCBS/gDif

2 campos

Campo	O que é	Ocorrência	Regras
pDif	Percentual do diferimento	Obrigatório, uma vez	—
vDif	Valor do diferimento	Obrigatório, uma vez	—

CTeOS/infCte/imp/IBSCBS/gIBSCBS/gCBS/gRed

2 campos

Campo	O que é	Ocorrência	Regras
pAliqEfet	Aliquota Efetiva que será aplicada a Base de Calculo (em percentual)	Obrigatório, uma vez	—
pRedAliq	Percentual de redução de aliquota do cClassTrib	Obrigatório, uma vez	—

Perguntas frequentes

Quantos campos tem o XML do CT-e OS?

O esquema oficial (PL_CTe_400_NT2026.002_RTC_1.01_corr_2), lido pelo Buscador NCM, declara 238 nomes de tag distintos, em 617 posições — a mesma tag aparece em mais de um lugar do arquivo, e cada posição tem ocorrência própria. Deste total, 595 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 do CT-e OS?

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 do CT-e OS é 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 do CT-e OS é um campo do CT-e OS?

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.