[[:ajuda|{{ :ajuda:gsan-batch.png?nolink&200|}}]]
====== Atualização Cadastral Via Coletor de Dados ======
<columns>
O **Ambiente Virtual 2** é o repositório onde serão armazenados os dados cadastrais dos imóveis após o trabalho de atualização cadastral, realizado pelas equipes de recadastramento. A rotina atualizará os dados das matrículas dos imóveis na base de dados do sistema, identificando e marcando no **Ambiente Virtual 2** os dados inconsistentes encontrados pelo processo de atualização.
</columns>

<columns>
Para cada imóvel pesquisado são realizadas as seguintes críticas:

  - Caso não tenha sido informado o número do CPF/CNPJ na base de dados **Ambiente Virtual 2**, é gerada uma crítica com a mensagem //Número do CPF/CNPJ não foi informado//. Este registro é marcado para que seja feita a análise de ocorrências e estatística.
  - Caso seja informado o número do CPF/CNPJ, é feita a validação do número do CPF/CNPJ e a verificação deste número na base de dados da Receita Federal.
  - No caso de a rotina retornar alguma inconsistência, é gerada crítica para o número do CPF/CNPJ.
  - No caso de a rotina não retornar o nome, é gerada uma crítica para o número do CPF/CNPJ.
  - No caso de a rotina retornar um CPF/CNPJ corrigido, o registro é marcado e o número do CPF/CNPJ e o nome são atualizados na base de dados.
  - Se o número do CPF/CNPJ da base de dados do **Ambiente Virtual 2** for diferente da base de dados, e o CPF/CNPJ estiver ligado a um **Registro de Atendimento**, é gerada uma mensagem de crítica: //O número do CPF/CNPJ está ligado a uma RA na base de dados da empresa//.
</columns>

\\
===== Atributos =====

\\
==== Atributo Categoria ====

O atributo não é atualizado se a **Categoria** passar pelas seguintes mudanças:

^Base de Dados da Empresa^Base de Dados Ambiente Virtual 2^
|Categoria diferente de Residencial|Categoria Residencial|
|Categoria Industrial|Categoria Comercial|
|Qualquer categoria|Categoria Público|
|Categoria Público|Qualquer categoria|

<columns>
Será gerada uma crítica com a mensagem: //Categoria inconsistente//. A base de dados **Ambiente Virtual 2** faz as seguintes validações:

  - Para os tipos de categoria //Comercial//, //Industrial// e //Público//, verifica se o usuário do imóvel está associado a um CPF; caso esteja, o sistema gera crítica com a mensagem: //Imóvel na Categoria Comercial, Industrial ou Público associado a um número de CPF//.
  - Para o tipo de categoria //Residencial//, o sistema verifica se o usuário do imóvel está associado a um CNPJ; caso esteja, o sistema gera crítica com a mensagem: //Imóvel na Categoria Residencial associado a um número de CNPJ//.
</columns>

\\
==== Atributo Ligação de Água ====
<columns>
O atributo não é atualizado se a situação da ligação passar pelas seguintes mudanças (só será consistido quando a situação nas duas bases de dados forem diferentes):
</columns>

^Base de Dados da Empresa^Base de Dados Ambiente Virtual 2^
|Ligado|Qualquer outra situação|
|Qualquer outra situação|Diferente de ligado|

Será gerada uma crítica com a mensagem: //Situação da Ligação do Imóvel inconsistente//.

\\
==== Atributo Economias ====
<columns>
O atributo não é atualizado caso a quantidade de economias da matrícula do imóvel na base de dados **Ambiente Virtual 2** for menor que a quantidade de economias na base de dados da empresa. Nesse caso, será gerada uma crítica com a mensagem: //Quantidade de Economias inconsistente//.
</columns>

\\
==== Atributo Situação do Hidrômetro ====
<columns>
O atributo não é atualizado se a situação do hidrômetro, na base de dados do **Ambiente Virtual 2**, for diferente da base de dados da empresa, e a situação na base de dados do **Ambiente Virtual 2** for igual a //não medido//. Nessa caso, será gerada uma crítica com a mensagem: //Situação do Hidrômetro inconsistente//.
</columns>

