Pré-requisitos

Os anexos de retorno devem ser liberados nas permissões de perfil dos usuários para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual o Manual de Instalação de Customizações na Customizações na seção Liberando Acesso aos Menus.

Após serem liberados nas permissões de perfil dos usuários teremos acesso as customizações no módulo Educacional através do caminho:

Módulo Educacional | Educacional | Aba Customização.

Detalhamento do processo

A interface customizada estará disponível em:

TOTVS Educacional | Customizações | Integração SALESFORCE | Parâmetros

A partir dela, o usuário poderá configurar os seguintes parâmetros:

Dados de Conexão – WS, deve ser informado os dados:

• Endereço WebService: informar o endereço de acesso ao WebService disponibilizado pelo Perseus.
• Usuário: informar o Usuário de acesso ao WebService disponibilizado pelo Perseus.
• Senha: informar a senha de acesso ao WebService disponibilizado pelo Perseus.

Bolsa Adicional: será utilizado para conceder descontos, que poderão ser aplicados em campanhas promocionais, aplicadas pelo vendedor no ato da venda no SALESFORCE.

Serviço para pagamento com boleto:  Neste parâmetro deverá ser associado apenas um registro, o “Mensalidade – Boleto”

Serviço para pagamento com cartão de crédito: Neste parâmetro deverá ser associado apenas um registro, o “Mensalidade – Cartão Crédito”.

Serviço para pagamento com cartão de débito: Neste parâmetro deverá ser associado apenas um registro, o “Mensalidade – Cartão Débito”.

Serviço para pagamento com dinheiro: Neste parâmetro deverá ser associado apenas um registro, o “Mensalidade - Dinheiro”.

Status de Matrícula – Inativar Contrato Cancelado: Usuário define o código da Situação de Matrícula que será utilizada para cancelar um contrato no Salesforce.

Status de Matrícula – Inativar Contrato Suspenso: Usuário define o código da Situação de Matrícula que será utilizada para suspender um contrato no Salesforce. 

Status de Matrícula Inicial - Importação Salesforce: Usuário define o código da Situação de Matrícula que será utilizada para matricular o aluno no SGE pelo processo de Importação de Matrícula. 

Modalidades de Curso - Técnicas e EJA:  O usuário deverá informar a(s) Modalidade(s) de Curso(s) cadastro nativo (SMODALIDADECURSO). Para todos os cursos que estiverem vinculados às modalidades informadas neste parâmetro, no envio da Matriz Curricular /Plano de Curso a customização irá enviar para o SALESFORCE a modalidade "Técnico". Para as modalidades que não estiverem parametrizadas, será enviado "Curta e Média duração". Essa classificação é utilizada no SALESFORCE para agrupamento dos planos de pagamento. A FIEC poderá incluir novas modalidades de acordo com a necessidade.

• Caso a natureza financeira não seja enviada, será necessário cadastrá-las manualmente através da interface no SGE. 
• O campo conta contábil não está disponível para inclusão via API (apenas pela interface). 
• Os cadastros de Produtos e Natureza Financeira do CRM precisam estar equivalentes aos cadastros do Protheus/SGE, com os mesmos códigos, para que seja possível efetuar o de-para entre os cadastros/sistemas. Tais cadastros são enviados do SGE para o Protheus, no momento do envio do Pedido de Venda (integração Protheus), exatamente como foram importados do CRM.
• A API só deve ser acionada para envio de serviços relacionados à mensalidades/cursos. Demais serviços já deverão estar disponíveis no SGE, como por exemplo: segunda via de histórico, taxa de material escolar, multa rescisória, dentre outros.
• Quando o serviço do CRM for atualizado com status inativo, não serão atualizadas as matrizes curriculares dos cursos relacionados, já que se fossem inativadas, não seriam permitidas novas matrículas para as turmas já existentes. 

Pré-requisitos

Alterar a situação de matrícula do aluno no período letivo para uma das situações parametrizadas na aba Status de Matrícula – Inativar Contrato, para que o contrato do aluno seja Cancelado ou Suspenso no SALESFORCE. 

Detalhamento do processo

Exportar do SGE para o SALESFORCE os dados de cancelamento ou suspensão de contrato e atualização de vagas na turma, sempre que a situação de matrícula do aluno no período letivo for alterada para um status parametrizado (que exige alteração contratual e libere a vaga do aluno na turma).

O usuário deverá efetuar o processo de Alteração de situação de matrícula, por meio do menu: 

Secretaria | Matrícula | Matrícula no Período Letivo, em seguida, Processo | Alterar situação da matrícula.

Selecione a matricula do aluno no Período Letivo. Clique em Processos –Alterar situação de matrícula.

A customização acionará os métodos do Webservice SALESFORCE, sempre quando a situação de  matrícula do aluno for alterada, para envio dos dados correspondentes.

A exportação de Cancelamento do Contrato Financeiro,  ocorrerá se atender às seguintes regras: 

