Descrição do processo

Parâmetros necessários para a Integração de dados entre o TOTVS Educacional (SGE) e o Protheus.

Detalhamento do processo

A tela de parâmetros esta disponível em TOTVS Educacional | Customização | Parâmetros da Integração - TOTVS Educacional (SGE) x Protheus e exibe uma visão com a lista de parâmetros disponíveis para configuração. São eles:

• Servidor Barramento: endereço de acesso ao banco de dados correspondente ao barramento IIF disponibilizado pelo cliente.
• Usuário: usuário para conexão com o banco de dados do barramento IIF.
• Senha: senha do usuário informado para conexão com banco de dados do barramento IIF. O campo é salvo criptografado.
• Empresa Protheus: código da Empresa do Protheus correspondente à Coligada da parametrização no TOTVS Educacional. Este campo é utilizado para efetuar o De-Para entre Coligada e Empresa.
• Habilita Integração: campo que define se a integração estará habilitada (valor igual a um) ou desabilitada (valor igual a zero). Este parâmetro é verificado antes de cada gatilho que efetua importação ou exportação de dados referentes à integração (plug-ins, processos customizados). Caso esteja desmarcado, os gatilhos não são executados.
• Condição de Pagamento: código da condição de pagamento que é utilizada ao enviar o Pedido para o Protheus. O cadastro de condição de pagamento do Protheus não é sincronizado com o TOTVS Educacional (SGE) sendo sempre enviado no pedido o valor parametrizado neste campo (Atualmente o cliente utiliza a condição de pagamento = 9).
• Código do Tipo de Baixa – Cancelamento: código do tipo de baixa por cancelamento que será enviado ao Protheus, nas situações de cancelamento de lançamentos.
• Código do Tipo de Baixa – Cartão de Crédito: código do tipo de baixa por cartão de crédito que será enviado ao Protheus, nas situações de baixa de lançamento com a forma de pagamento igual a cartão de crédito.

Os campos acima são de preenchimento livre. Não existe lista para buscar os cadastros e selecionar os códigos. Os códigos devem ser informados diretamente nos campos.

É necessário fazer o cadastro dos parâmetros em todas as Coligadas que utilizarão a integração. As informações são armazenadas em tabela customizada (ZPARAMETROTEMPLATE), por coligada.

O acesso à parametrização é pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

Importante: O preenchimento dos parâmetros é de responsabilidade do cliente. Para o correto funcionamento da customização, todos os dados devem estar parametrizados corretamente.

Descrição do processo

Criação de um anexo customizado no cadastro de serviços, disponível em TOTVS Educacional | Financeiro/Contábil | Serviços, em que o usuário faz a parametrização de informações necessárias para criação do pedido de venda no Protheus.

Detalhamento do processo

O usuário deve selecionar o Serviço para o qual deseja informar os parâmetros, clicar em Anexos – Integração Protheus. A tela possui os seguintes campos disponíveis:

• Natureza Financeira: campo em formato lista, onde o usuário pode selecionar o código da natureza financeira que será utilizada para Serviço. A lista de Naturezas é obtida através da tabela nativa de Natureza Orçamentária Financeira do TOTVS Educacional (TTBORCAMENTO), que será preenchida com os dados do cadastro de Natureza do Protheus, através do processo definido no Req.03.

• Produto: campo em formato lista, onde o usuário poderá selecionar o código do produto que será utilizado para o Serviço. A lista de Produtos será obtida através da tabela nativa do TOTVS Educacional (TPRODUTO), que será preenchida com os dados do cadastro de Produtos do Protheus, através do Processo Automático de Importação de Cadastros Básicos (Protheus => SGE).

• TES: campo em formato lista, onde o usuário pode selecionar um código de TES que será utilizado para o Serviço. Para seleção da TES, a customização consulta a View IIFR_SF4010_VW do barramento IIF que retorna uma lista de registros para o usuário selecionar um item.

• Série: campo texto onde o usuário informa a série que será utilizada pelo Serviço, quando gerar o Pedido no Protheus.

• Prefixo: campo texto onde o usuário informa a o prefixo do documento que será utilizada pelo Serviço, quando gerar o Pedido no Protheus.

