Páginas filhas
  • Manual Operacional da Customização de Contratos

Versões comparadas

Chave

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

Manual Operacional da Customização - Contratos (Integração ERP)


Projetos: FS007270, FS007271, FS007272, FS007878, FS007916, FS008136 e FS008062

Nome do cliente: FIEP

Objetivo


O manual a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual se baseiam no que está descrito nos documentos de especificação dos projetos abaixo e alterações de escopo:

  • FS007270-Integrações AX Fase I
  • FS007271-Integrações AX Fase II
  • FS007272-Pronatec
  • FS007878-Integração AX - Item de Venda
  • FS007916 (960607) - Integração ERP - Item de Venda - Carga Horária
  • FS008136 (A02305) - Tratativas Situação de Matrícula
  • FS008262 - Integração ERP - Data Início Contrato



Expandir
titleParametrização das Integrações

Pré-requisitos


Não se aplica.


Descrição do processo


Esta tela permitirá o cadastro dos parâmetros necessários para conexão com os WebServices necessários para integração do TOTVS Educacional com o Sistema AX, parâmetros necessários para integração do contrato, aditivo de contrato e termo de rescisão, e parâmetros para demais processos da customização.


Detalhamento do processo


No TOTVS Educacional, por meio do menu Customização | Integração ERP | Parametrização das Integrações, o usuário administrador efetuará as parametrizações referentes ao processo.




Deverão ser parametrizados as seguintes informações:


Campo

Descrição

WS – Matrícula

Endereço de acesso ao WebService de Matrícula disponibilizado pelo AX e a chave criptografada de acesso

WS – Customer Service

Endereço de acesso ao WebService de Customer Service disponibilizado pelo AX e a chave criptografada de acesso

WS – Itens de Venda


Endereço de acesso ao WebService de Itens de Venda disponibilizado pelo AX e a chave criptografada de acesso

WS – Informações da Unidade Operacional (Filial)

Endereço de acesso ao WebService de Unidade Operacional disponibilizado pelo AX e a chave criptografada de acesso


Obs.: Campos de preenchimento obrigatório




Guia: Integração com o sistema AX

SubGuia Integração do Contrato | Parâmetros:

 

Aluno do contrato:

Habilita campos complementares do aluno na tela customizada de integração do contrato (Sim/Não): caso seja habilitado este parâmetro, na tela de integração do contrato serão apresentados os dados complementares do aluno.

 




Serviço odontológico:

  • Utiliza serviço odontológico: Marcar a esta flag para informar se o contexto (coligada / filial / nível de ensino) utilizará o serviço odontológico (sim / não). Caso o usuário habilite está “flag”, os demais dados abaixo referentes ao serviço odontológico deverão ser preenchidos.
  • Código do serviço de odontologia: Deverá ser informado o código do serviço de odontologia (item de venda), a ser exibido no processo de integração de contrato com o sistema AX.

Observação:

Ao usuário clicar em “salvar”, a rotina customizada validará se em outro contexto (coligada, filial e nível de ensino) existe o item de venda (código do serviço de odontologia) associado.

Caso seja localizado, será apresentada a seguinte mensagem: “ O item de venda já se encontra parametrizado na coligada ‘X’, filial ‘X’ e nível de ensino ‘X’”. 

  • Valor do serviço de odontologia: Informar o valor do serviço de odontologia, a ser exibido no processo de integração de contrato com o sistema AX.


Pessoas vinculadas ao contrato:

  • Gestor responsável pelo contrato: deverá ser informado o gestor responsável pelo contrato no contexto (coligada/filial/nível de ensino), essa informação parametrizada será buscada no momento da integração do contrato com o sistema AX.
  • Gerente responsável para Assinatura do contrato: deverá ser informado o gerente responsável pela assinatura do contrato no contexto (coligada/filial/nível de ensino), essa informação parametrizada será buscada no momento da integração do contrato com o sistema AX.

Observação:

O CPF do Gerente responsável para Assinatura do contrato, será preenchido automaticamente de acordo com o cadastro da Pessoa no TOTVS. Caso não seja exibido, o cadastro de pessoa deverá ser atualizado podendo ser feito por meio do lookup da seguinte maneira: Clicar no nome da pessoa | cadastro de pessoa | Doc. Básicos e atualizar o CPF.


Alteração da situação de matrícula:

  • Status Matriculado Default: deverá ser informado o status matriculado padrão que será utilizado no processo de mudança de turma
  • Motivo de alteração de matrícula do contrato: deverá ser informado o motivo da alteração de matrícula do contrato que será utilizado no processo de mudança de turma
  • Motivo de alteração de matrícula do aditivo do contrato: deverá ser informado o motivo da alteração de matrícula do aditivo do contrato que será utilizado no processo de mudança de turma
  • Motivo de alteração de matrícula do aditivo do contrato sem valor: deverá ser informado o motivo da alteração de matrícula do aditivo do contrato sem valor que será utilizado no processo de mudança de turma



Modelo de Contrato:

  • Modelo de contrato: deverão ser informados quais modelos de contrato serão apresentados no processo customizado de integração do contrato, requisito 3.



Usuário com permissão para efetivar matrícula com data retroativa:

  • Código de usuário: deverá ser informado quais usuários possuirão permissão para efetuar a matrícula com data retroativa ao mês vigente (conforme descrito por meio do Req.3).



Status de Pré-matrículado: usuário deverá informar quais os status de matrículas considerados como “pré-matriculado”. Por intermédio desta lista, será realizada uma validação através do requisito 3.



Status de Matriculado: usuário deverá informar quais os status de matrículas considerados como “matriculado”. Por intermédio desta lista, será realizada uma validação através do requisito 3.




Expandir
titleGuia Integração de termos de rescisão e aditivos de contrato

Rescisão de Contrato: Usuário deverá informar as situações de matrícula consideradas para verificação se o contrato pode ser rescindido (conforme descrito por meio do Req. 07).