• A integração do cancelamento do contrato irá ocorrer apenas no momento que a situação de matrícula do aluno for um valor existente nos parâmetros que indicam Inativação de Contrato (aba Status de Matrícula – Inativar Contrato) independente se o contrato/venda se originou no SGE ou no SALESFORCE.
• O registro do contrato do aluno no SGE deverá estar com status de Cancelado.

Após o usuário alterar a situação do aluno no SGE para Cancelado, a turma liberará a vaga na turma do SGE atualizando o campo Alunos Matriculados na turma.

Exemplo 1:

Quantidade de Alunos matriculados antes da alteração de situação de matrícula = 2

Exemplo 2:

Quantidade de Alunos matriculados após alteração de situação de matrícula = 1

Para os casos de alunos que estão Pré-Matriculados e desistiram do curso ou não realizaram  o pagamento do boleto de matrícula dentro do prazo estipulado pela FIEC, o usuário terá que alterar a situação do aluno no SGE para Cancelado, para que ele libere a vaga na turma do SGE (atualiza o campo Alunos Matriculados na turma). Existem dois caminhos para executar este processo sendo eles:

• Para alunos que realizaram a contratação do curso através da funcionalidade do Processo Seletivo, estará disponível em: TOTVS Educacional | Sistema Indústria|Processo Seletivo| Cancelamento de pré-matrícula (Customização do Departamento Nacional).
• Já para as contratações de alunos que foram realizadas diretamente via secretaria (balcão) sem ser através do Processo Seletivo, estará disponível em: TOTVS Educacional| Matricula e Avaliação| Menu Mais…| Confirmação de matrícula por pagamento (recurso nativo no RM).

A atualização das vagas da turma ocorrerá sempre que o status de matrícula do período letivo for alterado para um dos valores parametrizados (Cancelamento ou Suspensão).

O caminho para execução deste processo está disponível em:

TOTVS Educacional| Matricula e Avaliação| Menu Mais…| Confirmação de matrícula por pagamento (recurso nativo no RM).

Pré-requisitos

É necessário que o Contrato seja gerado automaticamente para todas as matrículas importadas do SALESFORCE para o SGE.

Detalhamento do processo

Armazenar as informações referente a compra realizada pelo E Commerce e  cálculo de multa rescisória e crédito do aluno, caso existam para aquele contrato. A interface customizada estará disponível em: 

TOTVS Educacional | Financeiro/Contábil | Contratos| Anexos | Dados Complementares do Contrato.

Image RemovedImage Added

Os dados serão preenchidos automaticamente pela customização através do processo de importação de Vendas/Matrículas do SALESFORCE para o SGE, detalhado no Processo de Importação de Vendas - Matrículas SALESFORCE.

A interface irá exibir os seguintes campos:

• ID Oportunidade Venda: ID da oportunidade de venda gerado pelo SalesForce
• Data Venda: data da realização da venda
• Pedido Fiscal: Número do Pedido Fiscal gerado no Protheus
• Recebe boleto por e-mail: indica se o aluno irá receber o boleto por email. Este campo poderá ser alterado manualmente pelo usuário, diretamente no SGE.
• Código XNUMPRO: código de rastreamento do contrato. O formato do XNUMPRO é SGE+(Cód Coligada)+F(Cód Filial)+C(Num Contrato). Ex: SGE3F20C123
• Forma de pagto da Primeira parcela: indica a forma de pagamento da primeira parcela
• Forma de pagto das demais parcelas: indica a forma de pagamento das demais parcelas
• Quantidade de parcelas do contrato: Indica a quantidade de parcelas (mensalidades) do contrato.
• Número de parcelas pgto cartão (1ª parcela): Indica a quantidade de parcelamento quando o pagamento da primeira parcela for em cartão. 
• Duração: indica a duração do curso em meses
• Data da Compra: preenchido pela integração com a data da venda (oportunidade fechada), o mesmo  não poderá ser editado pela interface.
• E commerce: preenchido pela integração com Sim ou Não, o mesmo não poderá ser editado pela interface.
• ID Oportunidade Venda: preenchido pela integração com o identificador da oportunidade gerada pelo SALESFORCE, o mesmo não poderá ser editado pela interface.
• Recebe Boleto por E-mail: preenchido pela integração com Sim ou Não, o mesmo não poderá ser editado pela interface.
• XNUMPRO: Número do contrato gerado no SGE, no momento da importação de matrícula. Este campo também existirá no anexo de parcelas, já que parcelas extras lançadas após a criação do contrato poderão ter outro XNUMPRO. No entanto, teremos um XNUMPRO principal, referente ao contrato.
• Forma de Pagamento - Primeira Parcela: Forma de pagamento da primeira parcela enviada pelo Salesforce no processo de importação de matrícula. A primeira parcela pode ser paga em dois cartões: dois de crédito, dois de débito ou um de cada. Armazenar a sigla enviada pelo Salesforce e a descrição da forma de pagamento.
• Forma de Pagamento - Demais Parcelas: Forma de pagamento da segunda parcela em diante, enviada pelo Salesforce no processo de importação de matrícula. Armazenar a sigla enviada pelo Salesforce e a descrição da forma de pagamento.

