[[:ajuda|{{ :ajuda:gsan-arrecadacao.png?nolink&200|}}]]
====== Inserir contrato de arrecadador ======
<columns>
O objetivo desta funcionalidade é inserir o contrato de arrecadador 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:Arrecadador]] > Inserir Contrato de Arrecadador**.
</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:rwe353535_inserir_c.jpg?nolink  |}}
</WRAP>

<columns>
O usuário informa o período de vigência (data de início da vigência e data de fim da vigência), referente à tarifa de arrecadadores, criando assim um histórico para consultas posteriores. Dessa forma, é possível identificar a tarifa vigente em cada período e gerar as informações necessárias, sem a necessidade de alteração da tarifa atual para se obter as informações de períodos anteriores.

No momento da inserção da tarifa, o usuário informará a data de início de vigência da tarifa. Essa data terá que ser superior à data de início de vigência da última tarifa inserida no GSAN, pois o término da vigência da última tarifa anteriormente incluída será a data de início de vigência da nova tarifa **menos um dia**.

No momento da manutenção dos históricos de tarifas, não poderá ocorrer sobreposição de vigências nem intervalos de vigência entre as tarifas, ou seja, serão utilizadas as mesmas regras da inclusão de tarifas no processo de manutenção.

Informe os campos obrigatórios (para orientações sobre o preenchimento dos campos clique **[[=ajuda:arrecadacao:inserir_contrato_de_arrecadador#preenchimento_dos_campos|AQUI]]**). Em seguida, clique em {{:ajuda:adicionar.png?nolink|}}. Feito isso, o sistema preenche os campos do quadro **Tarifas Contrato**. Verifique as informações e clique em {{:ajuda:inserir.png?nolink|}} para a inserção do novo contrato do arrecadador.

Para pesquisar a **Conta Depósito Arrecadação** ou a **Conta Depósito Tarifa** clique no botão {{:ajuda:lupa.gif?nolink|}} ao lados dos respectivos campos. O sistema visualiza a janela abaixo:
</columns>

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

<columns>
Entre as opções disponibilizadas pelo sistema, selecione o **Banco** e a **Agência**. Depois, informe o **Número da Conta**. Em seguida, clique no botão {{:ajuda:arrecadacao:b_1509_pesquisar.jpg?nolink|}}.

**Atenção**: antes da inserção do contrato de arrecadador, 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 do contrato de arrecadador, o sistema exibe a mensagem **Informe <<nome do campo que não foi preenchido>>**.
  * 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 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.
  * Verificar se pessoa física:
    * Caso o cliente informado não seja uma pessoa física, o sistema exibe a mensagem **Cliente responsável pelo contrato de arrecadador deve ser do tipo PESSOA FÍSICA**.
  * Validar Data:
    * Caso a Data informada não seja uma data válida, o sistema exibe a mensagem **Data Inválida**.
  * Data Fim anterior a Data Início:
    * Caso a Data Início do Contrato seja superior à Data Fim do Contrato informado, o sistema exibe a mensagem **Data Início do Contrato deve ser anterior ou igual à Data Fim do Contrato**.
  * Verificar existência do contrato de arrecadador:
    * Caso o código do contrato já exista no sistema, o sistema exibe a mensagem **Contrato de Arrecadador já existe no cadastro**.
    * Caso exista no sistema um contrato arrecadador vigente, o sistema exibe a mensagem **Já existe no cadastro um Contrato de Arrecadador vigente**.
  * Validar tarifa:
    * Caso o valor informado seja igual ou menor que zero, o sistema exibe a mensagem **Valor da Tarifa Inválido**.
    * Caso o valor monetário não seja informado e percentual também não tenha sido informado, o sistema exibe a mensagem **Informar valor monetário da tarifa ou percentual para tarifa**.
    * Caso o percentual informa seja maior que 100,0 (cem), ou igual a 0,0 (zero), o sistema exibe a mensagem **Percentual informado para cálculo da tarifa inválido**.
  * Validar dias de **FLOAT**:
    * Caso a quantidade de dias de **FLOAT** informado seja igual ou menor que zero, o sistema exibe a mensagem **Quantidade de Dias de FLOAT inválido**.
  * Validar forma de arrecadação:
    * Caso a forma de arrecadação já tenha sido informada, o sistema exibe a mensagem **Forma de Arrecadação para o contrato já informada**.
    * Caso não tenha sido informada nenhuma forma de arrecadação, o sistema exibe a mensagem **Informe pelo menos uma forma de arrecadação**.
  * Validar Data de Vigência da tarifa:
    * Caso a Data informada não seja uma data válida, o sistema exibe a mensagem **Data Inválida**.
    * Caso a Data informada não faça parte do intervalo da data de vigência do contrato (data informada > Data Fim do Contrato ou data informada < Data Início do Contrato), o sistema exibe a mensagem **Data de início de vigência deverá fazer parte do intervalo da data de vigência do contrato**.
    * Caso exista tarifa cadastrada para a mesma forma de arrecadação, o sistema seleciona a data de inicio de vigência da ultima tarifa incluída anteriormente e, se essa data for maior ou igual a data de inicio de vigência da tarifa a ser incluída, o sistema exibe a mensagem **Data de início de vigência deverá ser superior a data de início de vigência da tarifa anteriormente cadastrada**.
  * Validar Contrato Arrecadador Existente:
    * O sistema verifica se já existe contrato arrecadador para o mesmo arrecadador informado, caso exista, o sistema exibe a mensagem **Contrato Arrecadador já cadastrado para o Arrecadador informado**.
</columns>

===== Preenchimento dos Campos =====
^Campo ^Orientações para Preenchimento^
|Arrecadador|Campo obrigatório - Selecione uma das opções disponibilizadas pelo sistema.|
|Número do Contrato|Campo obrigatório - Informe o número do contrato, com no máximo 10 (dez) dígitos.|
|Conta Depósito Arrecadação|Campo obrigatório - Clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a conta bancária para depósito da arrecadação. O sistema exibe na tela o código do banco arrecadador, o código da agência bancária, e o número da conta.\\ Este conjunto de informações deve conter no máximo 10 (dez) dígitos.\\ 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 **Conta Depósito Arrecadação**, clique no link **[[:ajuda:pesquisar_conta_bancaria|Pesquisar Conta Bancária]]**.|
|Conta Depósito Tarifa|Campo obrigatório - Clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a conta bancária para depósito da arrecadação. O sistema exibe na tela o código do banco arrecadador, o código da agência bancária, e o número da conta.\\ Este conjunto de informações deve conter no máximo 10 (dez) dígitos.\\ 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 **Conta Depósito Tarifa**, clique no link **[[:ajuda:pesquisar_conta_bancaria|Pesquisar Conta Bancária]]**.| 
|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 é 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 **Código do Cliente**, clique no link **[[:ajuda:pesquisar_cliente|Pesquisar Cliente]]**.|
|Código do Convênio|Campo obrigatório - Informe o código do Convênio com, no máximo 20 (vinte) caracteres. Esse código de convênio indica a cobrança de parcelamento do cliente responsável.|
|Código do Convênio Débito Automático|Campo obrigatório - Informe o código do Convênio para débito automático com, no máximo 20 (vinte) caracteres. Esse código de convênio indica a cobrança de parcelamento do cliente responsável via débito automático.|
|Concessionária|Selecione a concessionária, da lista disponibilizada pelo sistema.| 
|Indicador de Cobrança de ISS|Selecione a opção **Cobra ISS** para cobrar ISS, caso contrário, informe a opção **Não Cobra ISS**.| 
|Data Inicio do Contrato |Informe a data de inicio do contrato, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?nolink|}} para selecionar a data desejada. O sistema replica esta data para a data de fim do contrato.\\ Caso a data de inicio do contrato seja limpa, o sistema limpa também a data de fim do contrato.\\ Para obter detalhes sobre o preenchimento do campo de datas, clique no link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**.| 
|Data Fim do Contrato |Informe a data de fim do contrato, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?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]]**.|
|Tamanho Máximo para Identificação do Imóvel|Campo obrigatório - Informe o tamanho máximo para identificação do imóvel, com no máximo 2 (dois) dígitos.|
|E-mail |Campo obrigatório - Informe o e-mail, com no máximo 40 (quarenta) caracteres.|
|Indicador de Convênio para Cobrança de Parcelamento de Cliente Responsável  |Campo obrigatório - Selecione entre Sim ou não se o código de convênio que indica a cobrança de parcelamento do cliente responsável é considerado.|
|Forma|Campo obrigatório - Para cada forma de arrecadação, pelo menos uma forma deve ser informada, como também é obrigatório o preenchimento dos campos:\\ Valor da Tarifa;\\ Percentual da Tarifa;\\ Quantidade de dias do //FLOAT//;\\ Data de Inicio da Vigência.\\ Em seguida, clique no botão {{:ajuda:adicionar.png?nolink|}} e os dados serão exibidos no quadro da tela referente à //Tarifas Contrato//.|
|Valor da Tarifa|Campo obrigatório - Informe o valor correspondente a tarifa a ser utilizada pelo sistema para o arrecadador.|
|Percentual da Tarifa|Campo obrigatório - Informe o percentual correspondente a tarifa a ser utilizada pelo sistema para o arrecadador.|
|Quantidade de dias do FLOAT|Campo obrigatório - Informe a quantidade de dias do //FLOAT// bancário.|
|Data Inicio da Vigência|Campo obrigatório - Informe a data de inicio da vigência, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?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]]**.|
|Tarifas Contrato |Neste quadro serão exibidos os dados após ser clicado no botão {{:ajuda:adicionar.png?nolink|}}. Um item incluído neste quadro poderá ser removido, basta clicar no botão {{:ajuda:arrecadacao:excluir_1509.jpg?nolink|}}.|
\\

===== 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:calendario.gif?nolink|}}|Ao clicar neste botão, o sistema permite selecionar 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 link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**.|
|{{:ajuda:adicionar.png?nolink|}}|Ao clicar neste botão, o sistema adiciona os dados referentes à tarifa do contrato a ser inserido.|
|{{:ajuda:limpar.jpg?nolink|}}|Ao clicar neste botão, o sistema limpa o conteúdo dos campos na tela.|
|{{:ajuda:arrecadacao:excluir_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema remove o item selecionado.|
|{{: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 conclui os procedimentos de inserir o contrato arrecadador.|
|{{:ajuda:arrecadacao:b_1509_pesquisar.jpg?nolink|}}|Ao clicar neste botão, o sistema permite pesquisa a conta bancária do arrecadador.|

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

 **[[=postgres:arrecadacao:uc0509|Inserir Contrato de Arrecadador]]**

==== Termos Principais ====

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


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