SubGuia Aditivo de Contrato:

Valor da disciplina: Habilita campo para informar valor aplicado da disciplina (Sim/Não): caso seja habilitado este parâmetro, na tela de integração do aditivo do contrato (descrito por meio dos requisitos Req.08 e Req.08.1) será apresentado o campo de valor da disciplina para que o usuário informe no momento da integração.



Mudança de turma: usuário deverá informar as situações de matrículas consideradas para verificação do Status de “Mudança de turma” (conforme descrito por meio do Req.07.1). Sendo informado o status da matrícula de destino.



Equivalências e dispensas: usuário deverá informar as situações de matrículas consideradas para serem utilizadas no processo de “Dispensas” (conforme descrito por meio do Req.08.1).




Modalidade do curso: usuário deverá informar as modalidades de curso consideradas para a integração com o AX das dependências e disciplinas avulsas (Req.08 e Req.08.1).




Venda Avulsa: deverá ser informado um ítem de venda a ser utilizado no momento da integração da venda avulsa (Req.15 – Vendas avulsas).








Expandir
titleAnexo customizado no cadastro de matriz aplicada

Pré-requisitos


Não se aplica.


Descrição do processo


Este anexo permite o preenchimento de informações adicionais do contrato do aluno para serem utilizadas no processo de Integração do contrato ERP.


Detalhamento do processo


O usuário deverá acessar no TOTVS Educacional o menu Currículo e Oferta | Matrizes curriculares, Anexo | Matriz Aplicada, por meio da edição de um registro,  Anexo | Dados do contrato ERP


.



Os seguintes campos serão disponibilizados por meio desta tela:

  • Valor sugerido do curso: usuário preencherá o valor sugerido do curso.
  • Quantidade de parcela: usuário informará a quantidade de parcelas “default” da matriz aplicada (curso).
  • Item de venda: usuário preencherá o item de venda.

Importante:

Um item de venda poderá estar associado a mais de uma matriz aplicada, desde que a matriz aplicada tenha somente o turno diferente de uma para a outra. Caso o usuário escolha o item de venda que já esteja associado a uma matriz aplicada diferente, a rotina customizada emitirá uma mensagem ao usuário e não permitirá que o cadastro seja concluído.




Expandir
titleAnexo customizado no cadastro de município

Pré-requisitos


Não se aplica.


Descrição do processo


Esse anexo permitirá o cadastrado do número IBGE de determinado município


Detalhamento do processo


O usuário deverá acessar no TOTVS Gestão Fiscal,  por meio do cadastro de município, localizado no menu | Cadastros | Município | Anexo | Dados IBGE.


O seguinte campo será disponibilizado por meio desta tela:

  • Número do IBGE (campo texto): usuário preencherá o código do IBGE associado ao município.


Observação: Através do cadastro do responsável financeiro (cliente/fornecedor), na aba de “endereço”, campo “código munícipio”, ao chamar a tela de listagem, é possível efetuar a edição de um município.


Expandir
titleHistórico dos dados de serviço odontológico

Pré-requisitos


É necessário executar o script “Totvs_Campos_Complementares” para criar os seguintes campos:

DTADESAOODONTO – Tipo DateTime

DTCANCSERVODONTO – Tipo DateTime

Ativar os campos complementares: ODONTO, DTADESAOODONTO, DTCANCSERVODONTO.


Descrição do processo


Este requisito possibilita a gravação do histórico das últimas informações antes da alteração dos seguintes campos complementares de matrícula no período letivo: Aderiu serviço odontolócio?, Data de adesão do serviço odontológico, Data de cancelamento do serviço odontológico.


Detalhamento do processo


Usuário acessa por meio do TOTVS Educacional, a matrícula no período letivo, localizada por meio do menu: Currículo e Oferta | Alunos | Matrícula no Período Letivo, para controle odontológico, existirão os seguintes campos complementares:

  • Aderiu Serviço Odontológico (SMATRICPLCOMPL.ODONTO);
  • Data de adesão do serviço odontológico (campo complementar a ser criado na tela de matrícula do período letivo);
  • Data de cancelamento do serviço odontológico (campo complementar a ser criado na tela de matrícula do período letivo)


A cada alteração de dados de um destes campos na matrícula do período letivo, as informações (dados antigos) serão armazenadas em tabela customizada para histórico. 


Expandir
titleProcesso de consulta de status do aluno no ERP

Pré-requisitos


Preencher o endereço e chave de acesso ao WebService de Matrícula conforme Req. 1.


Descrição do processo


Este processo possibilita a visualização do status do contrato do aluno no ERP.


Detalhamento do processo


Usuário acessa no TOTVS Educacional, o processo “Consulta do Status de contrato do aluno no ERP” na tela de “Contrato do ERP”, localizada na matrícula no período letivo, através do menu: Currículo e Oferta | Alunos | Processos, Matricular Aluno, Anexo | Contrato do ERP, seleciona um registro, Processos | Consulta do Status de contrato do aluno no ERP.



Na tela do processo, usuário avança a primeira etapa do processo para que sejam apresentados os dados referente ao status do contrato do aluno retornados pelo ERP.

Expandir
titleConsulta status do aluno no ERP

Pré-requisitos


Não se aplica.


Descrição do processo


Este processo acionará a integração de consulta do Status do aluno no ERP.


Detalhamento do processo


Conforme descrito no requisito 3.6, o usuário acionará a integração de consulta do Status do aluno no ERP.

No processo será consumido método de consulta disponibilizado pelo ERP, serão buscados os seguintes dados :

                Status do Contrato ERP

                Status do aluno.

Expandir
titleCancelamento exclusão, transferência, trancamento

Pré-requisitos


