Integração bancaria via sistema de VAN
Linha de Produto: | RM |
Segmento: | Construção e Projetos
|
Módulo: | TOTVS Gestão Financeira - Fluxus |
Descrição
Com o objetivo de otimizar o processo bancário, o sistema foi evoluído para permitir a integração bancária (remessa e retorno de arquivos) usando sistema de VAN. Nesse conceito o Totvs Gestão Financeira gera os arquivos remessa dos boletos emitidos, de forma automática, direcionando para uma pasta parametrizada de onde os bancos irão lê-los para processamento. Após o processamento o banco disponibiliza os arquivos de retorno numa pasta padrão de onde a nossa aplicação irá ler, de forma automática e com periodicidade parametrizável, e processar os arquivos.
Para a implementação do processo será necessário a parametrização/execução dos seguintes processos:
- Parametrização da remessa
- Agendamento da remessa
- Validação da execução da remessa
- Exclusão do agendamento da remessa
- Parametrização do retorno
- Agendamento do retorno
- Validação da execução do retorno
- Exclusão do agendmaneto o retorno
Obs: As imagens utilizadas ao longo do documento são meramente ilustrativas e retiradas da execução do Totvs Gestão Financeira em base com dados de teste.
Deck of Cards |
---|
id | Parametrização da Remessa |
---|
|
Card |
---|
id | 1 |
---|
label | Parametrização da Remessa |
---|
| Parametrização Para disponibilizar o recurso, deve ser habilitado a opção Remessa de Cobrança em lote no cadastro de perfil do usuário. ![](/download/attachments/389554035/image2018-8-8_10-29-59.png?version=1&modificationDate=1533739215000&api=v2)
Acesse o cadastro do convênio e informe os dados de Remessa de Cobrança. No Diretório de destino informe o caminho de rede, que será o local onde o banco irá fazer a leitura os arquivos gerados. Para geração de arquivos sequencias, o campo Nome do Arquivo deve ser composto por uma parte fixa e por uma parte variável definida pelas seguintes tags: - DDMMYYYY informação da data de geração do arquivo (parte fixa)
- # caractere para definir o número sequencial do arquivo (parte variável).
![](/download/attachments/389554035/image2018-8-8_10-57-58.png?version=1&modificationDate=1533739215000&api=v2)
Remessa de Cobrança em Lote Remessa de Pagamento em Lote Remessa de Débito Automático em Lote |
Card |
---|
id | 2 |
---|
label | Agendamento de Remessa |
---|
| Agendamento de Remessa Acesse o Menu Movimentações Bancárias | Processos em Lote | Remessa de Cobrança em Lote. ![](/download/attachments/389554035/image2018-8-8_11-0-35.png?version=1&modificationDate=1533739215000&api=v2)
Na visão de Cobrança em Lote, inclua ou selecione o filtro de acordo com as informações do Boleto para o processo de remessa. Caso deseje salvar em diretório diferente do default cadastrado no convênio, informe no campo Diretório de destino o caminho desejado. ![](/download/attachments/389554035/image2018-8-8_11-3-44.png?version=1&modificationDate=1533739215000&api=v2) ![](/download/attachments/389554035/image2018-8-8_11-4-3.png?version=1&modificationDate=1533739215000&api=v2)
Importante: O filtro é baseado nos dados do boleto. Ao ser selecionado deve-se referenciar ao código da coligada que será realizado o processo, caso não seja informado o sistema irá executar para todas as coligadas. Como default, o sistema já possui um filtro interno para não carregar boletos do tipo Débito Automático, nem com status de remessa cancelado, registrado, registrado online ou baixado, nem com status baixado. ![](/download/attachments/389554035/image2018-8-8_11-33-30.png?version=1&modificationDate=1533739215000&api=v2)
Agendamento Para utilizar esta funcionalidade, é necessário que o ambiente esteja parametrizado para 3 camadas para definir o agendamento e a frequência no qual o processo será executado. Defina quando ocorrerá a primeira execução e a repetição. Para cada execução o sistema irá gerar um arquivo para cada convênio distinto que encontrar nos boletos remetidos no processo. ![](/download/attachments/389554035/image2018-8-8_11-39-44.png?version=1&modificationDate=1533739214000&api=v2)
|
Card |
---|
id | 3 |
---|
label | Validação do Agendamento de Remessa |
---|
| Validação do log do processo de Agendamento Para validar a execução da remessa após o agendamento, acesse o Jobs pelo menu Ambiente | Processos | Gerenciamento de Jobs e crie um filtro com o campo Classe do Processo com “FinRemessaLoteCobDataProc”, com os seguintes Status: - 2 para “OK”;
- 5 para “Erro”;
- 6 para “Atenção”.
![](/download/attachments/389554035/image2018-8-8_14-14-40.png?version=1&modificationDate=1533748481000&api=v2)
Obs.: Poderá ser criado também filtro para data de execução (Campo Executar em) caso necessário. No resultado exibido na visão é possível configurar colunas caso deseje exibir somente os campos necessários para validação. Ao editar o registro é exibido na aba Resultado da Execução o log do processo, com dois tipos, um para a geração dos arquivos e outro para informar quais os convênios nomeados com Código da Coligada e Identificador do Convênio, tiveram a remessa concluída. Exemplo: ![](/download/attachments/389554035/image2018-8-8_14-17-16.png?version=1&modificationDate=1533748637000&api=v2) ![](/download/attachments/389554035/image2018-8-8_14-17-37.png?version=1&modificationDate=1533748658000&api=v2)
Após a execução, o sistema irá salvar os arquivos de acordo com o diretório parametrizado no convênio ou no caminho informado no processo. Importante ressaltar a permissão do acesso ao diretório onde os arquivos serão salvos caso estejam sendo enviados para um diretório localizado na rede. ![](/download/attachments/389554035/image2018-8-8_14-28-37.png?version=1&modificationDate=1533749323000&api=v2)
Cancelamento do Agendamento de Remessa Para excluir o agendamento de remessa, acesse o Jobs e monte um filtro com o campo Classe do processo com “FinRemessaLoteCobDataProc” e Status nulo. Sistema retorna o próximo agendamento a ser executado, exclua o registro. Dessa forma não ocorrerá mais execução do processo de forma automática. ![](/download/attachments/389554035/image2018-8-8_14-56-26.png?version=1&modificationDate=1533750987000&api=v2)
|
Card |
---|
id | 5 |
---|
label | Agendamento do Retorno |
---|
| Agendamento de Retorno de Cobrança Acesse Retorno de Cobrança em Lote (Registrada) no menu Movimentação Bancária | Integração Bancária | Retorno Bancário e defina os parâmetros: ![](/download/attachments/389554035/image2018-8-8_15-12-55.png?version=1&modificationDate=1533751976000&api=v2)
Banco: Banco no qual o layout de retorno de cobrança está informado. Pasta de Leitura dos arquivos de retorno: Caminho onde se encontra os arquivos de retorno que serão processados. Para ambientes que roda em três camadas ou em ambiente CLOUD, é importante selecionar um caminho no qual o servidor que irá executar o processo e o usuário do sistema operacional tenham acesso de leitura/gravação. Serão desconsiderados os arquivo com a extensão .OLD. Pasta onde o log de retorno será salvo (opcional): Este campo informa o caminho onde será salvo os logs dos arquivos de retorno processados, e caso não seja informado nenhum caminho, o log de execução não será salvo. Para ambientes que roda em três camadas ou em ambiente CLOUD, é importante selecionar um caminho no qual o servidor que irá executar o processo e o usuário do sistema operacional tenham acesso de leitura/gravação. Renomear arquivo de retorno processado para extensão .old: Define se após a execução do processo o arquivo de retorno será renomeado com a extensão .Old. Caso esse parâmetro não seja marcado, na próxima vez que o processo for executado para pasta selecionada, o sistema irá tentar processar-lo novamente. Os demais parâmetros segue a mesma lógica do retorno de cobrança comum. Obs.: - A conta caixa que será utilizada para efetuar a baixa será a definida no lançamento e deve estar vinculada ao banco no qual o layout está informado.
- A contabilização será efetuada baseado no evento contábil definido nos default do tipo de documento/campos opcionais do lançamento.
Agendamento É necessário que o ambiente esteja parametrizado para 3 camadas para definir o agendamento e a frequência no qual o processo será executado. Defina quando ocorrerá a primeira execução e a repetição. O sistema processará todos os arquivos disponíveis no diretório informado (com exceção daqueles de extensão .old). ![](/download/attachments/389554035/image2018-8-8_15-49-20.png?version=1&modificationDate=1533754161000&api=v2)
|
Card |
---|
id | 6 |
---|
label | Validação do Agendamento de Retorno |
---|
| Validação do log do processo de Retorno Para validar a execução da remessa após o agendamento, acesse o Jobs pelo menu Ambiente | Processos | Gerenciamento de Jobs e crie um filtro com o campo Classe do Processo com “FinRemessaLoteCobDataProc”, com os seguintes Status: - 2 para “OK”;
- 5 para “Erro”;
- 6 para “Atenção”.
![](/download/attachments/389554035/image2018-8-8_15-54-57.png?version=1&modificationDate=1533754498000&api=v2)
Obs.: Poderá ser criado também filtro para data de execução (Campo Executar em) caso necessário. No resultado exibido na visão é possível configurar colunas caso deseje exibir somente os campos necessários para validação. O registro é exibido na aba Resultado da Execução o log do processo, mostrando as etapas de processamento, a renomeação de arquivo e log salvo (aba Mensagem), exemplo: ![](/download/attachments/389554035/image2018-8-8_15-57-53.png?version=1&modificationDate=1533754674000&api=v2) ![](/download/attachments/389554035/image2018-8-8_15-58-23.png?version=1&modificationDate=1533754703000&api=v2)
Cancelamento do Agendamento de Retorno Para cancelar o agendamento de retorno, basta acessar o Jobs e criar um filtro com o campo Classe do Processo com “FinRetornoCobrancaLoteData” e Status nulo. Sistema retorna o próximo agendamento a ser executado, exclua o registro. Dessa forma não ocorrerá mais a execução do processo de forma automática. |
|