CAMPO DO XML · CT-E OS Opcional 2 posições

tpPagAnt

Tipo Pagamento ou Pagamento Antecipado

✓ Conferido · 08 de setembro de 2026

Onde fica no arquivo

No documento

CTeOS/infCte/ide/tpPagAnt

Opcional, no máximo uma vez
cteOSProc/CTeOS/infCte/ide/tpPagAnt

Opcional, no máximo uma vez

O caminho até aqui, nível a nível

CTeOS — Conhecimento de Transporte Eletrônico Outros Serviços
└ infCte — Informações do CT-e Outros Serviços
└ ide — Identificação do CT-e Outros Serviços
└ tpPagAnt — você está aqui

Dentro do grupo ide , identificação do CT-e Outros Serviços

O que o arquivo aceita neste campo

Ocorrência: 0-1
Tamanho: 1
Tipo no esquema: TPagAnt
Formato base: string

Valores aceitos — 2

Lista fechada do esquema oficial: qualquer outro valor é recusado na validação do arquivo.

O mesmo nome em outros documentos fiscais — 5

tpPagAnt aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento	O que o leiaute dele diz	Caminho lá
CT-e	Tipo Pagamento ou Pagamento Antecipado	CTeSimp/infCte/ide/tpPagAnt
NF3e	Tipo Pagamento ou Pagamento Antecipado	NF3e/infNF3e/ide/tpPagAnt
NFAg	Tipo Pagamento ou Pagamento Antecipado	NFAg/infNFAg/ide/tpPagAnt
NFCom	Tipo Pagamento ou Pagamento Antecipado	NFCom/infNFCom/ide/tpPagAnt
NFGas	Tipo Pagamento ou Pagamento Antecipado	NFGas/infNFGas/ide/tpPagAnt

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 32

São os campos que ficam ao lado deste no arquivo, dentro de CTeOS/infCte/ide. Quem preenche um costuma precisar dos outros na mesma passada.

cCT Código numérico que compõe a Chave de Acesso. cDV Digito Verificador da chave de acesso do CT-e CFOP Código Fiscal de Operações e Prestações cMunEnv Código do Município de envio do CT-e (de onde o documento foi transmitido) cMunFim Código do Município de término da prestação cMunIni Código do Município de início da prestação cUF Código da UF do emitente do CT-e. dhCont Data e Hora da entrada em contingência dhEmi Data e hora de emissão do CT-e OS gCompraGov Grupo de Compras Governamentais gPagAntecipado Grupo de antecipação de pagamento indIEToma Indicador da IE do tomador: 1 – Contribuinte ICMS; 2 – Contribuinte isento de inscrição;… infPercurso Informações do Percurso do CT-e Outros Serviços mod Modelo do documento fiscal modal Modal do CT-e OS natOp Natureza da Operação nCT Número do CT-e OS procEmi Identificador do processo de emissão do CTe OS serie Série do CT-e OS tpAmb Tipo do Ambiente tpCTe Tipo do CT-e OS tpEmis Forma de emissão do CT-e tpImp Formato de impressão do DACTE OS tpServ Tipo do Serviço UFEnv Sigla da UF de envio do CT-e (de onde o documento foi transmitido) UFFim UF do término da prestação UFIni UF do início da prestação verProc Versão do processo de emissão xJust Justificativa da entrada em contingência xMunEnv Nome do Município de envio do CT-e (de onde o documento foi transmitido) xMunFim Nome do Município do término da prestação xMunIni Nome do Município do início da prestação

Perguntas frequentes

O que é o campo tpPagAnt do CT-e OS?

Tipo Pagamento ou Pagamento Antecipado No XML ele fica em CTeOS/infCte/ide/tpPagAnt. Opcional, no máximo uma vez, com tamanho 1.

tpPagAnt aparece em quantos lugares do CT-e OS?

Em 2 posições do esquema oficial: CTeOS/infCte/ide/tpPagAnt, cteOSProc/CTeOS/infCte/ide/tpPagAnt. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.

Quais valores tpPagAnt aceita no CT-e OS?

O esquema oficial restringe a 2 valores: 1, 3. Qualquer outro valor é recusado já na validação do arquivo, antes de qualquer regra de negócio.

tpPagAnt no CT-e OS é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 5 outros documentos (CT-e, NF3e, NFAg, NFCom, NFGas), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição do CT-e OS?

Do esquema XML oficial (PL_CTe_400_NT2026.002_RTC_1.01_corr_2). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.