[[:ajuda|{{ :ajuda:gsan-arrecadacao.png?nolink&200|}}]]
====== Manter Agência Bancária ======
<columns>
O objetivo desta funcionalidade é manter ou atualizar as bases de dados do cadastro de agência bancária. Ela pode ser acessada via **Menu de sistema**, no caminho: **[[:Ajuda:pagina_inicial|GSAN]] > [[:Ajuda:Arrecadação]] > [[:ajuda:Arrecadação:Aviso Bancário]] > Manter Agência Bancária**.
</columns>

Feito isso, o sistema acessa a tela de filtro a seguir:

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

<columns>
Acima, o sistema exibe a tela de filtro, onde devem ser informados os parâmetros necessários à seleção. Informe os parâmetros que julgar necessários e clique no botão {{:ajuda:arrecadacao:filtrar_1509.jpg?nolink|}}. Em seguida, o sistema exibe a próxima tela:
</columns>

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

<columns>
Acima, o sistema permite gerar o relatório das **Agências Bancárias Cadastradas**, clicando no botão {{:ajuda:impressora2.jpg?nolink|}}, conforme **[[=ajuda:arrecadacao:manter_agencia_bancaria#modelo_de_relatorioagencias_bancarias_cadastradas|modelo]]**.

Caso queira excluir um item cadastrado, marque o checkbox correspondente e clique no botão {{:ajuda:arrecadacao:remover_1509.jpg?nolink|}}. Para remover todos os itens, clique no link **__Todos__** e em seguida clique no mesmo botão. Caso queira atualizar os dados da agência bancária, clique no link do campo **Cód.Banco**. Feito isso, o sistema acessa a tela de atualização.
</columns>

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

<columns>
Acima, faça as modificações que julgar necessárias e clique no botão {{:ajuda:arrecadacao:atualizar_1509.jpg?nolink|}} (para detalhes sobre o preenchimento dos campos clique **[[=ajuda:arrecadacao:manter_agencia_bancaria#preenchimento_dos_campos|AQUI]]**.

**Atenção**: o botão {{:ajuda:adicionar.png?nolink|}} fica indisponível quando existe endereço cadastrado.

Para remover um endereço cadastrado, clique no botão {{:ajuda:arrecadacao:excluir_1509.jpg?nolink|}}. Este campo é obrigatório no cadastramento da agência bancária, logo, o botão {{:ajuda:adicionar.png?nolink|}} volta a ficar disponível para a inserção do novo endereço. Ao clicar no link do campo **Endereço**, o sistema exibe a tela abaixo para possibilitar a alteração dos dados do endereço da agência bancária:
</columns>

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

<columns>
Para conhecer detalhes do preenchimento do campo **Logradouro**, clique no link **[[:ajuda:pesquisar_logradouro|Pesquisar Logradouro]]**. Para conhecer detalhes do preenchimento do campo **CEP**, clique no link **[[:ajuda:pesquisar_cep|Pesquisar CEP]]**. Para conhecer detalhes do preenchimento dos campos **Perímetro Inicial** e **Perímetro Final**, clique no link **[[:ajuda:pesquisar_logradouro|Pesquisar Logradouro]]**.

Informe os campos necessários e clique no botão {{:ajuda:arrecadacao:atualizar_1509.jpg?nolink|}}. Antes de atualizar os dados da agência bancária, o sistema efetua algumas validações:

  * Verificar preenchimento dos campos:
    * Caso o usuário não informe o conteúdo de algum campo necessário à atualização da agência bancária, o sistema exibe a mensagem //Informe <<nome do campo que não foi preenchido>>//.
  * Atualização realizada por outro usuário:
    * Caso o usuário tente atualizar uma agência bancária que já tenha sido atualizada durante a manutenção corrente, o sistema exibe a mensagem //Esse(s) registro(s) foi(ram) atualizado(s) ou removido(s) por outro usuário durante a operação. Realize uma nova manutenção//.
  * Agência bancária possui vínculos no sistema:
    * Caso o usuário tenha selecionado uma agência bancária que possua outros vínculos no sistema, o sistema exibe a mensagem //Não é possível excluir a(s) gerência(s) regional(is) selecionada(s) devido a vínculos com outras informações//.
  * 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.
</columns>

====== Tela de Sucesso ======
<WRAP center round box 100%>
{{  :ajuda:arrecadacao:ttela_ab_ts_1509.jpg?nolink  |}}
</WRAP>

==== MODELO DE RELATÓRIO: AGÊNCIAS BANCÁRIAS CADASTRADAS ====
<WRAP center round box 100%>
{{  :ajuda:arrecadacao:bab_relatorio_1509.jpg?nolink  |}}
</WRAP>

====== Preenchimento dos Campos ======
^Campo^Preenchimento dos Campos^
|Banco|Campo obrigatório - Selecione uma das opções disponibilizadas pelo sistema.|
|Código da Agência Bancária|Campo obrigatório - Informe o código da agência bancária, com no máximo 5 (cinco) caracteres.|
|Nome da Agência Bancária|Campo obrigatório - Informe o nome da agência bancária, com no máximo 40 (quarenta) caracteres.|
|Endereço|Clique no link do campo **Endereço** para alterar os dados do endereço da agência bancária.|
|Telefone|Campo obrigatório - Informe o número de telefone, com no máximo 9 (nove) dígitos.|
|Ramal|Informe o número do ramal do telefone, com no máximo 4 (quatro) dígitos.|
|Fax|Informe o número do fax, com no máximo 9 (nove) dígitos.|
|E-Mail|Informe o e-mail válido da agência bancária, com no máximo 40 (quarenta) caracteres.|
\\



====== 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:fechar.png?nolink|}}|Ao clicar neste botão, o sistema fecha a tela em exibição.|
|{{:ajuda:limpar.jpg?nolink|}}|Ao clicar neste botão, o sistema limpa o conteúdo dos campos na tela.|
|{{:ajuda:adicionar.png?nolink|}}|Ao clicar neste botão, o sistema permite adicionar um novo endereço no cadastro de agência bancária.|
|{{:ajuda:arrecadacao:b_cancelar_.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|
|{{:ajuda:arrecadacao:filtrar_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a execução do filtro com base nos parâmetros informados.|
|{{:ajuda:impressora2.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda geração do relatório de agências bancárias cadastradas.|
|{{:ajuda:arrecadacao:excluir_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema exclui o endereço cadastrado e habilita o botão {{:ajuda:adicionar.png?nolink|}} para inserir novo endereço.|
|{{:ajuda:arrecadacao:remover_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema remove a(s) agência(s) bancária(s) selecionada(s) das bases de dados.|
|{{:ajuda:arrecadacao:voltar_f_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema retorna à tela de filtro.|
|{{:ajuda:arrecadacao:xb_voltar_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema volta à tela anterior.|
|{{:ajuda:Desfazer.png?nolink|}}|Ao clicar neste botão, o sistema desfaz o último procedimento realizado.|
|{{:ajuda:arrecadacao:atualizar_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a execução da atualização dos dados.|

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

**[[=postgres:arrecadacao:uc0516|Manter Agência Bancária]]**

**[[=postgres:arrecadacao:uc0515|Inserir Agência Bancária]]**


==== Termos Principais ====

**[[=ajuda:arrecadacao|Arrecadação]]**

===== Vídeos =====

**[[=treinamentos:livre:video-aulas:manter_agencia_bancaria|Manter Agência Bancária]]**


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