Base de Conhecimento de Gestão Comercial de Saneamento

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
[[:ajuda|{{ :ajuda:gsan-faturamento.png?nolink&200|}}]]
====== Alterar Vínculo de Clientes com Imóvel e Contas ======
<columns>

O objetivo dessa funcionalidade é alterar o vínculo de clientes com o imóvel e suas respectivas contas. Para ser efetuada essa alteração, é necessária a abertura de um registro de atendimento (RA) anterior para o imóvel informado.

A funcionalidade pode ser acessada via **Menu de Sistema**, através do caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Faturamento]] > [[:ajuda:Conta]] > Alterar Vínculo de Clientes com Imóvel e Contas**.

Feito isso, o sistema acessa a tela a seguir:
</columns>
\\

==== Observação ====
^Informamos que os dados exibidos nas telas a seguir são fictícios, e não retratam informações de clientes.^

<WRAP center round box 100%>
{{  :ajuda:alterar_vinculo_cic.jpg?nolink  |}}
</WRAP>
\\

<columns>

A funcionalidade apresenta uma tela para que seja informado o imóvel para o qual se deseja alterar os vínculos de clientes e contas. Para comandar a execução, clique no botão {{:ajuda:alterarvinculo.png?nolink|}}. Para detalhes sobre o preenchimento dos campos, clique **[[=ajuda:alterar_vinculo_de_clientes_com_imovel_e_contas#preenchimento_dos_campos|AQUI]]**.

**Atenção**: por solicitação da **Caern** e **Caema**, o sistema foi ajustado para possibilitar a exibição dos débitos dos imóveis por cliente, e por período de relacionamento com o cliente:
  - Criado um parâmetro de sistema, para definir se a mensagem de substituição de cliente na retificação será exibida e, caso esteja definido como **SIM**, será exibida a mensagem a seguir, que aguardará confirmação: 
    - Deseja substituir o(s) cliente(s) vinculado(s) à conta pelo(s) cliente(s) atualmente vinculado(s) ao imóvel?;
    - O sistema apresenta as opções **Sim** e **Não** e só será efetuada a substituição do(s) cliente(s) vinculado(s) à conta pelo(s) cliente(s) vinculado(s) ao imóvel, se a opção escolhida for **SIM**.
  - Será apresentado o campo na tela, para que seja informado o imóvel para o qual se deseja alterar os vínculos de clientes e contas. Caso seja marcado o campo **Colocar Revisão**, a conta será colocada em revisão pelo motivo **Mudança de cliente Responsável**.
  - A partir da seleção do imóvel, serão exibidos os clientes vinculados, sendo informado para cada um, as datas de início e de fim da vinculação, o código, o nome do cliente, o tipo de relação do cliente com o imóvel, e o indicador se esse deve ser o nome a ser exibido na conta. A funcionalidade possibilitará:
    - A remoção de vínculos de clientes com o imóvel, referentes a determinado período de vinculação, e tipo de relação do cliente com o imóvel;
    - A adição de novos vínculos de clientes com o imóvel, referentes a determinado período de vinculação, e tipo de relação do cliente com o imóvel;
    - A alteração de vínculos existentes de clientes com o imóvel, especificamente no que se refere ao período de vinculação e ao tipo de relação do cliente com o imóvel.
  - Além das validações que são normalmente executadas para a vinculação de clientes ao imóvel, também serão feitas, pela nova funcionalidade, as seguintes:
    - A validação referente aos intervalos de início e de fim de vinculação, para o tipo da relação do cliente com o imóvel, e para o indicador de exibição do nome do cliente na conta, de modo que não haja lacunas de tempo sem clientes vinculados, e/ou duplicidade de clientes em um mesmo período. Ou seja, será permitido ao usuário efetuar a remoção, adição e alteração de vínculos de clientes com o imóvel, mas será necessário que, ao final, todos os vínculos estejam íntegros quanto aos períodos de início e de fim da vinculação, associados tanto ao tipo de relação dos clientes com os imóveis, como ao indicador de exibição do nome do cliente na conta. - Dessa forma, ao se informar, por exemplo, diversos clientes vinculados a um imóvel com o tipo de relação igual a USUÁRIO, desde a data mais antiga de vínculo inicial até a data corrente (cliente com maior data de vínculo inicial e sem data de vínculo final), não poderá haver lacunas de período sem vinculação de cliente do tipo USUÁRIO, nem duplicidade de clientes para um mesmo período. Cada vínculo de cliente com o imóvel com uma data final de vinculação informada, haverá outro vínculo de cliente com a data imediatamente seguinte, como sendo a data de início de vinculação para o tipo de relação USUÁRIO. Da mesma forma, não poderá haver outro vínculo de cliente, cujo período de vinculação já esteja informado para outra vinculação do tipo de relação USUÁRIO. Validação semelhante, referente aos intervalos de início e de fim de vinculação também será feita com relação ao indicador de exibição do nome do cliente na conta, ou seja, independentemente do tipo de relação do cliente com o imóvel, e não poderá haver lacunas nem duplicidades quanto aos períodos informados, referente à indicação do cliente, cujo nome deverá constar na conta correspondente ao período.
    - Após a vinculação consistente dos clientes ao imóvel selecionado, será executada a alteração referente à vinculação dos clientes com as respectivas contas dos períodos informados. Todos os clientes anteriormente vinculados a uma conta em aberto, cujo imóvel associado sofreu alteração de vínculos, serão automaticamente desvinculados da conta, e os novos clientes vinculados ao imóvel para o período referente à data de medição do consumo faturado na conta, serão vinculados a esta.
    - Para cada conta vinculada ao imóvel cujos vínculos com clientes estão sendo alterados, caso a conta esteja em aberto, na situação NORMAL, INCLUÍDA ou RETIFICADA, e cuja data de leitura referente ao mês de faturamento esteja compreendida no intervalo entre a data inicial e a final de vínculo do cliente com o imóvel, serão alterados os vínculos existentes da conta com os clientes, substituindo os anteriores pelos clientes informados como vinculados ao imóvel no período.
    - Os clientes anteriormente vinculados a uma conta, cujo imóvel associado sofreu alteração de vínculos e a conta se enquadre nas condições acima, serão automaticamente desvinculados da conta, mas o histórico será preservado para permitir a sua identificação em consultas posteriores.
    - Será também verificado, para cada conta, cujo vínculo com o cliente tenha sido alterado, se existem itens de negativação associado às mesmas e ao cliente que foi desvinculado. - Quando existir, esses itens serão retirados da negativação. Serão cancelados os itens de negativação associados ao cliente que está sendo desvinculado. Caso todos os itens de negativação associados ao cliente desvinculado sejam cancelados, ele será automaticamente retirado da situação de negativação.
\\

Criado no cadastro de imóvel um indicador de alteração de vínculo de clientes e contas, o qual será ativado para cada imóvel que tenha sido atualizado por esta funcionalidade, possibilitando futuras ações de cobrança para esses imóveis. 

Alterada a funcionalidade **Consultar Contas do Imóvel** (chamada pela funcionalidade **[[:ajuda:atendimento:consultar_imovel|Consultar Imóvel]]**, nas abas de **[[:ajuda:cadastro:Histórico do Faturamento]]** e **[[:ajuda:cadastro:Débitos do imóvel]]**), para que sejam exibidos os atuais clientes vinculados a uma conta, bem como os clientes anteriores resultantes dessas alterações, quando for o caso. 

Alterada a funcionalidade Consultar Conta, que é acionado pela funcionalidade **[[:ajuda:atendimento:consultar_imovel|Consultar Imóvel]]** nas abas **[[:ajuda:cadastro:Histórico do Faturamento]]** e **[[:ajuda:cadastro:Débitos do imóvel]]**, para que, ao clicar no link existente sob a referência de uma conta, na tela popup contendo os dados da conta, sejam exibidos os atuais clientes vinculados à conta e os clientes anteriores alterados através da execução desta funcionalidade **Alterar Vínculo de Clientes com Imóvel e Contas**, caso existam.  

Alterada a funcionalidade **[[:ajuda:emitir_segunda_via_da_conta_sem_taxa|Emitir Segunda Via de Conta]]**, de modo a possibilitar a emissão da segunda via de uma conta apresentando o cliente vinculado (opção padrão), ou o atual cliente que está vinculado ao imóvel. Assim, caso o cliente associado à conta selecionada não seja o mesmo que o atualmente associado ao imóvel, ao clicar no ícone da impressora para a geração da segunda via da conta, o sistema exibirá uma tela com a mensagem: “Caso deseje emitir a segunda via em nome do cliente que está vinculado à conta (opção padrão), clique no botão **Cliente Conta**. Caso deseje a conta em nome do atual cliente vinculado ao imóvel, clique no botão **Cliente Atual**. Caso a opção selecionada seja **Cliente Conta**, a funcionalidade emitirá a conta com o cliente vinculado, conforme já ocorre atualmente. Caso a opção selecionada seja **Cliente Atual**, o sistema deverá emitir a conta em nome do atual cliente vinculado ao imóvel com indicador de conta ativo. Esta opção só estará disponível quando a funcionalidade for executada de forma presencial, através de um usuário logado ao sistema, não sendo possível realizá-la através da internet. 

Para possibilitar um futuro rastreamento de outra alteração executada na emissão da segunda via de conta, acontece o registro histórico de todas as emissões efetuadas de forma presencial, salvando no sistema o usuário que efetuou a emissão, com a respectiva data e hora, a indicação se foi com o cliente da conta ou o do imóvel, e o nome do cliente associado.

A funcionalidade possibilita a obtenção do histórico de emissão de segunda via de conta.

Alterada a funcionalidade **[[:ajuda:atendimento:consultar_imovel|Consultar Imóvel]]**, nas abas referentes aos **[[:ajuda:cadastro:Dados adicionais]]**, **[[:ajuda:cadastro:Débitos do imóvel]]**, e **[[:ajuda:cadastro:Documento Cobrança]]**, conforme a seguir:
  - Aba de **[[:ajuda:cadastro:Documento Cobrança]]**, além dos atuais documentos de cobrança exibidos (foram incluídas as colunas referentes ao indicador de extrato do imóvel ou do cliente, e ao responsável pela emissão do documento), foi acrescida uma nova tabela com a finalidade de exibir o histórico de emissão de segunda via de contas;
  - Aba de **[[:ajuda:cadastro:Dados adicionais]]**, foi incluída uma tabela contendo o histórico de todas as vinculações de clientes com o imóvel, classificados de acordo com os períodos de início e fim dos vínculos, do mais atual para o mais antigo. Também constarão as informações dos clientes referentes às Situações de Cobrança e Negativações, exibindo o código do cliente e um link sobre cada um, o qual, quando ativado, apresentará uma tela **popup** com os dados detalhados do cliente;
  - Aba de **[[:ajuda:cadastro:Débitos do imóvel]]**: as informações dos clientes atuais do imóvel permanecem na parte superior da tela e, mais abaixo, serão exibidos os clientes do imóvel que possuam débitos, do mais atual para o mais antigo, com links sobre o valor total do débito de cada cliente, o qual, quando acionado, exibirá, logo após a linha do cliente, as faturas e guias associadas. 
\\

Também foi criada uma nova opção visando imprimir o extrato de débito do cliente, na qual o usuário terá a opção de selecionar as faturas e as guias do cliente para o qual deseja emitir o extrato. O layout do extrato será o mesmo, mas caso sejam selecionados débitos de um só cliente, o extrato sairá com o nome desse cliente. Caso contrário, o extrato ficará com o nome do cliente atual do imóvel. 

Foi alterada a funcionalidade **[[=postgres:cobranca:uc0444|Gerar e Emitir Extrato de Débito]]**, de modo a possibilitar a geração/emissão do extrato do cliente selecionado, considerando as contas e as guias de pagamento selecionadas para ele. 

Para possibilitar um futuro rastreamento, a emissão do extrato de débito terá o registro histórico de todas as emissões efetuadas de forma presencial, salvando no sistema, o usuário que efetuou a emissão, com a respectiva data e hora, bem como a indicação se este foi emitido para o imóvel ou se para um cliente, além da identificação do cliente associado ao imóvel. 

A consulta aos extratos de débito emitidos será feita através da aba [[:ajuda:cadastro:Documento Cobrança]], na funcionalidade **[[:ajuda:atendimento:consultar_imovel|Consultar Imóvel]]**.

Ajustada a funcionalidade **[[:ajuda:Alterar Vínculo de Clientes com Imóvel e Contas]]**, de modo a tornar necessária a abertura anterior de um Registro de Atendimento - RA.

As funcionalidades **[[:ajuda:Informar Parâmetros do Sistema]]** e **[[:ajuda:Consultar Parâmetros do Sistema]]** foram alteradas para considerar um novo parâmetro, referente à quantidade de vezes máxima permitida para que uma conta tenha seu vínculo com clientes alterado. 

Alterada a funcionalidade **[[:ajuda:Alterar Vínculo de Clientes com Imóvel e Contas]]**, com o objetivo de efetuar a verificação - se existe um RA aberto para o imóvel informado. Caso contrário, o sistema exibe uma mensagem de erro, alertando o usuário de que não foi encontrado um RA correspondente para o respectivo imóvel. Ao concluir a funcionalidade com sucesso, será feito o encerramento do RA associado.

A cada alteração de vínculo de clientes a uma conta é verificado se a quantidade de vezes que a conta já sofreu alteração de vínculos não excede o limite máximo fixado na tabela de parâmetros. Caso o limite seja excedido, o sistema exibe uma mensagem de erro, caso contrário, efetua a alteração de vínculos com os clientes e incrementa o contador existente na respectiva conta. 

Caso o usuário que estiver executando a funcionalidade possua a permissão especial, não será feita a verificação do excesso ao limite máximo, sendo sempre alterado o vínculo dos clientes à conta e incrementado o respectivo contador.
</columns>
\\

====== Preenchimento dos Campos ======

^Campo^Orientações para Preenchimento^
|Matrícula do Imóvel|<columns>Campo obrigatório. Informe a matrícula do imóvel, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_imovel|Pesquisar Imóvel]]**, para selecionar a matrícula desejada. A identificação do imóvel será exibida pelo sistema no campo ao lado. Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição. \\ **Regra associada**: campo preenchido com até nove dígitos. Após o preenchimento, o sistema valida o imóvel existente e verifica se existe registro de atendimento aberto para o imóvel. Caso não exista registro aberto para imóvel, o sistema exibe a mensagem: //Não existe registro de atendimento aberto de alterar vínculo para imóvel informado// e retorna para a tela principal.</columns>|
|Cliente Usuário Atual|Este campo é exibido pelo sistema quando informada a matrícula do imóvel.|
|Situação de Água|Este campo é exibido pelo sistema quando informada a matrícula do imóvel.|
|Situação de Esgoto|Este campo é exibido pelo sistema quando informada a matrícula do imóvel. |
|Código do Cliente|<columns>Campo obrigatório. Informe o código do cliente, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_cliente|Pesquisar Cliente]]**, para selecionar o cliente desejado. O nome do cliente será exibido pelo sistema no campo ao lado. Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição. \\ **Regra associada**: campo preenchido com até nove dígitos.</columns>|
|Tipo da Relação|<columns>Campo obrigatório. Selecione uma das opções disponibilizadas pelo sistema. \\ **Regra associada**: caso o cliente não seja cadastrado no sistema, clicar no botão {{:ajuda:inserircliente.png?nolink|}} e a tela de inserir os dados do cliente será exibida, conforme exemplo **[[=ajuda:inserir_cliente|AQUI]]**.</columns>|
|Data Inicio do Vínculo|</columns>Campo obrigatório. Informe a data de inicio do vínculo, no formato dd/mm/aaaa (dia, mês, ano). \\ **Regra associada**: campo preenchido automaticamente após identificação do imóvel ou cliente, mas habilitado para alteração.</columns>|
|Data Fim do Vínculo|<columns>Informe a data de fim do vínculo, no formato dd/mm/aaaa (dia, mês, ano). \\ **Regra associada**: campo preenchido automaticamente após identificação do imóvel ou cliente, mas habilitado para alteração.</columns>|
|Motivo Fim do Vínculo| Selecione uma das opções disponibilizadas pelo sistema. \\ **Regra associada**: caso seja informada a **Data de Fim do Vínculo**, este campo será obrigatório.|
|Nome da Conta|<columns>Campo obrigatório. Selecione uma das opções **Sim** ou **Não**. \\ **Regra associada**: é obrigatório existir um cliente com o indicador //nome da conta// ativo durante o período de tempo relacionado com o imóvel. O sistema verifica se existe mais de um cliente com o indicador de //nome da conta// ativo para o mesmo período de relação. Caso exista, o sistema exibe a mensagem: //Existe mais de um cliente para o mesmo período com o indicador nome conta ativo//. Caso exista um período sem cliente com o indicador //nome conta// ativo, o sistema exibe: //Existe intervalo de período sem cliente com o indicador nome conta//.</columns>|
|Cliente(s) Vinculado(s)|<columns>Este quadro contém os dados relativos à vinculação do cliente com o imóvel. Para remover um item, marque no checkbox correspondente, ou para marcar todos os itens clique no link **__Todos__** e, em seguida, clique no botão {{:ajuda:botao_remover.jpg?nolink|}}. Para adicionar cliente à base de dados, clique no botão {{:ajuda:adicionar.png?nolink|}} e complemente as informações de vinculação. \\ **Regra associada**:  o sistema pesquisa todos os clientes anteriormente vinculados a uma conta em aberto, cujo imóvel associado sofreu alteração de vínculos. Nesse caso, tais clientes são automaticamente desvinculados da conta. No lugar deles, vincula-se os novos clientes vinculados ao imóvel para o período referente à data de medição do consumo faturado na conta. Caso o cliente desvinculado da conta esteja negativado, o sistema retira a negativação da conta desse cliente.</columns>|
\\

