Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- uc2235 [26/01/2026 14:41] – [[SB0001] - Pesquisar Guia de Pagamento Imóvel] claudio.lira
+++ uc2235 [26/01/2026 18:09] (atual) – [[SB0001] - Pesquisar Guia de Pagamento Imóvel] claudio.lira
@@ Linha 21: / Linha 21: @@
   - O sistema exibe tela para receber os filtros de pesquisa das guias de pagamento em revisao:
-      - **Imóvel**: o usuário informa ou pesquisa a matrícula do imóvel;
+      - **Imóvel**: o usuário informa ou pesquisa a matrícula do imóvel:** [FS0001-VALIDAR IMÓVEL];**
         - Caso seja informado/pesquisado o imóvel, desabilitar o filtro de cliente;
-      - **Cliente**: o usuário informa ou pesquisa o código de cleinte;
+      - **Cliente**: o usuário informa ou pesquisa o código de cleinte: **[FS0002-VALIDAR CLIENTE;**
         - Caso seja informado/pesquisado o código do cliente, desabilitar o filtro de imóvel;
       - **Incluir Guias com Pagamento**: ( ) SIM ( ) NÃO (selecionar entre SIM E NAO);
@@ Linha 39: / Linha 39: @@
       - **Motivo de Revisão**: exibir relação com as descrição dos motivos de revisão: **o usuário poderá selecionar um ou mais motivos;**
         - Selecionar **cmrv_dsmotivorevisaoconta**  da tabela faturamento.conta_motivo_revisao com cmrv_icuso = 1;
-  - O sistema pesquisa as guias de pagamento em revisão
+      - **Botões de Açoes**:
-      - Caso o usuário tenha informado matrícula do imóvel** [SB0001 - Pesquisar Guia de Pagamento Imóvel]**;
+        - **LIMPAR**: Caso selecionado, limpar os filtros informados e retornar para o item 1 do fluxo principal;
-      - Caso o usuário tenha informado código de cliente** [SB0002 - Pesquisar Guia de Pagamento Cliente]**;;
+        - **CANCELAR**: Caso selecionado, retornar para o menu principal do sistema;
+        - **GERAR**: Caso selecionado, o sistema pesquisa as guias de pagamento em revisão para geração do relatório:
+          - Caso o usuário tenha informado matrícula do imóvel** [SB0001 - Pesquisar Guia de Pagamento Imóvel]**;
+          - Caso o usuário tenha informado código de cliente** [SB0002 - Pesquisar Guia de Pagamento Cliente]**;;
   - Encerra o caso de uso.
@@ Linha 58: / Linha 61: @@
         - **gpag_dtvencimento >= data inicial do intervalo**  e **gpag_dtvencimento <= data final do intervalo**;
       - **Motivo de Revisão**: selecionar guias de pagamento com **cmrv_id**  correspondente aos motivos de revisao selecionados;
-  - Caso o filtro de **INCLUIR GUIAS COM PAGAMENTO = SIM, **Selecionar as guias da tabela **faturamento.guia_pagamento_historico **de acordo com os filtros informados com:
+  - Caso o filtro de **INCLUIR GUIAS COM PAGAMENTO = SIM;**
-      - **IMOV_ID = matrícula do imóvel informada/pesquisada;**
+      - Selecionar as guias da tabela **faturamento.guia_pagamento_historico **de acordo com os filtros informados com:
-      - **Intervalo Data de Revisão: **selecionar apenas guias de pagamento cuja a data de revisão estaja dentro do intervalo de data de revisão informado;.
+        - **IMOV_ID = matrícula do imóvel informada/pesquisada;**
-        - **gpag_dtrevisao >= data inicial do intervalo**  e **gpag_dtrevisao <= data final do intervalo**;
+        - **Intervalo Data de Revisão: **selecionar apenas guias de pagamento cuja a data de revisão estaja dentro do intervalo de data de revisão informado;.
-      - **Intervalo Data de Emissão: **selecionar apenas guias de pagamento cuja a data de emissão estaja dentro do intervalo de data de emissão informado;.
+          - **gpag_dtrevisao >= data inicial do intervalo**  e **gpag_dtrevisao <= data final do intervalo**;
-        - **gpag_dtemissao >= data inicial do intervalo**  e **gpag_dtemissao <= data final do intervalo**;
+        - **Intervalo Data de Emissão: **selecionar apenas guias de pagamento cuja a data de emissão estaja dentro do intervalo de data de emissão informado;.
-      - **Intervalo Data de Vencimento: **selecionar apenas guias de pagamento cuja a data de vencimento estaja dentro do intervalo de data de vecimento informado;.
+          - **gpag_dtemissao >= data inicial do intervalo**  e **gpag_dtemissao <= data final do intervalo**;
-        - **gpag_dtvencimento >= data inicial do intervalo**  e **gpag_dtvencimento <= data final do intervalo**;
+        - **Intervalo Data de Vencimento: **selecionar apenas guias de pagamento cuja a data de vencimento estaja dentro do intervalo de data de vecimento informado;.
-      - **Motivo de Revisão**: selecionar guias de pagamento com **cmrv_id**  correspondente aos motivos de revisao selecionados;
+          - **gpag_dtvencimento >= data inicial do intervalo**  e **gpag_dtvencimento <= data final do intervalo**;
+        - **Motivo de Revisão**: selecionar guias de pagamento com **cmrv_id**  correspondente aos motivos de revisao selecionados;
+  - **Processar as guias de pagamentos retornadas**:
+      - Caso tenha retornado guias de pagamentos da tabela **guia_pagamento ou guia_pagamento_historico **o sistema gera o relatório com as guias de pagamentos de imóvel:
+        - Gerar Relatório Guia Pagamento Imóvel:** [SB0003- Gerar Relatório Guia de Imóvel];**
+      - Caso Contrário:** [FS0003-Dados Não Retornados]**;
-==== [SB0002] - Gerar relatório ====
+==== [SB0003] - Gerar relatório Guia de Imóvel ====
-  - O sistema gera o relatório conforme layout abaixo:
+  - O sistema gera o relatório com as guias de pagamento de imóvel conforme layout abaixo:
-      - Dados do filtro;
+      - **Título**: Relatório de Guias de Pagamento em Revisão por RGL;
-      - **Detalhe**: a partir da tabela IMOVEL_ATLZ_CADASTRAL_DM, para cada imóvel selecionado:
+      - **Dados dos filtros informados**:
-        - Inscrição:
+        - Intervalo da data de revisão;
-          - LOCA_ID;
+        - Intervalo da data de emissão;
-          - IMAC_CDSETORCOMERCIAL;
+        - Intervalor da data de vencimento;
-          - IMAC_NNQUADRA;
+      - **Identificação do imóvel**:
-          - IMAC_NNLONTE;
+        - RGL: imov_id da guia de pagameno;
-          - IMAC_NNSUBLOTE;
+        - Endereço do imóvel: exbir o endereço do imóvel formatado (logradouro/número/complemento/bairro/cidade/uf);
-        - Matrícula: IMOV_ID;
+        - Cliente Usuário Atual: exbir clie_nmcliente da tabela cadasro.cliente com clie_id = clie_id da tabela cliente_imovel com:
-        - Endereço: **Inclui** **[[:postgres:geral:inclui:uc0085|[UC0085 - Obter Endereço]]]** , passando os dados do endereço a partir da tabela IMOVEL_OCORR_ATLZ_CAD_DM;
+          - imov_id = imov_id da guia de pagamento;
-        - Hidrômetro: HIAC_NNHIDROMETRO da tabela HID_INST_HIST_ATL_CAD_DM com IMAC_ID = id do imóvel selecionado;
+          - crtp_id = 2 (relação de usuário);
-        - Cadastrador: USUR_NMUSUARIO da tabela USUARIO com USUR_NMLOGIN = IMAC_NMLOGIN ou USUR_NNCPF = IMAC_NMLOGIN ;
+          - clim_dtrelacaofim = nulo (usuário atual);
-        - Data Ocorrência: IMAC_TMVISITA;
+      - **Detalhe por guia de pagamento selecionada**:
-        - Ocorrência Cadastro: exibe a lista de ocorrências do imóvel (COCR_DSCADASTROOCORRENCIA da tabela CADASTRO_OCORRENCIA onde COCR_ID = COCR_ID da tabela IMOVEL_OCORR_ATLZ_CAD_DM com IMAC_ID = IMAC_ID selecionado);
+        - Para cada guia de pagamento retornada exibir os dados da guia de pagamento em revisão:
-        - Ocorrência de Hidrômetro: LTAN_DSLEITURAANORMALIDADE da tabela LEITURA_ANORMALIDADE com LTAN_ID = LTAN_ID da tabela IMOVEL_ATLZ_CADASTRAL_DM;
+          - **Número da Guia**: gpag_id
-          - Observação: REAT_DSOBSERVACAORETORNO
+          - **Data Emissão**: gpag_dtemissao(dd/mm/aaaa);
+          - **Data de Vencimento**: gpag_dtvencimento(dd/mm/aaaa);
+          - **Valor da Guia**: gpag_vldebito;
+          - **Data de Revisão**: gpag_dtrevisao(dd/mm/aaaa);
+          - **Motivo de Revisão**: cmrv_dsmotivorevisaoconta;
+      - **Total: **exibir no final do relatório:
+        - **Quantidade de guias em Revisão**: exibir a quantidade de guias;
+        - **Valor total das guias em revisão**: exibir o somatório de gpag_vldebito das guiasr
+**Fluxos Secundários:**
-**Fluxos Secundários:**
+**[FS0001] - Validar Imóvel**
+  - O sistema pesquisa a matrícula do imóvel informado: selecionar **imov_id**  na tabela cadastro.imovel com **imov_id = matrícula informada**;
+      - **Cáso a pesquisa não retorne o imóvel, **exibir mensagem: **'Matrícula do imóvel informada não existe'**  e retornar para o item 1 do fluxo principal;
+**[FS0002] - Validar Cliente**
+  - O sistema pesquisa o código do cliente informado: selecionar **clie_id**  na tabela cadastro.cliente com **clie_id = código do cliente informado**;
+      - **Cáso a pesquisa não retorne o cliente, **exibir mensagem: **'Código do cliente informado não existe'**  e retornar para o item 1 do fluxo principal;
+**[FS0003] - Dados Não Retornados**
+  - Exibir mensagem: **'Não foram encontrados dados para os filtros informados'**  e retornar para o item 1 do fluxo principal;