Páginas filhas
  • Manual Operacional da Customização - Integração SGE x Dynamics

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Projeto: FS008539 – Integração SGE x Dynamics

Nome do cliente: FIEPA


Objetivo
Este documento foi elaborada para informar aos multiplicadores e usuários-chave da área Educacional sobre as funcionalidades que possibilitarão a integração do SGE com o Dynamics. Também tem como objetivo habilitá-los a usarem as funcionalidades associadas a esses processos no SGE – SISTEMA DE GESTÃO ESCOLAR (TOTVS Educacional), bem como capacitar novos multiplicadores e usuários finais. Para isso, será apresentada uma visão prática do processo e cadastros educacionais, explorando os conceitos utilizados e as funcionalidades do Sistema. O material orienta a execução das atividades para garantir que todo o Processo Educacional mapeado durante o Programa seja contemplado.


Público Alvo
Este manual é destinado aos colaboradores selecionados como multiplicadores e usuários-chave para o Programa SGE.


Metodologia
Este material tem como base a visão prática e completa do Processo Customizado ,da área Educacional utilizando a Integração com o Dynamics. A metodologia utilizada tem como ponto de partida o mapeamento completo do respectivo processo, relacionado com as interfaces no Sistema TOTVS Educacional. Sempre que houver alguma atividade a ser realizada no Sistema, as suas funcionalidades e rotinas serão explicadas com detalhe.


Expandir
titleParâmetros da Customização

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 de Instalação de Customizações na seção Liberando Acesso aos Menus.

Print tela


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 Dynamics | Parâmetros

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

Atualiza Cliente PJ: Se o campo não estiver marcado, alterações em cliente PJ não serão enviadas para o Dynamics.
Client ID: Informe o identificador do cliente na API.
Client Secret: Informe a secret utilizada pela API.
Código da Filial Dynamics - Site: Deverá ser preenchido e armazenado por filial no RM. Será utilizado para informar o código correspondente à filial que será enviado para o Dynamics na integração, eliminando a necessidade de de-para fixo no código fonte.
Código da Coligada: Deverá ser preenchido e armazenado por coligada no RM. Este código será utilizado pela integração, substituindo os momentos em que são enviados os códigos fixos 1–SESI e 2-SENAI (campo Company).
Código do Produto: Deverá ser preenchido e armazenado por coligada no RM. Será utilizado para informar o código correspondente ao produto que será enviado para o Dynamics na integração, eliminando a necessidade de manter o código fixo no código fonte.
Concatenar Código Coligada ao Departamento: Deverá ser marcado e armazenado por coligada no RM. Será utilizado para definir se o código da coligada será concatenado ao código do departamento, no momento do envio da dimensão financeira, campo DimensionDisplayValue. Tal informação é enviada ao Dynamics nos processos de taxa extra, contrato e alteração de competência.
Conta Orçamentária - Receita: Campo texto para informar o código da conta orçamentária que será utilizada no envio da combinação da dimensão contábil (criação do contrato de venda).
Conta Orçamentária - Carga Inicial - Acordo: Campo texto para informar o código da conta orçamentária que será utilizada no envio da combinação da dimensão contábil e conta contábil na carga de dados de Acordos.
Conta Orçamentária – Receita – Taxas Extras: Campo texto para informar o código da conta orçamentária que será utilizada no envio da combinação da dimensão contábil e conta contábil (envio de taxas extras do contrato de venda).
Data de Produção (Preenchido pelo processo de Carga): Esse campo será preenchido automaticamente com a data que o usuário realizou o Processo Customizado de Carga Inicial de Dados. A customização não realizará o bloqueio deste campo para edição manual.
Número tentativas de reenvio: Campo texto para informar o número máximo de tentativas que a customização deverá tentar realizar a integração com dynamics dos registros com status de erro.
Serviço (por nível de ensino): Campo utilizado para informar o código do serviço que será considerado para envio dos contratos para o Dynamics.
Status que indica Matrícula: Será exibido uma lista da tabela padrão de situação de matrícula (SSTATUS) para que seja informado quais situações de matrícula que a customização irá considerar o aluno como matriculado.
Endereço do Web Service de Autenticações: Endereço de acesso ao Webservice para autenticação para das operações no Dynamics.
Endereço do Web Service de Integrações: Endereço de acesso ao Webservice disponibilizado pelo Dynamics para efetuar as operações de inserção de clientes, contratos, títulos, baixas, etc.


Nota
titleDica:

