Rejeição 252: ambiente informado diferente do ambiente de recebimento

A rejeição 252 ocorre quando o ambiente informado na mensagem não corresponde ao ambiente do Web Service que a recebeu. O valor de tpAmb é 1 para produção e 2 para homologação. Para corrigir, identifique se a operação é real ou de teste e alinhe o conteúdo da solicitação ao destino correto. Não envie dados de teste para produção apenas para eliminar a mensagem.

O problema pode surgir na autorização, na consulta de um recibo, em eventos ou em outros serviços. Uma nota enviada corretamente não garante que as configurações usadas nas etapas seguintes também estejam certas.

Produção e homologação precisam permanecer separadas

Homologação é o ambiente destinado aos testes. Produção é o ambiente utilizado nas operações fiscais efetivas. Marcar tpAmb=1 não prova que um documento foi autorizado: o resultado depende do processamento e da resposta recebida.

Na autorização de NF-e e NFC-e, modelos 55 e 65, a regra B24-10 do MOC 7.0, Anexo I, verifica NFe/infNFe/ide/tpAmb contra o ambiente do Web Service. A validação é indicada como obrigatória.

Um exemplo simples: a configuração aponta para produção, mas o XML conserva tpAmb=2 de um teste anterior. Antes de mudar qualquer coisa, confirme a finalidade daquela emissão. Se ainda é um teste, o destino é que deve ser corrigido para homologação. Se é uma operação real, o emissor precisa gerar corretamente o documento destinado à produção.

Confira a chamada efetiva, não só o seletor na tela

Separe o XML transmitido, cStat, xMotivo, data e horário. Peça o endereço completo do serviço acionado e a identificação do estabelecimento. Registre também modelo, versão e tipo de operação executada.

Não deduza o ambiente apenas por encontrar uma palavra como “hom” no endereço. Confira a classificação na relação oficial do serviço. Bibliotecas, intermediadores e configurações por filial podem resolver o destino de forma diferente da exibida na tela principal.

A TecnoSpeed e a InvoiSys destacam a comparação entre tpAmb e servidor receptor. A aplicação prática exige olhar o XML da mesma tentativa: um documento gerado antes da alteração pode manter o valor antigo mesmo depois de o usuário trocar o ambiente do sistema.

A mensagem que falhou pode ser uma consulta

No retorno de autorização, o tpAmb pertence à consulta do recibo, em consReciNFe/tpAmb. O MOC, Visão Geral, página 77, associa E01 ao 252. Se o lote foi enviado em produção e sua consulta foi montada ou direcionada para homologação, corrija a consulta no contexto do envio original.

Não conclua que o lote foi rejeitado na autorização só porque sua consulta falhou. Preserve o recibo recebido e apure o resultado no ambiente correto antes de retransmitir a nota. A UF do recibo e o tipo de autorizador têm validações próprias, diferentes da conferência de ambiente.

O MOC também documenta 252 na consulta de protocolo, J01, e na consulta de status, K01. Nessas operações, procure tpAmb na mensagem de consulta. Alterar o XML fiscal arquivado não é uma solução para um parâmetro incorreto da requisição.

Eventos e inutilização têm configuração própria

Em um lote de eventos, confira envEvento/evento/infEvento/tpAmb. A regra P09-10 compara esse ambiente com o do serviço receptor. Cancelamento, manifestação e outros eventos devem seguir o leiaute e o encaminhamento específicos; não basta copiar uma configuração genérica de autorização.

Imagine uma empresa fictícia que autorizou uma NF-e em produção, mas manteve o módulo de eventos no ambiente de testes. Se a mensagem e o destino do evento divergirem, poderá ocorrer 252. Se ambos forem de homologação, a ausência do documento naquele ambiente poderá produzir outro retorno. Portanto, nem toda tentativa sobre uma nota de produção feita em homologação necessariamente retorna 252.

Na inutilização, a conferência I01 recai sobre inutNFe/infInut/tpAmb. A resposta 252 não confirma a inutilização da faixa solicitada. Corrija o pedido e acompanhe seu resultado, preservando a numeração e o estabelecimento verdadeiros.

A TOTVS documenta um caso com parâmetros separados de autorização e eventos. Seus procedimentos de reconfiguração e reinício são específicos daquele produto; não se deve alternar ambientes ou reiniciar serviços de qualquer emissor sem um diagnóstico.

Outros usos do mesmo código

A NT 2014.002 v1.40, página 11, apresenta H01/252 na distribuição DF-e. Nesse serviço, o ambiente é informado na solicitação distDFeInt. Não é necessário editar a nota de um fornecedor para corrigir a configuração de uma busca de documentos.

No caso de documento emitido com Provedor de Assinatura e Autorização, PAA, há uma verificação adicional de destino. A NT 2026.001 v1.02b, página 16, exige a SVRS na regra P09-10. Não basta conferir 1 ou 2: verifique também esse encaminhamento específico. A coluna 55/65 da regra não libera NFC-e pelo PAA; o mesmo documento traz vedação própria ao modelo 65 nessa série. Confirme a implantação aplicável, sem transportar a exigência para toda emissão comum.

A NT NFC-e 2014.001, páginas 7 e 8, também registra 252 no gerenciamento de CSC da NFC-e, pela regra A04. Há ainda eventos com condições próprias. Essas ocorrências não autorizam emitir, revogar ou substituir códigos de segurança para resolver qualquer falha de ambiente. Primeiro identifique o serviço e a versão. Não compartilhe CSC, certificado, chave privada ou senha em chamados públicos.

O que não deve ser confundido com tpAmb

O campo tpEmis informa a modalidade de emissão, não produção ou homologação. Acionar contingência não corrige automaticamente um tpAmb incompatível. UF e ambiente também são dimensões separadas: um destino pode atender o estado correto e ainda pertencer ao ambiente errado.

Não mude valores, série ou data para fazer a nota “parecer” de teste ou de produção. Essas características não substituem a identificação expressa do ambiente. A própria chave de acesso não contém um campo tpAmb; conserve o ambiente junto dos registros e protocolos do sistema.

Verifique o resultado e previna a repetição

Corrija a origem do parâmetro ou a rota incorreta. Quando houver mudança em conteúdo assinado, regenere e assine pelo fluxo do emissor. Antes de nova transmissão, esclareça tentativas anteriores sem resposta. Depois, leia o retorno individual pertinente: autorização da nota, registro do evento ou conclusão do pedido são resultados diferentes.

Na implantação de uma filial ou atualização da integração, confira conjuntamente envio, retorno, consultas e eventos. Manter filas e configurações separadas por ambiente reduz o risco de um teste reaproveitar dados de produção ou de uma operação real continuar apontando para homologação.

Referência de atualização: 09/10/2026. Diagnóstico condicionado ao serviço, modelo, versão, UF e ambiente.