Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Aviso
titleATENÇÃO
Este é um documento de referência em desenvolvimento.
Será informada, oportunamente, a data de disponibilidade para clientes pilotos, visto que no momento ainda se encontra em fase de desenvolvimento.

Índice
maxLevel2

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).

Esta rotina realiza, se configurada, 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

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.

.
Sua execução passa por configurações descritas no item Configurações.


Informações
titleNota

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 seguintes configurações abaixo descritas:


Deck of Cardsexpand
id001
Card
defaulttrue
id01
label
title
Cadastrando o agendamento "Schedule" (CFGA010)
Acessando SIGACFG "Configurador" > Ambiente > Cadastros > Schedule > Agendamentos > Cadastro >
  1. Acesse, no módulo Configurador (SIGACFG),  Ambiente →  Cadastros →  Schedule →  Agendamentos →  Cadastro →  Botão Incluir:

    Image Modified

  2. Ao clicar no botão incluir os campos: Código, Usuário, Nome do Usuário, Data, Hora e Ambiente serão

auto
  1. preenchidos automaticamente com as informações do acesso propriamente dito, será necessário definir apenas a "

ROTINA
  1. Rotina" que no caso deve ser utilizado para Retorno Automático de Extratos Bancários (FINA475), a "Empresa

\
  1. /Filial" que o JOB vai considerar no Processamento e também deve-se informar o

MÓDULO
  1. "Módulo" que se refere a ROTINA "06 - Financeiro"

    Image Modified


    Informações
    titleImportante

    O botão "Parâmetros" não será utilizado para a rotina FINA475, pois os parâmetros de execução são definidos no Cadastro Parâmetros de Bancos FINA130.



  2. Após realizado as definições acima, clique em "Recorrência", para definir a recorrência de execução do Job:
    Image Modified
    Defina em qual momento e quantas vezes será realizado o processamento e "Confirme":

    Image Modified
  3. Feito isso, "Confirme" a inclusão do Agendamento:

    Image Modified

  4. Ainda no Cadastro do Schedule (CFGA010) acesse: Agent > Cadastro > Adicionar Agents Padrão

    Image Modified

    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,
  1. Porta e Ambiente - que será executado o Job parametrizado anteriormente.
card
id
Expandir
label
title
02
Cadastrando Parâmetros Bancos (FINA130)

Este cadastro tem como finalidade configurar os parâmetros bancários utilizados em diversas operações relacionadas a comunicação bancária.

card
03
Expandir
id
title
label
Configuração de Envio de E-mail - Visão Geral

01. Gerando uma senha de APP para envio do email.

Para a importação de extratos bancários, é necessário gerar uma senha de APP, no caso do G-Mail, primeiro precisamos ativar a verificação em duas etapas:

Image Modified

Após a verificação de duas etapas ativada, é necessário adicionar um APP e gerar uma senha:

Image Modified

Image Modified

Copie a senha gerada e salve em um lugar seguro.

Image Modified

02. Configurando o serviço de e-mail.

Com a senha de app gerada, abra o Protheus no SIGACFG, ambiente, E-

MAIL

mail/Proxy, Configurar. Coloque o servidor de e-mail, o seu e-mail e a senha do APP gerada anteriormente, em servidor de e-mail necessita de autenticação, coloque sim.

Image Modified

Na próxima tela, apenas clique em avançar sem alterar nada:

Image Modified

Utiliza segurança TLS - SIM

Image Modified

Finalize a configuração de E-MAIL:

Image Modified

Expandir
titleConfigurações de Credenciais para Importação do Extrato via API
Aviso
titleATENÇÃO
A operação de extrato por API ainda se encontra em desenvolvimento.
Será informada, oportunamente, a data de disponibilidade para clientes pilotos, visto que no momento ainda se encontra em fase de desenvolvimento.


Bancos disponíveis para operação de extrato por API:


É possível efetuar a importação do extrato bancário por meio da API (Interface de Programação de Aplicações), eliminando a necessidade de um arquivo para tal procedimento.

Para utilizar o serviço de API, é fundamental configurar as credenciais por meio de um layout Pagar nas configurações de contas do NGF (Novo Gestor Financeiro).

É possível incluir um layout acessando o a rotinaFINA710 - Novo Gestor Financeiro.

  • Acesse o menu Comunicação online;
  • Selecione a opção Configuração de contas;
  • E cadastre um Novo layout.

Novo layout de contaImage Added












Também é preciso selecionar entre as opções "API Extrato" — evitando que este layout seja considerado na API para registros de títulos a pagar — ou "Ambos", para que o layout seja incluído tanto na operação de extrato quanto no registro via API dos títulos a pagar.

Opções de layoutImage Added


Após essa etapa de configuração, informe as credenciais de autenticação fornecidas pelo banco, juntamente com o certificado digital correspondente.

Credenciais layoutImage Added

Para mais informações sobre este processo acesse Contas a pagar (Comunicação bancária online).


Informações
titleImportante:

Certifique-se de que este serviço esteja ativo para a sua conta bancária. Recomenda-se verificar a disponibilidade diretamente com o seu gerente.


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.


Informações
titleBloqueio 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.

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 os 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âmetroDescrição
      MV_FNATCONDefine a natureza financeira a ser utilizada ao efetivar movimentos bancários de tarifas,encargos, IOF e CPMF na importação de extratos via JOB      



Informações
titleImportante

Para que esses movimentos sejam efetivados realmente de forma automática (além das configurações acima) é necessário que a natureza financeira desses movimentos seja indicada no parâmetro MV_FNATCON, e que seja uma natureza existente e válida. Caso não exista a natureza nessas condições, as tarifas serão apenas importadas, dependendo da efetivação manual posteriormente.


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

Nota
titleImportante

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.

           

HTML
<!-- 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>

...