Histórico de Alterações

A tela de Histórico de Alterações mostra tudo o que foi alterado nas configurações do eDocs: o que mudou, de qual valor para qual, quando, em qual tela, por quem e por qual motivo. Ela serve para entender por que uma configuração está diferente do esperado. Por exemplo: quando o recebimento de NFS-e aparece desativado e ninguém lembra de ter alterado.

A tela é somente consulta: não é possível editar nem apagar registros.

Quais alterações são mostradas na tela?

• Configurações de Empresas e Filiais (por exemplo: Ativar recebimento de NFS-e, e-mail, integração com ERP, validações XSD, responsável técnico por estado).
• Algumas configurações gerais do sistema, como ativação dos executores de cada tipo de documento, e-mail e integrações WCF.
• Configurações usadas pelo sistema que ligam ou desligam rotinas, mesmo as que não têm campo em tela. Elas aparecem como Parâmetro interno.
• Troca do serial da licença, feita em Configurações > Licenças > Atualizar licença.

Colunas disponíveis

Data
Data e hora em que a alteração foi registrada.

Configuração
Nome da configuração, como aparece na tela de configurações. Nas configurações internas, que não têm campo em tela, aparece o texto "Parâmetro interno:" seguido do nome.

Tela
Onde a configuração fica no sistema (Por exemplo: Configurações > Filial > NFS-e). Para configurações internas, mostra a rotina que usa a configuração.

Parâmetro
Nome da configuração gravada no sistema, escrito de forma legível. Ajuda o suporte a identificar exatamente qual configuração mudou.

Filial/Empresa
De quem é a configuração. Para filial, mostra o CNPJ. Para os demais casos, mostra o tipo (Geral, Empresa, Sistema por estado etc.) e o código.

Valor anterior
Valor que a configuração tinha antes da alteração.

Valor novo
Valor depois da alteração.

Operação
Tipo da alteração:

• Inclusão: a configuração passou a existir com um valor diferente do padrão.
• Alteração: o valor da configuração mudou.
• Exclusão: a configuração foi removida. Nesse caso ela volta a usar o valor padrão do sistema.

Usuário
E-mail de quem fez a alteração. Se o e-mail não existir, mostra o login. Essa coluna ficará em branco quando a alteração foi feita pelo próprio sistema.

Origem
O que provocou a alteração:

• Desconhecida: alteração de origem desconhecida.
• Usuário: alteração feita por uma pessoa nas telas do eDocs.
• Rotina automática: alteração feita por uma rotina do próprio sistema (por exemplo, a desativação automática semanal do recebimento).
• Erro da Senior Cloud: o sistema alterou a configuração por causa de uma resposta de erro da Senior Cloud (por exemplo, falta de licença do módulo de NFS-e). O motivo mostra o código e a mensagem recebida.
• Sincronização: alteração vinda da sincronização de configurações entre ambientes.
• Integração: alteração feita por uma integração externa (ERP, web service).
• Atualização: alteração feita durante uma atualização de versão ou migração de dados.
• Conciliação diária: alteração encontrada pela conciliação, que não passou pelas telas do eDocs (veja o item "Conciliação das configurações").
• Licença: troca do serial pelo botão Atualizar licença.

Motivo
Explicação da alteração, quando existir. Nas alterações automáticas, essa coluna informará o motivo (Por exemplo: a licença de recebimento não está ativa).

Como os valores são exibidos

Os valores são mostrados em texto de fácil entendimento, da mesma forma para todas as configurações:

• Configurações de Sim ou Não aparecem como Sim e Não.
• Configurações com opções aparecem pelo nome da opção. Exemplo: em Ativar recebimento, os valores possíveis são Não, Xml, Pdf e Ambos.
• Valores de texto e números aparecem como foram gravados.

Botões disponíveis

• Atualizar: recarrega a lista. A seta ao lado permite escolher a atualização automática da tela.
• Filtrar: abre o painel de filtros.
• Remover Filtro: limpa os filtros aplicados e mostra todos os registros.
• Conciliar agora: pede a conciliação das configurações agora, sem esperar o horário automático (veja o item abaixo).

Filtros

Para filtrar, clique em Filtrar, preencha os campos desejados e clique em OK. Os filtros de texto não diferenciam letras maiúsculas e minúsculas e procuram pelo texto como ele é exibido na tela.

• Data: período em que a alteração foi registrada.
• Local: tipo de dono da configuração (Sistema, Sistema por estado, Empresa, Filial, Usuário, Emissor ou Empresa (serial)).
• Configuração: parte do nome da configuração. Para as internas, pode digitar o texto como aparece na tela, por exemplo "Parâmetro interno: Atualizacao Pendente".
• Parâmetro: nome da configuração, como aparece na coluna Parâmetro.
• Tela: parte do caminho da tela, por exemplo "Filial > NFS-e".
• Filial (CNPJ): CNPJ da filial.
• Operação: Inclusão, Alteração ou Exclusão.
• Origem: o que provocou a alteração.
• Usuário: e-mail ou login de quem alterou.

