Rejeição 252: ambiente do XML difere do serviço acessado
Revisão editorial em 15 de out. de 2026. Confira as versões e condições das regras nas fontes do artigo.
A Rejeição 252, regra B24-10, indica que o ambiente informado na NF-e ou NFC-e difere do ambiente do Web Service que recebeu a transmissão. tpAmb=1 identifica produção; tpAmb=2, homologação. A validação é obrigatória para modelos 55 e 65. A correção exige comparar o XML exato à URL efetivamente usada, não apenas conferir uma opção na tela. MOC 7.0, Anexo I, p. 77.
Onde localizar o ambiente e qual URL comparar?
No documento enviado, leia infNFe/ide/tpAmb. No registro da integração, obtenha o endpoint efetivo do serviço de autorização da tentativa. Compare se ambos se referem a produção ou a homologação para a UF e o autorizador corretos. Configuração de proxy, provider ou cliente compartilhado pode selecionar destino diferente daquele mostrado na interface.
O tpAmb do retorno ajuda a confirmar o contexto atendido, mas não substitui o XML de entrada e o endereço usado. Não misture o retorno de uma consulta com a transmissão de outra nota ou empresa. A mesma numeração pode aparecer em testes e produção sem significar o mesmo estado fiscal.
Ambiente é o mesmo que serviço de NF-e ou NFC-e?
Não. Produção/homologação é uma dimensão; modelo 55/65 é outra. As rejeições 450 e 775 verificam envio ao serviço separado de modelo errado, quando a SEFAZ mantém essa separação. A 252 pode ocorrer mesmo com o serviço do modelo correto se o ambiente estiver incompatível.
Homologação destina-se a testes e não produz uma autorização de produção. Uma resposta obtida ali não deve ser armazenada ou exibida como conclusão produtiva da nota. Tampouco se deve reaproveitar um XML de teste trocando apenas tpAmb para colocá-lo em circulação real.
Exemplos de divergência nas duas direções
Exemplo sintético: XML com tpAmb=2 chega à URL de produção. A configuração do documento indica teste, enquanto o serviço é produtivo. Antes de corrigir, confirme a intenção autorizada e o ambiente em que a emissão deveria ocorrer; não escolha automaticamente a produção porque a URL já aponta para ela.
No sentido inverso, XML com tpAmb=1 chega à homologação por uma variável de configuração herdada do desenvolvimento. A integração deve ser corrigida após confirmar empresa, recurso e autorização operacional. O retorno de teste não prova que a nota produtiva foi autorizada. Se já houve outra tentativa produtiva, seu estado deve ser consultado separadamente.
Como provar a correção?
Registre empresa, ambiente pretendido, tpAmb, UF, endpoint e retorno da mesma tentativa. Corrija a divergência comprovada de configuração ou serialização e valide o percurso em contexto de teste apropriado. Não basta uma conexão ou HTTP 200; a resposta fiscal identifica o processamento.
Preserve XMLs e históricos separados por ambiente. Se houve resultado incerto, consulte no ambiente original antes de retransmitir. Não edite uma nota autorizada nem promova automaticamente dados de homologação a produção. Confira o retorno individual do ambiente correto após qualquer ação cabível.
Os exemplos são cenários sintéticos de diagnóstico. Os valores são apresentados em texto para comparação; não constituem um XML fiscal pronto para transmitir. A conferência operacional exige o XML original e o retorno da mesma tentativa.