tpAmb: produção e homologação na NF-e e NFC-e

tpAmb, no grupo ide, informa o ambiente de processamento da NF-e ou NFC-e: 1 significa produção e 2, homologação. É obrigatório e deve corresponder ao ambiente do Web Service que recebe o documento. Homologação é o ambiente de testes; uma autorização recebida nele não comprova autorização de uma operação em produção. MOC 7.0, B24, p.10.

Nesta página:

• Onde localizar e de onde vem o valor
• O que significa a rejeição 252
• Homologação também pode retornar protocolo de autorização
• Descrição de teste e outros indicadores

Onde localizar e de onde vem o valor

No XML de envio, procure NFe/infNFe/ide/tpAmb. No processado, o caminho completo é /nfeProc/NFe/infNFe/ide/tpAmb. Não confunda esse indicador com outra ocorrência de tpAmb em mensagens de consulta, retorno de lote, protocolo ou evento: verifique o pai da tag.

O valor deve vir da configuração de ambiente usada na geração e no envio pelo emissor. A URL do serviço e o XML precisam corresponder ao mesmo ambiente; trocar apenas um dos dois cria divergência. Quando uma integração possui configurações por empresa, UF ou modelo, confira a configuração efetiva da nota enviada, em vez de presumir que a configuração padrão do software foi aplicada.

Fragmento sintético e parcial para localizar o campo em uma emissão de teste; os demais elementos de ide foram omitidos, e este não é um XML pronto para transmissão:

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

A referência estrutural exige um valor permitido, mas validar esse fragmento não valida uma nota inteira. O documento completo ainda precisa de estrutura, assinatura, campos e regras correspondentes ao fluxo.

O que significa a rejeição 252

A regra B24-10, para os modelos 55 e 65, retorna 252 — Ambiente informado diverge do Ambiente de recebimento quando o ambiente da nota difere do Web Service. MOC 7.0, p.77.

Exemplo de diagnóstico: o XML contém 2, mas o envio utiliza o endpoint de produção. O valor 2 é permitido pelo schema; o erro é a incompatibilidade entre XML e serviço. Se a intenção confirmada era um teste, corrija o direcionamento para homologação. Se a operação pretendida é produção, revise o fluxo configurado para essa operação e gere o documento no contexto correto, depois de confirmar que é uma emissão real autorizada pelo usuário responsável. Não transforme um teste em operação real apenas para eliminar 252.

Uma sequência de conferência evita confundir configuração com retorno:

1. Identifique a nota e guarde cStat, xMotivo, modelo, UF e XML efetivamente enviado.
2. Leia ide/tpAmb nesse arquivo, e confira qual endpoint recebeu a mensagem.
3. Verifique de onde cada valor foi obtido: configuração carregada, empresa efetiva, seleção de ambiente e roteamento da integração.
4. Corrija a origem da divergência, regenere e valide o documento pelo emissor. Não edite um XML já assinado para mudar somente a tag.
5. Confira que o novo XML e o destino de envio correspondem à intenção confirmada. Leia o resultado individual; desaparecer 252 não garante autorização, pois outras validações podem apontar problemas.

Se a tela, o XML e o log de envio indicam ambientes diferentes, registre qual etapa mudou o valor. Esse conjunto permite ao suporte reproduzir a causa sem precisar testar em produção uma nota criada para homologação.

Homologação também pode retornar protocolo de autorização

No protocolo protNFe/infProt, tpAmb informa o ambiente do retorno. Compare-o com ide/tpAmb, a chave chNFe e o resultado cStat/xMotivo. Um protocolo de homologação com cStat=100 continua sendo resultado de teste. A presença de protocolo, PDF ou chave de acesso não muda seu ambiente. NT 2026.002 v1.10a, PR05 a PR12, pp.5–6.

Se você recebeu apenas um XML de envio, procure o arquivo processado e o retorno correspondente antes de concluir que houve autorização. Se recebeu arquivos de teste e de produção juntos, mantenha a identificação de ambiente em cada registro para não reconciliar protocolo ou eventos de um contexto com o outro.

Descrição de teste e outros indicadores

Em homologação, a regra I04-10 exige a descrição padronizada no primeiro item de NFC-e modelo 65 e de NF-e modelo 55 com DANFE Simplificado Tipo 2 (tpImp=6):

NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL

A descrição fica em det/prod/xProd; tpAmb continua em ide. A regra verifica somente o primeiro item naquele contexto, e não torna a frase uma descrição comercial de cadastro. A ampliação à NF-e com tpImp=6 tem cronograma de produção em 03/08/2026, mas sua condição continua sendo o documento em homologação. NT 2026.002 v1.10a, pp.3 e 11–12.

tpEmis descreve emissão normal ou outra modalidade permitida; mod indica modelo 55 ou 65; tpAmb separa produção e testes. Esses indicadores respondem perguntas diferentes: contingência não é homologação, e NFC-e não é sinônimo de teste.

Para aprofundar o diagnóstico, consulte a rejeição 373, o número do protocolo e o tipo de emissão.