Parametrizar o(s) status de matrícula que o contrato pode ser rescindido por meio do menu Customização | Integrações ERP | Integração com o sistema ERP | Integração de Termos de Rescisão e Aditivos de Contrato | Rescisão de Contrato conforme Req. 1.


Somente um aluno deverá ser selecionado para execução do processo.


Descrição do processo


Este requisito verifica através do processo nativo de “Alteração de Situação de Matrícula” se a nova situação de matrícula selecionada está parametrizada conforme req.1, para rescisão de contrato. Em seguida realiza a rescisão do contrato ou inativação do aluno no sistema ERP, e apresenta o termo de encerramento/rescisão do contrato em PDF para o usuário.


Detalhamento do processo


Quando o usuário 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, a rotina customizada verificará se a nova situação escolhida pelo usuário para a matrícula no período letivo se encontra parametrizada com o “status que o contrato pode ser rescindido” (conforme descrito por meio do requisito 1).


Caso esteja parametrizada, será verificado o tipo de contrato vinculado a matrícula do aluno conforme descrição a seguir:

        Se o contrato em questão for igual a “Pessoa Física com valor” ou “Pessoa Física com valor” será efetuada a rescisão do contrato

        Se o contrato em questão for igual a “Pessoa Jurídica”, “Pessoa Jurídica empresa estrangeira”, “Base Estadual/Nacional” ou “CEI”, será efetuada a inativação do aluno no contrato.


Por fim, será apresentado ao usuário o termo de rescisão do contrato em formato PDF.

Expandir
titleItem de Venda

Pré-requisitos


Preencher dados de conexão de acesso ao WebService do ERP no TOTVS Educacional | Customização | Parametrização das Integrações conforme Req. 1.


Descrição do processo


Este processo realiza integração do TOTVS Educaional com o sistema ERP para importação da lista de itens de venda.


Detalhamento do processo


Usuário deverá acessar o TOTVS Educacional | Menu Customização | Integração ERP | Processos Agendados | Item de venda ERP, ao qual será utilizado o JOBSERVER, por onde o usuário administrador poderá configurar a periodicidade que será agendada o processo  usado na integração do TOTVS Educacional x Sistema ERP.




O processo customizado automaticamente conforme agendamento do JOBSERVER realizará a integração do TOTVS Educacional com o sistema ERP realizando a importação dos itens de venda cadastrados no ERP.

Expandir
titleUnidade Operacional

Pré-requisitos


Este processo irá identificar o código da coligada da Filial de acordo com o CNPJ da Coligada cadastrada no TOTVS Serviços Globais.

Portanto, o usuário deverá atualizar o cadastro de Coligada no TOTVS Serviços Globais | Administração | Coligadas, de modo que as Filiais cadastradas no ERP tenham as Coligadas correspondentes cadastradas no TOTVS Serviços Globais.

Descrição do processo


Este processo realiza a importação do cadastro de Unidade Operacional (Filial) do sistema ERP para o TOTVS Educacional.


Detalhamento do processo


Usuário acessa o processo no TOTVS Educacional, através do Menu Customização | Integração ERP | Processos Agendados | Unidade Operacional do ERP, ao qual será utilizado o JOBSERVER, por onde o usuário administrador poderá configurar a periodicidade que será agendada o processo usado na integração do TOTVS Educacional x Sistema ERP.




O processo automaticamente conforme agendamento do JOBSERVER, realizará a integração com o sistema ERP, para obtenção da lista de unidade operacional atualizará

o cadastro de Filiais do TOTVS Educacional.


Expandir
titleModelos de contratos e termos aditivo e de rescisão

Pré-requisitos


Não existem pré-requisitos para este processo.


Descrição do processo


Este processo realiza a importação de modelos de contratos e termos de aditivo e rescisão cadastrados no sistema ERP, de modo que possam ser parametrizados por meio do req. 1 através do menu de Customização | Parametrização das Integrações | Integração com o sistema ERP | Integração de contrato | Modelo de contrato.


Detalhamento do processo


Usuário acessa o processo no TOTVS Educacional, através do Menu Customização | Integração ERP | Processos Agendados | Modelos de contratos e Termos aditivo e de rescisão do ERP, ao qual será utilizado o JOBSERVER, por onde o usuário administrador poderá configurar a periodicidade que será agendada o processo usado na integração do TOTVS Educacional x Sistema ERP.



O processo executará automaticamente conforme agendamento do JOBSERVER realizando a integração com o sistema ERP para obtenção da lista de modelos de contratos.

Posteriormente, este modelos estarão disponíveis para parametrização conforme req. 1.

Expandir
titleIntegração de contrato com sistema ERP

Pré-requisitos


Realizar as parametrizações conforme descrito no item “Parametrização das Integrações”.


Criar os campos complementares conforme tabela abaixo:


SMATRICPLCOMPL

Nome da coluna

Descrição

Tipo

Tamanho

Tabela dinâmica

ODONTO

Aderiu Serviço Odontológico?

Alfanumérico

10

SIMOUNAO

DTADESAOODONTO

Data Adesão

Alfanumérico

255


INTEGRADOAX

Integrado AX

Alfanumérico

10


EMPRESA

Empresa:

Alfanumérico

10


EBEP

EBEP?

Alfanumérico

10

SIMOUNAO

BAIXARENDA

Possui declaração de baixa renda?

Alfanumérico

10

SIMOUNAO

TIPOBOLSA

Tipo Bolsa

Alfanumérico

10


TIPODESC

Tipo de Desconto

Alfanumérico

10

TIPODESC

CATEGORIA

Categoria

Alfanumérico

10


CNPJAPREND

CNPJ de Aprendizagem (somente números)

Alfanumérico

20


ARTICULACAO

Articulação

Alfanumérico

10

ARTICULACA

TIPOGRAT

Condição do aluno

Alfanumérico

10

TIPOGRAT

SALUNOCOMPL

Nome da coluna

Descrição

