Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- ajuda:batch:altera_arquivo_texto_-_processo_259 [06/10/2015 20:03] – a edivaldo.alves
+++ ajuda:batch:altera_arquivo_texto_-_processo_259 [16/01/2018 18:14] (atual) – [Preenchimento dos Campos] tadeu.sarmento
@@ Linha 1: / Linha 1: @@
 [[:ajuda|{{ :ajuda:gsan-batch.png?nolink&200|}}]]
 ====== Altera Arquivo Texto - Processo 259 ======
+<columns>
+O processo **[[:ajuda:Batch]] 259 - GERAR TXT OS CONTAS PAGAS PARCELADAS** é a rotina que tem o objetivo de baixar, no caso de parcelamento, a //ordem de serviço// de cobrança, quando a entrada do parcelamento (quando existir entrada), e cada conta paga, mesmo que não tenha sido quitado todo o débito, devem ser enviadas para a empresa. Nesse caso, deve-se sempre ser verificado se o comando está ativo.
+</columns>
+<columns>
+O comando da funcionalidade é acessado via **Menu de sistema**, no caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Batch]] > [[:Ajuda:batch:Inserir Processo]] > [[:ajuda:Batch:Processo Eventual ou mensal]] > Altera Arquivo Texto - Processo 259**. Feito isso, o sistema acessa a tela a seguir:
+</columns>
-O processo [[:ajuda:Batch]] 259 - GERAR TXT OS CONTAS PAGAS PARCELADAS é a rotina que tem o objetivo baixar a Ordem de Serviço de cobrança, no caso de parcelamento, quando a entrada do parcelamento (quando existir entrada), e cada conta paga, mesmo que não tenha sido quitado todo o débito, deve ser enviado para a empresa. - Deve sempre ser verificado se o comando está ativo.
+==== 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:batch:pe_batch.jpg?nolink  |}}
+</WRAP>
-A funcionalidade seleciona todas as ordens de serviços associadas aos comandos ativos e não será retirado o imóvel de cobrança.
+<columns>
+Acima, selecione o **Tipo de Processo** //Eventual// e clique em {{:ajuda:batch:setaadireitaavancar.png?nolink|}}. O sistema visualiza a tela abaixo:
+</columns>
-A alteração do arquivo TXT enviado para a empresa de cobrança por resultado, contempla as regras do boletim de medição da cobrança por resultado.
+<WRAP center round box 100%>
+{{  :ajuda:batch:ip_259.jpg?nolink  |}}
+</WRAP>
-As contas e guias objeto desta geração deverão está com pagamento com situação igual a Valor Não Confere, A Contabilizar e Classificado. Todas as outras situações não serão válidas para a geração do arquivo texto.
+<columns>
+Na tela acima, é possível selecionar o processo, agendar uma data e uma hora futura, bem como informar se há processo iniciado precedente.
-Incluídas no arquivo as contas pagas e incluídas no comando.
+O Processo é composto por três passos:
-Para garantir segurança e para validação dos valores enviados, será gerada uma tabela no banco de dados com o conteúdo dos arquivos com as seguintes informações:
+  - Gerar Arquivo Ordens de Serviço de Contas Pagas Parceladas;
+  - Incluir Contas em Cobrança;
+  - Gerar Arquivo Parcelamentos Negociados Empresa Cobrança.
-  * Ordem de Serviço;
+A funcionalidade gera o **TXT** para as empresas de cobrança com os parcelamentos negociados, incluindo o débito total negociado, valor da entrada, quantidade de parcelas, valor da parcela, descontos (se houver), débitos incluídos no parcelamento (conta a conta) e dia de vencimento.
-  * Comando de Cobrança;
-  * Data do envio data de pagamento;
-  * Informações do Pagamento:
-    * Guia de pagamento de entrada de parcelamento;
-    * Informações das contas pagas (incluídas ou enviadas);
-    * Informações do pagamento de parcelas de parcelamento.
-Esta tabela não terá funcionalidade de acesso, as auditorias deverão ser feitas através de acesso ao banco de dados.
+Foi criada uma nova funcionalidade **[[:ajuda:Batch]]** para geração do **TXT**, que deve ser enviado à empresa responsável pela cobrança. Essa rotina poderá ser executada semanalmente ou diariamente, conforme solicitação do usuário. Foi incluída uma informação no sistema que indica se o parcelamento já foi enviado para a empresa responsável pela cobrança (indicador de envio de TXT).
-O layout original do arquivo deve ser adequado para que este acompanhamento seja efetivo pela empresa de cobrança.
+O sistema seleciona todos os comandos de cobrança por resultado ativos, ou seja, cuja data de encerramento não esteja preenchido e ordena por empresa, pois gera um **TXT** para cada empresa responsável. De posse do comando, obtém todos os imóveis que pertencem ao comando, cujo motivo de retirada da conta esteja sem informação, verificando se existe algum parcelamento associado, cuja entrada tenha sido quitada ou não possua valor de entrada, e que o indicador de envio de **TXT** esteja sem informação.
-\\
-Para comandar o processamento [[:ajuda:Batch]], selecione a opção em "Tipo do Processo" **Processo Eventual** e, em seguida, clique no botão  {{:ajuda:batch:setaadireitaavancar.png?nolink|}}.
+Para cada parcelamento encontrado, é gerado um registro com as seguintes informações:
+  - Empresa;
+  - Número do Parcelamento;
+  - Valor Total Negociado;
+  - Valor da Entrada;
+  - Quantidade de Parcelas;
+  - Valor da Parcela;
+  - Valor de Desconto;
+  - Dia de Vencimento do imóvel, seguindo as regras do GSAN; e
+  - Referência da conta (Ano e Mês) com seu respectivo valor.
-{{:ajuda:batch:iniciarprocesso.png?nolink|}}
+Alterado o processo **259 - GERAR TXT OS CONTAS PAGAS PARCELADAS**, executado diariamente, para inclusão do campo **Faixa de Atraso de Débito**, no arquivo texto de retorno, e inclusão de tratamento para as contas canceladas.
-\\
-Na tela de "Inserir Processo Mensal ou Eventual", pode ser agendada para uma data e hora futura, bem como informar se há processo iniciado precedente.
+Foram realizados os seguintes procedimentos no **GSAN**:
-O Porocesso é composto dos steps:
+  - Incluído, no final do arquivo texto de retorno (posições 117 a 137), o campo //Faixa de Atraso de Débito//, para armazenar a informação da faixa de atraso de débito do imóvel: 3 a 6 contas; 7 a 24 contas ou acima de 24 contas. A faixa será selecionada de acordo com a empresa e o percentual da faixa de débito armazenado para o imóvel no GSAN;
+  - Incluído o tratamento para as contas canceladas, semelhante ao tratamento dado às contas quitadas e parceladas, retirando os imóveis da cobrança e enviando-os para o arquivo texto de retorno;
+  - No tratamento para as contas canceladas, será alterado o arquivo texto de retorno, para formatar o campo //Motivo do Encerramento// (posições 31 a 60), com o conteúdo **CANCELADA** e o campo //Indicador de Tipo de Pagamento// (posição 116) com brancos.
-  * Gerar Arquivo OS Contas Pagas Parceladas;
+As empresas que efetuam a cobrança por resultado e recepcionam este arquivo **TXT**, devem alterar seus sistemas para se adaptarem ao novo //layout// do arquivo, contemplando a faixa de débito e tratar o recebimento da conta na situação CANCELADA.
-  * Incluir Contas em Cobrança;
-  * Gerar Arquivo Parcelamentos Negociados Empresa Cobrança
-{{:ajuda:batch:inserirproc259_2.png?nolink|}}
+A funcionalidade seleciona todas as ordens de serviços associadas aos comandos ativos sem retirar o imóvel de cobrança. A alteração do arquivo **TXT** enviado para a empresa de cobrança por resultado, contempla as regras do boletim de medição da cobrança por resultado.
-\\
-A funcionalidade gera o TXT para as empresas de cobrança com os parcelamentos negociados, incluindo o débito total negociado, valor da entrada, quantidade de parcelas, valor da parcela, descontos se houver, débitos incluídos no parcelamento (conta a conta) e dia de vencimento.
+As contas e guias objeto desta geração deverão estar com pagamento com situação igual a //Valor Não Confere//, //A Contabilizar// e //Classificado//. Todas as outras situações não serão válidas para a geração do arquivo texto. Além disso, foram incluídas no arquivo as contas pagas e incluídas no comando.
-Criada uma nova funcionalidade [[:ajuda:Batch]] para geração do TXT, que deverá ser enviada à empresa responsável pela cobrança. Esta rotina poderá ser executada semanalmente ou diariamente, conforme solicitação do usuário.
+Para garantir segurança e para validação dos valores enviados, será gerada uma tabela no banco de dados com o conteúdo dos arquivos, contendo as seguintes informações:
-Incluída uma informação no sistema que indica se o parcelamento já foi enviado para a empresa responsável pela cobrança (indicador de envio de TXT).
+  - Ordem de Serviço;
+  - Comando de Cobrança;
+  - Data do envio data de pagamento;
+  - Informações do Pagamento:
+    - Guia de pagamento de entrada de parcelamento;
+    - Informações das contas pagas (incluídas ou enviadas);
+    - Informações do pagamento de parcelas de parcelamento.
-O sistema seleciona todos os comandos de cobrança por resultado ativos, ou seja, cuja data de encerramento não esteja preenchido e ordena por empresa, pois gera um TXT para cada empresa responsável.
+Esta tabela não terá funcionalidade de acesso, as auditorias deverão ser feitas através de acesso ao banco de dados. O //layout// original do arquivo deve ser adequado para que este acompanhamento seja efetivo pela empresa de cobrança.
+\\
-De posse do comando, obtém todos os imóveis que pertencem ao comando e, cujo motivo de retirada da conta esteja sem informação, verifica se existe algum parcelamento associado, cuja entrada do parcelamento tenha sido quitada ou não possua valor de entrada, e que o indicador de envio de TXT esteja sem informação.
+====== Preenchimento dos Campos ======
+^Campo^Preenchimento dos Campos^
+|Processo|Informe o número do processo **259 - GERAR TXT OS CONTAS PAGAS PARCELADAS** ou clique em {{:ajuda:lupa.gif?nolink|}} para **[[=ajuda:batch:pesquisar_processo|pesquisar o processo]]**.\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
+|Data do Agendamento|Campo obrigatório - Informe a data no formato dd/mm/aaaa (dia, mês, ano) para processamento da rotina, ou clique no botão {{:ajuda:batch:calendario.png?nolink|}}, link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**, para selecionar a data desejada.|
+|Hora do Agendamento|Campo obrigatório - Informe a hora para dar inicio ao processamento da rotina, no formato hh:mm:ss (hora, minuto, segundo).|
+|Processo Inciado Precedente|Caso exista um processo precedente, informe ou clique no botão {{:ajuda:lupa.gif?nolink|}} ao lado do campo. O nome do processo será exibido no campo ao lado.\\ Para apagar o conteúdo do campo, clique no botão  {{:ajuda:borracha.gif?nolink|}} que se encontra sob o campo.|
+\\
-Para cada parcelamento encontrado será gerado um registro com as seguintes informações:
+====== Funcionalidade dos botões ======
-  * Empresa;
-  * Número do Parcelamento;
-  * Valor Total Negociado;
-  * Valor da Entrada;
-  * Quantidade de Parcelas;
-  * Valor da Parcela;
-  * Valor de Desconto;
-  * Dia de Vencimento do imóvel, seguindo as regras do GSAN; e
-  * Referência da conta (Ano e Mês) com seu respectivo valor.
-Alterado o processo "259 - GERAR TXT OS CONTAS PAGAS PARCELADAS", executado diariamente, para inclusão do campo "Faixa de Atraso de Débito", no arquivo texto de retorno e inclusão de tratamento para as contas canceladas.
-Foram realizados os seguintes procedimentos no GSAN:
+^Botão^Descrição da Funcionalidade^
-  * Incluído, no final do arquivo texto de retorno (posições 117 a 137), o campo "Faixa de Atraso de Débito", para armazenar a informação da faixa de atraso de débito do imóvel: 3 a 6 contas; 7 a 24 contas ou acima de 24 contas. A faixa será selecionada de acordo com a empresa e o percentual da faixa de débito armazenado para o imóvel no GSAN;
+|{{:ajuda:lupa.gif?nolink|}}|Ao clicar neste botão, o sistema permite consultar um dado nas bases de dados.|
-  * Incluído o tratamento para as contas canceladas, semelhante ao tratamento dado às contas quitadas e parceladas, retirando os imóveis da cobrança e enviando-as para o arquivo texto de retorno;
+|{{:ajuda:borracha.gif?nolink|}}|Ao clicar neste botão, o sistema apaga o conteúdo do campo em exibição.|
-  * No tratamento para as contas canceladas será alterado o arquivo texto de retorno, para formatar o campo "Motivo do Encerramento" (posições 31 a 60), com o conteúdo "CANCELADA" e o campo "Indicador de Tipo de Pagamento" (posição 116) com brancos.
+|{{:ajuda:batch:calendario.png?nolink|}}|Utilize este botão para selecionar uma data válida no formato dd/mm/aaaa (dia, mês, ano), link **[[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]]**.|
+|{{:ajuda:batch:setaadireitaavancar.png?nolink|}}|Utilize este botão para avançar para a tela seguinte.|
+|{{:ajuda:Desfazer.png?nolink|}}|Ao clicar neste botão, o sistema desfaz o último procedimento realizado.|
+|{{:ajuda:batch:kkkcelar.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|
+|{{:ajuda:batch:iniciar.png?nolink|}}|Utilize este botão para autorizar o sistema iniciar o processo na data e hora informada.|
-As empresas que efetuam a cobrança por resultado e recepcionam este arquivo TXT, deverão alterar seus sistemas para se adaptarem ao novo layout do arquivo, contemplando a faixa de débito e tratar o recebimento da conta na situação CANCELADA.
 \\
+===== Referências =====
-====== Preenchimento dos Campos ======
+**[[=postgres:controle_batch:uc1642|Iniciar Processo]]**
+==== Termos Principais ====
-^Campo^Preenchimento dos Campos^
+**[[=ajuda:batch|Batch]]**
-|Processo|Informe o número do processo "259 - GERAR TXT OS CONTAS PAGAS PARCELADAS".\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|
-|Data do Agendamento|Campo obrigatório - Informe a data no formato dd/mm/aaaa (dia, mês, ano) para processamento da rotina, ou clique no botão {{:ajuda:batch:calendario.png?nolink|}}, link [[:ajuda:pesquisar_calendario|Pesquisar Data - Calendário]], para selecionar a data desejada.|
-|Hora do Agendamento|Campo obrigatório - Informe a hora para dar inicio ao processamento da rotina, no formato hh:mm:ss (hora, minuto, segundo).|
-|Processo Inciado Precedente|Caso exista um processo precedente, informe ou clique no botão {{:ajuda:lupa.gif?nolink|}} ao lado do campo. O nome do processo será exibido no campo ao lado.\\ Para apagar o conteúdo do campo, clique no botão  {{:ajuda:borracha.gif?nolink|}} que se encontra sob o campo.|
-\\
-Funcionalidade dos Botões\\
+**[[=ajuda:batch:processo_eventual_ou_mensal|Processo Eventual ou mensal]]**
-\\
-{table}
- Botão| Descrição da Funcionalidade\\
- {image:Lupa.gif}| Utilize este botão para consultar a informação referente o conteúdo do campo. A descrição será exibida ao lado do campo.\\
- {image:Borracha.gif}| Utilize este botão para apagar o conteúdo do campo em exibição.\\
- {image:Calendario.gif}| Utilize este botão para selecionar uma data válida no formato dd/mm/aaaa (dia, mês, ano).\\
- {image:SetaaDireitaAvancar.png}|Utilize este botão para avançar para a tela seguinte. \\
- {image:Desfazer.png}| Utilize este botão para desfazer as informações fornecidas na tela.\\
- {image:cancelar.jpg}| Utilize este botão para cancelar a operação e retorna a tela inicial\\
- {image:Iniciar.png}| Utilize este botão para autorizar o sistema iniciar o processo na data e hora informada\\
 \\
 \\
 \\
-Clique [[:Ajuda|aqui]] para retornar ao Menu Principal do GSAN
+Clique **[[:ajuda|aqui]]** para retornar ao Menu Principal do GSAN