Histórico da Página

Projeto: FS008491 – Integrações com Protheus

Nome do cliente: FIEC

Objetivo
O objetivo dessa documentação é detalhar a integração do SGE com Protheus.

Público Alvo

Este manual é destinado aos colaboradores selecionados como usuários-chave da área Educacional do SESI e SENAI (DR-FIEC).

Expandir

title	Parâmetros da Customização

Pré Requisitos

O menu da customização deverá ser liberado nas permissões do perfil dos usuários para que esteja disponível para as devidas parametrizações. 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.

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 | Customização.

Detalhamento do processo

A interface customizada estará disponível em: TOTVS Educacional | Customizações | Integração Protheus| Parâmetros

Ao ser acessada, o usuário poderá preencher os seguintes campos:

Web Service Token: Endereço de acesso ao Webservice para autenticação das operações no Protheus.
Web Service Operações: Endereço de acesso ao Webservice disponibilizado pelo Protheus para efetuar as operações de inserção de clientes, pedidos, títulos, baixas, etc.
Client Secret Key: Informe a secret key utilizada pela API.
Client ID: Informe o identificador do cliente na API.
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 Protheus dos registros com status de erro.
Situação de matrícula: deverão ser informadas neste campo todas as situações de matrícula que caracterizam cancelamento do contrato do aluno e que deverá verificar se há aplicação de multa e/ou crédito do aluno. OBS: As situações de matrícula são por Coligada/Nível de Ensino.
Modalidades curso Técnico SENAI: deverão ser informadas as modalidades de curso técnico no SENAI. Estas modalidades serão utilizadas na identificação das regras para cálculo de multa rescisória e crédito de aluno. Atualmente na base SGE existem 2 modalidades que correspondem ao curso técnico: Modalidades 31 (Habilitação Técnica de Ensino Médio) e 32 (Habilitação Técnica de Ensino Médio – Itinerário V Ens Médio).
Cód. REDECARD no Protheus: Deverá ser informado o código do cliente REDECARD cadastrado no Protheus.
Cód. GETNET no Protheus: Deverá ser informado o código do cliente GETNET no cadastrado Protheus.
Dias limites para retroagir o cancelamento do contrato: deverá ser informada a quantidade de dias que pode ser retroagido o cancelamento do contrato, a contar da data atual. Por exemplo, se neste campo for informado 5, se o cancelamento estiver ocorrendo no dia 12 o usuário poderá informar que a data do cancelamento ocorreu no máximo no dia 7 do mesmo mês. Se tentar colocar data anterior a esta, a customização não irá permitir e irá bloquear o processo de cancelamento do contrato, emitindo uma mensagem em tela para o usuário. Caso a FIEC não queira permitir o cancelamento retroativo, deverá informar 0 neste campo.
Perfil para retroagir cancelamento do contrato sem limite de data: deverá ser informado neste campo o perfil de usuário que poderá cancelar o contrato com qualquer data anterior a data atual, sem fazer consistência de quantidade de dias limites informados no parâmetro anterior. O perfil do usuário deverá ser criado de forma padrão no sistema e os usuários com esta permissão deverão estar devidamente associados a ele. Este parâmetro é global e o mesmo valor definido valerá para as duas coligadas.
Meio de Pagamento - Baixa de lançamentos do Protheus: meio de pagamento que deverá ser utilizado para efetivar as baixas no RM, enviadas pelo Protheus através da API de baixa de lançamentos.

Expandir

title	Atualização de Clientes

Pré-requisitos

O cadastro do cliente deverá existir no SGE e no Protheus.
Somente alterações no cadastro do cliente realizadas no SGE serão enviadas para atualização do cadastro no Protheus.

Aviso

title	Atenção

Um novo cliente sempre será cadastrado pelo Sales Force e enviado tanto para o SGE quanto para o Protheus neste momento.

Portanto, a integração entre SGE x Protheus se dará somente na atualização de dados de um cliente já cadastrado anteriormente.

Detalhamento do Processo

Ao realizar alteração das informações listadas abaixo no cadastro do cliente, o cadastro do Protheus será atualizado.

CPF ou CNPJ
Sexo do cliente (para PF)
Nome
Nome Fantasia
Endereço (rua e número), estado, município, bairro, CEP, complemento, país
DDD, telefone, fax
Email
Identidade
Data de nascimento

O acesso ao cadastro de clientes será pelo menu padrão do SGE, disponível em: TOTVS | Backoffice | Gestão Financeira | Cadastros | Clientes-Fornecedores

Expandir

title	Centro de Custos - Anexo Filial

Pré-requisitos

O cadastro de centro de custos será feito manualmente no SGE e no Protheus, não havendo integração deste cadastro entre os dois sistemas.

Detalhamento do Processo

Cada Filial deverá ter o seu Centro de Custo (UO) associado ao seu cadastro. Para fazer esta associação, o usuário deverá acessar o cadastro da Filial através do Menu Executar, disponível ao lado direito da tela, conforme demonstrado na figura abaixo:

Dica

title	Dica

Ao clicar na opção "Executar", digite a palavra "Filial" e esolha a opção dentro do menu Fiscal.

Após acessar o cadastro das Filiais, selecione a filial desejada e acesse Anexos | Centro de Custo

Ao abrir a tela, informe o centro de custo correspondente à Filial

Aviso

title	Atenção

Só será permitida a associação de um único Centro de Custo por Filial.

Expandir

title	Item Contábil

Pré-requisitos

O cadastro e/ou alteração de item contábil será realizado no Protheus e integrado ao SGE.
Os itens contábeis disponíveis no SGE deverão ser associados as Matrizes Aplicadas

Detalhamento do Processo

A visão dos itens contábeis já cadastrados poderá ser acessada através do menu Educacional | Customização | Integração Protheus | Cadastros | Item Contábil

Para associar o item contábil a uma matriz aplicada acesse Educacional | Curriculo e Oferta | Matrizes Curriculares | Anexo | Matriz Aplicada.

Edite a matriz aplicada desejada e acesse Anexos | Item Contábil

Expandir

title	Pedido de Vendas

Pré Requisitos

Os contratos educacionais originados de vendas de cursos serão gerados no SGE a partir da integração com SalesForce. Nenhum contrato que tenha valor financeiro será incluído diretamente no SGE.

Aviso

title	Gratuidade Regimental

Os contratos com Gratuidade Regimental serão incluídos diretamente no SGE, mas não terão parcelas financeiras, portanto não haverá geração de Pedido de Vendas para estes contratos.

Expandir

title	Inclusão do Pedido de Vendas

Detalhamento do Processo

Os contratos educacionais originados do SalesForce serão gravados no SGE com suas devidas parcelas do contrato (sem gerar títulos a receber).

No momento em que houver esta inclusão do contrato no SGE, serão enviados automaticamente para o Protheus:

Pedidos de Vendas Gerenciais: 1 pedido de vendas gerencial para cada parcela (mensalidade) do contrato educacional.
Pedido de Vendas Fiscal: 1 pedido de vendas fiscal com o valor total do contrato.

Os contratos educacionais poderão ser visualizados no SGE, acessando o seguinte caminho:

TOTVS Educacional | Educacional | Financeiro - Contábil | Contratos

Dica

title	Dica

Os contratos são visualizados conforme Filial/Nível de Ensino selecionados no contexto do módulo. Para selecionar o contexto, clique no ícone "Contexto Educacional" localizado na parte superior - esquerda da tela:

Visualização dos contratos:

Dica

title	Dica

Selecione um contrato e acesse Anexos | Parcela para visualizar as parcelas desse contrato.

Para cada parcela será gerado um Pedido de Vendas Gerencial no Protheus.

O total de parcelas corresponde ao valor total do Pedido de Vendas Fiscal gerado no Protheus

Dados complementares do contrato:

Selecione o contrato e acesse Anexo | Dados Complementares do Contrato para visualizar informações importantes referente a venda do curso e Pedido de Vendas relacionados.

Pasta Identificação:

Informações relacionadas a compra do curso, originadas do SalesForce

ID Oportunidade Venda: ID da oportunidade de venda gerado pelo SalesForce
Data Compra: data da realização da compra
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. SGE + código da coligada (2) + número do contrato (67)
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
Dados da baixa com cartão: grava as informações do pagamento com cartão de crédito no momento da venda.
E- Commerce: indica se a compra foi realizada pelo E-Commerce

Pasta Pedido de Vendas

Informações relacionadas aos Pedidos de Vendas gerados no Protheus, referentes ao contrato

Visualização dos Pedidos de Vendas

Os pedidos de vendas poderão ser visualizados no Protheus | Faturamento | Atualizações | Pedidos | Pedidos de Venda

Inclusão de parcela extra no contrato - outras receitas

Caso haja alguma inclusão de parcela no Contrato Educacional posteriormente (taxas de solicitação de serviços por exemplo), será gerado um novo Pedido de Vendas correspondente a esta parcela (somente Gerencial, não gera Pedido Fiscal).

O XNUMPRO deste pedido tem o seguinte formato: SGE-codcoligada-nºcontrato-id parcela

MONITOR DE LOG: CONTRATO | ANEXO | MONITOR DE LOG = INCLUIR PRINT E DESCRIÇÃO

Expandir

title	Atualização do Pedido de Vendas

Detalhamento do Processo

Após a integração dos Pedidos de Vendas ao Protheus, poderão ocorrer algumas alterações no SGE que precisarão ser enviadas para atualização destes Pedidos.

As alterações permitidas são:

Data de Entrega Pedido Fiscal: ocorrerá quando houver alteração da maior data final da turma/disciplina em que o aluno está matriculado. Esta alteração será feita acessando a turma | anexo | turmas disciplinas