Tipo

Tamanho

Tabela dinâmica

MOTIVOCPF

Motivo CPF não informado:

Alfanumérico

10

SMOTIVOCPF

Tabela dinâmica: SIMOUNAO

Código

Descrição

0

Não

1

Sim

Tabela dinâmica: MEIOPGTO

Código

Descrição

01

Descrição 01

02

Descrição 02

...

...




Descrição do processo


Este processo é responsável por realizar a integração das matriculas do TOTVS Educacional, com os contratos financeiros no sistema ERP.


Detalhamento do processo


Para realizar a integração, o usuário deverá acessar o processo customizado, localizado no menu “Matrícula e Avaliação | Matrículas | Processos | Integração de Contrato com sistema ERP”.



Uma vez acionado, o processo customizado realizará as seguintes validações antes de seguir com a integração:


  • Verifica se existe turma vinculada na matrícula.
  • Verifica se no cadastro da turma as datas de início e fim estão preenchidas.
  • Verifica se a data da matrícula é anterior ao mês atual e caso positivo verifica se o usuário tem permissão para executar a matrícula com data retroativa
  • Verifica se o status da matricula no período letivo esta cadastrada na parametrização “Status de Pré-Matriculado”.
  • Verifica se o contrato referente a matrícula foi enviado ao ERP anteriormente.
  • Verifica se o item de venda foi devidamente parametrizado na Matriz Aplicada.


Caso alguma das validações citadas acima, seja verdadeira, será apresentado uma mensagem ao usuário informando o motivo da inconsistência e o processo será interrompido.



Etapas para inclusão de contrato no ERP


Se o processo não encontrar nenhuma inconsistência, será apresentado um “wizard” onde o usuário deverá avançar todos os passos informando todas as obrigatoriedades antes de enviar o contrado ao ERP


Na primeira etapa, será apresentado os tipos de contrato. Caso o tipo de contrato selecionado esteja relacionado a Pessoa Física (PF), o campo "Modelo de Contrato" será obrigatório, caso o tipo de contrato selecionado esteja relacionado a Pessoa Jurídica (PJ), o campo “Número do contrato no ERP” será obrigatório.


Tipos de contrato PF:

  • Pessoa Física
  • Pessoa Física – Estrangeira


Tipos de contrato PJ:

  • Pessoa Jurídica
  • Pessoa Jurídica – Estrangeira
  • Base Estadual/Nascional
  • CEI




Para o campo “Modelo do contrato”, será listado todos os registros importados do ERP através da rotina customizada para agendamento e/ou execução localizada no menu “Customização | Integração ERP | Processos Agendados | Modelos de Contrato e Termos de aditivo e de rescisão do ERP”.


Para o campo “Número do Contrato no ERP”, o usuário deverá informar um código de contrato para que a rotina customizada verifique se este contrato está válido no sistema ERP e se existe vagas disponíveis.




  1. Tipo de Contrato PJ


Caso o tipo de contrato selecionado seja PJ, todas as consistências estejam de acordo e o usuário acione o botão “Executar”, a rotina customizada consumira o webservice do AX invocando o método “Contract_CorporateRegistrationInsert” passando as informações abaixo:


ID

Atributo

Descrição

Origem da informação no TOTVS

1

contractId

Número do contrato

Informação localizada no campo “Número do contrato no AX”

2

programId

Código do Item de Venda

Código do Item de venda parametrizado na Matríz Aplicada. ZPARAMHABILITACAOFILIAL.CODITEMVENDA

3

student

Informações do Aluno

Informação localizada na tabela abaixo (bloco Student).





  1. Tipo de Contrato PF


Caso o tipo de contrato selecionado seja PF, e todas as consistências estejam de acordo, a rotina customizada apresentará os passos abaixo:


Caso a opção “Habilita campos complementares do aluno no contrato” presente na parametrização da Integração de contrato esteja marcada, será apresentada o passo abaixo contendo as informações complementares da matrícula no período letivo .


Por meio desta tela, as informações não poderão ser alteradas. Sendo assim, as informações serão apresentadas apenas para consulta. Caso haja a necessidade de alterar estas informações, o usuário deverá efetuar por meio da matrícula no período letivo do aluno.



Ao avançar, a rotina customizada, executará uma validação na data de matricula, verificando se a mesma é anterior ao mês corrente. Caso positivo, a  o processo deverá considerar a data inicial do mês e apresentará uma mensagem informativa ao usuário.


Após a execução da validação, será exibido o próximo passo com os dados do curso e data do contrato. Nessa etapa, os campos de data início e fim do contrato são de preenchimento obrigatórios.




Caso a opção “Utiliza serviço odontológico” presente na parametrização da Integração de contrato esteja marcada, será apresentada a etapa abaixo contendo as informações do código do serviço odontológico e valor do serviço odontológico que foram previamente cadastradas na parametrização.


Por meio desta tela, o usuário deverá informar se haverá ou não desconto odontológico através do campo “adesão de odonto escolar” e posteriormente a data de adesão do serviço odontológico.




Ao avançar, será apresentado a etapa contendo as informações da parametrização da forma de pagamento, onde o usuário deverá informar os seguintes campos:


  • Desconto: Através deste campo, o usuário poderá adicionar um desconto no valor total do contrato.


  • Observação: Campo texto para que o usuário informe somente como descritivo o motivo da concessão do desconto no contrato.


  • Nº (id) solicitação de Bolsa e Desconto: Campo texto para que o usuário informe o número da identificação de solicitação (workflow) aberto no TOTVS para aprovação do desconto.


  • Parcelas: Campo para que o usuário informe a quantidade de parcela que será gerada para o pagamento, como “default” será buscada a informação parametrizada junto a matriz aplicada.


  • Vencimento da Primeira parcela: Usuário preencherá qual será o vencimento da primeira parcela.


  • Período: Campo para que o usuário informe a periodicidade do vencimento das demais parcelas, podendo ser fixa em todo dia X ou em um período de X dias.


