Base de Conhecimento de Gestão Comercial de Saneamento

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
[[:ajuda|{{ :ajuda:gsan-arrecadacao.png?nolink&200|}}]]
====== Registrar Movimento dos Arrecadadores ======
<columns>
O objetivo desta funcionalidade é registrar o movimento dos agentes arrecadadores. Esse movimento diz respeito aos arquivos enviados pelos bancos, referentes aos recebimentos de contas, débito automático, guias de pagamento, entre outros, conforme o tipo de movimento recebido.
</columns>

<columns>
Para a **CAERN**, essa rotina de arrecadação foi ajustada para reconhecer e tratar os novos tipos de documento (//extratos de débito e guias de pagamento//) modelo **Carteira 17**, que serão recepcionados através dos movimentos de ficha de compensação. Nesse caso, a rotina que trata a recepção do código de barras da ficha de compensação //identifica// os tipos de documento //extrato de débito// e //guia de pagamento//. Além disso, para as contas pagas no formato **Carteira 17**, na composição do **Nosso Número**, caso o //Tipo do Documento// seja preenchido com **00**, o sistema recupera a conta através do //Identificador do Documento// preenchido com o **Número do Boleto**.

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

Feito isso, o sistema acessa a tela abaixo:

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

<columns>
Dependendo da seleção no campo **Qual a forma de processamento?**, a tela é visualizada com campos diferentes. Acima, temos a opção **Processamento de arquivos disponível em diretório**. Nela, clique em {{:ajuda:arrecadacao:rd_botoao.jpg?nolink|}} para confirmar os arquivos no diretório informado. Caso o diretório esteja sem arquivos, o sistema alerta, conforme modelo **[[=ajuda:arrecadacao:registrar_movimento_dos_arrecadadores#tela_de_sucesso|AQUI]]**.

Ao selecionar a opção **Upload de arquivo**, o sistema acessa a tela a seguir:
</columns>

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

<columns>
Nesse caso, informe todos os campos, obrigatoriamente, e clique no botão {{:ajuda:arrecadacao:boton_registrar_ma.jpg?nolink|}}. Para detalhes sobre o preenchimento clique **[[=ajuda:arrecadacao:registrar_movimento_dos_arrecadadores#preenchimento_dos_campos|AQUI]]**.

**Atenção**: o processamento pode ser acompanhado, através da opção **[[=ajuda:batch:filtrar_processo|Consultar Processo Iniciado]]**.

Na consulta do processo será apresentada uma coluna contendo o nome do processo, o agente arrecadador, o número sequencial do arquivo (NSA), e o tipo de movimento (débito automático, código de barras, ou ficha de compensação), permitindo acompanhar o processamento da mesma forma que são acompanhados os processos batch. A unidade de processamento é o registro do arquivo, e a barra de processamento avança à medida que os registros do arquivo são processados.

Em seguida, o sistema efetua algumas validações antes de registrar o novo movimento:

  * 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//.
    * 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 existência do arquivo de movimento de arrecadador:
    * Caso o arquivo de movimento de arrecadador informado não exista no diretório padrão, o sistema exibe a mensagem //Arquivo de Movimento de Arrecadador Inexistente//.
  * Verificar existência de dados no arquivo:
    * Caso o arquivo esteja sem dados, o sistema exibe a mensagem //Arquivo <<nome do arquivo >> sem dados// e encerra a operação.
  * Verificar a existência do registro código Z:
    * Caso até o final do arquivo não seja encontrado o registro código Z ou, antes do fim do arquivo seja encontrado outro registro código A, o sistema exibe a mensagem //Arquivo de Movimento Não Possui o registro código “Z” (Trailler)// e encerra a operação.
  * Verificar a existência de registros com código inválido:
    * Caso o tipo de movimento (campo A10) seja igual a //CODIGO DE BARRAS// e existam no arquivo registros com código diferente de A, G e Z, o sistema exibe a mensagem //Arquivo de Movimento Contém Registros Com Código Inválido// e encerra a operação.
    * Caso o tipo de movimento (campo A10) não seja igual a //CODIGO DE BARRAS// e existam no arquivo registros com código igual a G, o sistema exibe a mensagem //Arquivo de Movimento Contém Registros Com Código Inválido// e encerra a operação.
  * Validar código de movimento:
    * Caso o código do movimento (campo B07) seja diferente de 1 e 2, atribuir o valor //CÓDIGO DE MOVIMENTO INVÁLIDO// ao campo Descrição da Ocorrência do Movimento.
  * Validar data de opção/exclusão:
    * Caso a data de opção/exclusão (campo B05) esteja inválida atribuir o valor //DATA DE OPÇÃO/EXCLUSÃO INVÁLIDA// ao campo Descrição da Ocorrência do Movimento.
  * 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 e encerra a operação.
  * Validar data de débito/pagamento:
    * Caso a data de débito/pagamento esteja inválida, atribui o valor //DATA DE DÉBITO/PAGAMENTO INVÁLIDA// ao campo Descrição da Ocorrência do Movimento.
    * Caso a data de débito/pagamento seja posterior à data corrente:
    * Caso o tipo do registro seja F e o campo F07 seja igual a 00 ou 31, atribui o valor //DATA DE DÉBITO/PAGAMENTO POSTERIOR A DATA CORRENTE// ao campo Descrição da Ocorrência do Movimento.
    * Caso contrário o tipo de registro seja diferente de F, atribui o valor //DATA DE DÉBITO/PAGAMENTO POSTERIOR A DATA CORRENTE// ao campo Descrição da Ocorrência do Movimento.
  * Validar ano/mês de referência:
    * Caso o ano/mês de referência esteja inválido, atribui o valor //ANO/MÊS DE REFÊNCIA DA CONTA INVÁLIDO// ao campo Descrição da Ocorrência do Movimento.
  * Validar valor debitado/recebido:
    * Caso o valor debitado/recebido contenha caracteres não numéricos, atribui o valor //VALOR DEBITADO/RECEBIDO NÃO NUMÉRICO// ao campo Descrição da Ocorrência do Movimento.
  * Validar matrícula do imóvel:
    * Caso a matrícula do imóvel contenha caracteres não numéricos, atribui o valor //MATRÍCULA DO IMÓVEL INVÁLIDA// ao campo Descrição da Ocorrência do Movimento.
  * Validar data do crédito:
    * Caso a data do crédito esteja preenchida (valor diferente de brancos) e esteja  inválida, atribui o valor //DATA DE CRÉDITO INVÁLIDA// ao campo Descrição da Ocorrência do Movimento.
  * Verificar existência da forma da arrecadação:
    * Caso a forma de arrecadação não seja encontrada, atribui o valor correspondente a guichê de caixa a forma de arrecadação. 
  * Inserir o Dígito Verificador na Matrícula do Imóvel:
    * Caso esteja processando movimento da **Empresa=CAER**, <<Inclui>> Dígito Verificador Módulo 11, passando a matrícula do imóvel sem o dígito e agregando o dígito verificador obtido ao final da matrícula do imóvel.
  * Verificar a existência do registro código 9:
    * Caso até o final do arquivo não seja encontrado o registro código 9 ou, antes do fim do arquivo seja encontrado outro registro código 0, o sistema exibe a mensagem //Arquivo de Movimento Não Possui o registro código 9 (Trailler de Arquivo)// e encerra a operação.
  * Verificar a existência de registros com código inválido na ficha de compensação:
    * Caso existam no arquivo registros com código diferente de 0, 1, 3, 5 e 9, o sistema exibe a mensagem //Arquivo de Movimento Contém Registros Com Código Inválido// e encerra a operação.
  * Validar data de débito/pagamento da ficha:
    * Caso a data de débito/pagamento esteja inválida, o sistema exibe a mensagem //DATA DE DÉBITO/PAGAMENTO INVÁLIDA// ao campo.
  * Descrição da Ocorrência do Movimento:
    * Caso a data de débito/pagamento seja posterior a data corrente, o sistema exibe a mensagem //DATA DE DÉBITO/PAGAMENTO POSTERIOR A DATA CORRENTE// ao campo Descrição da Ocorrência do Movimento.
  * Validar valor debitado/recebido da ficha:
    * Caso o valor debitado/recebido contenha caracteres não numéricos, o sistema exibe a mensagem //VALOR DEBITADO/RECEBIDO NÃO NUMÉRICO// ao campo Descrição da Ocorrência do Movimento.
  * Validar código para débito automático:
    * Caso o código para débito automático contenha caracteres não numéricos, atribui o valor //CÓDIGO PARA DÉBITO AUTOMÁTICO INVÁLIDO// ao campo Descrição da Ocorrência do Movimento.
</columns>

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

\\
====== Preenchimento dos Campos ======
^Campo^Preenchimento dos Campos^
|Arrecadador|Campo obrigatório - Informe o código do arrecadador, ou clique no botão {{:ajuda:lupa.gif?nolink|}} para seleiconar o arrecadador desejado. O nome 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 arrecadador, clique no link **[[:ajuda:pesquisar_arrecadador|Pesquisar Arrecadador]]**.|
|Tipo Movimento|Campo obrigatório - Selecione uma das opções disponibilizadas pelo sistema.|
|Código Convênio|Campo obrigatório - Selecione uma das opções disponibilizadas pelo sistema.\\ Caso exista apenas um convênio com o agente arrecadador, este será exibido automaticamente pelo sistema e não permite alteração.|
|Nome Arquivo|Campo obrigatório - Clique no botão {{:ajuda:arrecadacao:escolher_arquivo.jpg?nolink|}} para selecionar o arquivo de movimento dos arrecadadores a serem incluídos no sistema.|
\\

====== Funcionalidade dos Botões ======
^Botão^Descrição da Funcionalidade^
|{{:ajuda:arrecadacao:rd_botoao.jpg?260|}}| Botão visualizado na opção **Processamento de arquivos disponível em diretório**. Ao clicar nele, o sistema confirma os arquivos no diretório informado. Caso o diretório esteja sem arquivos, o sistema informa conforme modelo **[[=ajuda:arrecadacao:registrar_movimento_dos_arrecadadores#tela_de_sucesso|AQUI]]**.|
|{{: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:escolher_arquivo.jpg?nolink|}}|Ao clicar neste botão, o sistema permite selecionar um arquivo contendo o movimento dos arrecadadores para uma pasta específica.|
|{{:ajuda:arrecadacao:boton_registrar_ma.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a execução do comando de registro dos arrecadadores.|
|{{:ajuda:arrecadacao:desfazer.jpg?nolink|}}|Ao clicar neste botão, o sistema desfaz o último procedimento realizado.|
|{{:ajuda:arrecadacao:ccancelar.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|

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

**[[=postgres:arrecadacao:uc0242| Registrar Movimento dos Arrecadadores]]**


==== Termos Principais ====

**[[:ajuda:Arrecadação:Movimento dos Arrecadadores]]**

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

**[[=treinamentos:livre:video-aulas:registrar_movimento_dos_arrecadadores|Registrar Movimento dos Arrecadadores]]**


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

~~ODT~~