\\
==== Exclusão do Imóvel ====
<columns>
O imóvel não é atualizado caso esteja na situação de //excluído// na base de dados do **Ambiente Virtual 2**. Nesse caso, será gerada uma crítica com a mensagem: //Imóvel excluído, atualização deve ser feita pelo GSAN//.
</columns>

\\
==== Inclusão de um novo imóvel ====
<columns>
Caso o imóvel não exista na base de dados da empresa, é chamada a rotina de inclusão de imóvel do **GSAN**. Caso seja encontrada alguma inconsistência, será gerada uma mensagem de crítica pela rotina de inclusão.
</columns>

\\
==== Atualização de Inscrição (mudança de quadra/rua para quadra; lote) ====

A atualização dos dados de inscrição só é realizada durante o fechamento da rotina do faturamento, sendo comandada pelo usuário.

\\
==== Atualização de Logradouro ====
<columns>
A atualização dos logradouros só é realizada durante o fechamento da rotina do faturamento. A rotina é executada diariamente em determinado horário, devendo registrar todas as inconsistências encontradas. Estes registros são apresentados na aplicação de verificação das matrículas inconsistentes após o recadastramento.

Na consulta aos dados dos imóveis pelo sistema **GSAN**, é disponibilizada para o usuário a informação identificando as matrículas atualizadas sem crítica (atualização Cadastral OK), e as matriculas atualizadas com critica (atualização Cadastral Pendente). O sistema registra também a pendência por inscrição e logradouro (Pendente Insc/Logr).
</columns>

\\
==== Validações e Mensagens ====
<columns>
Na geração de críticas com a mensagem //Categoria inconsistente// na base de dados **Ambiente Virtual 2**, o sistema faz as seguintes validações:

  - Para os tipos de categoria //Comercial//, //Industrial// e //Público//, o sistema verifica se o usuário do imóvel está associado a um CPF; caso esteja, o sistema gera crítica com a mensagem: //Imóvel na Categoria Comercial, Industrial ou Público associado a um número de CPF//.
  - Para o tipo de categoria //Residencial//, o sistema verifica se o usuário do imóvel está associado a um CNPJ; caso esteja, o sistema gera crítica com a mensagem: //Imóvel na Categoria Residencial associado a um número de CNPJ//.

O atributo não é atualizado se a situação da ligação passar pelas seguintes mudanças (só será consistido quando a situação nas duas bases de dados forem diferentes):
</columns>

^Base de Dados da Empresa^Base de Dados Ambiente Virtual 2^
|Ligado|Qualquer outra situação|
|Qualquer outra situação|Diferente de ligado|


\\
==== ATUALIZAÇÃO DAS TABELAS DE LOGRADOURO E BAIRRO ====
<columns>
A funcionalidade de atualização do cadastro de logradouros da base de dados **GSAN** será realizada a partir das atualizações dos logradouros na base de dados do **ADMIN**. Serão atualizadas as tabelas de //Logradouro//, //Bairro//, além do endereço dos imóveis de determinada //Localidade//.

Para atualização no GSAN, são gerados os dados de //Logradouro// e //Bairro// que sofreram atualizações no **ADMIN**.

\\
==== Tabelas geradas para o GSAN ====
<columns>
BAIRRO ADMIN

  * ID do Bairro GSAN;
  * Descrição do Bairro;
  * Indicador de Atualização (I - Inclusão, A - Alteração, S - Sem alteração);
  * Data atualização GSAN.

LOGRADOURO ADMIN

  * ID do Logradouro GSAN;
  * ID do Tipo de Logradouro;
  * ID do Título do Logradouro;
  * Nome do Logradouro;
  * Indicador de atualização (I - Inclusão, A - Alteração do Nome, S - Sem alteração);
  * Data atualização GSAN.
</columns>

\\
==== Atualização das Tabelas Bairro, Logradouro, Logradouro & Bairro no GSAN ====

As tabelas de LOGRADOURO e BAIRRO do GSAN são atualizadas pela rotina de atualização diária da atualização cadastral.

