Á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

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 Exemplo de Utilização.

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.

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:


Expandir
Deck of Cards
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
02label
Expandir
id
title
label
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
id03
Expandir
titleConfiguraçã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.


  • 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â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      




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>

...