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

Modificado em Qua, 2 Out na (o) 1:17 PM

O que é?

Este documento foi criado para ajudar você, cliente da CRM Educacional, a entender, configurar e utilizar a integração do CRM Educacional com o TOTVS RM® para enviar anexos do CRM para o módulo do processo seletivo e/ou educacional do TOTVS RM®.

Premissas

Para usar essa integração, é necessário que a parte de inscrição/matrícula já esteja funcionando. O usuário que fará a integração precisa ter permissão no processo seletivo para incluir arquivos do candidato. Se a sua instituição usa o TBC® via IIS, existe uma limitação no tamanho da requisição enviada, então é preciso ajustar essa configuração para enviar anexos grandes. No caso do RM Host, essa limitação não existe.

Existem duas maneiras de integrar os anexos pelo processo seletivo. A primeira envia apenas os anexos inseridos na inscrição. A segunda, se configurados os tipos de documentos, envia os anexos como documentos solicitados do aluno no módulo educacional. Esta última opção não é compatível com a integração de automação de ofertas, pois as ofertas no TOTVS RM® precisariam de um cadastro adicional de documentos exigidos, que não está disponível na integração. Existe uma outra integração específica para documentação que atende melhor a necessidade de incluir os documentos no cadastro do aluno conforme os anexos da inscrição.

Parâmetros

Integração de Anexos

O parâmetro [IMPORTACAOANEXOS] habilita essa funcionalidade na integração. Para ativá-la, basta colocar o valor “true”.

De/Para Tipo de Documento

Se a Instituição desejar enviar os anexos como documentos solicitados do aluno no módulo educacional, é necessário fazer uma equivalência do tipo de documento no CRM para o tipo de documento no TOTVS RM®. Use o parâmetro [DEPARA][ANEXOS][DOCUMENTO] com o valor composto por um conjunto de chave/valor em JSON, conforme exemplo:

{
"Certidão de Nasc.": "Certidão de Nascimento",
"RG": "Doc. Identidade"
}

A chave (esquerda) é o nome do documento no CRM e o valor (direita) é o nome do documento no TOTVS RM®. Caso os nomes sejam idênticos, não há necessidade de incluí-lo no de/para.

Configurações no TOTVS RM®

Permissão do processo seletivo

Será necessário atribuir uma permissão específica ao usuário de integração para que ele possa Incluir Arquivos do candidato .

Documentos Exigidos no Educacional

Lembre-se de que esse processo de cadastro é demorado e não é compatível com a integração de automação de ofertas. Sugerimos usar a integração própria para enviar documentos solicitados do aluno no educacional. De qualquer forma, se a Instituição desejar enviar os anexos como documentos solicitados do aluno no módulo educacional, é necessário configurar em todas as Áreas de Interesses Ofertas, quais são os documentos exigidos, bem como marcar a opção de “Exibir na inscrição do portal?”.

Por fim, no cadastro do processo seletivo do TOTVS RM® é necessário habilitar a cópia dos documentos exigidos do processo seletivo para os documentos solicitados do aluno no educacional. Acesse o cadastro do processo seletivo e na aba “Venda online de cursos” habilite o parâmetro “Copiar arquivos de documentos solicitados do candidato para o aluno ao matricular através da venda online”.

Importação da Fórmula Visual

Para finalizar a configuração, é necessário importar uma fórmula visual desenvolvida para tratar os arquivos recebidos pelo TBC®. Baixe a fórmula visual e importe-a seguindo os passos presentes no tutorial:

https://centraldeatendimento.totvs.com/hc/pt-br/articles/360007618012-RM-Integra%C3%A7%C3%B5es-F%C3%B3rmula-Visual-Importa%C3%A7%C3%A3o-Exporta%C3%A7%C3%A3o

Esta fórmula visual utiliza um gatilho na inclusão da inscrição do processo seletivo, então ao importá-la, é necessário marcar o parâmetro de importar gatilhos.