[[ajuda:cobranca|{{:ajuda:gsan-cobranca.png?nolink&200|}}]]
[[:ajuda|{{ :ajuda:gsan-faturamento.png?nolink&200|}}]]
====== Informar Itens de Contrato de Serviço ======
<columns>
O objetivo desta funcionalidade é informar os itens de um contrato de prestação de serviço. Ela pode ser acessada via **Menu de Sistema**, através do caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:micromedicao|Micromedição]] > Acompanhamento de Serviços de Hidrômetro > Informar Itens de Contrato de Serviço**. Ou: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Faturamento]] > [[:ajuda:Item de Contrato]] > Informar Itens de Contrato de Servico**.
</columns>

Feito isso, o sistema acessa a tela a seguir:
==== Observação ====
^Informamos que os dados exibidos nas telas mais abaixo são fictícios, e não retratam informações de clientes.^

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

<columns>
Acima, selecione, obrigatoriamente, a empresa. Só depois de informada a empresa é que o sistema exibe os números de contrato disponíveis. Escolha o número ao qual o item será incluído e informe os demais campos, de acordo com as instruções de preenchimento **[[=ajuda:cobranca:informar_itens_de_contrato_de_servico#preenchimento_dos_campos|AQUI]]**. Feito isso, clique em {{:ajuda:cobranca:b_concluir_manam.jpg?nolink|}}.

**Atenção:** O boletim de cobrança para a nova sistemática não terá cálculo de taxa de sucesso na quitação dos débitos do cliente. Para isso, o valor da taxa de sucesso será opcional.

**Atenção**: no campo **Valor Desconto Penalidade para o item de contrato**, informe com até oito dígitos e duas casas decimais, o valor que penaliza as ordens encerradas por //decurso de prazo// ou outras penalidades de //fiscalização// (que manterá um multiplicador para cada tipo de ocorrência). Dessa forma, o sistema calcula as penalidades de //decurso de prazo// e de //fiscalização//, usando o valor informado aqui, no item de contrato.

  - No caso de //decurso de prazo//, o sistema utiliza, no lugar do valor do item de contrato, o valor informado de penalidade do contrato.
  - No caso de penalidade de //fiscalização//, o sistema utiliza, no lugar do valor pago pela ordem de serviço, o valor informado de penalidade do contrato, multiplicando pelo índice do motivo de não aceitação, //caso exista//.
\\

No campo **Tipo de Serviço**, clique em {{:ajuda:lupa.gif?nolink|}} para selecionar o tipo de serviço associado ao contrato, conforme exemplo **[[=ajuda:pesquisar_tipo_de_servico|AQUI]]**. Caso queira selecionar uma **Atividade**, repita o procedimento e acesse a //popup// descrita **[[=ajuda:pesquisar_atividade_do_tipo_de_servico|AQUI]]**. Depois, utilize o botão {{:ajuda:cobranca:as.jpg?nolink|}} para adicionar o tipo de serviço e a atividade selecionadas. Caso queira remover algum item, clique em {{:ajuda:arrecadacao:x_excluir.jpg?nolink|}}.

Para incluir um aditivo, informe as datas de inicio do aditivo e do fim do aditivo, no formato dd/mm/aaaa (dia, mês, ano), ou clique no botão {{:ajuda:calendario.gif?nolink|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar as datas desejadas. O sistema fará a validação das datas. Em seguida, clique no botão {{:ajuda:cobranca:75656_adicionar.jpg?nolink|}}.
</columns>

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

<columns>
Durante o preenchimento dos campos, o sistema efetua algumas validações. São elas:

  - Validações do sistema:
    - Verificar existência da empresa:
      - Caso a empresa não exista no cadastro do sistema, o sistema exibe a mensagem: //Empresa  inexistente//.
    - Validar data:
      - Caso a data informada esteja inválida, o sistema exibe a mensagem: //Data Inválida//.
      - Caso a data informada fim de contrato esteja menor ou igual que a data início do contrato, o sistema exibe a mensagem: //Data final deve ser maior que data inicial//.
    - Informar pelo menos um item do contrato:
      - Caso o usuário não tenha informado itens para o contrato, o sistema exibe a mensagem: //Informe pelo menos um item do contrato//.
    - 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 //<<descrição da função>> efetuada com sucesso//.
    - Validar a Taxa de Sucesso:
      - Caso o valor da taxa de sucesso ou igual a zeros ou nulo, o sistema exibe a mensagem: //Valor taxa de sucesso inválido//.
    - Validar Tipo de Serviço:
      - Caso o tipo de serviço informado não exista no sistema, o sistema exibe a mensagem: //Tipo de Serviço inexistente//.
    - Validar Tipo de Serviço Existente:
      - Caso o tipo de serviço já tenha sido informado para o item de contrato, o sistema exibe a mensagem: //O Tipo de Serviço selecionado já foi informado para este Item de Contrato//.
</columns>

\\
==== Tela de Sucesso ====
<WRAP center round box 100%>
{{  :ajuda:fat_-_informaritenscontratoservico_-_telasucesso.png?nolink  |}}
</WRAP>

\\
==== Preenchimento dos Campos ====
^Campo^Preenchimento dos Campos^
|**Empresa**|Campo obrigatório - Selecione a empresa entre as opções disponibilizadas pelo sistema.|
|**Número do Contrato**|Campo obrigatório - Ao selecionar a empresa, o número do contrato cadastrado será exibido e não permite alteração.\\ Caso a empresa não tenha contrato cadastrado, será permitido informar o número do contrato.|
|**Data de Inicio do Contrato**|Campo obrigatório - 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|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar a data desejada.\\ Caso já exista contrato cadastrado, o sistema exibe este campo e não permite alteração.|
|**Data de 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|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar a data desejada.|
|**Valor Global do Contrato**|Informe o valor do contrato, com o tamanho máximo de 12 (doze) dígitos, sendo duas casas decimais.|
|**Percentual Taxa de Sucesso**|Informe o percentual referente a taxa de sucesso, com 5 (cinco) dígitos, com duas casas decimais.|
|**Observação**|Caso deseje colocar alguma observação sobre o contrato, este campo disponibiliza até 400 (quatrocentos) caracteres.|
|**Município Principal do Contrato**|Selecione o município principal do contrato, da lista disponibilizada pelo sistema.|
|**Percentual Mínimo Execução**|Informar o percentual mínimo para execução dos serviços de instalação e substituição de hidrômetro. Para mais detalhes sobre **[[treinamentos:livre:processos:processo_de_gestao_de_micromedicao|Processo de Gestão de Micromedição]]** acesse o link associado ao nome.|
|**Percentual Serviços Rejeitados**|Informar o percentual de serviços rejeitados no contrato, no processo de gestão de micromedição. Para mais detalhes sobre **[[treinamentos:livre:processos:processo_de_gestao_de_micromedicao|Processo de Gestão de Micromedição]]** acesse o link associado ao nome.|
|**Contrato com Administração Local**| Indicar a existência ou não de um contrato com administração local.|
|**Item de Contrato**|Campo obrigatório - Selecione uma das opções disponibilizadas pelo sistema.|
|**Valor do Item**|Campo obrigatório - Informe o valor do item, com o tamanho máximo de 12 (doze) dígitos, sendo duas casas decimais.|
|**Tipo de Serviço**|Informe o código do tipo de serviço, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar o tipo desejado, conforme tela de pesquisa abaixo. O tipo de serviço 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.|
|**Atividade**| Informar a atividade executada no itens de contrato ou clique no botão {{:ajuda:lupa.gif?nolink|}} para selecionar a atividade desejada. A atividade  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.|
|**Percentual de Serviços Não Executados /  Não Aceitos para Aplicação de Multa**|Informe o percentual referente a taxa de sucesso, com 4 (quatro) dígitos, com duas casas decimais.|
|**Percentual da Multa a Ser Aplicada Quando o Percentual Acima For Atingido**|Informe o percentual referente a taxa de sucesso, com 4 (quatro) dígitos, com duas casas decimais.|
|**Quantidade Orçada para o Item de Contrato**|Informe a quantidade orçada para o item, com o tamanho máximo de 8 (oito) dígitos, sendo duas casas decimais.|
|**Valor Orçado para o Item de Contrato**|Informe o valor orçado para o item de contrato, com o tamanho máximo de 10 (dez) dígitos, sendo duas casas decimais.|
|**Valor Desconto Penalidade para o item de contrato**|Informe com até oito dígitos e duas casas decimais, o valor que penaliza as ordens encerradas por //decurso de prazo// ou outras penalidades de //fiscalização//. Dessa forma, o sistema calcula as penalidades de //decurso de prazo// e de //fiscalização//, usando o valor informado aqui, no item de contrato.|
|**Itens do Contrato**|Nesta tabela serão exibidos os itens do contrato.\\ Para remover um item cadastrado, clique no botão  {{:ajuda:arrecadacao:x_excluir.jpg?nolink|}} na coluna //Remover//.|
|**Aditivos**|Nesta tabela serão exibidos os aditivos para o contrato.|
\\

==== Funcionalidade dos Botões ====
^Botão^Descrição da Funcionalidade^
|{{: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), link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**.|
|{{: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:cobranca:75656_adicionar.jpg?nolink|}}|Ao clicar neste botão, o sistema permite adicionar um novo item de contrato.|
|{{:ajuda:incluiraditivo.png?120|}}|Ao clicar neste botão, o sistema permite adicionar um novo aditivo ao contrato.|
|{{:ajuda:arrecadacao:x_excluir.jpg?nolink|}}|Ao clicar neste botão, o sistema remover um item cadastrado.|
|{{:ajuda:cobranca:bp.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a execução de pesquisa de Tipo de Serviço, com base nos parâmetros informados.|
|{{:ajuda:limpar.jpg?nolink|}}|Ao clicar neste botão, o sistema limpa o conteúdo dos campos na tela.|
|{{:ajuda:relatorios:botao_cancelar.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|
|{{:ajuda:relatorios:concluir.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a inserção do item do contrato nas bases de dados do sistema.|

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

**[[=postgres:micromedicao:uc1055|Informar Valor de Item de Serviço Por Contrato]]**

==== Termos Principais ====

**[[=ajuda:faturamento|Faturamento]]**


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