Nesta etapa os campos de vencimento da primeira parcela e a periodicidade dos demais vencimentos, são de preenchimento obrigatórios.



Depois de preencher os campos da condição de pagamento e acionar o botão avançar, será apresentado a etapa contendo as informações de todas as parcelas. Nesta etapa, o usuário poderá ajustar as datas de vencimento e os valores da parcela coso haja necessidade.





Ao final de todos os passos o usuário deverá acionar o botão “Executar”, onde a rotina customizada consumira o webservice do ERP invocando o método “Contract_IndividualRegistrationInsert” passando as informações abaixo:


ID

Atributo

Descrição

Origem da informação no TOTVS

1

ContractIndividual

Classe contendo todas as informações necessárias para incluir um contrato PF

Informação localizada na tabela abaixo (bloco ContractIndividual).

Expandir
titleManutenção de contrato no sistema ERP

Pré-requisitos


Vide pré-requisitos do item “Integração de contrato com sistema ERP”.


Descrição do processo


Este processo é responsável por realizar a manutenção das matriculas do TOTVS Educacional, que foram integrados com os contratos financeiros no sistema ERP.


Detalhamento do processo


Para realizar a manutenção, o usuário deverá acessar o processo customizado, localizado no menu “Matrícula e Avaliação | Matrículas | Processos | Manutenção de Contrato com sistema ERP”.


Image Added


Uma vez acionado, o processo customizado realizará as seguintes validações antes de seguir com a integração:


  • Verifica se existe turma vinculada na matrícula.
  • Verifica se no cadastro da turma as datas de início e fim estão preenchidas.
  • Verifica se a data da matrícula é anterior ao mês atual e caso positivo verifica se o usuário tem premissão para executar a matrícula com data retroativa
  • Verifica se o status da matricula no período letivo esta cadastrada na parametrização “Status de Matriculado”.


Caso alguma das validações citadas acima, seja verdadeira, será apresentado uma mensagem ao usuário informando o motivo da inconsistência e o processo será interrompido.


Image Added


Se o processo não encontrar nenhuma inconsistência, será apresentado um “wizard” onde o usuário deverá avançar todos os passos informando todas as obrigatoriedades antes de enviar o contrato ao ERP.


Na primeira etapa, será apresentado as informações do contrato atual, ou seja, contrato que deverá ser rescindido no ERP.


Image Added



Atualmente no ERP, existem 3 tipos de rescisão “Pessoa Física sem valor”, “Pessoa Física com valor” e “Pessoa Jurídica” e para cada tipo, a rotina customizada deverá executar um processo diferente.



  1. Pessoa Jurídica

 

Caso o tipo do contrato atual seja PJ e o status igual a “Emitido”, a rotina customizada executará a inativação do aluno, consumindo o webservice do ERP invocando o método “Contract_CorporateRegistrationCancel” passando as informações abaixo:


ID

Atributo

Descrição

Origem da informação no TOTVS

1

contractId

Número do contrato

Informação localizada no campo “Número do contrato no ERP”

2

programId

Código do Item de Venda

Código do Item de venda parametrizado na Matríz Aplicada. ZPARAMHABILITACAOFILIAL.CODITEMVENDA

3

academicId

Código do aluno

Informação do registro acadêmico do aluno

(CODCOLIGADA + RA)

 

 

  1. Pessoa Física com valor

 

Caso o tipo do contrato atual seja PF, tenha valor e esteja com itaus igual a “Apto a rescindir”, a rotina customizada executará a rescisão do contrato, consumindo o webservice no ERP invocando o método “Contract_IndividualRegistrationTerminate” passando as informações abaixo:


ID

Atributo

Descrição

Origem da informação no TOTVS

1

contractId

Número do contrato

Informação localizada no campo “Número do contrato no ERP”



 

  • Pessoa Física sem valor


Caso o tipo do contrato atual seja PF e não tenha valor, a rotina customizada executará o cancelamento do contrato, consumindo o webservice no ERP invocando o método “Contract_IndividualRegistrationCancellation” passando as informações abaixo:



ID

Atributo

Descrição

Origem da informação no TOTVS

1

ContractIndividualAmendment

Dados da renegociação

Informação  Informação localizada na parte abaixo (bloco  ContractIndividualAmendment ).



Os próximos passos para a inclsão do novo contrato no ERP, seguem as mesmas validções e etapas descritas no item “Integração de contrato com sistema ERP

Expandir
titleMapeamento das informações TOTVS x ERP

Student

ID

Atributo

Descrição

Origem da informação no TOTVS

1

AcademicId

Id Aluno SGE

Concatenação da Coligada + Registro Acadêmico do aluno.

(SALUNO.CODCOLIGADA + SALUNO.RA)

2

Address

Endereço do Aluno

Informação localizada na parte abaixo (bloco AddressStudent).

3

AdultEducation

Se o Curso é EJA

Para a coligada SENAI = 3, o valor enviado será igual a “FALSE”.

 