Os dados informados nesta interface são armazenados por Serviço e Coligada. Será necessário informar estes parâmetros para cada serviço que for utilizado pela Integração Protheus.
Cada Serviço poderá ter somente um registro de anexo vinculado. O serviço "MENSALIDADE BALCÃO" por exemplo, na coligada SESI terá apenas uma natureza financeira, produto, TES, serie e prefixo associado. Mas dentro da mesma coligada poderemos ter outro serviço "MENSALIDADE INDUSTRIA' e nele teremos outros anexos, natureza financeira, produto, TES, serie e prefixo associado.
Os dados do cadastro da TES não serão armazenados em tabelas do TOTVS Educacional. A consulta para mostrar a lista será feita diretamente no barramento IIF.
O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Descrição do Processo

1. No TOTVS Educacional usuário acessa o menu Customização | Importação de Cadastros Básicos do Protheus para o TOTVS Educacional (SGE).
2. É exibida tela customizada de Job para agendamento ou execução imediata.
Se usuário desejar executar o processo imediatamente:
3. Rotina customizada executa processo de importação de cadastros básicos.
4. Caso contrário, usuário preenche as parametrizações de agendamento e os dados são gravados nas tabelas do gerenciamento de processos (para posterior execução quando forem atingidas as condições (data/hora) do agendamento.
5. Fim do Processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

O objetivo deste requisito é efetuar a importação de cadastros básicos do barramento IIF para o TOTVS Educacional.
Será criado um processo customizado que poderá ser executado manualmente ou agendado para executar com intervalos de tempo parametrizados pelo usuário. A tela para agendamento/execução do processo estará disponível no menu TOTVS Educacional | Customização | Importação – Cadastros Básicos.
Ao ser executado, o processo irá consultar Views disponíveis no barramento IIF referentes aos cadastros do Protheus. São elas:

Todos os registros das Views consultadas deverão retornar o código da Empresa no Protheus. Através dele, será buscada a Coligada do TOTVS Educacional, na tabela de parâmetros ZPARAMETROSTEMPLATE. O registro será gerado no TOTVS Educacional para a Coligada associada à Empresa do Protheus. São exceções os cadastros de Natureza Financeira, Moeda e Produto que serão globais.
Segue abaixo detalhamento dos campos de cada entidade à ser importada para o TOTVS Educacional.

• • Centro de Custo (CTT):

Além dos campos detalhados na coluna Campo TOTVS Educacional, será necessário preencher:

• • • "Envia para SPED Contábil" (GCCUSTO.ENVIASPED) com valor = F.
    • "Data da Inclusão" (GCCUSTO.DATAINCLUSAO) com a data corrente.

• • Item Contábil (CTD):

• • Classe de Valor (CTH):

• • Natureza Financeira (SED):

• • Moeda (CTO):

• • Banco (SA6):

Ao importar o cadastro de Bancos do Protheus, serão preenchidas quatro tabelas no TOTVS Educacional: GBANCO, GAGENCIA, FCONTA e FCXA.
Importante: O cadastro de Bancos do Protheus é por Empresa e Filial. O cadastro de banco de TOTVS Educacional é por Coligada. Para resolver este conflito, o cliente disponibilizará na View as informações consolidadas por Empresa, de modo que possam ser importadas para o TOTVS Educacional por Coligada.

Importante: No cadastro do Protheus, o Banco se repete para cada Agência e Conta cadastrada. Ele deverá ser gravado na tabela GBANCO do TOTVS Educacional apenas uma vez, verificando se já foi importado através do código A6_COD igual a GBANCO.NUMBANCO. O mesmo vale para Agência do Banco, que só precisa ser gravada na tabela GAGENCIA quando não existir outro registro para o mesmo Banco (GAGENCIA.NUMBANCO) com o campo A6_AGENCIA igual a GAGENCIA.NUMAGENCIA.
Cada Conta importada (vínculo entre Banco, Agência e Conta) deverá gerar uma Conta Caixa no TOTVS Educacional.
Ao gerar a Conta Caixa, será necessário preencher os campos básicos (a aba Integração bancária. Os campos serão preenchidos conforme abaixo:

• • Produto (SB1):

O cadastro de Produtos do TOTVS Educacional será Global, equivalente ao cadastro compartilhado do Protheus.
Todos os registros serão importados com o tipo igual a Serviço (TPRODUTO.TIPO = S). Todos serão importados como último nível (TPRODUTO.ULTIMONIVEL = 1) e não serão importados grupos e subgrupos do Protheus.
Além dos campos definidos acima, será preenchido ainda o campo TPRODUTO.DTCADASTRAMENTO, com a data corrente.
Importante: todos os produtos que estiverem disponíveis no barramento (View) serão importados para o TOTVS Educacional. É responsabilidade do Cliente/Protheus classificar os produtos cadastrados a fim de identificar os que precisam ser enviados ao TOTVS Educacional.

• • Plano de Contas (CT1):

Além dos campos definidos acima, serão preenchidos os campos:

• "Natureza da Conta para Emissão de SPED" (CCONTA.NATSPED) com o valor "Não Informada";
• "Data de Inclusão" (CCONTA.DATAINCLU) com a data corrente.

Ao executar, o processo customizado irá fazer a conexão com o barramento IIF e consultar as Views pré-definidas para cada cadastro. Para cada registro selecionado em cada uma das Views, será executada funcionalidade nativa do TOTVS Educacional para inclusão/atualização do registro no banco de dados, sendo validadas todas as regras de negócio padrão. Após validações, as tabelas correspondentes do TOTVS Educacional serão preenchidas com os dados das Views.
As Views do barramento deverão retornar apenas registros ainda não importados pelo TOTVS Educacional. Para isso, ao finalizar a importação dos dados, a customização deverá executar uma procedure do barramento (IIFR_STATUS_REPLICACAO_PRC) que será responsável por marcar o registro como já integrado. Desta forma, o barramento conseguirá mostrar nas Views apenas os registros pendentes de integração.
A procedure IIFR_STATUS_REPLICACAO_PRC deverá receber o mnemônico da tabela, o R_E_C_N_O_ do registro do Protheus e o status do registro: 'C' para Concluído ou 'F' para Falha.
Assinatura da Procedure: IIFR_STATUS_REPLICACAO_PRC(TABELA, R_E_C_N_O_, STATUS DEFAULT 'C').
Exemplo: IIFR_STATUS_REPLICACAO_PRC('CTT', 1807, 'C').
Ao final do processo, será gerado um log da execução, contendo informações como: Views consultadas, número de registros importados e mensagem de erro, caso ocorra. Este log será gravado em tabelas nativas do TOTVS Educacional e estará disponível para visualização através da interface - menu Ambiente, Gerenciamento de Jobs.
Importante:

1. Somente os cadastros mencionados acima serão sincronizados de forma automática através do processo de importação.
2. As informações de Empresa/Coligada e Filial não serão sincronizadas entre os dois sistemas, sendo necessário realizar o cadastro manual nos dois sistemas. As Views consultadas nestes requisitos deverão trazer o código da Empresa (duas primeiras posições do campo Filial-Protheus), possibilitando a associação entre a Empresa (Protheus) e a Coligada (TOTVS Educacional).
3. A regra para ocultar/mostrar registros integrados ou não nas Views e a criação do pacote para atualização de registros processados são tratados pelo barramento e é de responsabilidade do Cliente.
4. A pedido do cliente, a chave R_E_C_N_O_ do Protheus não será armazenada no TOTVS Educacional. Segundo o cliente, como este é um número sequencial, ele poderá não refletir o código correto em determinadas situações.
5. Não será necessário preencher o Código da Filial no cadastro das entidades importadas acima no TOTVS Educacional. Portanto, não utilizaremos o Código da Filial do Protheus nesta importação.
6. Não está prevista integração de dados de Parâmetros de Banco, Contrato de Banco e Dados do convênio. Estas parametrizações deverão ser informadas manualmente nos dois sistemas.
7. Não está prevista integração de dados de Tipo de Documento (X5), já que será utilizado apenas um código que será fixo no Protheus.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

• Descrição do Processo

1. No TOTVS Educacional usuário acessa menu Currículo e Oferta | Estrutura curricular | Mais | Modalidades do Curso | Anexos | Item Contábil.
2. Visão customizada do Anexo é exibida.
3. Usuário insere/altera/exclui registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Estrutura curricular | Mais | Modalidades do Curso, será criado um anexo customizado para que sejam informados os Itens Contábeis vinculados às Modalidades do Curso.
Neste anexo, será disponibilizado um campo do tipo lookup que referenciará a tabela SITEMCONTABILPROTHEUS. Os registros exibidos no lookup serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPMODALIDADEITEMCONTABIL) cujo detalhamento de dados segue abaixo.

PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir, editar e excluir registros. O usuário poderá selecionar somente Itens Contábeis vindos do Protheus, não podendo incluir manualmente novo Item Contábil sem que seja validado na tabela SITEMCONTABILPROTHEUS.
2. As informações serão armazenadas em uma tabela customizada (ZIPMODALIDADEITEMCONTABIL).
3. Para cada Modalidade poderão ser vinculados vários Itens Contábeis de acordo com a necessidade do usuário.
4. O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu do Anexo

Fig.2 – Visão do Anexo


Fig.3 – Formulário de Edição

• Fluxo do Processo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa menu Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada | Anexos | Dados Financeiros – Integração Protheus.
2. Interface customizada do anexo é exibida.
3. Usuário insere/altera registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada, será criado um anexo customizado para que seja informado o Item Contábil e a Classe de Valor vinculados às Matrizes Aplicadas.
Neste anexo, serão disponibilizados dois campos do tipo lista que farão referência às tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS. Os registros exibidos nas listas serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPMATRIZDADOSFINANCEIROS) cujo detalhamento de dados segue abaixo.

