[[:ajuda|{{ :ajuda:gsan-relatorio.png?nolink&200|}}]]
====== R0591 - Relatório Clientes Especiais ======
<columns>
O objetivo desta funcionalidade é gerar o relatório de clientes especiais a partir da seleção de parâmetros de filtro. Para efeitos do sistema, são considerados //especiais// os clientes grandes e corporativos. A opção pode ser acessada via **Menu de Sistema**, através do caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Relatório]] > [[:ajuda:relatorios:cadastro| Cadastro]] > R0591 - Relatório Clientes Especiais**.
</columns>

Feito isso, o sistema exibe a tela de filtro abaixo:

^Informamos que os dados exibidos nas telas e relatórios a seguir são fictícios e não retratam informações de clientes.^
<WRAP center round box 100%>
{{  :ajuda:relatorios:0591_relatorio_gc_cc.jpg?nolink  |}}
</WRAP>

<columns>
Agora, preencha os campos que julgar necessários conforme orientações a seguir:

  - **Gerência Regional**: selecione, da lista disponibilizada pelo sistema, a gerência regional à qual o imóvel está vinculado.
  - **Unidade de Negócio**: selecione, da lista disponibilizada pelo sistema, a unidade de negócio vinculada à gerência regional.
  - **Localidade Inicial**: informe o código da localidade inicial do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. Ao preencher esse campo, o campo final correspondente é preenchido automaticamente e os campos **Setor Comercial Inicial, Rota Inicial, Localidade Final, Setor Comercial Final e Rota Final** são habilitados.
  - **Setor Comercial Inicial**: informe o código do setor comercial inicial do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. Ao preencher esse campo, o campo final correspondente é preenchido automaticamente.
  - **Rota Inicial**: informe o código da rota inicial vinculada ao setor com, no máximo, quatro dígitos.
  - **Localidade Final**: Informe o código da localidade final do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. Ao preencher esse campo, o campo final correspondente é preenchido automaticamente.
  - **Setor Comercial Final**: Informe o código do setor comercial final do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. Ao preencher esse campo, o campo final correspondente é preenchido automaticamente.
  - **Rota Final**: informe o código da rota final vinculada ao setor com, no máximo, quatro dígitos.
  - **Perfil do Imóvel**: selecione, da lista disponibilizada pelo sistema, o perfil do imóvel que deseja visualizar no relatório. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.
  - **Categoria**: selecione, da lista disponibilizada pelo sistema, a categoria do imóvel que deseja visualizar no relatório. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.
  - **Subcategoria**: selecione, da lista disponibilizada pelo sistema, a subcategoria do imóvel que deseja visualizar no relatório. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica. **Atenção**: caso a(s) categoria(s) seja(m) informada(s) e a subcategoria não seja informada, o sistema seleciona os imóveis que possuam as categorias informadas em alguma de sua(s) subcategoria(s).
  - **Situação da Ligação de Água**: selecione, da lista disponibilizada pelo sistema, a situação da ligação de água que deseja visualizar no relatório.
  - **Situação da Ligação de Esgoto**: selecione, da lista disponibilizada pelo sistema, a situação da ligação de esgoto que deseja visualizar no relatório.
  - **Intervalo de Quantidade de Economias**: informe o intervalo que selecionará os imóveis por quantidades de economias. Quando o intervalo inicial for informado, o valor é replicado no intervalo final, caso este não esteja preenchido ou esteja preenchido com valor igual, permitindo alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial.
  - **Intervalo de Consumo de Água**: informe o intervalo que selecionará os imóveis por consumo de água. Para imóveis que não tiverem consumo de água, o sistema considera, se houver, o consumo de esgoto no intervalo informado. Quando o intervalo inicial for informado, o valor é replicado no intervalo final, caso este não esteja preenchido ou esteja preenchido com o mesmo valor, permitindo alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial. 
  - **Intervalo de Consumo de Esgoto**: informe o intervalo que selecionará os imóveis por consumo de esgoto. Quando o intervalo inicial for informado, o valor é replicado no intervalo final, caso este não esteja preenchido ou esteja preenchido com valor semelhante, permitindo alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial.
  - **Cliente Responsável**: informe o código do cliente responsável pelo imóvel com até sete dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar o cliente desejado.
  - **Intervalo de Consumo por Responsável**: informe o intervalo com até quatro dígitos, para selecionar os imóveis que possuam relação ativa do tipo **Responsável** com clientes, configurados pelo somatório dos consumos de água ou de esgoto por cliente responsável, e que esteja no intervalo informado. Quando o intervalo inicial for informado, é replicado o mesmo valor no intervalo final, caso este não esteja preenchido ou esteja preenchido com valor igual, permitindo a alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial.
  - **Data de Instalação do Hidrômetro**: informe, no formato DD/MM/AAAA, para imóveis que possuam hidrômetro instalado e cuja data de instalação esteja compreendida no intervalo informado, ou clique no botão {{:ajuda:relatorios:calendarrio.jpg?nolink|}}, para selecionar uma data desejada.
  - **Capacidade do Hidrômetro**: selecione, da lista disponibilizada pelo sistema, a capacidade do hidrômetro em metros cúbicos/hora. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.
  - **Tarifa de Consumo**: selecione, da lista disponibilizada pelo sistema, a tarifa de consumo do imóvel. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.
  - **Anormalidade de Leitura**: informe com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a anormalidade desejada. Em seguida, marque ou **Sim** ou **Não** ou **Todos**, indicando se a anormalidade deve cobrir ou não os imóveis do relatório.
  - **Anormalidade de Consumo**: selecione a anormalidade de consumo da lista disponibilizada pelo sistema. Em seguida, marque ou **Sim** ou **Não** ou **Todos**, indicando se a anormalidade de consumo deve cobrir ou não os imóveis do relatório.

