tpAmb em infProt: produção e homologação na resposta da SEFAZ

tpAmb, em /nfeProc/protNFe/infProt/tpAmb, identifica o ambiente ao qual pertence a resposta individual da SEFAZ. O valor 1 significa produção; o valor 2 significa homologação. O campo é obrigatório e o tipo TAmb admite somente esses dois valores.

Por que conferir o ambiente da resposta

O ambiente da nota está em NFe/infNFe/ide/tpAmb; aqui está o ambiente informado no protocolo. A integração deve correlacionar nota, requisição, serviço chamado e retorno no mesmo ambiente, além de comparar chNFe. Um arquivo de homologação não comprova autorização em produção.

O ambiente não é uma preferência de apresentação e não depende do nome da pasta. Um número de protocolo, uma chave de 44 caracteres ou uma mensagem de autorização sem contexto de ambiente pode levar a uma associação indevida. Preserve esse dado no armazenamento e em consultas.

Fragmento e cenários sintéticos

Exemplo parcial de domínio, sem nota ou protocolo operacional:

<tpAmb xmlns="http://www.portalfiscal.inf.br/nfe">2</tpAmb>

Esse trecho representa homologação. Não deve ser alterado para 1 para transformar um teste em produção: qualquer autorização efetiva precisa ser obtida no ambiente correspondente com seus documentos reais.

Cenário A: a aplicação consulta produção, mas armazenou a resposta de homologação. Confira endpoint, configuração, requisição e arquivo original. Corrija a associação ou a configuração de leitura comprovadamente errada. Cenário B: uma cópia exibe 1 e o original tem 2. Investigue o mapper ou a reconstrução do arquivo; não trate a cópia editada como evidência fiscal.

Como investigar sem reenviar por tentativa

Registre tpAmb da nota, tpAmb do infProt e o ambiente do serviço utilizado. Compare a chave integral e a empresa/emitente correspondente. Se os dados divergem, separe os registros e recupere a resposta correta antes de concluir que houve rejeição ou ausência de autorização.

A regra de autorização252/B24-10 verifica ambiente da NF-e versus ambiente de recebimento do Web Service. Ela não é uma validação que manda editar tpAmb de infProt. Uma inconsistência local entre retorno e nota pode estar na integração, e precisa ser diagnosticada em sua origem.

O que o ambiente não informa

tpAmb=1 não significa autorização, e tpAmb=2 não significa erro. O resultado individual vem de cStat/xMotivo. Para situação atual, consulte a chave e seus eventos no ambiente correspondente. A assinatura, se presente no protocolo, deve ser preservada; editar o ambiente muda o conteúdo que ela protege.

Leituras relacionadas

• chNFe — /nfeProc/protNFe/infProt/chNFe
• infProt — /nfeProc/protNFe/infProt

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: TProtNFe, linhas 6686–6770.
• Tipos básicos NF-e/NFC-e — PL_010f_v1.04: TChNFe, TProt, TStat, TAmb, TVerAplic, TMotivo e TDateTimeUTC.
• NT 2025.002 RTC — 1.52: seção 5.1, p. 11; PR03–PR90, p. 13.
• MOC 7.0 Anexo I — 7.00: A03-10 p. 74; B02-10, B02-20, B03-10 e B06-10 p. 75.