01. VISÃO GERAL
Esta rotina tem como objetivo permitir a importação automática de extratos bancários, facilitando o processo de conciliação bancária.
Ela utiliza arquivos de retorno bancário para extratos bancários de uma ou mais contas correntes.
Sua execução passa por configurações descritas no item Configurações.
Nota
Essa rotina foi ajustada para atender a Lei Geral de Proteção de Dados (Lei n° 13.70), sendo que alguns campos que apresentam informações consideradas como dados sensíveis e/ou pessoais, serão ofuscados deixando de ser legíveis.
02. CONFIGURAÇÕES
Para utilizar a rotina de importação automática são necessários as configurações abaixo descritas:
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
- Se SIM, iniciar o processamento do Job.
- Verificar na configuração de Comunicação Remota (SEE) se existem subcontas que possuem Job Ativado
- Verificar se existem configurações de Job ativas para o processo.
- 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."
- 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."
- 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.
- Se sucesso:
- Em caso de inexistência do arquivo de extrato ou configuração por API não haverá processamento.
- 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 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.
- Em caso de tentativa de importação duplicada de arquivos de retorno evitando que os dados do extrato estejam em mais de um processo.
Bloqueio de movimentações
Para ser processado pelo job, é necessário que o registro do cadastro de banco esteja desbloqueado, isto é, A6_BLOCKED = '2' e A6_MSBLQL = '2' (se existir). Se um dos campos citados estiver em branco, o banco pode não ser considerado no processamento do job.
- 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.
- Data do Movimento + Banco + Agência + Conta + Documento + Valor + Carteira
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)
- 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:
- 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. = 1 (Efetivar Todos (Encargos, Tarifas, IOF e CPMF))
- 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.
- Efetiva Trf. = 2 (Não Efetivar)
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
- 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
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
Importante
Estes arquivos são exemplo de configuração e devem serem utilizados apenas em testes.
Pode ser utilizado como exemplo para a configuração, seguindo as posições dispostas no manual, do extrato do seu banco.