Para a coligada SESI = 2, no cadastro do curso do aluno (localizado por meio da matricula), será buscada a modalidade (SCURSO.CODMODALIDADECURSO.

Se estiver parametrizada com a modalidade igual a EJA = 3, o valor enviado será igual a “TRUE”, do contrário, será enviado o valor igual a “FALSE”.

4

BirthDate

Data de Aniversário

Data de nascimento.

(PPESSOA.DTNASCIMENTO)

5

ContinuousEducation

Educação Continuada

Para as coligadas SESI = 2 e SENAI = 3, o valor enviado será igual a “FALSE”.

Observação: no projeto NA não trata esta informação.

6

DependenType

Segmento

Para a coligada SENAI = 3, o valor enviado será igual a “0”.


Para a coligada SESI = 2, por meio do campo complementar “categoria” (SMATRICPLCOMPL.CATEGORIA),

Será verificado se o valor preenchido é igual a “3 -

Dependente de trabalhador de indústria”, caso positivo, será enviado o valor igual a “1”, do contrário, envia o valor igual a “0”.

7

IndustryIndicated

Indicação Indústria

Para a coligada SENAI = 3, o valor enviado será igual a “FALSE”.

Para a coligada SESI = 2, por meio do campo complementar “categoria” (SMATRICPLCOMPL.CATEGORIA),

será verificado se o valor preenchido é igual a “1 – Trabalhador da Indústria” ou “3 -

Dependente de trabalhador de indústria”, caso positivo, será enviado o valor igual a “TRUE”, do contrário, será enviado o valor igual a “FALSE”.

8

JoinVentureName

Ação Articulada

Para a coligada SENAI = 3, por meio do campo complementar “Articulação” (SMATRICPLCOMPL.ARTICULACAO).

será verificado se o valor preenchido é igual a “1 – Há articulação Sesi/Senai”, caso positivo, será enviado o valor igual a “1”, do contrário, será enviado o valor igual a “0”.


Para a coligada SESI = 2, por meio do campo complementar “EBEP” (SMATRICPLCOMPL.EBEP),

será verificado se o valor preenchido é igual a “1”, caso positivo, será enviado o valor igual a “1”, do contrário, será enviado o valor igual a “0”.

9

LegalGuardian

Responsável legal = responsável financeiro.

Informação localizada na parte abaixo

 (bloco LegalGuardianStudent ).

10

LowIncome

Baixa Renda

Para a coligada SESI = 2 e SENAI = 3,  por meio do campo complementar “Possui declaração de baixa renda” (SMATRICPLCOMPL.BAIXARENDA),

será verificado se o valor preenchido é igual a “SIM”, caso positivo, será enviado o valor igual a “TRUE”, do contrário, será enviado o valor igual a “FALSE”.

11

Nome

Nome do Aluno

Nome do aluno

(PPESSOA.NOME)

12

Nationality

Nacionalidade do Aluno

Descrição da nacionalidade do aluno.

(SALUNO.NACIONALIDADE / PCODNACAO.DESCRICAO)

13

RegistrationCompany

Unidade que o aluno está matriculado (mesmo valor passado no Company do Token)

Enviar código da filial no TOTVS

Educacional, sendo buscado o dado por meio da matrícula no período letivo do aluno.

(SMATRICPL.CODFILIAL)

14

ScholarShipName

Tipo de Bolsa


Para as coligadas SENAI e SESI.

Será incluído um campo complementar na matrícula do período letivo (SMATRICPLCOMPL.TIPOBOLSA), vinculado a uma tabela dinâmica.

Sendo enviado o valor informado no campo.

15

StudentsDocuments

Documentos do Aluno

Informação localizada na parte abaixo (bloco DocumentsStudent).

AddressStudent

ID

Atributo

Descrição

Origem da informação no TOTVS

1

City

Cidade

Cidade do aluno (PPESSOA.CIDADE)

2

Complement

Complemento

Complemento (PPESSOA.COMPLEMENTO)

3

ContactInfo

Informação do Contato

Informação localizada na parte abaixo (bloco AddressContactInfoStudent).

4

Country

Pais

Pais (PPESSOA.PAIS)

5

IBGECode

Código do IBGE

O código do IBGE será buscado por meio do Anexo customizado no cadastro do município.

6

Name

Apelido do Local

Buscar descrição do “Tipo de bairro”

(PPESSOA.CODTIPOBAIRRO / DTIPOBAIRRO.DESCRICAO).

7

Neighborhood

Bairro

Bairro (PPESSOA.BAIRRO)

8

Number

Número

Número (PPESSOA.NUMERO)

9

Principal

Endereço Preferencial

Fixo: TRUE

10

State

Estado

Nome do estado (SALUNO.ESTADO / GETD.NOME)

11

Street

Logradouro

Rua (PPESSOA.RUA)

12

Type

Tipo do Endereço

Informação localizada na parte abaixo (bloco AddressTypeStudent).

13

ZipCode

CEP

Cep (PPESSOA.CEP)

AddressContactInfoStudent

ID

Atributo

Descrição

Origem da informação no TOTVS

1

BranchLine

Ramal


2

CelularNumber

Nº Celular

Telefone celular (PPESSOA.TELEFONE2)

3

Email

Email

Email (PPESSOA.EMAIL)

4

Fax

Fax

Fax (PPESSOA.FAX)

5

PhoneNunber

Nº Telefone

Telefone residencial (PPESSOA.TELEFONE1)

6

SMS

SMS


7

WebSite

WebSite


AddressTypeStudent

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Description

Descrição do Tipo

Residencial

2

Id

Identificação do Tipo

Fixo: 1

LegalGuardianStudent

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Number

Número

Caso o responsável acadêmico tenha o campo CPF informado, este deverá ser enviado.

(SALUNO.CODPESSOARACA/ PPESSOA.CPF).

Do contrário, se o responsável for estrangeiro, deverá ser buscado o documento “Registro Geral RNE” (SALUNO.CODPESSOARACA/ PPESSOA.NROREGGERAL).

2

Type

Tipo do Documento

 “CPF” ou “RNE” (utilizado para o caso em que o responsável for estrangeiro).

DocumentsStudent

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Number

Número

Buscar o CPF do aluno (PPESSOA.CPF), do contrário, se o aluno for estrangeiro, deverá ser buscado o documento “Registro Geral RNE” (PPESSOA.NROREGGERAL).


Observação:

No SESI, para confirmar se o aluno é estrangeiro, através do campo “Motivo CPF não informado” (SALUNOCOMPL.MOTIVOCPF), haverá o código igual a 04 = Estrangeiro”.


No SENAI, para confirmar se o aluno é estrangeiro, através do campo “Motivo CPF não informado” (SALUNOCOMPL.MOTIVOCPF), haverá o código igual a 01 = Estrangeiro”.

2

Type

Tipo do Documento

 “CPF” ou “RNE” (utilizado para o caso em que o responsável for estrangeiro).

               

ContractIndividual

ID

Atributo

Descrição

Origem da informação no TOTVS

1

ContractTemplate

Código do Modelo do Contrato

Será buscada a informação preenchida pelo usuário na etapa de escolha dos tipos de contrato.

2

ExternalId

Id do contrato no Siaes

Código sequencial gerado para o contrato.

3

Payer

Pagante [Responsável Financeiro]

Informação localizada na parte abaixo (bloco Customer)

4

PaymentConditions

Condições de Pagamento [Parcelas]

Informação localizada na parte abaixo (bloco PaymentConditions)

5

Program

Informações do Curso [Curso, Unidade, Data de Inicio, Data de Fim, etc]

Informação localizada na parte abaixo (bloco ProgramInput).

6

ResponsibleManager

Gerente responsável pelo contrato

Nome do responsável pelo contrato conforme parametrização. (ZPARAMCONTRATO.GESTORCONT)

7

Service

Lista serviço Odontologia

Informação localizada na parte abaixo (bloco ServiceInput).

8

SignatureManager

Gerente para Assinatura contrato

Nome do responsável pela assinatura do contrato conforme parametrização. (ZPARAMCONTRATO.GERENTECONT)

9

Student

Dados do aluno

Informação localizada na parte acima (bloco Student).

10

Term

Datas de criação e vigência do contrato

Informação localizada na parte abaixo (bloco ContractTerm).

11

TotalAmount

Valor total do Contrato

Valor será cálculo pelo processo de integração do contrato. Campo valor Total do contrato presente da etapa da condição de pagamento

Customer

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Addresses

Endereço do pagante

Informação localizada na parte abaixo (bloco AddressCustomer).

2

CCM

Cadastro de Contribuinte municipal


3

CNAE

Classificação Nacional de Atividades Econômicas


4

Category


Fixo 1

5

CommunicationChannels

Canal de Comunicação

Informação localizada na parte abaixo (bloco CommunicationChannelsCustomer).

6

EstablishmentType

Tipo e Estabelecimento

Informação localizada na parte abaixo (bloco EstablishmentTypeCustomer).

7

ExternalAppId

Código do Sistema Externo de comunicação

Fixo: SGE

8

ExternalCustomerId

Código do Pagante no SGE

Código do responsável financeiro no TOTVS (FCFO.CODCFO)

9

FederalId

CPF do pagante

CPF do responsável financeiro. (FCFO.CGCCFO)

10

GroupId

Código do Grupo do Cliente[CLI PJ, CLI PF, Abono Pronatec]

Valor Fixo: CLI PF

11

ICMS

ICMS


12

ISS

ISS


13

InscricaoEstadual

Inscrição Estadual

Inscrição estadual do responsável financeiro. (FCFO.INSCRESTADUAL)

14

NIT

Número de Identificação do Trabalhador

NIT do responsável financeiro. (FCFO.NIT)

15

Name

Nome do Pagante

Nome do responsável financeiro.(FCFO.NOME)

16

NameAlias

Nome do Pagante

Nome fantasia do responsável financeiro.

(FCFO.NOMEFANTASIA)

17

Nationality

Nacionalidade

Valor Fixo “BR”.

AddressCustomer

ID

Atributo

Descrição

Origem da informação no TOTVS

1

City

Cidade

Nome do município (GMUNICIPIO.NOMEMUNICIPIO)

2

Complement

Complemento

Complemento (FCFO.COMPLEMENTO)

3

ContactInfo

Informação do Contato

Informação localizada na parte abaixo (bloco AddressContactInfoCustomer).

4

Country

Pais

Nome do pais (FCFO.IDPAIS / GPAIS.DESCRICAO)

5

IBGECode

Código do IBGE

O código do IBGE será buscado por meio do Anexo customizado no cadastro do município (ZDADOSIBGE.NUMEROIBGE)

6

Name

Apelido do Local

Descrição do tipo de bairro

(FCFO.TIPOBAIRRO) / (DTIPOBAIRRO.DESCRICAO)

7

Neighborhood

Bairro

Bairro (FCFO.BAIRRO)

8

Number

Número

Número (FCFO.NUMERO)

9

Principal

Endereço Preferencial

Fixo: TRUE

10

State

Estado

Estado (FCFO.CODETD)

11

Street

Logradouro

Rua (FCFO.RUA)

12

Type

Tipo do Endereço

Informação localizada na parte abaixo (bloco AddressTypeCustomer).

13

ZipCode

CEP

Cep (FCFO.CEP)

AddressContactInfoCustomer

ID

Atributo

Descrição

Origem da informação no TOTVS

1

BranchLine

Ramal


2

CelularNumber

Nº Celular

Telefone Celular (FCFO.TELEX)

3

Email

Email

Email (FCFO.EMAIL)

4

Fax

Fax

Fax (FCFO.FAX)

5

PhoneNunber

Nº Telefone

Telefone  (FCFO.TELEFONE)

6

SMS

SMS


7

WebSite

WebSite


AddressTypeCustomer

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Description

Descrição do Tipo

Fixo: Nota Fiscal

2

Id

Identificação do Tipo

Fixo: 1

CommunicationChannelsCustomer

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Type

Tipo

Fixo: Telefone

2

Value

Valor

Telefone (FCFO.TELEX)

EstablishmentTypeCustomer

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Description

Descrição

Descrição do tipo de responsável financeiro

(FCFO.CODTCF / FTCF.DESCRICAO)

2

Id

Código

Código do tipo de responsável financeiro (FCFO.CODTCF)

PaymentConditions

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Ammount

Valor da Parcela

Valor da parcela calculado pelo processo de integração.

2

DueDate

Data de Vencimento

Data de vencimento informado pelo usuário na tela de processo de integração.

3

InstallmentNumber

Nº da Parcela

Identificador da parcela, gerado automaticamente no processo de integração.

ProgramInput

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Attendees

Qtd. Participantes

Sempre (1)

2

DepartamentUnit

Unidade do Contrato

Nome da filial vinculada na matrícula

do período letivo do aluno.(GFILIAL.CODFILIAL)

3

GradeNotes

Período

Através da matrícula no período letivo do aluno, será buscada a turma vinculada.

Em seguida, no cadastro da turma, será buscado o nome, o período (data inicial e final e horário do turno).


(SMATRICPL.TURMA / STURMA.NOME, STURMA.DTINICIAL, STURMA.DTFINAL / STURMA.IDHABILITACAO, SHABILITACAOFILIAL.CODTURNO / STURNO.HORINI, STURNO.HORFIM)


Exemplo:

3º Ano - Ensino Médio | 01/02/2014 – 28/11/2014 | 07:30 - 11:30

4

Hours

Carga Horária

A partir da matrícula no período letivo, será localizada a grade do curso, em seguida, o campo “Carga horária”

(SGRADE .CARGAHORARIA)

5

Id

Identificação do Curso

(item de venda)


A partir da matrícula no período letivo, será buscada a matriz aplicada do curso, em seguida, o campo customizado “item de venda”. (ZPARAMHABILITACAOFILIAL.CODITEMVENDA)

6

InvoiceByProduction

Item de venda por produção

A partir da matrícula no período letivo, será buscada a matriz aplicada do curso, em seguida, verificado se o campo customizado “item de venda” se encontra preenchido.

(SMATRICPL / SHABILITACAOFILIAL)

Caso positivo, enviar a informação igual a “TRUE”. Do contrário, enviar a informação igual a “FALSE”.

7

MinimumFrequency

Frequência mínima do curso


8

MinimumGrade

Nota mínima de aprovação

 

9

ResponsabilityCenter

Centro de Responsabilidade

A partir da matrícula no período letivo, será localizada a matriz aplicada do curso, em seguida, será buscada a informação de centro de custo. (SHABILITACAOFILIAL.CODCCUSTO).

10

Term

Vigência do Curso

Informação localizada na parte abaixo (bloco ProgramTerm).

11

TotalAmount

Valor do Curso

(sugerido do curso)

A partir da matrícula no período letivo, será localizada a matriz aplicada do curso, em seguida, no Anexo customizado, será buscada a informação de “valor sugerido do curso”).