No momento que o usuário salvar o anexo de Dados Financeiros se o Item Contábil estiver preenchido serão realizadas as seguintes validações:

1. O Curso da Matriz Aplicada associada ao anexo que está sendo salvo possui Modalidade?
2. O Item Contábil informado está vinculado à Modalidade do Curso (Req. 04)?

Se o Curso da Matriz Aplicada não possuir Modalidade de Curso associada, ou se a Modalidade do Curso da Matriz Aplicada não estiver associada ao Item Contábil informado (Req.04), será exibida mensagem de erro, impossibilitando salvar o anexo.
Portanto, só será possível salvar o anexo se o Item Contábil e a Modalidade estiverem vinculados no TOTVS Educacional.
PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir e editar registros. O usuário poderá selecionar somente Itens Contábeis e Classes de Valor vindos do Protheus, não podendo incluir manualmente sem que sejam validados nas tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS respectivamente.
2. As informações serão armazenadas em uma tabela customizada (ZIPMATRIZDADOSFINANCEIROS).
3. Para cada Matriz Aplicada poderá ser vinculado apenas um Item Contábil e uma Classe de Valor.
4. O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu Anexo

• Descrição do Processo

1. No TOTVS Educacional usuário acessa Currículo e Oferta | Estrutura Curricular | Matrizes curriculares | Anexos | Matriz Aplicada.
2. Visão nativa é exibida.
3. Usuário inclui/altera registro e clica em salvar.
4. Item Contábil e Modalidade vinculados?
4.1. Sim. Executa passo 5.
4.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Matriz Aplicada.
5. Item Contábil e Centro de Custo vinculados?
5.1. Sim. Informações da Matriz Aplicada são salvas.
5.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Matriz Aplicada
6. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