Para preencher cada um dos campos acima, clique duas vezes em cima do campo ou clique no ícone "Editar"

Expandir
titleExportação e Atualização de Clientes

Pré-requisitos

Para que alterações em clientes PJ não sejam enviadas para o Dynamics, o parâmetro abaixo não deverá estar habilitado.

Detalhamento do processo

Ao incluir um Contrato Educacional no TOTVS Educacional, o responsável financeiro associado às parcelas deste contrato serão enviadas para o Dynamics, junto com os dados do Pedido (Contrato). Caso o responsável financeiro associado já exista no Dynamics, será enviada uma atualização deste cadastro. Para integração destes dados foi desenvolvido um processo de exportação no TOTVS Educacional | Customização | Integração Dynamics | Exportação | Contratos.


O processo poderá ser executado a qualquer momento pelo usuário, na data do processamento ou agendado conforme recurso nativo de agendamento de job.

Ao ser executado, este processo enviará os Responsáveis Financeiros (clientes) dos contratos pendentes de envio para o Dynamics. (O detalhamento do envio do contrato está disponível em item específico deste manual).

Atualização de Clientes

Ao alterar os campos listados abaixo no cadastro de clientes (somente Pessoa Física), será enviada uma atualização deste cadastro para o Dynamics. 

Campos a serem atualizados: 

  • Nome
  • Data de nascimento
  • Endereço
  • Contato

Ao editar qualquer um dos campos citados, será enviada automaticamente uma atualização deste cliente (Pessoa Física) para o Dynamics. Para realizar a alteração, acesse o TOTVS Backoffice | Gestão Financeira | Cadastros | Clientes Fornecedores.

Expandir
titleValidação no Período Contábil do Contrato Educacional

Descrição do processo

A customização não permitirá que um contrato educacional seja incluído sem o preenchimento dos campos Competência Inicial e Competência Final. 

Além disso, foi desenvolvido uma consistência para alteração destas datas, devendo respeitar algumas regras: 

  • Não será permitido data de competência sem preencher. (Se estiver preenchida no plano de pagamento, já será preenchida automaticamente no contrato).
  • Contrato Contabilizado no Dynamics: Não será permitido alteração das datas de competência. 
  • Contrato não contabilizado no Dynamics: será permitido alterar data de competência inicial desde que seja maior que o mês de execução do processo (data atual).
  • Contrato não contabilizado no Dynamics: será permitido alterar data de competência final desde que seja maior ou igual ao mês de execução do processo (data atual).


Detalhamento do processo

Para o preenchimento ou alteração das datas de competência no contrato educacional, acesse TOTVS Educacional | Financeiro - Contábil | Contratos. Ao editar o contrato, acesse a aba “Contabilização”.

Nota
titleDica:
Para o preenchimento automático das datas de competência no contrato educacional, preencha estas datas no cadastro do Plano de Pagamento. Disponível em: TOTVS Educacional | Financeiro - Contábil | Planos de Pagamento.


Assim, todo contrato que for incluído para este plano, já terá estas datas preenchidas automaticamente.

Expandir
title Validação ao salvar Matriz Aplicada

Descrição do processo

Ao salvar uma Matriz Aplicada no TOTVS Educacional, a customização fará as seguintes validações: 

  • Centro de Custo deverá estar preenchido nas Matrizes Aplicadas do SENAI e SESI. 
  • Departamento deverá estar preenchido nas Matrizes Aplicadas do SENAI.

Detalhamento do processo

A validação para inclusão ou alteração da Matriz Aplicada será nos campos Centro de Custos (Sesi e Senai) e Departamento (somente Senai). Disponível em: TOTVS Educacional | Currículo e Oferta | Matrizes Curriculares | Anexo | Matriz Aplicada


Aviso
titleImportante:

Para a Coligada SESI, o departamento será validado no cadastro de Turmas. 

Validação

Portanto haverá uma validação ao salvar uma Turma (SESI)

Ao salvar uma Turma no TOTVS Educacional, a  a customização irá verificar se o campo Departamento disponível em: TOTVS Educacional | Currículo e Oferta | Turmas | Aba Identificação  esta preenchido, pois a validação para inclusão ou alteração da turma, será no campo Departamento. 



2.6 Exportação de Contratos | Parcelas | Lançamentos Financeiros | Boletos

