[[:ajuda|{{ :ajuda:gsan-arrecadacao.png?nolink&200|}}]]
====== Inserir Devoluções ======
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**.
Feito isso, o sistema visualiza a tela abaixo:
===== 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.^
{{ :ajuda:arrecadacao:inserir_d_2109.jpg?nolink |}}
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]]**.
Antes de inserir nova devolução, o sistema efetua algumas validações:
* Validar data da devolução:
* 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 <>//.
* 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 <> da Matrícula do Imóvel é diferente da 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 <>//.
* Verificar existência de dados:
* Caso não exista a tabela na base de dados, o sistema exibe a mensagem: //Tabela <> inexistente// e cancela a operação.
* Caso a tabela esteja sem dados, o sistema exibe a mensagem: //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 <>//. 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//.
===== Tela de Sucesso =====
{{ :ajuda:arrecadacao:x1_inserir_devolucao.tsjpg.jpg?nolink |}}
====== 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 é 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 é 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 é 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]]**.|
\\
====== 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: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.|
===== Referências =====
**[[=postgres:arrecadacao:uc0272|Inserir Devoluções]]**
==== Termos Principais ====
**[[=ajuda:arrecadacao:guia_de_devolucao|Guia de Devolução]]**
**[[=ajuda:arrecadacao|Arrecadação]]**
===== Vídeos =====
**[[=treinamentos:livre:video-aulas:inserir_devolucao|Inserir Devolução]]**
\\
Clique **[[:ajuda|aqui]]** para retornar ao Menu Principal do GSAN.