CAMPO DO XML · DC-E Obrigatório 13 posições 1 regra

tpAmb

Tipo do Ambiente

✓ Conferido · 28 de agosto de 2026

Onde fica no arquivo

No documento

DCe/infDCe/ide/tpAmb

Obrigatório, uma vez
dceProc/protDCe/infProt/tpAmb

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção 2 - Homologação
dceProc/DCe/infDCe/ide/tpAmb

Obrigatório, uma vez

Nos eventos

eventoDCe/infEvento/tpAmb

Obrigatório, uma vez

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

Na consulta ao web service

consSitDCe/tpAmb

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção; 2 - Homologação;
consStatServDCe/tpAmb

Obrigatório, uma vez

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

Na resposta do web service

retConsSitDCe/tpAmb

Obrigatório, uma vez

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

Obrigatório, uma vez

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

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção 2 - Homologação
retEventoDCe/infEvento/tpAmb

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção 2 - Homologação
retDCe/protDCe/infProt/tpAmb

Obrigatório, uma vez

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

No arquivo distribuído (documento + protocolo)

procEventoDCe/eventoDCe/infEvento/tpAmb

Obrigatório, uma vez

Identificação do Ambiente: 1 - Produção 2 - Homologação
procEventoDCe/retEventoDCe/infEvento/tpAmb

Obrigatório, uma vez

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

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

DCe — Declaração de Conteúdo Eletrônica
└ infDCe — Informações da DCe
└ ide — Identificação da DCe
└ tpAmb — você está aqui

Dentro do grupo ide , identificação da DCe

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.

As regras que verificam este campo — 1

O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.

598 tpAmb Transportadora, nesse caso deverá existir o campo D13

Se tag: tpAmb (id:B10) = 2: - o xNome (E04) deve ser informado com a literal “DCE EMITIDA EM AMBIENTE DE HOMOLOGACAO

Mensagem: DCe emitida em ambiente de homologação com nome do destinatário diferente de DCE EMITIDA EM AMBIENTE DE HOMOLOGACAO

O mesmo nome em outros documentos fiscais — 10

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	Tipo do Ambiente	GTVe/infCte/ide/tpAmb
DeRE	Identificação do ambiente para o qual os dados estão sendo transmitidos.	DeRE/evtAntecReceb/ideEvento/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 — 11

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

cDC Código numérico que compõe a Chave de Acesso. cDV Digito verificador da chave de acesso cUF Código da UF de emissão e autorização da DCe dhEmi Data e hora de emissão do documento fiscal mod Modelo da DCe nDC Número do documento fiscal nSiteAutoriz Identificação do número do Site do Autorizador de recepção da DCe serie Série do documento fiscal tpEmis Forma de emissão do Documento Fiscal tpEmit Tipo do Emitente da DCe verProc Versão do processo de emissão

Perguntas frequentes

O que é o campo tpAmb do DC-e?

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

tpAmb aparece em quantos lugares do DC-e?

Em 13 posições do esquema oficial: DCe/infDCe/ide/tpAmb, dceProc/protDCe/infProt/tpAmb, dceProc/DCe/infDCe/ide/tpAmb, eventoDCe/infEvento/tpAmb, consSitDCe/tpAmb, consStatServDCe/tpAmb e outras. 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 DC-e?

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.

Que rejeição tpAmb pode causar no DC-e?

1 regra do manual cita este campo, disparando o código 598. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.

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

O nome se repete no leiaute de 10 outros documentos (BP-e, CT-e, DeRE, 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 DC-e?

Do esquema XML oficial (PL_DCe_v1.00a_NT2024.001v1.00). 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.