Âncora
_2et92p0
_2et92p0
Descrição do processo:
A integração de Contratos e Parcelas/Boletos será realizada para os contratos e parcelas/boletos de alunos com situação de matrícula no Período letivo igual a situação de matrícula parametrizada e que ainda não foram exportados para o Dynamics.
Serão exportadas parcelas de mensalidades e também alteração em parcelas já integradas anteriormente.
Âncora
_tba5i9v8m2v8
_tba5i9v8m2v8
Para integração destes dados foi desenvolvido um processo de exportação no TOTVS Educacional | Customização | Integração Dynamics | Exportação | Contratos.
Âncora
_ckl5s3sfnoub
_ckl5s3sfnoub

Âncora
_2et92p0
_2et92p0
Detalhamento do processo:
Status que indica matrícula:
A situação de matrícula deverá estar informada nos parâmetros da customização. Serão considerados para exportação todos os contratos de alunos com o status informado neste parâmetro.

Exportação de Mensalidades:
Para exportar os contratos/lançamentos/boletos para o Dynamics, acesse o menu TOTVS Educacional | Customização | Integração Dynamics | Exportação | Contratos.
Âncora
_6u05nsb9u0fz
_6u05nsb9u0fz
O processo poderá ser executado a qualquer momento pelo usuário, na data do processamento ou agendado conforme recurso nativo de agendamento de job.
Âncora
_zulbfvwr3g9
_zulbfvwr3g9

Âncora
_xf98s262z14r
_xf98s262z14r

Âncora
_nm7yvb1da9r7
_nm7yvb1da9r7

Âncora
_nly7ier9wl9t
_nly7ier9wl9t

Âncora
_nl0pfp5bkwo9
_nl0pfp5bkwo9

Âncora
_pp4hi3draimz
_pp4hi3draimz
Ao executar o processo, para cada Contrato Educacional do TOTVS será enviado para o Dynamics cabeçalho de Contrato de Vendas, para cada mês de competência do contrato educacional (período de contabilização do contrato) será criada uma linha no contrato de vendas e para cada Parcela/Boleto do contrato será criada uma linha de boleto no contrato de vendas (linha financeira) no Dynamics.
Para os casos de mais de um responsável financeiro no mesmo contrato, será gerado um lançamento para cada responsável financeiro, e estes lançamentos serão enviados ao Dynamics.
Âncora
_jtea77lbytx2
_jtea77lbytx2
Este processo envia apenas as parcelas referentes à Mensalidades no Contrato. Para identificá-las será criado um parâmetro por Nível de Ensino para definir o Serviço que será reconhecido como Mensalidade, para que a customização consiga identificar as parcelas que estão associadas a esse serviço.
Âncora
_vnozse9r2533
_vnozse9r2533

Âncora
_rjnqlascrurt
_rjnqlascrurt
Alteração de parcelas do contrato
Âncora
_gve8g68sxwx1
_gve8g68sxwx1
Após ter ocorrido a integração de um contrato, poderá haver necessidade de alteração de seus valores no SGE. As alterações abaixo, quando realizadas, serão enviadas para o Dynamics atualizando os valores integrados anteriormente.
Âncora
_qoxmljoq668f
_qoxmljoq668f
⇒ Inclusão de uma nova parcela no contrato: Integração ocorrerá na geração do lançamento financeiro.
Âncora
_s31wju9tw3dk
_s31wju9tw3dk
⇒ Inclusão de bolsa incondicional em parcelas do contrato: Integração ocorrerá na re-geração do lançamento financeiro.
Âncora
_n11x0kn3grn4
_n11x0kn3grn4
⇒ Inclusão de desconto no lançamento financeiro: Integração ocorrerá ao salvar o lançamento financeiro.
Âncora
_ya4yf1rdmjve
_ya4yf1rdmjve
⇒ Alteração de data de vencimento do lançamento financeiro /boleto: Integração ocorrerá ao finalizar o processo de alteração de data de vencimento do lançamento financeiro.
Âncora
_1r5gqebolahs
_1r5gqebolahs
⇒ Cancelamento de lançamento financeiro: integração ocorrerá quando os lançamentos financeiros de um contrato forem cancelados, após a execução do cancelamento do contrato.
Âncora
_r1prfzjlfzxb
_r1prfzjlfzxb

Âncora
_curljlcil2lt
_curljlcil2lt

Âncora
_b9rrkvoxkl3s
_b9rrkvoxkl3s
2.7 Exportação de Taxas Extras