====== Funcionalidade dos Botões ======

^Botão^Descrição da Funcionalidade^
|{{:ajuda:lupa.gif?nolink|}}|Ao clicar neste botão, o sistema permite consultar um dado nas bases de dados.|
|{{:ajuda:borracha.gif?nolink|}}|Ao clicar neste botão, o sistema apaga o conteúdo do campo em exibição.|
|{{:ajuda:inserircliente.png?nolink|}}|Ao clicar neste botão, o sistema comanda a inserção de um novo cliente não cadastrado.|
|{{:ajuda:adicionar.png?nolink|}}|Ao clicar neste botão, o sistema permite adicionar novos clientes para vínculos.|
|{{:ajuda:botao_remover.jpg?nolink|}}|Ao clicar neste botão, o sistema exclui os itens marcados nos checkboxs.|
|{{:ajuda:relatorios:botaoo_cancelarr.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|
|{{:ajuda:limpar.jpg?nolink|}}|Ao clicar neste botão, o sistema limpa o conteúdo dos campos da tela.|
|{{:ajuda:alterarvinculo.png?nolink|}}|Ao clicar neste botão, o sistema comanda a execução dos vínculos com base nos parâmetros informados.|

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

**[[=postgres:cadastro:uc1366|UC1366 - Alterar Vínculo de Clientes com o Imóvel e Contas]]**

==== Termos Principais ====

**[[=ajuda:faturamento|Faturamento]]**

**[[=ajuda:registro_atendimento|Registro de Atendimento]]**


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