Será criado um plugin customizado que interceptará o evento do botão Salvar/OK do cadastro de Matriz Aplicada acessado através do menu TOTVS Educacional | Currículo e Oferta | Estrutura curricular | Matriz curricular | Anexos | Matriz Aplicada.
No momento que o usuário salvar uma Matriz Aplicada e se houver Item Contábil vinculado à ela, serão realizadas as seguintes validações.

1. O Curso da Matriz Aplicada que está sendo salva possui Modalidade?
2. O Item Contábil da Matriz Aplicada (Req. 05) está vinculado à Modalidade do Curso (Req. 04)?
3. A Matriz Aplicada que está sendo salva possui Centro de Custo?
4. O Item Contábil e o Centro de Custo da Matriz Aplicada estão associados entre si no Protheus?

Se alguma das condições acima não for satisfeita, uma mensagem customizada será exibida ao usuário e ele será impossibilitado de salvar a Matriz Aplicada. Portanto, o usuário só conseguirá salvar as informações se o Item Contábil e a Modalidade estiverem vinculados no SGE e se o Item Contábil e o Centro de Custo estiverem vinculados no Protheus.
Para essa validação, o Protheus disponibilizará uma View (IIFR_CTA010_VW) que informará o vínculo entre Item Contábil e Centro de Custo. A consulta deverá ser feita por Coligada. Para isso, será considerada a Empresa Protheus parametrizada através do Req. 01. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.

• Descrição do Processo

1. No TOTVS Educacional usuário acessa Currículo e Oferta | Oferta | Turmas | Anexos | Dados Financeiros – Integração Protheus.
2. Interface customizada é exibida.
3. Usuário insere/altera/exclui registro.
4. Rotina armazena informações em tabela customizada.
5. Fim do fluxo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

