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-atendimento.png?nolink&200|}}]]
====== Consultar Arquivo Texto das Ordens de Serviço de Visita ======
<columns>
Esta funcionalidade tem como objetivo consultar os arquivos textos das ordens de serviço de visitas. A opção pode ser acessada via **Menu de Sistema**, no caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:atendimento|Atendimento ao Público]] > [[:ajuda:Ordem de Serviço]] > [[:ajuda:Inspeção de Anormalidade]] > Consultar Arquivo Texto das Ordens de Serviço de Visita**.
</columns>

Feito isso, o sistema visualiza a tela abaixo:

==== 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:1408_consultar_arquivo_texto_os.jpg?nolink  |}}
</WRAP>  

<columns>
Acima, informe, obrigatoriamente, o código da localidade, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a localidade desejada e tecle **Enter**. O nome da localidade será exibido 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. Opcionalmente, são fornecidos outros campos para consulta (para detalhes sobre o preenchimento dos demais campos clique **[[=ajuda:consultar_arquivo_texto_das_ordens_de_servico_de_visita#preenchimento_dos_campos|AQUI]]**).

Para comandar a execução da consulta, clique no botão {{:ajuda:selecionar.png?nolink|}}. O sistema exibe a tela a seguir:
</columns>

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

<columns>
Caso queira consultar as informações das ordens de serviço de visitas geradas para cada arquivo texto, clique sobre o //link// **Nome do Agente Comercial**, e o sistema exibirá a tela em duas abas:
  * Anormalidade;
  * Fotos.
</columns>

<WRAP center round box 100%>
{{  :ajuda:atend_-_os_inspanorm-consultarqtxtosvisitas-aba_anormalidade.png?nolink  |}}
</WRAP> 


<WRAP center round box 100%>
{{  :ajuda:atend_-_os_inspanorm-consultarqtxtosvisitas-aba_fotos.png?nolink  |}}
</WRAP> 

<columns>
Para atualizar, clique no checkbox apresentado e, em seguida, clique no botão {{:ajuda:atualizaros.png?nolink|}}.

Para alterar o **Agente Comercial**, selecione uma das opções disponibilizadas pelo sistema e clique no botão {{:ajuda:mobile:botao_atualizar.jpg?nolink|}}.
</columns>

<WRAP center round box 100%>
{{  :ajuda:atend_-_os_inspanorm-consultarqtxtosvisitas-alteraagentcomerc.png?nolink  |}}
</WRAP> 

<columns>
Antes das atualizações, o sistema executa algumas **[[=ajuda:consultar_arquivo_texto_das_ordens_de_servico_de_visita#validacoes_do_sistema|validações]]**.

Na funcionalidade **Consultar Arquivo Texto das Ordens de Serviço de Visita**, caso seja identificada a existência de movimento para atualização dos dados do cliente usuário do imóvel, deverá ser chamada uma nova funcionalidade para a execução da atualização destes dados.

Com base no arquivo de retorno do dispositivo móvel, serão considerados apenas os dados listados a seguir, para atualização do cliente:
  * CPF ou CNPJ;
  * Nome do cliente;
  * RG (número, órgão expedidor e unidade federativa);
  * Fone (DDD, número e ramal).

São aplicadas as regras a seguir quanto à atualização dos dados do cliente:
  * Se o __Nome__ e o __CPF/CNPJ__ foram alterados:
    * Pesquisar um cliente na base com CPF/CNPJ alterado:
      * Caso encontre um cliente com o CPF/CNPJ alterado com o mesmo nome alterado do cliente, então finaliza a relação do cliente anterior com o imóvel e cria uma nova relação entre o cliente encontrado e o imóvel.
      * Caso exista um cliente com o CPF/CNPJ alterado, mas não tenha o mesmo nome do nome do cliente alterado, então finaliza a relação do cliente anterior com o imóvel. O cliente que tem esse CPF/CNPJ alterado é atualizado para que não mais tenha esse CPF/CNPJ. Um novo cliente é inserido na base com o nome e CPF/CNPJ alterados. Uma nova relação é criada entre esse novo cliente e o imóvel.
      * Caso não exista cliente com o CPF/CNPJ alterado, então finaliza a relação do cliente anterior com o imóvel e cria uma nova relação entre o novo cliente e o imóvel.
    * Se só o __Nome__ foi alterado:
      * Finaliza a relação do cliente anterior com o imóvel e cria uma nova relação entre o novo cliente e o imóvel.
    * Se só o __CPF/CNPJ__ foi alterado:
      * Pesquisa um cliente na base com CPF/CNPJ alterado:
        * Caso encontre um cliente com o CPF/CNPJ alterado com o mesmo nome do cliente, então finaliza a relação do cliente anterior com o imóvel e cria uma nova relação entre o cliente encontrado e o imóvel.
        * Caso encontre um cliente com o CPF/CNPJ alterado, mas não tenha o mesmo nome do nome do cliente, então atualiza o campo CPF/CNPJ para nulo e atualiza o CPF/CNPJ do cliente para o valor alterado.
        * Caso não encontre um cliente com o CPF/CNPJ alterado, então atualiza o campo CPF/CNPJ do cliente para o valor alterado.

No arquivo contendo o movimento para atualização dos dados do cliente, a partir do dispositivo móvel, serão marcados os que efetivamente tiveram a atualização realizada com sucesso, bem como são registradas qualquer ocorrência de erro, inconsistência, entre outras, que tenham impedido a referida atualização. As mesmas validações realizadas nas funcionalidades de **[[=ajuda:inserir_cliente|Inserir Cliente]]** e **[[=ajuda:manter_cliente|Manter Cliente]]** serão executadas nesta nova funcionalidade.

A funcionalidade foi alterada para ser gerada uma situação especial de faturamento para o imóvel, quando forem atendidos os critérios a seguir:
  * A anormalidade encontrada estiver associada a uma identificação de situação especial de faturamento;
  * Ter havido ações de substituição / instalação de hidrômetro para o imóvel em período recente (nos últimos NN meses, conforme parâmetro cadastrado no sistema parâmetros);
  * Ter ocorrido pelo menos XX vezes a mesma anormalidade de hidrômetro para o imóvel em período recente (ocorrência de XX vezes nos últimos NN meses, conforme parâmetros cadastrados no sistema parâmetros).
</columns>

==== Validações do Sistema ====
<columns>
  * Verificar existência da localidade:
    * Caso o código da localidade informada não exista na tabela LOCALIDADE com indicador de uso igual a ativo, o sistema exibe a mensagem: //Localidade inexistente//.
  * Verificar existência do setor comercial:
    * Caso o código do setor comercial informado não exista no sistema com indicador de uso igual a ativo, o sistema exibe a mensagem: //Setor Comercial inexistente//.
    * Caso o código do setor comercial informado não pertença à localidade informada, o sistema exibe a mensagem: //Setor Comercial não pertence à localidade informada <<localidade informada>>//.
  * Verificar existência da quadra:
    * Caso o código da quadra informada não exista na tabela QUADRA com indicador de uso igual a ativo, o sistema exibe a mensagem: //Quadra inexistente//.
    * Caso o código da quadra informado não pertença ao setor comercial informado, o sistema exibe a mensagem: //Quadra não pertence ao setor comercial informado <<setor comercial informado>>//.
  * Verificar atributos iniciais e finais:
    * Caso seja informado o atributo inicial e não seja informado o atributo final, o sistema exibe a mensagem: //Informe <<nome do atributo>> final//.
    * Caso seja informado o atributo final e não seja informado o atributo inicial, o sistema exibe a mensagem: //Informe <<nome do atributo>> inicial//;
    * Caso o conteúdo do atributo final seja menor (inferior, anterior) ao conteúdo do atributo inicial, o sistema exibe a mensagem: //<<Nome do atributo>> Final é menor que o <<Nome do atributo>> Inicial//.
  * Nenhum registro encontrado:
    * Caso a seleção não encontre nenhum registro com os filtros selecionados, o sistema exibe a mensagem: //Nenhum Arquivo Texto para o Roteiro Empresa foi encontrado para a solicitação informada//.
  * Verificar situação das ordens de serviço:
    * Caso alguma das ordens de serviço associadas não esteja encerrada, o sistema exibe a mensagem: //Existem ordens de serviço não encerradas associada ao arquivo texto, confirma a mudança de situação do arquivo para finalizado? Sim ou Não// . Caso //Sim//, continuar o processamento.
  * Verificar situação do arquivo:
    * Caso algum dos  arquivos selecionados esteja na situação //Disponível// e não exista //Agente Comercial Informado// e o usuário solicita //Liberar Arquivo//, o sistema exibe a mensagem: //Existe arquivo selecionado sem agente comercial informado//.
    * Caso algum dos  arquivos selecionados esteja na situação //Disponível// e o usuário solicita a //Não Liberação do Arquivo//, o sistema exibe a mensagem: //Existe arquivo selecionado na situação de disponível//.
    * Caso algum dos  arquivos selecionados esteja na situação //Disponível// e o usuário solicita a //Colocar Arquivo em Campo//, o sistema exibe a mensagem: //Existe arquivo selecionado na situação de disponível, não pode ser colocado em campo//.
    * Caso algum dos  arquivos selecionados esteja na situação //Disponível// e o usuário solicita a //Não Liberação do Arquivo//, o sistema exibe a mensagem: //Existe arquivo selecionado na situação de disponível//.
    * Caso algum dos arquivos selecionados esteja na situação //Liberado// e o usuário solicita a //Colocar Arquivo em Campo//, o sistema exibe a mensagem: //Existe arquivo selecionado na situação de liberado, não pode ser colocado em campo. Usar a funcionalidade de transmissão do Arquivo//.
    * Caso o arquivo esteja na situação //Liberado// e o usuário solicita a //Liberar Arquivo//, o sistema exibe a mensagem: //Existe arquivo selecionado já liberado//.
    * Caso o arquivo esteja na situação //Finalizado// e o usuário solicita a //Finalizar Arquivo//, o sistema exibe a mensagem: //Existe arquivo selecionado já Finalizado//.
    * Caso o arquivo esteja na situação //Finalizado// e o usuário solicita a //Não Liberar Arquivo//, o sistema exibe a mensagem: //Existe arquivo selecionado já Finalizado//.
    * Caso o arquivo esteja na situação //Em Campo// e o usuário solicita a //Colocar Arquivo Em Campo//, o sistema exibe a mensagem: //Arquivo selecionado já em campo//.
    * Caso o arquivo esteja na situação //Em Campo// e o usuário solicita a //Liberar Arquivo//, o sistema exibe a mensagem: //Arquivo selecionado já em campo e não pode ser liberado//.
    * Caso o arquivo esteja na situação //Em Campo// e o usuário solicita a //Não Liberar Arquivo//, o sistema exibe a mensagem: //Arquivo selecionado em campo e não pode ser não liberado//.
    * Caso o arquivo esteja na situação //Em Campo// e o usuário solicita //Informa Agente Comercial//, o sistema exibe a mensagem: //Arquivo selecionado em campo, não é permitido alterar Agente Comercial//.
    * Caso o arquivo esteja na situação //Finalizado// e o usuário solicita //Informa Agente Comercial//, o sistema exibe a mensagem: //Existe arquivo selecionado já Finalizado//.
</columns>

\\

====== Tela de Sucesso ======
<WRAP center round box 100%>
{{  :ajuda:atend_-_os_inspanorm-consultarqtxtosvisitas-tela_sucesso.png?nolink  |}}
</WRAP> 
\\
====== Preenchimento dos Campos ======
^Campo^Orientações para Preenchimento^
|Localidade|Campo obrigatório - Informe o código da localidade, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_localidade|Pesquisar Localidade]]**, para selecionar a localidade desejada, tecle Enter, e o nome da localidade será exibido 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.|
|Setor Comercial Inicial|Informe o código do setor comercial, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_setor_comercial|Pesquisar Setor Comercial]]**, para selecionar o setor desejado, o nome do setor será exibido 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.|
|Setor Comercial Final|Informe o código do setor comercial, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_setor_comercial|Pesquisar Setor Comercial]]**, para selecionar o setor desejado, o nome do setor será exibido 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.|
|Quadra Inicial|Informe a quadra inicial.|
|Quadra Final|Informe a quadra final.|
|Agente Comercial|Selecione uma das opções disponibilizadas pelo sistema.|
|Situação Arquivo Texto|Selecione uma das opções disponibilizadas pelo sistema. \\ **Regra associada**: Caso já exista um arquivo texto para o comando, a localidade, o intervalo do setor comercial //maior// ou //igual// ao setor comercial inicial informado, e o intervalo da quadra //menor// ou //igual// à quadra final informada; e se no intervalo informado existe alguma ocorrência nos campos seelcionados, o sistema exibe mensagem de crítica.|

\\

====== 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 na base de dados.|
|{{:ajuda:borracha.gif?nolink|}}|Ao clicar neste botão, o sistema permite apagar o conteúdo do campo em exibição.|
|{{:ajuda:desfazer.png?nolink|}}|Ao clicar neste botão, o sistema desfaz o último procedimento realizado.|
|{{:ajuda:relatorios:botaoo_cancelarr.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|
|{{:ajuda:selecionar.png?nolink|}}|Ao clicar neste botão, o sistema executa a seleção com base dos parâmetros informados para consulta.|
|{{:ajuda:liberar.png?nolink|}}|Ao clicar neste botão, o sistema libera o arquivo.|
|{{:ajuda:naoliberar.png?nolink|}}|Ao clicar neste botão, o sistema não libera o arquivo.|
|{{:ajuda:emcampo.png?nolink|}}|Ao clicar neste botão, o sistema disponibiliza o arquivo para o campo.|
|{{:ajuda:finalizar.png?nolink|}}|Ao clicar neste botão, o sistema finaliza o arquivo.|
|{{:ajuda:informaragentecom.png?nolink|}}|Ao clicar neste botão, o sistema permite atualizar o agente comercial.|
|{{:ajuda:setaadireitaavancar.png?nolink|}}|Ao clicar neste botão, o sistema avança para aba seguinte.|
|{{:ajuda:atualizaros.png?nolink|}}|Ao clicar neste botão, o sistema comanda o processamento de atualização de OS.|
|{{:ajuda:relatorios:2botao_voltar.jpg?nolink|}}|Ao clicar neste botão, o sistema retorna à aba anterior.|
|{{:ajuda:fechar.png?nolink|}}|Ao clicar neste botão, o sistema fecha a tela de popup.|
|{{:ajuda:mobile:botao_atualizar.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda o processamento de atualização.|

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

**[[=postgres:atendimento_ao_publico:uc1220|Gerar Arquivo Texto para as Ordens de Serviço de Visita]]**

**[[=ajuda:mobile|Mobilidade]]**

==== Termos Principais ====

**[[=ajuda:o#ordem_de_servico|Ordem de Serviço]]**



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