\\

Após preencher todos os campos que julgar necessários, clique no botão {{:ajuda:relatorios:arrecadacao:botao_filtrar.jpg?nolink|}}. Caso o relatório seja muito extenso, ele pode ser encaminhado para processamento **[[=ajuda:batch|Batch]]**. Seu agendamento pode ser visualizado **[[=ajuda:batch:filtrar_processo|AQUI]]**. Antes de o sistema gerar o relatório de clientes especiais conforme os parâmetros informados, algumas validações são necessárias:

  - Verificar existência de dados:
    - Caso não exista a tabela na base de dados, o sistema exibe a mensagem **Tabela «nome da tabela» inexistente** e cancela a operação.
    - Caso a tabela esteja sem dados, o sistema exibe a mensagem **Tabela «nome da tabela» sem dados para seleção** e cancela a operação.
  - Verificar existência da localidade:
    - Caso o código da localidade não exista na tabela LOCALIDADE, o sistema exibe a mensagem **Localidade inexistente** e retorna para o passo correspondente no fluxo principal.
  - Verificar existência do cliente:
    - Caso o código do cliente não exista na tabela CLIENTE, o sistema exibe a mensagem **Cliente inexistente** e retorna para o passo correspondente no fluxo principal.
  - Validar data:
    - Caso a data esteja inválida, o sistema exibe a mensagem **Data inválida** e retorna para o passo correspondente no fluxo principal.
  - Verificar data final menor que data inicial:
    - Caso a data final seja anterior à data inicial, o sistema exibe a mensagem **Data Final do Período é anterior à Data Inicial do Período** e retorna para o passo correspondente no fluxo principal.
  - Verificar atributo final menor que atributo inicial:
    - Caso o conteúdo do atributo final seja anterior (inferior) ao conteúdo do atributo inicial, o sistema exibe a mensagem **«Nome do atributo» Final é menor que o «Nome do atributo» Inicial** e retorna para o passo correspondente no fluxo principal.
  - Verificar preenchimento dos campos:
    - Caso não tenha sido informada nenhuma opção de filtragem, o sistema exibe a mensagem **Informe pelo menos uma opção de seleção** e retorna para o passo 1 do fluxo principal.
  - Nenhum registro encontrado:
    - Caso a busca não retorne nenhum registro, o sistema exibe a mensagem **A pesquisa não retornou nenhum resultado** e retorna para o passo 1 do fluxo principal.
  - Verificar existência do setor comercial:
    - Caso o identificador do setor comercial não exista na tabela, o sistema exibe a mensagem **Setor Comercial inexistente** e retorna para o passo correspondente no fluxo principal.
  - Verificar existência da rota:
    - Caso o identificador da rota não exista na tabela ou a rota não pertença ao setor comercial informado, o sistema exibe a mensagem **Rota inexistente** e retorna para o passo correspondente no fluxo principal.
  - Verificar informação do setor comercial:
    - Caso o setor comercial não seja informado, o sistema exibe a mensagem **Informar Setor Comercial** e retorna para o passo correspondente no fluxo principal.
</columns>

\\
===== Modelo R0591 - Relatório Clientes Especiais =====
<WRAP center round box 100%>
{{  :ajuda:relatorios:big_clientes.jpg?nolink  |}}
</WRAP>

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

^Campo^Preenchimento dos Campos^
|**Gerência Regional**|Selecione, entre as opções disponibilizadas pelo sistema, a gerência regional para a qual deseja os dados do relatório.|
|**Unidade de Negócio**|Selecione, entre as opções disponibilizadas pelo sistema, a unidade de negócio para a qual deseja os dados do relatório. |
|**Localidade Inicial**|Informe o código da localidade inicial do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. O nome da localidade será exibido ao lado do campo. Para apagar o conteúdo do campo, clique em {{:ajuda:relatorios:borracha.gif?nolink|}} ao lado do campo de exibição. Ao digitar o conteúdo no campo inicial, este é replicado no campo final correspondente; ao limpar o conteúdo do campo inicial, este é limpo no campo final correspondente e os campos **Setor Comercial Inicial, Rota Inicial, Localidade Final, Setor Comercial Final e Rota Final** são habilitados.|
|**Setor Comercial Inicial**|Informe o código do setor comercial inicial do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. O nome da localidade será exibido ao lado do campo. Para apagar o conteúdo do campo, clique em {{:ajuda:relatorios:borracha.gif?nolink|}} ao lado do campo de exibição. Ao digitar o conteúdo no campo inicial, este é replicado no campo final correspondente; ao limpar o conteúdo do campo inicial, este é limpo no campo final correspondente.|
|**Rota Inicial**|Informe o código da rota inicial vinculada ao setor com, no máximo, quatro dígitos.|
|**Localidade Final**|Informe o código da localidade final do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. O nome da localidade será exibido ao lado do campo. Para apagar o conteúdo do campo, clique em {{:ajuda:relatorios:borracha.gif?nolink|}} ao lado do campo de exibição.|
|**Setor Comercial Final**|Informe o código do setor comercial final do imóvel com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a localidade desejada. O nome da localidade será exibido ao lado do campo. Para apagar o conteúdo do campo, clique em {{:ajuda:relatorios:borracha.gif?nolink|}} ao lado do campo de exibição.|
|**Rota Final**|Informe o código da rota final vinculada ao setor com, no máximo, quatro dígitos.|
|**Perfil do Imóvel**|Selecione, da lista disponibilizada pelo sistema, o perfil do imóvel que deseja visualizar no relatório. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.|
|**Categoria**|Selecione, da lista disponibilizada pelo sistema, a categoria do imóvel que deseja visualizar no relatório. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.|
|**Subcategoria**|Selecione, da lista disponibilizada pelo sistema, a subcategoria do imóvel que deseja visualizar no relatório. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.|
|**Situação da Ligação de Água**|Selecione, da lista disponibilizada pelo sistema, a situação da ligação de água que deseja visualizar no relatório.|
|**Situação da Ligação de Esgoto**|Selecione, da lista disponibilizada pelo sistema, a situação da ligação de esgoto que deseja visualizar no relatório.|
|**Intervalo de Quantidade de Economias**|Informe o intervalo que selecionará os imóveis por quantidades de economias. Quando o intervalo inicial for informado, o valor é replicado no intervalo final, caso este não esteja preenchido ou esteja preenchido com o mesmo valor, permitindo alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial.|
|**Intervalo de Consumo de Água**|Informe o intervalo que selecionará os imóveis por consumo de água. Para imóveis que não tiverem consumo de água, o sistema considera, se houver, o consumo de esgoto no intervalo informado. Quando o intervalo inicial for informado, o valor é replicado no intervalo final, caso este não esteja preenchido ou esteja preenchido com valor igual, permitindo alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial.|
|**Intervalo de Consumo de Esgoto**|Informe o intervalo que selecionará os imóveis por consumo de esgoto. Quando o intervalo inicial for informado, o valor é replicado no intervalo final, caso este não esteja preenchido ou esteja preenchido com o mesmo valor, permitindo alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial.|
|**Cliente Responsável**|Informe o código do cliente responsável pelo imóvel com até sete dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar o cliente desejado.|
|**Intervalo de Consumo por Responsável**|Informe o intervalo com até quatro dígitos, para selecionar os imóveis que possuam relação ativa do tipo **Responsável** com clientes, configurados pelo somatório dos consumos de água ou de esgoto por cliente responsável, e que esteja no intervalo informado. Quando o intervalo inicial for informado, é replicado o valor semelhante no intervalo final, caso este não esteja preenchido ou esteja preenchido com o mesmo valor, permitindo a alteração para valor maior que o inicial. Quando o intervalo inicial for limpo, o intervalo final deve ser limpo se for igual ao inicial.|
|**Data de Instalação do Hidrômetro**|Informe, no formato DD/MM/AAAA, para imóveis que possuam hidrômetro instalado e cuja data de instalação esteja compreendida no intervalo informado, ou clique no botão {{:ajuda:relatorios:calendarrio.jpg?nolink|}}, para selecionar uma data desejada.|
|**Capacidade do Hidrômetro**|Selecione, da lista disponibilizada pelo sistema, a capacidade do hidrômetro em metros cúbicos/hora. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.|
|**Tarifa de Consumo**|Selecione, da lista disponibilizada pelo sistema, a tarifa de consumo do imóvel. É possível escolher mais de uma opção, pressionando a tecla **Ctrl** enquanto clica.|
|**Anormalidade de Leitura**|Informe com até três dígitos ou clique em {{:ajuda:relatorios:botao_lupa.jpg?nolink|}} para selecionar a anormalidade desejada. Em seguida, marque ou **Sim** ou **Não** ou **Todos**, indicando se a anormalidade deve cobrir ou não os imóveis do relatório.|
|**Anormalidade de Consumo**|Selecione a anormalidade de consumo da lista disponibilizada pelo sistema. Em seguida, marque ou **Sim** ou **Não** ou **Todos**, indicando se a anormalidade de consumo deve cobrir ou não os imóveis do relatório.|

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

