Pular para o conteúdo principal

Workers

A tela Workers centraliza os processos automáticos (workers) do módulo de Pagamento do BankPlus. Cada worker é responsável por automatizar uma rotina, como buscar arquivos no banco, importar retornos, gerar ordens de pagamento ou integrar contabilizações no sistema de origem. Nesta tela você inicia, para, configura e acompanha a execução de cada worker. Para acessá-la, utilize o menu lateral em Configurações > Workers.

Visão geral da tela​

A imagem abaixo exibe a tela Workers, acessada via Configurações > Workers.

A tela apresenta, no topo, o seletor de visão (Padrão) e os botões de ação Iniciar, Limpar e Ajustar filtros.

Figura 1: Workers, Visão geral da tela.

A tela apresenta, no topo, o seletor de visão (Padrão) e os botões de ação Iniciar, Limpar e Ajustar filtros. Acima da lista ficam os botões Parar, Log de Alterações, Adicionar (+), Limpar ordenações e Configurações de Visão (engrenagem). Ao centro, a lista exibe os workers com as colunas Nome, Worker e Status.

Botões de ação​

Iniciar: aplica os filtros e carrega a lista de workers. (No detalhe de um worker, o botão Iniciar coloca o worker em execução.)

Limpar: remove os filtros aplicados e retorna a tela ao estado inicial.

Ajustar filtros: abre o modal de seleção de campos de filtro. Confira os detalhes na seção Modal: Ajustar filtros abaixo.

Parar: interrompe a execução do worker selecionado. Para utilizá-lo, selecione o worker na lista e clique em Parar.

Log de Alterações: exibe o histórico de cadastro (auditoria) das alterações de configuração dos workers. Confira os detalhes na seção Log de Alterações abaixo.

Adicionar (+): abre o formulário de cadastro de um novo worker. Confira os detalhes na seção Cadastro do worker abaixo.

Limpar ordenações: remove as ordenações aplicadas às colunas.

Configurações de Visão: personaliza as colunas exibidas (ícone de engrenagem).

Ao clicar em Ajustar filtros, o sistema abre o modal que permite escolher quais campos ficam disponíveis na barra de filtros da tela.

Os campos disponíveis para filtro são: Nome, Workers e Status.

Figura 2: Workers, Modal: Ajustar filtros.

Os campos disponíveis para filtro são: Nome, Workers e Status.

Lista de Workers​

A lista é preenchida ao abrir a tela ou ao clicar em Iniciar, e exibe todos os workers do módulo.

Modal Configurações de Visão da lista de workers, aba Colunas, com Nome, Worker e Status selecionadas.

Figura 3: Workers, Configurações de Visão.

As colunas exibidas são:

  • Nome: nome do worker. Tipo: texto.
  • Worker: identificação do processo. Tipo: texto.
  • Status: situação atual do worker (ex.: Parado, Em execução). Tipo: texto.

Você personaliza as colunas exibidas pelo ícone de Configurações de Visão (engrenagem), nas abas Colunas e Ordenar.

Configuração e salvamento de visões​

O seletor Padrão, no topo da tela, permite salvar e reutilizar configurações de filtros e colunas.

As opções disponíveis são Padrão (visão original do sistema), Gravar como (salva a configuração atual como uma nova visão) e Administrar (gerencia as visões salvas).

Figura 4: Workers, Configuração e salvamento de visões.

As opções disponíveis são Padrão (visão original do sistema), Gravar como (salva a configuração atual como uma nova visão) e Administrar (gerencia as visões salvas).

Cadastro do worker​

Para visualizar ou editar um worker, clique no ícone de detalhe (lupa), à direita da linha. Para cadastrar um novo, clique em Adicionar (+).

A página de detalhe exibe os dados gerais do worker (Worker, Nome e Status), seus parâmetros de configuração (Descrição e Valor) e o campo Tempo de Execução (Segundos), que define o intervalo entre as execuções do worker.

Figura 5: Workers, Cadastro do worker.

A página de detalhe exibe os dados gerais do worker (Worker, Nome e Status), seus parâmetros de configuração (Descrição e Valor) e o campo Tempo de Execução (Segundos), que define o intervalo entre as execuções do worker. Os botões disponíveis são Iniciar (coloca o worker em execução), Editar (habilita a edição), Remover (exclui o worker) e o botão de voltar (retorna à lista).

Logs do worker​

Cada worker possui um ícone de Logs, à direita da linha, que exibe o histórico de execução do processo, útil para acompanhar o que foi processado e diagnosticar eventuais erros.

Tela Workers, Logs do worker

Figura 6: Workers, Logs do worker.

Log de Alterações​

O botão Log de Alterações, acima da lista, exibe o histórico de cadastro (auditoria) das alterações de configuração dos workers, com o responsável e a data/hora.

Tela Workers, Log de Alterações

Figura 7: Workers, Log de Alterações.

Workers disponíveis​

O módulo disponibiliza os seguintes workers (CP = Contas a Pagar; LCM = Lançamento Contábil Manual):

  • Integração com VAN online via API: após o cadastro de uma VAN, busca de tempos em tempos os arquivos disponibilizados pelo banco.
  • Atualização de Dados do Parceiro: atualiza o cadastro do parceiro sempre que há uma alteração no sistema de origem. Pré-requisito: o sistema de origem deve gerar um log de atualização no cadastro do parceiro.
  • Busca automática de documentos: busca os documentos a pagar no sistema de origem por meio da conexão configurada na integração.
  • Importação de DDA VAN API: importa para a tela de DDA do BankPlus o arquivo DDA capturado pela VAN (disponibilizado pelo banco e buscado pelo worker Integração com VAN).
  • Geração de Ordem de Pagamento: após as previsões serem geradas e aprovadas (quando há workflow de aprovação ativo), gera e envia automaticamente as remessas de pagamento ao banco.
  • Importação de Retorno: importa os arquivos de retorno capturados pela VAN para a tela Gerenciador de Retorno da Ordem de Pagamento.
  • Integração via WebHook: importa e processa as mensagens de WebHook das APIs que oferecem essa tecnologia; quando a mensagem é um pagamento, cria o rascunho de CP/LCM para posterior integração.
  • Serviço de Integração de Contas a Pagar com Sistema de Origem: integra as contabilizações de contas a pagar no sistema de origem.
  • Serviço de Integração de Lançamento Contábil com Sistema de Origem: integra os lançamentos contábeis no sistema de origem.
  • Conciliação de Contas a Pagar: verifica se um contas a pagar foi compensado com sucesso no sistema de origem.
  • Envio de Comprovante: quando habilitado em um ou mais contratos de pagamento, envia os comprovantes de pagamento para o e-mail dos fornecedores, conforme o cadastro.
  • Serviço de Processamento de DDA: faz o vínculo automático dos DDAs importados com os documentos a pagar. As parametrizações ficam no contrato; a principal é a condição com base no vencimento (o boleto DDA é vinculado a um documento a pagar determinada quantidade de dias antes do vencimento).
  • Processamento de Retorno: automatiza o processamento do retorno importado para iniciar a contabilização, criando inicialmente um rascunho de CP/LCM no BankPlus para posterior integração.

Conclusão​

A tela Workers reúne a automação de ponta a ponta do módulo de Pagamento, da captura de arquivos no banco à contabilização no sistema de origem. Manter os workers corretamente configurados e ativos garante que as rotinas do BankPlus rodem automaticamente, com rastreabilidade pelos logs de execução e de alterações.

Artigos relacionados​