\\
==== Atualização tabela BAIRRO GSAN ====
<columns>
Para cada linha selecionada na tabela BAIRRO ADMIN são definidos os seguintes procedimentos:

  - Se o indicador for o de Inclusão ( I ):
    - Insere uma nova linha na tabela Bairro do GSAN.
    - Gera linha na tabela BAIRRO GSAN ADMIN (tabela responsável em guardar a relação DE / PARA entre as tabelas de bairro do ADMIN e GSAN);
  - ID do Bairro ADMIN - ID do Bairro da tabela BAIRRO ADMIN;
  - ID do Bairro GSAN - Novo ID do Bairro gerado na tabela BAIRRO do GSAN.
  
Atualiza o atributo //Data atualização GSAN// da tabela BAIRRO ADMIN com a data corrente:

  - Se o indicador for o de Alteração (A):
    - Atualiza a //Descrição// do bairro da tabela **GSAN** com o atributo //Descrição do Bairro// da tabela  **BAIRRO ADMIN**.
    - Atualiza o atributo //Data atualização GSAN// da tabela **BAIRRO ADMIN** com a data corrente.
</columns>

\\
==== Atualização tabela LOGRADOURO GSAN ====
<columns>
Para cada linha selecionada na tabela LOGRADOURO ADMIN, são definidos os seguintes procedimentos:

  - Se o indicador for o de Inclusão ( I ):
    - Insere uma nova linha na tabela LOGRADOURO do GSAN.
    - Gera linha na tabela LOGRADOURO GSAN ADMIN (tabela responsável em guardar a relação DE / PARA entre as tabelas de logradouro do ADMIN e GSAN);
    - ID do Logradouro ADMIN - ID do Logradouro da tabela Logradouro ADMIN;
    - ID do Logradouro GSAN - Novo ID do Logradouro gerado na tabela LOGRADOURO do GSAN;
    - Atualiza o atributo Data atualização GSAN da tabela LOGRADOURO ADMIN com a data corrente.

  - Se o indicador for o de Alteração ( A ):
    - Atualiza a //Descrição// do logradouro da tabela **GSAN** com o atributo //Descrição do Logradouro// da tabela **LOGRADOURO ADMIN**.
    - Atualiza o atributo //Data atualização GSAN// da tabela **LOGRADOURO ADMIN** com a data corrente.
</columns>

\\
==== Atualização do Logradouro e Bairro dos Imóveis ====
<columns>
Na tabela //Imóvel Retorno// existe um indicador identificando se o atributo foi incluído no **ADMIN** para os campos //ID de logradouro//, //ID de bairro//. (Este identificador indicará quando a rotina deverá acessar as tabelas //LOGRADOURO GSAN ADMIN, BAIRRO GSAN ADMIN//).

Na rotina diária de atualização cadastral:

  - Se o logradouro associado ao imóvel na tabela de retorno no **Ambiente Virtual 2** for um logradouro novo, será feita a pesquisa na tabela LOGRADOURO GSAN ADMIN para encontrar o ID gerado na tabela de LOGRADOURO do GSAN.
  - Se o bairro associado ao imóvel na tabela de retorno no **Ambiente Virtual 2** for um bairro novo, será feita a pesquisa na tabela BAIRRO GSAN ADMIN para encontrar o ID gerado na tabela de BAIRRO do GSAN.
  - Faz a pesquisa na tabela Logradouro Bairro através do ID do Logradouro e ID do Bairro vindos do A**Ambiente Virtual 2**; se não encontrar a linha, fazer a inclusão dos ID´s na tabela Logradouro Bairro e atualizar o ID do novo Logradouro Bairro no imóvel.
</columns>

\\
==== Ajustes na rotina batch de atualização cadastral do ambiente virtual 2 para o GSAN ====
<columns>
Caso o imóvel novo seja identificado como duplicado e marcado no pré-GSAN para //Liberar Atualiz. GSAN//, esse imóvel será considerado como atualização, e a rotina considerará esse imóvel novo com uma atualização, entrando assim nas inconsistências.
</columns>

\\
===== Referências =====

**[[=postgres:controle_batch|Batch]]**

==== Termos Principais ====

**[[=ajuda:batch|Batch]]**

**[[=ajuda:batch:processo_eventual_ou_mensal|Processo Eventual ou mensal]]**



\\
\\
\\
Clique **[[:ajuda|aqui]]** para retornar ao Menu Principal do GSAN