Conciliação das configurações

Algumas alterações não passam pelas telas do eDocs. Por exemplo: uma alteração feita direto no banco de dados, por um script ou por outra ferramenta. Nesses casos o sistema não percebe a mudança na hora. A conciliação é uma verificação que descobre essas alterações e as registra no histórico.

Como funciona

A conciliação compara as configurações que estão vigentes no sistema com o último registro do histórico de cada uma. Se houver diferença, ela registra:

• Inclusão: encontrou uma configuração com valor diferente do padrão que não tinha registro anterior no histórico.
• Alteração: o valor atual é diferente do último valor registrado no histórico.
• Exclusão: a configuração existia no histórico, mas não existe mais. Ela volta a usar o valor padrão.

Esses registros aparecem na tela com a origem Conciliação diária e um motivo explicando o que foi encontrado. Como a conciliação só descobre que algo mudou depois do fato, ela não sabe quem fez a alteração, e por isso a coluna Usuário fica em branco.

Quando é executado?

• Automaticamente, todos os dias, pelo serviço do eDocs, na madrugada, entre 02:00 e 05:59, fora do horário de maior uso. O serviço do eDocs precisa estar em execução.
• Quando você quiser, pelo botão Conciliar agora.

Além da conciliação, a rotina diária também remove os registros com mais de 12 meses e escreve no log do sistema um resumo do que foi feito.

O que é verificado?

• Configurações gerais e de empresas: todas as configurações acompanhadas pelo histórico.
• Configurações de filiais: para que a rotina continue rápida mesmo com milhares de filiais, são verificadas as configurações mais importantes do recebimento de NFS-e (Ativar recebimento, Ativar monitoramento nas prefeituras, Consulta DF-e e Monitoramento no Ambiente Nacional) e as configurações que já têm histórico.
• Configurações que estão com o valor padrão e nunca tiveram registro não geram linha, pois isso é o mesmo que a configuração não existir.
• Configurações que o sistema altera continuamente, como datas de última consulta e contadores, não são verificadas.

Limite por execução

Cada execução registra no máximo 500 linhas. Se houver mais diferenças, o restante é registrado nas execuções seguintes. Na primeira vez em uma base com muitas filiais, pode levar alguns dias para o histórico ficar completo.

Botão Conciliar agora

• Clique em Conciliar agora e confirme a mensagem.
• A conciliação é enviada para execução em segundo plano, e a tela mostra uma mensagem com um link para acompanhar. Você pode continuar usando o sistema normalmente.
• Ao terminar, a lista e a faixa de status (acima da lista) são atualizadas.

Só é possível executar uma conciliação por vez. Se já existir uma em andamento, o sistema avisa. O resumo completo (quantidade de inclusões, alterações e exclusões por configuração) pode ser consultado em Sistema > Processamentos em segundo plano.

A faixa de status mostra a data da última conciliação (manual ou automática) e o que ela encontrou.

Perguntas frequentes - FAQ

Como descobrir se o recebimento de NFS-e foi desativado automaticamente?

Clique em Filtrar e preencha Configuração com "Ativar recebimento". Veja a coluna Origem da última linha: "Rotina automática" ou "Erro da Senior Cloud" indicam que foi o próprio sistema, e a coluna Motivo explica a causa. Se a origem for "Usuário", a coluna Usuário mostra quem alterou.

Por que a tela está vazia?

O histórico só registra alterações feitas a partir da versão 5.8.16.62. Se nenhuma configuração acompanhada foi alterada desde então, a lista fica vazia. Verifique também se há filtros aplicados e use Remover Filtro.

O que significa "Parâmetro interno"?

É uma configuração usada pelo próprio sistema, que não tem campo nas telas de configuração. Ela aparece no histórico porque liga ou desliga uma rotina e ajuda a entender o comportamento do sistema.

Por que algumas linhas não têm usuário?

Quando a alteração é feita pelo sistema (rotina automática, erro da Senior Cloud, sincronização) ou descoberta pela conciliação, não há um usuário associado.

Uma filial nova foi criada e não apareceu nada. Está certo?

Sim. As configurações que nascem com o valor padrão não geram registros. Só aparecem as alterações feitas depois.

Alterei um valor direto no banco de dados. Quando aparece na tela?

Na próxima conciliação: no horário automático (entre 02:00 e 05:59) ou imediatamente, clicando em Conciliar agora.

A troca de serial aparece na tela?

Sim. Ao clicar em Atualizar licença, se o serial foi alterado, aparece um registro com origem Licença, mostrando o serial anterior e o novo. Se o serial não mudou, nada é registrado.

Posso apagar ou editar um registro do histórico?

Não. A tela é somente consulta, e os registros são removidos automaticamente depois de 12 meses.

A tela não aparece no menu Configurações. Por quê?

Verifique se o seu usuário é Administrador, Cloud Administrador ou Suporte. Em ambientes com vários clientes, a tela só aparece depois de selecionar um cliente (tenant), pois ela não existe na base principal do gerenciador.