CAMPO DO XML · NF-E Obrigatório 4 regras

tpAmb

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

✓ Conferido · 02 de outubro de 2026

Onde fica no arquivo

No documento

NFe/infNFe/ide/tpAmb

Obrigatório, uma vez

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

NFe — Nota Fiscal Eletrônica
└ infNFe — Informações da Nota Fiscal eletrônica
└ ide — identificação da NF-e
└ tpAmb — você está aqui

Dentro do grupo ide , identificação da NF-e

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

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.

373 tpAmb

Se documento for NFC-e (mod=65) ou NF-e com DANFE Simplificado Tipo 2 (tag:tpImp=6): - Se ambiente de homologação (tag:tpAmb=2, id:B24): - Descrição do primeiro item da Nota Fiscal (tag:xProd) deve ser informada como “NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL" (NT 2015.002)

Mensagem: Descrição do primeiro item diferente de NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL

397 tpAmb

Se QR Code versão “100" e Parâmetro Tipo de Ambiente doQR-Code diverge do Tipo de Ambiente da Nota Fiscal (tag:tpAmb, id:B24) (NT 2017.002 / NT 2015.002)

Mensagem: Parâmetro do QR-Code divergente da Nota Fiscal:

397 tpAmb

Se qrCode informado: Se QR Code versão “2 ou 3" e Parâmetro Tipo de Ambiente do QR-Code diverge do Tipo de Ambiente da Nota Fiscal (tag:tpAmb, id:B24) Observação: Para NFC-e/NF-e ONLINE ou OFFLINE é o 3º parâmetro da URL do QR Code. Obs 1: Para NF-e, modelo 55, somente é aceito contingência offline (tpEmis=9) para o DANFE Simplificado Tipo 2 (tag:tpImp=6)

Mensagem: Parâmetro do QR-Code divergente da Nota Fiscal:

598 tpAmb

Se tag:tpAmb (id:B24) = 2: - xNome (E04) deve ser informado com a literal “NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL"(NT 2011/002) Exceção: Não se aplica para tpEmis = 3-NFF (NT 2021.002)

Mensagem: NF-e emitida em ambiente de homologação com Razão Social do destinatário diferente de NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL

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
CT-e OS	Tipo do Ambiente	CTeOS/infCte/ide/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
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 — 30

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

cDV Digito Verificador da Chave de Acesso da NF-e cIndOp Código indicador do local da operação de fornecimento cMunFG Código do Município de Ocorrência do Fato Gerador (utilizar a tabela do IBGE) cMunFGIBS Informar o município de ocorrência do fato gerador do fato gerador do IBS / CBS. Campo… cNF Código numérico que compõe a Chave de Acesso. Número aleatório gerado pelo emitente para… cUF Código da UF do emitente do Documento Fiscal. Utilizar a Tabela do IBGE. dhCont Informar a data e hora de entrada em contingência contingência no formato… dhEmi Data e Hora de emissão do Documento Fiscal (AAAA-MM-DDThh:mm:ssTZD) ex.:… dhSaiEnt Data e Hora da saída ou de entrada da mercadoria / produto (AAAA-MM-DDTHH:mm:ssTZD) dPrevEntrega Data da previsão de entrega ou disponibilização do bem (AAAA-MM-DD) finNFe Finalidade da emissão da NF-e: 1 - NFe normal 2 - NFe complementar 3 - NFe de ajuste 4 -… gCompraGov Grupo de Compras Governamentais gPagAntecipado Informado para abater as parcelas de antecipação de pagamento, conforme Art. 10. § 4º idDest Identificador de Local de destino da operação (1-Interna;2-Interestadual;3-Exterior) indFinal Indica operação com consumidor final (0-Não;1-Consumidor Final) indIntermed Indicador de intermediador/marketplace 0=Operação sem intermediador (em site ou… indPres Indicador de presença do comprador no estabelecimento comercial no momento da oepração: 0… mod Código do modelo do Documento Fiscal. 55 = NF-e; 65 = NFC-e. natOp Descrição da Natureza da Operação NFref Grupo de infromações da NF referenciada nNF Número do Documento Fiscal procEmi Processo de emissão utilizado com a seguinte codificação: 0 - emissão de NF-e com… serie Série do Documento Fiscal tpEmis Forma de emissão da NF-e: 1 - Normal; 2 - Contingência FS; 3 - Regime Especial NFF (NT… tpImp Formato de impressão do DANFE: 0 - Sem DANFE; 1 - DANFE Retrato; 2 - DANFE Paisagem; 3 -… tpNF Tipo do Documento Fiscal (0 - entrada; 1 - saída) tpNFCredito Tipo de Nota de Crédito tpNFDebito Tipo de Nota de Débito verProc versão do aplicativo utilizado no processo de emissão xJust Informar a Justificativa da entrada

Perguntas frequentes

O que é o campo tpAmb do NF-e?

Identificação do Ambiente: 1 - Produção 2 - Homologação No XML ele fica em NFe/infNFe/ide/tpAmb. Obrigatório, uma vez.

Quais valores tpAmb aceita no NF-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 NF-e?

4 regras do manual citam este campo, disparando os códigos 373, 397, 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 NF-e é o mesmo campo dos outros documentos fiscais?

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

Do esquema XML oficial (PL_010f_v1.04). 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.