Á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):


Expandir
Deck of Cards
id001
Card
defaulttrue
id01
label
title
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
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
id
Expandir
label
title
03
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.


    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

    ...

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

    ...

    Nota
    titleImportante

    Estes arquivos são exemplo de configuração e deve ser utilizado 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.

    ...