Ambiente informado diverge do ambiente de recebimento

O que significa esta rejeição

A SEFAZ recebeu o lote em um webservice de produção mas o XML interno declara <tpAmb>2</tpAmb> (homologação), ou o contrário, recebeu em homologação um XML com <tpAmb>1</tpAmb> (produção). Cada webservice da SEFAZ atende exclusivamente um ambiente, e o atributo precisa bater.

Esse erro é um clássico em ambientes de teste mal isolados: o desenvolvedor aponta a URL para produção achando que está em homologação, ou vice-versa, e o XML vai com o tpAmb errado.

Causas mais comuns

• URL do webservice e <tpAmb> configurados em fontes diferentes (URL no banco, ambiente no arquivo de configuração).
• Migração de homologação para produção sem trocar o <tpAmb> no template do XML.
• Sistema que mistura tráfego de teste e produção no mesmo gateway sem normalização.
• Cópia de um XML de teste para produção sem editar o campo.
• Variável de ambiente sobrescrita por erro em deploy.

Regra de validação oficial

O webservice de autorização compara <tpAmb> com o seu próprio modo de operação. 1 significa produção, 2 significa homologação. Discrepância gera 252.

Exemplo XML, antes (errado)

<ide>
  <cUF>31</cUF>
  <cNF>00012345</cNF>
  <mod>55</mod>
  <serie>1</serie>
  <nNF>15842</nNF>
  <tpAmb>2</tpAmb>
</ide>

(enviado para a URL de produção da SEFAZ-MG)

Exemplo XML, depois (correto)

<ide>
  <cUF>31</cUF>
  <cNF>00012345</cNF>
  <mod>55</mod>
  <serie>1</serie>
  <nNF>15842</nNF>
  <tpAmb>1</tpAmb>
</ide>

(enviado para a URL de produção da SEFAZ-MG)

Passo a passo para corrigir

1. Localize a configuração da URL do webservice no ERP. Determine se aponta para produção ou homologação.
2. Confirme o conteúdo de <tpAmb> no XML antes do envio. Os dois precisam combinar.
3. Centralize a configuração em um único lugar: a URL e o tpAmb devem ser derivados de uma única variável, não duplicados.
4. Reenvie a nota com o ambiente correto. A numeração não é consumida (lote não autorizado).

Como o FazendaNota previne

O FazendaNota controla o endereço do webservice e o <tpAmb> a partir de uma única configuração de ambiente (produção ou homologação). Não há como apontar a URL de um ambiente e o tpAmb de outro: os dois andam sempre juntos, evitando o descasamento que dispara a 252.

Rejeições relacionadas

• Rejeição 217, NF-e não consta na base de dados da SEFAZ
• Rejeição 226, UF do Emitente diverge da UF autorizadora
• Rejeição 203, Emissor não habilitado para emissão da NF-e

Referência oficial

Esta rejeição está descrita no Anexo I - Leiaute e Regra de Validação do Manual de Orientação do Contribuinte (MOC) v7.0 da NF-e, publicado pelo CONFAZ. Texto integral em https://www.confaz.fazenda.gov.br/legislacao/arquivo-manuais/moc7-visao-geral.pdf