(ZPARAMHABILITACAOFILIAL.VLRSUGCURSO)

ProgramTerm

ID

Atributo

Descrição

Origem da informação no TOTVS

1

StartDate

Data de Inicio do agendamento

(Data inicio da turma = 

Data de vigência)

Será buscada a data de matrícula no período letivo do aluno, caso a data seja retroativa, será buscada a data do primeiro dia do mês atual.

2

EndDate

Data de Fim do agendamento

Através da matrícula no período letivo do aluno, será buscada a turma vinculada.

Em seguida, no cadastro da turma, será buscada a data  final.

3

StarTime

Hora de Inicio do agendamento

(Data fim da turma =

Data de vigência)

Através da matrícula no período letivo do aluno, será buscada a turma vinculada.

Em seguida, no cadastro da turma, será buscado o horário inicial do turno.

4

EndTime

Hora de Fim do agendamento

Através da matrícula no período letivo do aluno, será buscada a turma vinculada.

Em seguida, no cadastro da turma, será buscado o horário final do turno.

ServiceInput

ID

Atributo

Descrição

Origem da informação no TOTVS

1

Id

Id Odontologia

Código do serviço odontológico (ZPARAMCONTRATO.CODSERVODONT)

2

Quatity

Quantidades Serviço

Fixo 1.

