Histórico da Página

01. VISÃO GERAL

Essa Esta rotina tem como objetivo permitir a importação automática dos de extratos bancários, auxiliando no facilitando o processo de conciliação bancária utilizando arquivo .
Ela utiliza arquivos de retorno bancário para extratos bancários de uma ou mais contas correntes, com uso do Schedule rotina CFGA010 e correta configuração no cadastro FINA130 (Parâmetros Bancos).
Sua execução passa por configurações descritas no item Configurações.

02. EXEMPLO DE UTILIZAÇÃO

...

02. CONFIGURAÇÕES

Para utilizar a rotina de importação automática são necessários as configurações abaixo descritas:

Expandir
Deck of Cards
id 001
Card
default	true
id	01
label	title	Cadastrando o agendamento "Schedule" (CFGA010)
Acessando SIGACFG "Configurador" > Ambiente > Cadastros > Schedule > Agendamentos > Cadastro > Acesse, no módulo Configurador (SIGACFG),  Ambiente →  Cadastros →  Schedule →  Agendamentos →  Cadastro →  Botão Incluir: Image Removed Image Added Ao clicar no botão incluir os campos: Código, Usuário, Nome do Usuário, Data, Hora e Ambiente serão auto preenchidos automaticamente com as informações do acesso propriamente dito, será necessário definir apenas a " ROTINA Rotina" que no caso deve ser utilizado para Retorno Automático de COBRANÇA (FINA205) ou Retorno Automático de PAGAMENTO (FINA435)  Extratos Bancários (FINA475), a "Empresa \ /Filial" que o JOB vai considerar no Processamento e também deve-se informar o MÓDULO "Módulo" que se refere a ROTINA "06 - Financeiro" Image Removed Obs: O Image Added Informações title Importante O botão "Parâmetros" não serão utilizados para as rotinas FINA205 e FINA435 será utilizado para a rotina FINA475, pois os parâmetros de execução são definidos no Cadastro Parâmetros de Bancos FINA130. Após realizado as definições acima, clique em "Recorrência", para definir a recorrência de execução do Job: Image Removed Image Added Defina em qual momento e quantas vezes será realizado o processamento e "Confirme": Image Removed Image Added Feito isso, "Confirme" a inclusão do Agendamento: Image Removed Image Added Ainda no Cadastro do Schedule (CFGA010) acesse: Agent > Cadastro > Adicionar Agents Padrão Image Removed Image Added Ao realizar a inclusão de um AGENT padrão, automaticamente o sistema já preenche os dados do ambiente padrão (logado) - IP do AppServer, PORTA, Porta e Ambiente - que será executado o Job parametrizado anteriormente.
Card
id	02

Por padrão, se for digitado apenas uma barra " \ " no campo, o sistema entende que está apontando a RootPath, comando este configurado no AppServer.ini.

É comum esta pasta estar nomeada pelo legado de versões anteriores do Protheus, já em versões novas pode se encontrar a nomenclatura "Protheus_Data".

03. PROCESSAMENTO

• Leitura e importação dos dados de extrato bancário (Arquivos ou API) 

A importação dos dados de extrato bancário pode ser realizada de duas maneiras distintas: por arquivo e via API.

O processamento de importação dos dados de extrato bancário se dá da seguinte forma

• • Verificar se existem configurações de Job ativas para o processo.
    • Verificar na configuração de Comunicação Remota (SEE) se existem subcontas que possuem Job Ativado
      • Se SIM, iniciar o processamento do Job. 
        O Job será processado por empresa e suas filiais.
        
        
      • Se NÃO, finalizar o Job

• • O job verifica se existe um arquivo de extrato ou uma configuração para importação por API de acordo com as configurações contidas na aba Extrato Conciliação Automática.
    • Em caso de inexistência do arquivo de extrato ou configuração por API não haverá processamento.
      • Caso a importação dos dados seja por arquivo será registrado nas tabelas SIF (Cabeçalho Imp. Extrato Bancário) e SIG (Itens Import. Extrato Bancário) um registro com a informação "Não foram encontrados arquivos de extrato para importação no diretório."
        
        
      • Caso a importação dos dados seja por API será registrado nas tabelas SIF (Cabeçalho Imp. Extrato Bancário) e SIG (Itens Import. Extrato Bancário) um registro com a informação "Erro ao processar extrato por API."
    • Em caso de existência do arquivo de extrato ou configuração por API, deve processar a importação das informações para as tabelas SIF (Cabeçalho Imp. Extrato Bancário) e SIG (Itens Import. Extrato Bancário).
      • Se sucesso:
        • Será registrado nas tabelas SIF (Cabeçalho Imp. Extrato Bancário) e SIG (Itens Import. Extrato Bancário) os registros componentes do extrato bancário.
        • Será notificado o responsável, via e-mail configurado.
        • Caso a importação seja por arquivo, o arquivo de extrato bancário será movido para o diretório definido para arquivos cuja importação foi realizada com sucesso.
        • Se ativado efetuará o processo de conciliação prévia.
      • Se falha:
        • Será registrado nas tabelas SIF (Cabeçalho Imp. Extrato Bancário) e SIG (Itens Import. Extrato Bancário) um registro com a informação referente a falha.
        • Será notificado o responsável, via e-mail configurado.
        • Caso a importação seja por arquivo, o arquivo de extrato bancário será movido para o diretório definido para arquivos cuja importação falhou.

