[[:ajuda|{{ :ajuda:gsan-arrecadacao.png?nolink&200|}}]]
====== Inserir Agência Bancária ======
<columns>
O objetivo desta funcionalidade é inserir no cadastro do **GSAN** uma nova 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]] > Inserir Agência Bancária**.
</columns>

Feito isso, o sistema acessa a tela 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:inserir_ab_1_1509.jpg?nolink  |}}
</WRAP>

<columns>
Inicialmente o sistema exibe a tela acima. Informe os dados necessários para a inclusão dos dados cadastrais da nova agência bancária (para detalhes sobre o preenchimento dos campos,clique **[[=ajuda:arrecadacao:inserir_agencia_bancaria#preenchimento_dos_campos|AQUI]]**). Em seguida, clique no botão {{:ajuda:adicionar.png?nolink|}}.
</columns>

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

<columns>
Ao clicar no botão {{:ajuda:adicionar.png?nolink|}}, o sistema exibe a tela acima, para a inclusão do endereço da nova agência bancária. 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:inserir.png?nolink|}}.
<columns>

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

<columns>
Caso queira excluir as informações da nova agência e repetir o procedimento, clique em {{:ajuda:arrecadacao:x_excluir.jpg?nolink|}}. Caso confirme as informações, clique em {{:ajuda:inserir.png?nolink|}}.

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 à inclusão da agência bancária, o sistema exibe a mensagem //Informe <<nome do campo que não foi preenchido>>//.
  * Verificar existência da agência bancária:
    * Caso o código da agência bancária já exista, o sistema exibe a mensagem //Agência bancária já existe no cadastro//.
  * Verificar sucesso da operaçã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:tela_s_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 botão {{:ajuda:adicionar.png?nolink|}} para selecionar e incluir o 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:adicionar.png?nolink|}}|Ao clicar neste botão, o sistema exibe a tela para a inclusão do endereço da agência bancária.|
|{{: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:inserir.png?nolink|}}|Ao clicar neste botão, o sistema comanda a inserção dos dados nas bases de dados.|
|{{: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:arrecadacao:fechar.png?nolink|}}|Ao clicar neste botão, o sistema fecha a tela em exibição.|

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

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

==== Termos Principais ====

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

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

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


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