ARMAZENAMENTO ARQUIVO DE RETORNO BANCÁRIO

Informações Gerais

Objetivo

Inserir no banco de dados todos as linhas importadas no retorno bancário de pagamento, cobrança e débito automático.

Definição da Regra de Negócio

É necessário ter todas as informações que foram lidas no arquivo de retorno gravadas no banco de dados (tabela FRETORNOBANCARIOITEM). Existem dois objetivos na evolução desse processo. O primeiro é manter um log dos registros lidos nos retornos bancários. O outro é permitir que o processo seja quebrado em duas fases: importação do arquivo no banco de dados e processamento do mesmo.

• Foram criados dois novos campos na tabela de Item de Retorno Bancário. O primeiro é o Sequencial do Item de Retorno (SEQITEMRETORNO) que irá compor, juntamente com o campo IDRETORNO, a chave primária da tabela FRETORNOBANCARIOITEM. A chave anterior composta por IDRETORNO, LINHA, CODCOLIGADA e IDLAN não faz mais sentido já que agora todas as linhas de detalhe do arquivo serão armazenadas e não apenas aquelas processadas com sucesso. O segundo campo, CHAVELAN, armazenará a chave de identificação do lançamento na linha detalhe do arquivo importado, o valor da mesma é usado para identificar a qual lançamento/boleto aquela linha está relacionada.
• Todos os registros de detalhe lidos do arquivo de importação de retorno de cobrança, pagamento ou débito automático serão armazenados na tabela de Item de Retorno Bancário mesmo que ocorra erros no processo. As linhas importadas terão o campo CHAVELAN preenchidas.
• O Anteriormente o processo de checagem dos dados do retorno em relação aos lançamentos relacionados pode criar uma ou mais novas linhas criava mais de uma linha na tabela de Item de Retorno Bancário caso o boleto identificado esteja vinculado a mais de um lançamento. Assim, existirão mais de um registro com a mesma linha, mas com diferentes identificadores do lançamento (IDLAN). As novas linhas nunca terão o campo CHAVELAN preenchido, isso é exclusivo dos arquivo importadosEsse comportamento não mais existirá, somente uma linha ficará gravada e na mesma armazenada somente o Identificador do boleto e os campos de valor (Valor Baixado, Multa, Juros, Desconto e Opcional 1 a 8), com exceção de Valor Líquido que terá os valores somados de todos os lançamento envolvidos, conterão os valores lidos do arquivo.
• O campo de identificação do lançamento na tabela de Item de Retorno Bancário (IDLAN) somente será preenchido caso o retorno não seja por boleto. Assim, se o Identificador do Boleto (IDBOLETO) for preenchido, a Referência do Lançamento (IDLAN) ficará com valor nulo.
  
  

Tabelas Utilizadas

• FRETORNOBANCARIO – Retorno Bancário
• FRETORNOBANCARAIOITEM – Item de Retorno Bancário.

Dicionário de Dados

Arquivo ou Código do Script: FS.2017.10_06, FS.2017.10_07 e FS.2017.10_08.