Âncora
_2et92p0
_2et92p0
Descrição do Processo:
A integração de taxas extras será realizada para os contratos e parcelas/boletos de alunos com situação de matrícula no Período letivo igual a situação de matrícula parametrizada e que ainda não foram exportados para o Dynamics.
Serão consideradas taxas extras as parcelas que estiverem associadas à um contrato educacional e que não estiverem associadas ao serviço de Mensalidade (serviço informado no parâmetro customizado).
Detalhamento do Processo:
Âncora
_tba5i9v8m2v8
_tba5i9v8m2v8
Para integração destes dados foi desenvolvido um processo de exportação no TOTVS Educacional | Customização | Integração Dynamics | Exportação | Receitas.
Âncora
_ckl5s3sfnoub
_ckl5s3sfnoub

Âncora
_6u05nsb9u0fz
_6u05nsb9u0fz
O processo poderá ser executado a qualquer momento pelo usuário, na data do processamento ou agendado conforme recurso nativo de agendamento de job.
Âncora
_pp4hi3draimz
_pp4hi3draimz
Ao executar o processo, para cada taxa extra do Contrato Educacional do TOTVS será enviado para o Dynamics a Capa de diário geral da contabilidade, criação das linhas do diário geral da contabilidade e lançamento diário geral da contabilidade.
Âncora
_v9757sgrjsh9
_v9757sgrjsh9

Âncora
_p9x7ou1jseeq
_p9x7ou1jseeq

Âncora
_wlb1dsibf9us
_wlb1dsibf9us

Âncora
_tgsodda73hzu
_tgsodda73hzu

Âncora
_qfw5lorpars
_qfw5lorpars

Âncora
_isupp2k6gtxa
_isupp2k6gtxa
2.8 Exportação de Acordos

Âncora
_2et92p0
_2et92p0
Descrição do Processo:
A realização de acordo no SGE é uma ferramenta que permite a negociação de um ou vários lançamentos financeiros vencidos e/ou a vencer, consistindo na baixa destes lançamentos e gerando novos boletos com novos vencimentos.
Os acordos realizados no SGE ou pelo Portal do aluno que estiverem com o status = "efetivado" e que ainda não foram exportados para o Dynamics poderão ser enviados através do processo customizado.
Detalhamento do Processo:
Âncora
_tba5i9v8m2v8
_tba5i9v8m2v8
Para integração destes dados foi desenvolvido um processo de exportação no TOTVS Educacional | Customização | Integração Dynamics | Exportação | Acordos.

Âncora
_6u05nsb9u0fz
_6u05nsb9u0fz
O processo poderá ser executado a qualquer momento pelo usuário, na data do processamento ou agendado conforme recurso nativo de agendamento de job.
Âncora
_dz39x4f7n1n6
_dz39x4f7n1n6

Âncora
_xycfyu7vqa6r
_xycfyu7vqa6r

Para cada Acordo Financeiro do TOTVS Gestão financeira será enviada para o Dynamics os métodos de Criação da capa do diário de acordo SGE, Criação das linhas da capa do diário de acordo SGE, Criação das linhas de acordo referente ao título gerado e Lançamento do diário de acordo SGE.
Âncora
_3b19uaca6ps7
_3b19uaca6ps7

Âncora
_tnjjgpl2730q
_tnjjgpl2730q
2.9 Exportação de Baixas e Pagamento Antecipado

Âncora
_2et92p0
_2et92p0
Descrição do Processo:
As baixas de boletos vinculados aos contratos educacionais ocorrerão no SGE e serão enviadas para o Dynamics através de processo customizado.
A exportação de baixas será realizada para os seguintes tipos de baixa:
Baixa Manual do boleto: Ao realizar uma Baixa manual do boleto no TOTVS será necessário informar manualmente o valor pago.
⇒ Baixa automática do boleto: A baixa automática do boleto será realizada a partir dos pagamentos com cartão de crédito/débito pelo Portal do aluno e pelo retorno do arquivo de retorno do banco.
Detalhamento do Processo:
Âncora
_tba5i9v8m2v8
_tba5i9v8m2v8
Para integração destes dados foi desenvolvido um processo de exportação no TOTVS Educacional | Customização | Integração Dynamics | Exportação | Baixa.

