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:
- Acesse, no módulo Configurador (SIGACFG), Ambiente → Cadastros → Schedule → Agendamentos → Cadastro → Botão Incluir:
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"
Importante
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.
- Após realizado as definições acima, clique em "Recorrência", para definir a recorrência de execução do Job:
Defina em qual momento e quantas vezes será realizado o processamento e "Confirme":
- Feito isso, "Confirme" a inclusão do Agendamento:
- Ainda no Cadastro do Schedule (CFGA010) acesse: Agent > Cadastro > Adicionar Agents Padrão
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.
Este cadastro tem como finalidade configurar os parâmetros bancários utilizados em diversas operações relacionadas a comunicação bancária.
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:
Após a verificação de duas etapas ativada, é necessário adicionar um APP e gerar uma senha:
Copie a senha gerada e salve em um lugar seguro.
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.
Na próxima tela, apenas clique em avançar sem alterar nada:
Utiliza segurança TLS - SIM
Finalize a configuração de E-MAIL:
ATENÇÃ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:
- Banco do Brasil
É 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 rotina FINA710 - Novo Gestor Financeiro.
- Acesse o menu Comunicação online;
- Selecione a opção Configuração de contas;
- E cadastre um Novo layout.
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.
Após essa etapa de configuração, informe as credenciais de autenticação fornecidas pelo banco, juntamente com o certificado digital correspondente.
Para mais informações sobre este processo acesse Contas a pagar (Comunicação bancária online).
Importante:
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
- 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.
- 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 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. = 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âmetroDescriçãoMV_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
Importante
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
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.