Além das informações de Dados da baixa com Cartão, sendo elas:

• E commerce:  Sim ou Não, enviado pelo Salesforce no processo de importação de matrícula. 
• Adquirente do Cartão: Nome da adquirente, informado pela Loja e enviado pelo Salesforce no processo de importação de matrícula.
• NSU: Número do NSU do pagamento, informado pela Loja e enviado pelo Salesforce no processo de importação de matrícula.
• Meio de pagamento: Débito ou Crédito, informado pela Loja e enviado pelo Salesforce no processo de importação de matrícula.
• Bandeira: Nome da bandeira do cartão: Visa, Mastercard etc, informado pela Loja e enviado pelo Salesforce no processo de importação de matrícula.
• Quantidade de parcelas: Quantidade de parcelas do pagamento com cartão, informado pela Loja e enviado pelo Salesforce no processo de importação de matrícula.
• Valor total da Venda do cartão: Valor pago no cartão de crédito ou débito, informado pela Loja e enviado pelo Salesforce no processo de importação de matrícula.

Pré-requisitos

Não se aplica

Detalhamento do processo

Nesta interface o usuário poderá consultar os Logs das operações de exportação executadas pela integração do TOTVS Educacional com Perseus/Salesforce.

Os históricos das exportações de dados para o Perseus serão registrados e poderão ser visualizadas no menu: 

TOTVS Educacional | Customizações | Integração SALESFORCE |Monitor de Log

Será apresentada ao usuário uma visão com a relação de registros importados e exportados.

• Id Log: Identificador sequencial de Log.
• Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
• Valores Chave: Chave primária do registro integrado.
• Status: Situação da Integração (Sucesso ou Erro).
• Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação de Curso).
• Módulo: Tipo da integração que está sendo feita.
• Data de Criação: Data de Criação do registro.
• Data da última alteração: Data da última alteração do registro

Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:

Protótipo:

• Id. Item Log: Identificador sequencial do item de log.
• Id. Log: Identificador sequencial de log.
• Mensagem: Mensagem com o status da integração do item.
• Status:  Situação da integração do item selecionado.
• Dados Enviados: Relação dos dados enviados para integração.
• Dados Recebidos: Relação dos dados recebidos.
• Data de Criação:  Data de criação do registro. 
Data da última Alteração: Data da última alteração do registro.
• integração.
• Dados Recebidos: Relação dos dados recebidos.
• Data de Criação:  Data de criação do registro. 
• Data da última Alteração: Data da última alteração do registro.

No log os registros são agrupados pelas seguintes funcionalidades:

1 - Importação Serviço CRM
2 - Exportação de Curso
3 - Exportação da Matriz Aplicada
4 - Exportação da Disciplina
5 - Exportação da Turma
6 - Exportação de Cancelamento de Matrícula
7 - Importação Responsável Financeiro
8 - Importação Aluno
9 - Importação Matrícula

10- Gerar Contrato
11 - Atualização Quantidade Matrículas

Pré-requisitos

Não se aplica

Detalhamento do processo

Este processo possibilita ao usuário programar o reenvio de registros processados com erro que não foram exportados corretamente para o Perseus/Salesforce.

A funcionalidade está disponível na tela de Monitor de Logs, menu :

Processos | Reenvio de Registros.

Será permitido o usuário selecionar apenas um registro quando o mesmo estiver com o status de (Cancelado, Erro ou Pendente) e poderá ser executado manualmente. Ou caso o usuário não selecione nenhum registro na visão do Monitor de Logs, ele poderá executar ou agendar o reenvio, o processo processará novamente todos os registros com os status Erro ou Pendente.

Ao ser acionado o processo customizado de reenvio de dados a customização tentará realizar novamente o envio das informações ao Protheus, caso consiga o status do registro passará para Sucesso.

O processo de reenvio automático será executado até atingir o número máximo de tentativas parametrizado no Req.01 deste documento. Caso o parâmetro esteja vazio a customização não realizará nenhuma tentativa de reenvio automaticamente. 

Caso seja atingido o número máximo de tentativas de reenvio e em nenhuma das tentativas tenha retornado sucesso, a customização passará o status do registro para Cancelado, sendo o registro não integrado com o Perseus/Salesforce.  

Dependendo do erro ocorrido, o usuário precisará acessar o Monitor de log e analisar os logs, corrigir os registros (caso necessário) e então acionar o processo de reenvio. 

O reenvio será realizado conforme regras definidas nos requisitos originais de cada funcionalidade de exportação. O reenvio será realizado conforme regras definidas nos requisitos originais de cada funcionalidade de exportação..