Ambiente: Produção e Homologação

Escolher qual ambiente você está vendo, reconhecer quando está em Homologação e entender o que o seletor muda e o que ele não muda.

O seletor de ambiente

No topo de todas as telas há o seletor de ambiente, com as opções Produção e Homologação. O ambiente ativo aparece escrito, não só colorido. Qualquer pessoa da organização pode trocar, sem permissão especial, porque o seletor só muda o que você vê.

O ambiente escolhido vale para o dashboard, para as listas de emissão (NF-e, CT-e, MDF-e, NFS-e, eventos e inutilizações), para as listas de documentos recebidos (NF-e, CT-e e NFS-e) e para as exportações, que passam a abrir já filtradas por ele. O dashboard mostra um ambiente por vez: não existe a opção de somar os dois.

  1. 1Clique em Produção ou Homologação no seletor, ou abra o ⌘K (Ctrl+K no Windows) e escolha Ambiente: Produção ou Ambiente: Homologação.
  2. 2O dashboard e as listas abertas buscam os dados do novo ambiente. Quem usa leitor de tela ouve o aviso de que o ambiente mudou.
  3. 3A escolha fica guardada para você, nesta organização, e vale em qualquer computador em que você entrar.

Na primeira vez

Se a sua organização tem documentos nos dois ambientes e você ainda não escolheu, o sistema abre uma janela perguntando em qual ambiente você quer trabalhar. Produção já vem marcada: basta confirmar. Essa janela só fecha quando você confirma. Se a organização só tem documentos de um ambiente, o sistema usa esse ambiente e não pergunta nada. Se ainda não há documentos, usa o ambiente cadastrado na empresa e o dashboard avisa que ainda não há nada para mostrar.

O sistema nunca escolhe Homologação por conta própria quando existem documentos de Produção. Se você escolher um ambiente que deixou de ter documentos e não é o da empresa, a pergunta volta.

A tarja de Homologação

Enquanto você estiver em Homologação, aparece uma tarja fixa no topo de todas as telas, com o texto AMBIENTE DE HOMOLOGAÇÃO. Os dados desta tela são de teste e não têm valor fiscal. O título da aba do navegador também ganha o prefixo [HOMOLOG]. A tarja traz o botão Ver Produção, que volta ao ambiente real com um clique. Em Produção não há tarja.

Nas listas, cada nota mostra um selo com o ambiente dela, mesmo quando o filtro está em Todos os ambientes. Nas listas de documentos recebidos, o selo mostra — quando o ambiente do documento não pôde ser identificado.

O que o ambiente filtra e o que ele não filtra

Nas listas de emissão e de documentos recebidos, o filtro Ambiente começa no ambiente que você escolheu no topo. Você pode mudá-lo só naquela lista, inclusive para Todos os ambientes; nesse caso a lista mostra o aviso Filtro local, e o ambiente do topo não muda. Ao trocar o ambiente no topo, as listas voltam a acompanhá-lo.

No dashboard, os números de emissão e os de documentos recebidos (NF-e, CT-e e NFS-e, inclusive a situação das manifestações) seguem o ambiente ativo. O Status SEFAZ mostra o ambiente ativo, e só os Certificados Digitais A1 são identificados como independentes do ambiente, porque o mesmo certificado vale para os dois.

Documentos recebidos: de onde vem o ambiente

O ambiente de uma NF-e, CT-e ou NFS-e recebida é o que está escrito no próprio XML do documento (campo tpAmb), e não o ambiente em que a empresa está configurada hoje. Se a empresa foi trocada de Homologação para Produção depois do download, a nota baixada em Homologação continua sendo de Homologação.

Quando o XML não existe mais ou não traz essa informação, o documento fica sem ambiente identificado: ele nunca é tratado como Produção. Esses documentos não aparecem nem no recorte de Produção nem no de Homologação. Para encontrá-los, use a opção Sem ambiente identificado do filtro Ambiente das listas de recebidos; o dashboard também informa quantos ficaram de fora do período (a contagem para em 1.000, e aí aparece mais de 1.000).

Ambiente nas exportações

Nos relatórios em Excel de NF-e, itens de NF-e, CT-e e NFS-e, o campo Ambiente começa no ambiente ativo e pode ser trocado para Produção, Homologação ou Todos os ambientes. O total mostrado antes de gerar o arquivo usa o mesmo filtro e bate com o número de linhas da planilha, e o mesmo vale para o envio do relatório por e-mail. O botão Exportar Excel das listas leva o ambiente da lista; com o filtro em Sem ambiente identificado ele fica desligado, porque a exportação só filtra por Produção ou Homologação.

O ambiente é só um filtro: nenhuma marca de Homologação é gravada dentro do arquivo (nem no nome, nem em coluna ou aba). Para conferir de que ambiente é a planilha, olhe o filtro usado na geração. A mesma opção ambiente (1 ou 2) existe na API de download em lote de XML.

Ambiente da tela não é ambiente da nota

O seletor do topo não decide em que ambiente uma nota é emitida. Nos formulários de emissão continua valendo o campo Ambiente SEFAZ (ou, se você não mexer nele, o ambiente cadastrado na empresa). Quando o ambiente que você está vendo é diferente do ambiente em que a nota será emitida, o formulário mostra um aviso, por exemplo: “Você está vendo Produção, mas esta nota será emitida em Homologação.”

O aviso é só informativo: ele não impede a emissão e não pede confirmação extra. Emitir em Homologação e em Produção são ambos permitidos, e trocar o ambiente do topo com um formulário aberto não altera o ambiente da nota.

Links com ambiente

Para compartilhar uma tela já em um ambiente, acrescente ?ambiente=1 (Produção) ou ?ambiente=2 (Homologação) ao endereço. O valor do link vale só para aquela visita: o seletor mostra que ele veio do link e a sua escolha guardada não é alterada. Valores diferentes de 1 e 2 são ignorados.

Desenvolvido porGSATI Tecnologia da Informação