Âncora
_6u05nsb9u0fz
_6u05nsb9u0fz
O processo poderá ser executado a qualquer momento pelo usuário, na data do processamento ou agendado conforme recurso nativo de agendamento de job.
Exportação de Baixas
O processo irá acionar os métodos do Dynamics de Criação da capa do diário de baixa de pagamento, Criação das linhas da capa do diário de baixa do pagamento e Lançamento do diário de baixa de pagamento. Após processamento, o Dynamics retornará à informação se o registro foi processado com sucesso ou erro, informando a mensagem em caso de erro.
Exportação de Pagamento Antecipado
As baixas de lançamentos financeiros/boletos que possuem data de vencimento posterior ao mês corrente e que foram baixadas no mês corrente serão considerados pagamento antecipado.
A customização irá acionar os métodos Criação da capa do diário de adiantamento de contrato de venda, Criação das linhas da capa do diário de adiantamento e Lançamento do diário de adiantamento, enviando todas as informações do Pagamento Antecipado. Após o processamento o Dynamics retornará à informação se o registro foi processado com sucesso ou erro, informando a mensagem em caso de erro.


Âncora
_o58yos4p9ztj
_o58yos4p9ztj


Âncora
_1e5jjhu6h52g
_1e5jjhu6h52g

Âncora
_wrealr274qt3
_wrealr274qt3
2.10 Cancelamento de Contrato

Âncora
_2et92p0
_2et92p0
Descrição do Processo:
Os contratos educacionais do SGE já integrados ao Dynamics poderão ser cancelados a qualquer momento, através de funcionalidade nativa do SGE. Ao realizar este processo, a customização irá enviar as informações de cancelamento para o Dynamics, ao final da execução do processo.
Detalhamento do Processo:
Quando é enviado um cancelamento, o Dynamics finda o contrato, atualizando seu status. Depois de alterado, o contrato consegue receber apenas novas baixas (de títulos em aberto). Não será mais permitido enviar novos lançamentos e reconhecimento de receita para o contrato.
O cancelamento do contrato no SGE poderá ocorrer através dos seguintes processos:
⇒ Cancelar contrato: (TOTVS Educacional | Financeiro-Contábil | Contratos | Processo | Cancelar Contrato)

⇒ Alterar situação de matrícula: (TOTVS Educacional | Matrícula e Avaliação | Matrículas | Processo | Alterar Situação de Matrícula)



Âncora
_m2cvnryq29e2
_m2cvnryq29e2

Âncora
_zba05ic0gav3
_zba05ic0gav3
2.11 Carga inicial

Âncora
_2et92p0
_2et92p0
Descrição do Processo:
Processo customizado para realizar a Carga Inicial de dados TOTVS Educacional para o Dynamics disponível em: TOTVS Educacional | Customização | Integração Dynamics | Carga Inicial.

Detalhamento do Processo:
Ao ser executado o processo customizado retornará o campo "Data de Corte – Início", para que o usuário informe a Data Inicial que a customização deverá considerar os lançamentos financeiros e os Acordos Financeiros com Status Efetivado e que ainda possuem um ou mais lançamentos financeiros em aberto para esses serem enviados para o Dynamics.
O campo "Data de Corte – Início" será de preenchimento obrigatório. Caso o usuário não informe a data não será possível executar o processo.

Âncora
_dk8qk1wqs9r
_dk8qk1wqs9r

Âncora
_6tlq844eefi5
_6tlq844eefi5
2.12 Processo para Reenvio de Dados

Âncora
_2et92p0
_2et92p0
Descrição do Processo:
O objetivo do processo de reenvio de dados é permitir o envio para o Dynamics dos registros que não foram exportados corretamente. Esse processo poderá ser executado manualmente ou poderá ser agendado, por registro (com status de cancelado, erro ou pendente) e a integração efetuará a exportação dos registros novamente.
Detalhamento do processo
O processo de reenvio de dados está disponível na interface customizada de Monitor de Log que ao ser executado tentará realizar a exportação do registro novamente, armazenando o novo retorno. Será permitido selecionar apenas registros com status de erro ou cancelado. Caso não seja selecionado nenhum registro, serão reprocessados todos os registros com status de erro.
Para acessar o processo: TOTVS Educacional | Customização | Integração Dynamics | Monitor de Log | Processos | Reeenvio

Âncora
_d8qj01buo8om
_d8qj01buo8om

Âncora
_sr41v8bjfmd
_sr41v8bjfmd
2.13 Interface de Log

Âncora
_2et92p0
_2et92p0
Descrição do Processo:
Através do monitor de logs será possível realizar consultas dos Logs de todas as operações de exportação executadas pela integração do TOTVS Educacional com Dynamics.
Detalhamento do processo
O monitor de log está disponível em TOTVS Educacional | Customização | Integração Dynamics | Monitor de Log.

Na tela de log estarão disponíveis os seguintes campos:

  • 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 Cliente).
  • 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.
  • Filial: Filial do registro enviado.