Histórico da Página
Aviso | ||
---|---|---|
| ||
Este é um documento de referência em desenvolvimento. |
Índice | ||
---|---|---|
|
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).
Sua execução passa por configurações descritas no item Configurações.
Informações | ||
---|---|---|
| ||
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. |
Aviso | ||
---|---|---|
| ||
Esta rotina não realiza qualquer tipo de conciliação. As conciliações bancárias serão realizadas através do Conciliador Protheus.Para maiores informações, acesse Conciliador Backoffice. |
02. EXEMPLO DE UTILIZAÇÃO
...
02. CONFIGURAÇÕES
Para utilizar a rotina de importação automática são necessários as configurações abaixo descritas:
Expandir | ||||||
---|---|---|---|---|---|---|
Deck of Cards | ||||||
| ||||||
Card | ||||||
default | true | |||||
id | 01 | label |
|
| ||
Acessando SIGACFG "Configurador" > Ambiente > Cadastros > Schedule > Agendamentos > Cadastro >
Card | | |||||
id | 02 |
Expandir | ||
---|---|---|
| ||
Este cadastro tem como finalidade configurar os parâmetros bancários utilizados em diversas operações relacionadas a comunicação bancária.
Informações | | |
| ||
Card | ||
id | 03 | label |
Expandir | ||
---|---|---|
| ||
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- MAILmail/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: |
Expandir | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
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.
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).
|
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.
Informaçõ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.
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)
- 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âmetro Descrição MV_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
Informações | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
Estes arquivos são exemplo de configuração e devem serem utilizados apenas em testes. |
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> |
...