Integração do Rubeus Pay e a Ficha de Inscrições e Matrículas Rubeus

Integração com o Rubeus Pay

A integração com o Rubeus Pay permite o pagamento de itens configurados no menu financeiro da Plataforma Rubeus. Dessa forma, ao parametrizar essa ação em um componente do tipo botão, é possível, em um só clique, executar processos e consultas no TOTVS para gerar o lançamento, bem como buscar todos os dados referentes ao pagamento. Veremos a seguir como configurar essa integração!

||❗Dica: Para o entendimento do conteúdo aqui abordado, é muito importante a leitura do nosso material sobre o Rubeus Pay. Também recomendamos a leitura dos nossos conteúdos sobre componentes para mais contextualização! 😉 

Ações iniciais

No componente do tipo botão, selecione a aba ações e clique em adicionar ação. Então selecione a opção Integrações.

Configurações > Componentes > Novo componente > botão > ações > adicionar ação

Em seguida, clique novamente no botão adicionar ação, que aparecerá na tela. Dentre as opções que serão exibidas, selecione Rubeus Pay.

Lembre-se de incluir uma descrição para identificar mais facilmente essa ação na lista de ações do botão!

Geral

Nas configurações gerais, são exibidos alguns campos importantes. Veremos mais sobre eles a seguir:

1. Descrição: Neste campo, defina a natureza da ação. Do que ela se trata? Geralmente colocamos apenas Rubeus Pay.
2. Canal de pagamento: Nas configurações do Inscrições e Matrículas, na aba integrações, é possível adicionar canais de pagamento para o Rubeus Pay. Todos os canais adicionados são listados aqui para seleção.
3. Item de pagamento: Por padrão, o valor atribuído para pagamento será o valor vinculado à oferta de curso na Plataforma Rubeus. Através de um campo personalizado, é possível vincular um valor diferente, basta selecionar o campo nesta etapa.
4. Campo para salvar o link de pagamento: O link de pagamento é retornado da ação contendo todos os parâmetros necessários em sua URL. Selecione um campo do sistema que será responsável por armazenar esse valor.
5. Referência do lançamento: Defina um campo do sistema para receber o ID do lançamento, para que seja feita a referência do mesmo no momento de gerar o relatório do pagamento.
6. Campo para salvar forma de pagamento: A forma de pagamento é recebida com um nome específico, seja via PIX, boleto ou cartão. Esse nome é armazenado num campo do sistema definido aqui, que será enviado como parâmetro de uma consulta no passo seguinte, para retornar um ID referente ao método de pagamento.

Como destacado na imagem, após os campos ainda é possível definir se a etapa de pagamento deverá abrir um pop-up ou uma nova aba. Não esqueça de selecionar a sua opção desejada.

TOTVS

Nessa parte, o cenário pode variar de acordo com com as configurações da sua ficha e do seu TOTVS, mas idealmente contamos com uma estrutura composta por uma consulta, uma fórmula visual, processos para gerar o lançamento no TOTVS e outra fórmula visual. Veja o exemplo:

1º. Identifique a consulta responsável por retornar ID do tipo de baixa que será usado, seja cartão, boleto ou PIX. Para isso, clique em adicionar ação e selecione realizar consulta. 

2º. A primeira fórmula visual (FV) é responsável por alterar a data de vencimento do lançamento no TOTVS, deixando alinhado com o Rubeus Pay. Para isso, clique em adicionar ação e selecione executar processo. Selecione a fórmula visual já configurada e vincule todas as colunas necessárias aos respectivos campos do sistema.

3º e 4º. Deve ser chamado o processo de dar baixa no lançamento. Para isso, clique em adicionar ação e selecione executar processo. Selecione o processo referente à baixa de lançamento e vincule todas as colunas necessárias aos respectivos campos do sistema. Você pode utilizar o recurso de lógica para definir execuções personalizadas com base em algum retorno da consulta executada no primeiro passo.

5º. A segunda fórmula visual é responsável por desmarcar a conciliação do lançamento. A conciliação é uma flag do TOTVS para confirmação de pagamento, e essa confirmação deve ser inserida manualmente apenas após validação da instituição financeira.

O último passo é definir uma lógica, caso seja necessário. E, claro, não se esqueça de salvar as alterações após finalizar! 😉

Considerações finais

Caso tenha alguma dúvida, não deixe de compartilhá-la com algum especialista Rubeus ou em nossa Comunidade. Até a próxima!