Integração TOTVS RM - Integração de Bolsas com TOTVS RM®

O que é? 
 
Este documento tem como objetivo ajudar você a configurar a integração para a inclusão de bolsas de estudo com base nos cupons de desconto utilizados no CRM. Antes de realizar o processo de baixa da primeira parcela ou taxa de matrícula, a integração irá adicionar no contrato do aluno, no Módulo Educacional do TOTVS RM®, a bolsa correspondente aplicada via cupom de desconto na Ficha de Inscrição do CRM Educacional. Assim, você poderá realizar a baixa do lançamento financeiro em seguida. 
 
Premissas 
 
Para que essas configurações funcionem corretamente, é necessário que as configurações do TBC estejam devidamente ajustadas na integração. Os cadastros das bolsas no TOTVS RM® devem ter o valor ou percentual devidamente preenchidos ou o mapeamento ajustado para passar o percentual do cupom na bolsa. Além disso, é essencial que o serviço de pagamentos (boletos, cartão de crédito e débito) e sua devida integração já estejam homologados na ficha de inscrição. 
 
Configurações de Data Servers 
 
Para iniciar as configurações, acesse o aplicativo de Integração TOTVS® no Wakeme PRO. Na seção Configurações, aba Config. DataServers, inclua o DataServer "EduBolsaAlunoData" para cada uma das coligadas que irá utilizar a integração. 

Mapeamentos 
 
Por padrão, todos os campos necessários para o correto funcionamento da integração de bolsa já são tratados internamente e não precisam de mapeamento adicional. No entanto, se necessário, é possível realizar novos mapeamentos para sobrescrever o comportamento padrão. 
 
  

Utilizando a mesma bolsa com percentuais diferentes 
 
Normalmente, o cadastro do percentual de desconto da bolsa deve corresponder ao percentual do cupom, sendo necessário criar uma bolsa para cada percentual diferente. No entanto, uma alternativa para facilitar a gestão desses cadastros é utilizar um mesmo código de bolsa que permite a alteração de valor e mapear os campos de percentual de desconto do cupom e alguma outra informação no campo de observação da bolsa. Isso facilita a identificação no TOTVS RM®. Veja o exemplo a seguir para realizar o mapeamento. 
 
  

Obs.: O campo de desconto deve utilizar o tipo de conversão Decimal 6 ou menor para que a integração entenda corretamente as casas decimais do desconto. 
 
Código da Bolsa no Cupom de Desconto 
 
Após realizar os mapeamentos, é necessário incluir o código da bolsa no cadastro do cupom de desconto para que a integração identifique a bolsa e faça a inclusão no contrato. Para identificar o código correto, acesse o módulo educacional do TOTVS RM®, na aba Financeiro/Contábil, no cadastro de Bolsas. Identifique ou crie uma bolsa para o respectivo cupom de desconto do CRM. No exemplo a seguir, encontramos a bolsa com o código 11, DESCONTO DE IRMÃOS, onde o valor de desconto é um percentual de 5%. 
 
 

Após identificar ou criar a bolsa no TOTVS RM®, acesse o cadastro do cupom de desconto no CRM, encontre a Seção de Integrações e digite no campo Código Cupom SGA o código da respectiva bolsa. No exemplo abaixo, estamos vinculando a bolsa de código 11 ao cupom de desconto. Confira na imagem a seguir: