CAMPO DO XML · CT-E OS Obrigatório 5 posições

tpAmb

Tipo do Ambiente

✓ Conferido · 08 de setembro de 2026

Onde fica no arquivo

No documento

CTeOS/infCte/ide/tpAmb

Obrigatório, uma vez
cteOSProc/protCTe/infProt/tpAmb

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção 2 - Homologação
cteOSProc/CTeOS/infCte/ide/tpAmb

Obrigatório, uma vez

Na resposta do web service

retCTeOS/tpAmb

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção 2 - Homologação
retCTeOS/protCTe/infProt/tpAmb

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção 2 - Homologação

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
└ tpAmb — você está aqui

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

O que o arquivo aceita neste campo

Ocorrência: 1-1
Tamanho: —
Tipo no esquema: TAmb
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 — 12

tpAmb 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á
BP-e	Tipo do Ambiente	BPeTA/infBPe/ide/tpAmb
CT-e	Identificação do Ambiente: 1 - Produção 2 - Homologação	consSitCTe/tpAmb
DC-e	Identificação do Ambiente: 1 - Produção; 2 - Homologação;	consSitDCe/tpAmb
DeRE	Identificação do ambiente para o qual os dados estão sendo transmitidos.	DeRE/evtAntecReceb/ideEvento/tpAmb
GTV-e	Tipo do Ambiente	GTVe/infCte/ide/tpAmb
MDF-e	Identificação do Ambiente: 1 - Produção 2 - Homologação	consMDFeNaoEnc/tpAmb
NF-e	Identificação do Ambiente: 1 - Produção 2 - Homologação	NFe/infNFe/ide/tpAmb
NF3e	Identificação do Ambiente: 1 - Produção 2 - Homologação	consReciNF3e/tpAmb
NFAg	Identificação do Ambiente: 1 - Produção; 2 - Homologação;	consSitNFAg/tpAmb
NFCom	Identificação do Ambiente: 1 - Produção; 2 - Homologação;	consSitNFCom/tpAmb
NFGas	Identificação do Ambiente: 1 - Produção; 2 - Homologação;	consSitNFGas/tpAmb
NFS-e Via	Tipos de ambiente do Sistema Nacional NFS-e Via: 1 - Produção; 2 - Homologação;	evento/infEventoVia/tpAmb

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 tpCTe Tipo do CT-e OS tpEmis Forma de emissão do CT-e tpImp Formato de impressão do DACTE OS tpPagAnt Tipo Pagamento ou Pagamento Antecipado 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 tpAmb do CT-e OS?

Tipo do Ambiente No XML ele fica em CTeOS/infCte/ide/tpAmb. Obrigatório, uma vez.

tpAmb aparece em quantos lugares do CT-e OS?

Em 5 posições do esquema oficial: CTeOS/infCte/ide/tpAmb, cteOSProc/protCTe/infProt/tpAmb, cteOSProc/CTeOS/infCte/ide/tpAmb, retCTeOS/tpAmb, retCTeOS/protCTe/infProt/tpAmb. 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 tpAmb aceita no CT-e OS?

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

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

O nome se repete no leiaute de 12 outros documentos (BP-e, CT-e, DC-e, DeRE, GTV-e, MDF-e, NF-e, NF3e, NFAg, NFCom, NFGas, NFS-e Via), 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.