^Botão^Descrição da Funcionalidade^
|{{:ajuda:relatorios:botao_lupa.jpg?nolink|}}|Ao clicar neste botão, o sistema realiza uma consulta do campo desejado na base de dados do sistema.|
|{{:ajuda:relatorios:borracha.gif?nolink|}}|Ao clicar neste botão, o sistema apaga o conteúdo do campo em exibição.|
|{{:ajuda:relatorios:calendarrio.jpg?nolink|}}| Utilize este botão para selecionar uma data no calendário, no formado DD/MM/AAAA (dia, mês, ano), como demonstrado **[[=ajuda:pesquisar_calendario|aqui]]**.|
|{{:ajuda:relatorios:esfregao.jpg?nolink|}}| Ao clicar neste botão, o sistema limpa o conteúdo de todos os campos da tela.|
|{{:ajuda:relatorios:botao_cancelar.jpg?nolink|}}| Ao clicar neste botão, o sistema cancela a operação e retorna para a tela do menu inicial.|
|{{:ajuda:relatorios:botaoo_filtrar.jpg?nolink|}}| Ao clicar neste botão, o sistema gera o relatório de clientes especiais a partir da seleção de parâmetros de filtro.|

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

**[[=postgres:relatorios|Relatórios]]**

==== Termos Principais ====

**[[=ajuda:relatorio|Relatórios]]**

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

~~ODT~~
~~NOSIDEBAR~~