[[:ajuda|{{ :ajuda:gsan-arrecadacao.png?nolink&200|}}]]
====== Inserir Arrecadador ======
<columns>
O objetivo desta funcionalidade é inserir um agente arrecadador nas bases de dados do GSAN. Um agente arrecadador é um prestador de serviço ou um terceiro autorizado a receber os valores inerentes à atividade comercial. Todos os agentes arrecadadores devem ser cadastrados, para que se possa efetuar um controle dos valores recebidos por cada um deles.
</columns>

<columns>
A funcionalidade pode ser acessada via **Menu do sistema**, no caminho: **[[:Ajuda:pagina_inicial|GSAN]] > [[:Ajuda:Arrecadação]] > [[:ajuda:Arrecadação:Arrecadador]] > Inserir Arrecadador**.

Feito isso, o sistema acessa a tela a seguir:
</columns>

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

<columns>
Acima, informe obrigatoriamente o código do agente e o cliente. Os campos **Imóvel** e **Inscrição Estadual** são opcionais. Em seguida, clique no botão {{:ajuda:inserir.png?nolink|}}.

O sistema efetua algumas validações:

  * Verificar o preenchimento dos campos:
    * Caso o usuário não informe o conteúdo de algum campo necessário à inclusão do arrecadador, o sistema exibe a mensagem //Informe <<nome do campo que não foi preenchido>>//.
  * Verificar a existência do arrecadador:
    * Caso o código do agente arrecadador já exista, o sistema exibe a mensagem //Arrecadador 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>

====== Preenchimento dos Campos ======
^Campo ^Orientações para Preenchimento^
|Código do Agente|Campo obrigatório - Informe o código do agente arrecadador, com no máximo 3 (três) dígitos.|
|Cliente|Campo obrigatório - Informe o código do cliente, com no máximo 10 (dez) dígitos, ou clique no botão {{:Ajuda:lupa.gif?nolink|}} para selecionar o cliente desejado. O nome do cliente 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 obter detalhes sobre o preenchimento do campo //Cliente//, clique no //link// **[[:ajuda:pesquisar_cliente|Pesquisar Cliente]]**.|
|Imóvel |Informe a matrícula do imóvel, correspondente ao arrecadador, com no máximo 10 (dez) dígitos, ou clique no botão {{:Ajuda:lupa.gif?nolink|}} para selecionar o imóvel desejado. A identificação do imóvel 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 //Imóvel//, clique no //link// **[[:ajuda:pesquisar_imovel|Pesquisar Imóvel]]**.| 
|Inscrição Estadual |Informe a inscrição estadual válida, com no máximo 20 (vinte) caracteres.| 
\\

====== Tela de Sucesso ======
<WRAP center round box 100%>
{{  :Ajuda:arrec_-_inserirarrecadador_-_telasucesso.png?nolink  |}}
</WRAP>

====== 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: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 referente ao item de arrecadador.|

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

 **[[=postgres:arrecadacao:uc0506|Inserir Arrecadador]]**

==== Termos Principais ====

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


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