Á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

...

Para utilizar a rotina de importação automática são necessários as configurações abaixo descritas (clique em cada pasta para acessá-las):


label
Expandir
title
Deck of Cards
id001
Card
defaulttrue
id01
Cadastrando o agendamento "Schedule" (CFGA010)
  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 preenchidos automaticamente com as informações do acesso propriamente dito, será necessário definir apenas a "Rotina" que no caso deve ser utilizado para Retorno Automático de Extratos Bancários (FINA475), a "Empresa/Filial" que o JOB vai considerar no Processamento e também deve-se informar o "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.



  3. 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
  4. Feito isso, "Confirme" a inclusão do Agendamento:

    Image Modified

  5. 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 e Ambiente - que será executado o Job parametrizado anteriormente.
card
02
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
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/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 arquivos 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 arquivos dados de extrato bancário se dá da seguinte forma

...

    • 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.
          Será
          • 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.
            • O 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.
            • O 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.
          • O 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.

    ...

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

    ...