Data da Previsão de Faturamento (SENAI): ocorrerá quando houver alteração da menor data inicial da turma/disciplina, desde que esta alteração seja para mês posterior. Caso a alteração da data seja dentro do mesmo mês, não haverá alteração da data de previsão do faturamento.

Exemplo:

Início da turma/disciplina: 10/01/2021

Datas de vencimento:

- 1º Pedido: 10/01/2021
- 2º Pedido: 15/02/2021
- 3º Pedido: 15/03/2021

Data de previsão de faturamento:

- 1ª pedido: vazio
- 2º pedido: 16/01/2021
- 3º pedido: 16/02/201
- etc.
Alteração do Início da turma/disciplina: 20/01/2021 => não altera data de previsão de faturamento, pois não alterou o mês inicial.
Alteração do Início da turma/disciplina: 01/02/2021 => mudou para 1 mês subsequente.

Datas de vencimento:

- 1º Pedido: 10/01/2021
- 2º Pedido: 15/03/2021
- 3º Pedido: 15/04/2021

Data de previsão de faturamento: alterar 1 mês subsequente

- - - 1ª pedido: vazio
    - 2º pedido: 16/02/2021
    - 3º pedido: 16/03/201
    - etc

Atualização do campo “Envia boleto por email": ocorrerá quando houver alteração da informação existente no Contrato | Anexo | Dados complementares do Contrato

Expandir

title	Reenvio do Pedido de Vendas = PENDENTE

PENDENTE

Expandir

title	Eliminação por Resíduo

Detalhamento do Processo

Ao cancelar o Contrato Educacional no SGE, os Pedidos de Vendas Gerenciais que não estão faturados no Protheus deverão ser cancelados (eliminados por resíduo).

Os Pedidos de Vendas Gerenciais já faturados só serão eliminados por resíduo se o serviço ainda não tiver sido prestado e se o título a receber correspondente a este pedido ainda estiver em aberto.

Em resumo, o Pedido de Vendas Gerencial deverá ser eliminado por resíduo quando:

Não foi faturado

ou

Foi faturado E o serviço ainda não foi prestado E o título a receber está em aberto.

No mesmo instante em que os Pedidos Gerenciais referentes ao contrato cancelado são eliminados por resíduo, haverá uma atualização do valor do Pedido Fiscal, para que este fique correspondente aos valores faturados (que não foram cancelados).

O cancelamento do contrato educacional no SGE poderá ocorrer mediante os seguintes processos:

Manualmente: através da visão dedo processo “Cancelar Contrato” disponível no menu Educacional | Financeiro-Contábil | Contrato Contratos | processos | cancelar contrato

Image Removed

Processo | Cancelar Contrato.

Image Added

AutomaticamenteAlterar situação de matrícula: através do menu : mediante alteração de situação de matrícula do aluno que indique cancelamento do contrato em sua parametrização. A alteração de situação de matrícula pode ser realizada através do processo: Educacional | Matrícula e Avaliação | Matrículas Matrícula | Processos Processo | Alterar situação de matrícula. OBS: este processo irá cancelar o contrato desde que a nova situação de matrícula esteja parametrizada para ocorrer o cancelamento.Matrícula.

Aviso

title	Atenção

O Contrato cancelado ficará com a flag "cancelado" marcada

Expandir

title	Cancelamento do contrato - data retroativa

Detalhamento do Processo

Na tela de cancelamento do contrato é possível informar a data de cancelamento diferente à data atual.

Existem algumas regras para a informação desta data, que são:

Não será permitido informar maior que a data atual.
Todo usuário poderá infomar uma data retroativa que atenda o limite de dias informado nos parâmetros da customização (ver figura 1).
Somente usuários associados ao perfil informado nos parâmetros poderá informar uma data retroativa sem limite de dias (ver figura 2).

Figura 1: Parâmetro que informa o limite de dias para retroagir a data de cancelamento. Menu Educacional | Customização | Parâmetros

OBS: Se tiver 0 ou em branco, a data não poderá ser diferente que a data atual do cancelamento

Image Added

Figura 2: Parâmetro para associar o perfil que permite retroagir a data de cancelamento do contrato sem limite.

Image Added

Expandir

title	Parâmetros para cálculo de multa e crédito (NCC)

Expandir

title	Multa Rescisória

Expandir

title	NCC

Expandir

title	Títulos a receber

Expandir

title	Faturamento do Pedido de Vendas

Expandir

title	Impressão de Boletos

Expandir

title	Baixa dos títulos a receber

Expandir

title	Cancelamento da baixa

Expandir

title	Cancelamento do Título a Receber

Expandir

title	Pagamento com Cartão - Portal do Aluno

Expandir

title	Negociação - Acordos

Expandir

title	Simulador de Cancelamento de Contrato

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 56

Nova versão 57

Chave