No TOTVS Educacional por meio do menu Currículo e Oferta | Oferta | Turmas, será criado um anexo customizado para que seja informado o Item Contábil e a Classe de Valor vinculados às Turmas.
Neste anexo, serão disponibilizados dois campos do tipo lista que farão referência às tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS. Os registros exibidos nas listas serão filtrados pela Coligada do contexto.
As informações serão armazenadas em uma tabela customizada (ZIPTURMADADOSFINANCEIROS) cujo detalhamento de dados segue abaixo.

No momento que o usuário salvar o anexo de Dados Financeiros se o Item Contábil estiver preenchido serão realizadas as seguintes validações:

1. O Curso da Turma associada ao anexo que está sendo salvo possui Modalidade?
2. O Item Contábil informado está vinculado à Modalidade do Curso (Req. 04)?

Se o Curso da Turma não possuir Modalidade de Curso associada, ou se a Modalidade do Curso da Turma não estiver associada ao Item Contábil informado (Req.04), será exibida mensagem de erro, impossibilitando salvar o anexo.
Portanto, só será possível salvar o anexo se o Item Contábil e a Modalidade estiverem vinculados no TOTVS Educacional.
PONTOS DE ATENÇÃO:
1. Nesta interface, o usuário poderá incluir e editar registros. O usuário poderá selecionar somente Itens Contábeis e Classes de Valor vindos do Protheus, não podendo incluir manualmente sem que sejam validados nas tabelas SITEMCONTABILPROTHEUS e SCLASSEVALORPROTHEUS respectivamente.
2. As informações serão armazenadas em uma tabela customizada (ZIPTURMADADOSFINANCEIROS).
3. Para cada Turma poderá ser vinculado apenas um Item Contábil e uma Classe de Valor.
4. Dependendo da situação, o Item Contábil pode ser informado na Turma ou na Matriz Aplicada. Nos casos onde for informado em ambos, o Item Contábil da Turma deve prevalecer para a integração.
5. O acesso a esta interface será controlado pelas permissões concedidas por perfil de usuário disponíveis através do TOTVS Serviços Globais | Segurança | Perfil.

• Protótipo

As imagens dos protótipos são meramente ilustrativas, podendo variar ao longo do desenvolvimento de acordo com a ferramenta TOTVS.

Fig.1 – Menu do Anexo


Fig.2 – Anexo Dados financeiros – Integração Protheus

• Descrição do Processo

1. No TOTVS Educacional usuário acessa Currículo e Oferta | Oferta | Turmas.
2. Visão nativa é exibida.
3. Usuário inclui/altera registro e clica em salvar.
4. Item Contábil e Modalidade vinculados?
4.1. Sim. Executa passo 5.
4.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Turma.
5. Item Contábil e Centro de Custo vinculados?
5.1. Sim. Informações da Turma são salvas.
5.2. Não. Mensagem de erro customizada é exibida e usuário é impedido de salvar as informações da Turma
6. Fim do processo.

• Detalhamento de Cálculos

Não se aplica.

• Detalhamento de Processos Específicos

Será criado um plugin customizado que interceptará o evento do botão Salvar/OK do cadastro de Turma acessado através do menu TOTVS Educacional | Currículo e Oferta | Oferta | Turmas.
No momento que o usuário salvar uma Turma e se houver Item Contábil vinculado à ela, serão realizadas as seguintes validações.

1. O Curso da Turma que está sendo salva possui Modalidade?
2. O Item Contábil da Turma (Req. 07) está vinculado à Modalidade do Curso (Req. 04)?
3. A Turma que está sendo salva possui Centro de Custo?
4. O Item Contábil e o Centro de Custo da Turma estão associados entre si no Protheus?

Se alguma das condições acima não for satisfeita, uma mensagem customizada será exibida ao usuário e ele será impossibilitado de salvar a Turma. Portanto, o usuário só conseguirá salvar as informações se o Item Contábil e a Modalidade estiverem vinculados no SGE e se o Item Contábil e o Centro de Custo estiverem vinculados no Protheus.
Para essa validação, o Protheus disponibilizará uma View (IIFR_CTA010_VW) que informará o vínculo entre Item Contábil e Centro de Custo. A consulta deverá ser feita por Coligada. Para isso, será considerada a Empresa Protheus parametrizada através do Req. 01. O valor do campo EMPRESAPROTHEUS deverá ser recuperado da tabela ZPARAMETROTEMPLATE e passado como filtro para a View.