• • • Em caso de tentativa de importação duplicada de arquivos de retorno evitando que os dados do extrato estejam em mais de um processo.
      Utilizaremos o processo já existente que verifica o checksum do arquivo.
      
      • Será notificado o responsável, via e-mail configurado.
      • Será registrado nas tabelas SIF (Cabeçalho Imp. Extrato Bancário) e SIG (Itens Import. Extrato Bancário) um registro com a informação referente a falha.
      • Caso a importação seja por arquivo, o arquivo de extrato bancário será movido para o diretório definido para arquivos cuja importação falhou.

• Conciliação bancária automática

Se configurada a rotina realizará uma conciliação automática após a importação do extrato.

Neste momento, apenas serão conciliados registros da tabela Registros do Extrato Bancário (SIG) com os movimentos bancários do Financeiro (FK5/SE5) caso exista coincidência de chave completa:

• • Data do Movimento + Banco + Agência + Conta + Documento + Valor + Carteira
    • Obs: Para usuários da Conta Digital, haverá uma tentativa prévia de Conciliar pelas chaves FK5_CODPIX ou FK5_CODBAR.

As conciliações bancárias que não forem atendidas nesse processo, deverão ser realizadas através do Conciliador BackOffice. 

Para maiores informações, acesse Conciliador BackOffice.

• Efetivar movimento bancário de tarifas no momento da importação do extrato
  
  

Ao importar o extrato utilizando o JOB de importação, serão efetivados os movimentos referentes a Encargos, Tarifas, IOF e CPMF, criando assim os movimentos bancários no Financeiro.

• • No cadastro dos parâmetros de bancos (FINA130) configurar o campos Efetiva Trf. disponibilizado na aba destinada a conciliação bancária com as seguinte características:
    1 - Efetivar Todos (Encargos, Tarifas, IOF e CPMF)
    2 - Não efetivar (default)

• • Ao se processar o JOB de importação de dados, verificar o conteúdo do campo Efetiva Trf. está ativo.

• • • Efetiva Trf.  = 1 (Efetivar Todos (Encargos, Tarifas, IOF e CPMF))
      Para os registros que tiverem ss códigos descritos abaixo, na informação de Categoria do Lançamento, serão efetivados como movimentos bancários dentro do Protheus - Financeiro.
      
      Categoria do Lançamento
      Código adotado pela FEBRABAN, para identificar a categoria padrão do Lançamento, para conciliação entre Bancos.
      
      Débitos:
      '102' = Encargos
      '105' = Tarifas
      '109' = CPMF
      '110' = IOF 

• • • Efetiva Trf. = 2 (Não Efetivar)
      Não serão realizadas as efetivações.
      O usuário poderá efetivar esses movimentos no botão Efetivação no processo 0023 - Conciliação Bancária Automática.

Image Added

• • A natureza do movimento bancário será obtida do parâmetro MV_FNATCON.

    Parâmetro	Descrição
    MV_FNATCON	Define a natureza financeira a ser utilizada ao efetivar movimentos bancários de tarifas,encargos, IOF e CPMF na importação de extratos via JOB

• • Disponibilizado o ponto de entrada F475NAT para a manipulação da natureza a ser aplicada a cada movimento que for efetivado na importação do extrato via Job
    F475NAT - Ponto de entrada para manipulação da natureza para movimentos bancários

04. INFORMAÇÕES TÉCNICAS

          Tabelas utilizadas pela rotina:

• • • FK5 - Movimentos Bancários
    • QLC - Cabeçalho da Conciliação
    • QLD - Itens da Conciliação
    • SE5 - Movimentação Bancária
    • SEE - Comunicação Remota
    • SIF - Cabeçalho do Extrato Bancário
    • SIG - Registros do Extrato Bancário

Modelo de extrato bancário

O arquivo abaixo contém uma estrutura completa de configuração e extrato para efetuar testes.

Modelo configuração e extrato Conciliador.zip

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...