Diferenças

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

--- ajuda:arrecadacao:inserir_devolucoes [18/08/2015 20:44] – a edivaldo.alves
+++ ajuda:arrecadacao:inserir_devolucoes [21/03/2019 20:36] (atual) – tadeu.sarmento
@@ Linha 1: / Linha 1: @@
 [[:ajuda|{{ :ajuda:gsan-arrecadacao.png?nolink&200|}}]]
 ====== Inserir Devoluções ======
+<columns>
+O objetivo desta funcionalidade é inserir as devoluções nas bases de dados do **GSAN**. Ela pode ser acessada via **Menu do sistema**, no caminho **[[:Ajuda:pagina_inicial|GSAN]] > [[:Ajuda:Arrecadação]] > [[:ajuda:Arrecadação:Devolução]] > Inserir Devoluções**.
+</columns>
+Feito isso, o sistema visualiza a tela abaixo:
-O objetivo desta funcionalidade é inserir devoluções nas bases de dados do Gsan, podendo ser acessada no caminho [[:Ajuda:pagina_inicial|Gsan]] > [[:Ajuda:Arrecadação]] > [[:ajuda:Arrecadação:Devolução]] > Inserir Devoluções.
+===== Observação =====
+^Informamos que os dados exibidos nas telas e nos relatórios a seguir são fictícios e não retratam informações de clientes.^
+<WRAP center round box 100%>
+{{  :ajuda:arrecadacao:inserir_d_2109.jpg?nolink  |}}
+</WRAP>
-Valida data da devolução
+<columns>
-  * Caso a data da devolução esteja inválida, será exibida a mensagem “Data da Devolução inválida”.
+Informe os campos necessários à inclusão da guia de devolução e clique no botão {{:ajuda:inserir.png?nolink|}}. Para detalhes sobre o preenchimento dos campos clique **[[=ajuda:arrecadacao:inserir_devolucoes#preenchimento_dos_campos|AQUI]]**.
-  * Caso a data da devolução seja posterior à data corrente, será exibida a mensagem “Data da Devolução posterior à data corrente <<data corrente>>”.
-Verifica existência da guia de devolução
+Antes de inserir nova devolução, o sistema efetua algumas validações:
-  * Caso a guia de devolução não exista, será exibida a mensagem “Guia de Devolução inexistente”.
-Verifica preenchimento da guia de devolução
-  * Caso a guia de devolução esteja preenchida, não permite alteração.
-Verifica existência da localidade
+  * Validar data da devolução:
-  * Caso o código da localidade não exista no sistema, será exibida a mensagem “Localidade inexistente”.
+    * Caso a data da devolução esteja inválida, o sistema exibe a mensagem: //Data da Devolução inválida//.
+    * Caso a data da devolução seja posterior à data corrente, o sistema exibe a mensagem: //Data da Devolução posterior à data corrente <<data corrente>>//.
+  * Verificar existência da guia de devolução:
+    * Caso a guia de devolução não exista, o sistema exibe a mensagem: //Guia de Devolução inexistente//.
+  * Verificar preenchimento da guia de devolução:
+    * Caso a guia de devolução esteja preenchida, não permite alteração.
+  * Verificar existência da localidade:
+    * Caso o código da localidade não exista, o sistema exibe a mensagem: //Localidade inexistente//.
+  * Verificar existência da matrícula do imóvel:
+    * Caso a matrícula do imóvel informada não exista, o sistema exibe a mensagem: //Matrícula inexistente//.
+  * Verificar localidade da matrícula do imóvel:
+    * Caso tenha informado a Localidade e esta seja diferente da localidade da matrícula do imóvel, o sistema exibe a mensagem: //Localidade <<Código da Localidade do Imóvel>> da Matrícula do Imóvel é diferente da Localidade informada <<Localidade informada>>//; caso contrário, atribui a localidade da matrícula do imóvel ao campo Localidade.
+  * Verificar preenchimento do imóvel e do cliente:
+    * Caso informe a matrícula do imóvel, desabilita o Código do Cliente; caso contrário, habilita o Código do Cliente.
+    * Caso informe o Código do Cliente, desabilita a matrícula do imóvel; caso contrário, habilita a matrícula do imóvel.
+  * Verificar existência do código do cliente:
+    * Caso o código do cliente informado não exista no sistema, o sistema exibe a mensagem: //Cliente inexistente//.
+  * Validar referência da devolução:
+    * Caso a referência da devolução esteja inválida, o sistema exibe a mensagem: //Referência da Devolução inválida//.
+    * Caso a referência da devolução seja posterior ao mês e ano correntes, o sistema exibe a mensagem: //Referência da Devolução posterior ao Mês e Ano correntes <<mês e ano correntes>>//.
+  * 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 sucesso da transação:
+    * Caso o código de retorno da operação efetuada no banco de dados seja diferente de zero, o sistema exibe a mensagem conforme o código de retorno; caso contrário, exibe a mensagem //Devolução de código << Código da Devolução >> inserida com sucesso//.
+  * Verificar preenchimento da localidade:
+    * Caso tenha informado o cliente e não tenha sido informada a Localidade, o sistema exibe a mensagem: //O preenchimento do código da Localidade é obrigatório caso o Código do Cliente seja informado//.
+  * Verificar preenchimento da Guia de Devolução e dos Dados da Guia de Devolução:
+    * Caso a Guia de Devolução esteja preenchida, desabilita os Dados da Guia de Devolução; caso contrário, habilita os Dados da Guia de Devolução.
+    * Caso algum campo dos Dados da Guia de Devolução esteja preenchido, desabilita a Guia de Devolução; caso contrário, habilita a Guia de Devolução.
+  * Validar valor da devolução:
+    * Caso tenha sido informada a guia de devolução e o valor da devolução seja maior que o valor da devolução obtido a partir da Guia de Devolução, o sistema exibe a mensagem: //Valor da Devolução superior ao valor da Guia de Devolução <<valor da guia de devolução>>//. Confirma ou Cancela.
+  * Verificar existência do tipo de débito:
+  * Caso o tipo de débito não exista, o sistema exibe a mensagem: //Tipo de Débito inexistente//.
+</columns>
-Verifica existência da matrícula do imóvel
+===== Tela de Sucesso =====
-  * Caso a matrícula do imóvel informada não exista no sistema, será exibida a mensagem “Matrícula inexistente”.
+<WRAP center round box 100%>
+{{  :ajuda:arrecadacao:x1_inserir_devolucao.tsjpg.jpg?nolink  |}}
+</WRAP>
-Verifica localidade da matrícula do imóvel
+====== Preenchimento dos Campos ======
-  * Caso tenha informado a Localidade e esta seja diferente da localidade da matrícula do imóvel, será exibida a mensagem “Localidade <<Código da Localidade do Imóvel>> da Matrícula do Imóvel é diferente da Localidade informada <<Localidade informada>>”; caso contrário, atribui a localidade da matrícula do imóvel ao campo Localidade.
+^Campo^Preenchimento dos Campos^
+|Aviso Bancário|Campo obrigatório - Clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar o Aviso Bancário desejado. Os dados do aviso serão exibidos no campo ao lado.\\ Para consultar detalhes da seleção do aviso bancário, clique no link **[[:ajuda:pesquisar_aviso_bancario|Pesquisar Aviso Bancário]]**.\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
-Verifica preenchimento do imóvel e do cliente
+|Guia de Devolução|Informe o número da guia de devolução, com no máximo 9 (nove) dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a guia de devolução desejada. O nome é 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.|
-  * Caso informe a matrícula do imóvel, desabilita o Código do Cliente; caso contrário, habilita o Código do Cliente.
+|Localidade|Informe o número da Localidade, com no máximo 3 (três) dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a localidade desejada. O nome é exibido no campo ao lado.\\ Para consultar detalhes da seleção da localidade, clique no link [[:ajuda:pesquisar_localidade|Pesquisar Localidade]].\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
-  * Caso informe o Código do Cliente, desabilita a matrícula do imóvel; caso contrário, habilita a matrícula do imóvel.
+|Matrícula do Imóvel|Informe a matrícula do imóvel, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a matrícula desejada. A identificação é exibida 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.\\ Para obter detalhes sobre o preenchimento do campo **Matrícula do Imóvel**, clique no link **[[:ajuda:pesquisar_imovel|Pesquisar Imóvel]]**.|
+|Código do Cliente|Informe o código do cliente, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar o cliente desejado. O nome é exibido no campo ao lado.\\ Para consultar detalhes da seleção da localidade, clique no link **[[:ajuda:pesquisar_cliente|Pesquisar Cliente]]**.\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
+|Referência da Devolução|Informe a referência da devolução, no formado mm/aaaa (mês, ano).|
+|Tipo de Débito|Informe o tipo de débito, com no máximo 4 (quatro) dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar o tipo desejado. O nome do tipo de débito é 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.\\ Para consultar detalhes da seleção do tipo de débito, clique no link **[[:ajuda:pesquisar_tipo_de_debito|Pesquisar Tipo de Débito]]**.|
+|Valor da Devolução|Campo obrigatório - Informe o valor da devolução com duas casas decimais.|
+|Data da Devolução|Campo obrigatório - Informe a data da devolução, no formato dd/mm/aaaa (dia, mês, ano) ou clique no botão {{:ajuda:arrecadacao:calendario.png?nolink|}} para selecionar a data desejada.\\ Para obter detalhes sobre o preenchimento do campo de datas, clique no link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**.|
+\\
-Verifica existência do código do cliente
+====== Funcionalidade dos Botões ======
-  * Caso o código do cliente informado não exista no sistema, será exibida a mensagem “Cliente inexistente”.
+^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:arrecadacao:calendario.png?nolink|}}|Ao clicar neste botão, o sistema permite consultar uma data válida, no formato dd/mm/aaaa (dia, mês, ano).\\ Para obter detalhes sobre o preenchimento do campo de datas, clique no hiperlink **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**.|
+|{{:ajuda:Desfazer.png?nolink|}}|Ao clicar neste botão, o sistema desfaz o último procedimento realizado.|
+|{{:ajuda:arrecadacao:b_cancelar_.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|
+|{{:ajuda:inserir.png?nolink|}}|Ao clicar neste botão, o sistema comanda a inserção dos dados nas bases de dados do sistema.|
-Valida referência da devolução
+===== Referências =====
-  * Caso a referência da devolução esteja inválida, será exibida a mensagem “Referência da Devolução inválida”.
-  * Caso a referência da devolução seja posterior ao mês e ano correntes, será exibida mensagem “Referência da Devolução posterior ao Mês e Ano correntes <<mês e ano correntes>>”.
-Verifica existência de dados
+ **[[=postgres:arrecadacao:uc0272|Inserir Devoluções]]**
-  * Caso não exista a tabela na base de dados, será exibida a mensagem “Tabela <<nome da tabela>> inexistente” e cancela a operação.
-  * Caso a tabela esteja sem dados, será exibida a mensagem “Tabela <<nome da tabela>> sem dados para seleção” e cancela a operação.
-Verifica sucesso da transação
+==== Termos Principais ====
-  * Caso o código de retorno da operação efetuada no banco de dados seja diferente de zero, será exibida a mensagem conforme o código de retorno; caso contrário, exibe a mensagem “Devolução de código << Código da Devolução >> inserida com sucesso”.
-Verifica preenchimento da localidade
+**[[=ajuda:arrecadacao:guia_de_devolucao|Guia de Devolução]]**
-  * Caso tenha informado o cliente e não tenha sido informada a Localidade, será exibida a mensagem “O preenchimento do código da Localidade é obrigatório caso o Código do Cliente seja informado”.
-Verifica preenchimento da Guia de Devolução e dos Dados da Guia de Devolução
+**[[=ajuda:arrecadacao|Arrecadação]]**
-  * Caso a Guia de Devolução esteja preenchida, desabilita os Dados da Guia de Devolução; caso contrário, habilita os Dados da Guia de Devolução.
-  * Caso algum campo dos Dados da Guia de Devolução esteja preenchido, desabilita a Guia de Devolução; caso contrário, habilita a Guia de Devolução.
-Valida valor da devolução
+===== Vídeos =====
-  * Caso tenha sido informada a guia de devolução e o valor da devolução seja maior que o valor da devolução obtido a partir da Guia de Devolução, será exibida a mensagem “Valor da Devolução superior ao valor da Guia de Devolução <<valor da guia de devolução>>”. Confirma ou Cancela.
-Verifica existência do tipo de débito
+**[[=treinamentos:livre:video-aulas:inserir_devolucao|Inserir Devolução]]**
-  * Caso o tipo de débito não exista, será exibida a mensagem “Tipo de Débito inexistente”.
-Informe os campos necessários a inclusão da guia de devolução e clique no botão {{:ajuda:inserir.png?nolink|}}.
-{{:ajuda:arrecadacao:arrec_-_inserirdevolucao.png?nolink|}}
 \\
+Clique **[[:ajuda|aqui]]** para retornar ao Menu Principal do GSAN.
-====== Preenchimento dos Campos ======
-^Campo^Preenchimento dos Campos^
-|Aviso Bancário(*)|Campo obrigatório - Clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar o Aviso Bancário desejado. Os dados do aviso serão exibidos no campo ao lado.\\ Para consultar detalhes da seleção do aviso bancário, clique no link [[:ajuda:pesquisar_aviso_bancario|Pesquisar Aviso Bancário]].\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
-|Guia de Devolução|Informe o número da guia de devolução, com no máximo 9 (nove) dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a guia de devolução desejada. O nome 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.|
-|Localidade|Informe o número da Localidade, com no máximo 3 (três) dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a localidade desejada. O nome será exibido no campo ao lado.\\ Para consultar detalhes da seleção da localidade, clique no link [[:ajuda:pesquisar_localidade|Pesquisar Localidade]].\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
-|Matrícula do Imóvel|Informe a matrícula do imóvel, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a matrícula desejada. A identificação será exibida 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.\\ Para obter detalhes sobre o preenchimento do campo "Matrícula do Imóvel", clique no hiperlink [[:ajuda:pesquisar_imovel|Pesquisar Imóvel]].|
-|Código do Cliente|Informe o código do cliente, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar o cliente desejado. O nome será exibido no campo ao lado.\\ Para consultar detalhes da seleção da localidade, clique no link [[:ajuda:pesquisar_cliente|Pesquisar Cliente]].\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
-|Referência da Devolução|Informe a referência da devolução, no formado mm/aaaa (mês, ano).|
-|Tipo de Débito|Informe o tipo de débito, com no máximo 4 (quatro) dígitos, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar o tipo desejado. O nome do tipo de débito 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.\\ Para consultar detalhes da seleção do tipo de débito, clique no link [[:ajuda:pesquisar_tipo_de_debito|Pesquisar Tipo de Débito]].|
-|Valor da Devolução(*)|Campo obrigatório - Informe o valor da devolução com duas casas decimais.|
-|Data da Devolução(*)|Campo obrigatório - Informe a data da devolução, no formato dd/mm/aaaa (dia, mês, ano) ou clique no botão {{:ajuda:arrecadacao:calendario.png?nolink|}} para selecionar a data desejada.\\ Para obter detalhes sobre o preenchimento do campo de datas, clique no hiperlink [[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]].|
-\\
-= Funcionalidade dos Botões =
-|=Botão|=Descrição da Funcionalidade
-|[[image:Lupa.gif]]|Ao clicar neste botão, o sistema permite consultar um dado nas bases de dados.
-|[[image:Borracha.gif]]|Ao clicar neste botão, o sistema apaga o conteúdo do campo em exibição.
-|[[image:Calendario.gif]]|Ao clicar neste botão, o sistema permite consultar uma data válida, no formato dd/mm/aaaa (dia, mês, ano).
-Para obter detalhes sobre o preenchimento do campo de datas, clique no hiperlink [[Pesquisar Data - Calendário>>url:http://xwiki.ipad.com.br:8027/xwiki/bin/view/AjudaGSAN/calendario]].
-|[[image:Desfazer.png]]|Ao clicar neste botão, o sistema desfaz o último procedimento realizado.
-|[[image:cancelar2.jpg]]|Ao clicar neste botão, o sistema cancela o procedimento e retorna à tela principal.
-|[[image:http://192.168.64.215:8080/xwiki/bin/download/Arrecadacao/Inserir+Banco/Inserir.png?width=820||alt="Inserir.png"]]|Ao clicar neste botão, o sistema comanda a inserção dos dados nas bases de dados do sistema.
-\\
-\\
-\\
-Clique [[:ajuda|aqui]] para retornar ao Menu Principal do GSAN