3

TotalAmount

Valor do Serviço

(valor sugerido)

Valor sugerido do serviço odontológico (ZPARAMCONTRATO.VLRSERVODONT)

4

ResponsabilityCenter

Centro de Responsabilidade

A partir da matrícula no período letivo, será localizada a matriz aplicada do curso, em seguida, será buscada a informação de centro de custo.

(SMATRICPL / SHABILITACAOFILIAL.CODCCUSTO).

5

DepartamentUnit

Unidade do Contrato

Nome da filial da matrícula (GFILIAL.CODFILIAL)

ContractTerm

ID

Atributo

Descrição

Origem da informação no TOTVS

1

End

Data de Fim do Contrato

Será buscada a informação preenchida pelo usuário na tela de processo de integração do contrato.

2

Start

Data de Inicio do Contrato

Será buscada a informação preenchida pelo usuário na tela de processo de integração do contrato.

ContractIndividualAmendment

ID

Atributo

Descrição

Origem da informação no TOTVS

1

ContractId

Número do contrato

Informação localizada no campo “Número do contrato no AX”

2

GradeNotes

Período

Através da matrícula no período letivo do aluno, será buscada a turma vinculada.

Em seguida, no cadastro da turma, será buscado o nome, o período (data inicial e final e horário do turno).


(SMATRICPL.TURMA / STURMA.NOME, STURMA.DTINICIAL, STURMA.DTFINAL / STURMA.IDHABILITACAO, SHABILITACAOFILIAL.CODTURNO / STURNO.HORINI, STURNO.HORFIM)


Exemplo:

3º Ano - Ensino Médio | 01/02/2014 – 28/11/2014 | 07:30 - 11:30

3

PaymentConditions

Condição de Pagamento

Informação localizada na parte abaixo (bloco PaymentConditions)

4

TermStart

Data início

Data início do contrato

5

TotalAmount

Valor total

Valor total do contrato