Projeto: FS007780 (873247-874083) – Integração RM com Protheus – Parte 2 (SESI-SENAI)
Cliente: FIERGS
Data: 26/10/2017

Sumário

O documento a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual têm como base do que está descrito no documento "Especificação Anexo I – Detalhamento Funcional – FS007779 – Parte 2.

5.1. Req. 01 – Anexo customizado de Dados Financeiros no cadastro do Processo Seletivo
5.2. Req. 02 – Criação de Campos Customizados no Cadastro do Contrato
5.3. Req. 1. Objetivo do documento
2. Síntese
3. Instalando a customização
3.1. Ambiente necessário
3.2. Executando o instalador de arquivos
3.3. Executando os scripts
3.4. Permissao de acesso a telas
3.4.1. Verificando o perfil do usuário
3.4.2. Liberando acesso aos menus
4. Observações importantes
5. Requisitos
5.1. Req. 01 – Anexo customizado de Dados Financeiros no cadastro do Processo Seletivo
5.2. Req. 02 – Criação de Campos Customizados no Cadastro do Contrato
5.3. Req. 03 – Exportação de Clientes (TOTVS RM  Protheus)
5.4. Req. 04 – Exportação de Pedido de Venda (TOTVS RM  Protheus)
5.5. Req. 05 – Exportação de lançamentos contábeis (TOTVS RM  Protheus)
5.6. Req. 06 – Validação de Inadimplência (Win)
5.7. Req. 07 – Validação de Inadimplência (Web)
5.8. Req. 08 – Interface de Log e Reenvio de Dados
6. Requisitos – Análise de Impacto I
6.1. Novo requisito – Req.01 – Anexo customizado de Dados Financeiros no item de contrato do TOTVS Gestão de Estoque, Compras e Faturamento
6.2. Novo requisito – Req.02 – Exportação de Pedido de Venda – Contrato Corporativo (TOTVS RM  Protheus)
6.3. Novo requisito – Req.03 – Exportação de Lançamentos Contábeis (TOTVS RM  Protheus)
6.4. Novo requisito – Req.04 – Exportação de Cancelamento de Lançamento Financeiro (TOTVS RM  Protheus)
6.5. Alteração – Int. Parte 1 – Req. 03 – Processo Automático de Importação de Cadastros Básicos (Protheus => SGE) - Natureza
7. Histórico de Atualização do Documento
7.1. Histórico de Versões
7.2. Aprovação

...

O documento a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual têm como base do que está descrito no documento "Especificação Anexo I – Detalhamento Funcional – FS007779 – Parte 2.

...

O cliente FIERGS solicita customização para atender a demanda de integração entre SGE e Protheus.
A integração será realizada via banco de dados, utilizando o barramento IIF (Interface de Integração FIERGS) que será disponibilizado pela FIERGS, onde:
Para exportação de dados, o TOTVS Educacional irá escrever em tabelas de um banco de dados previamente parametrizado utilizando Pacotes (Procedures, Functions) disponibilizadas pela FIERGS para este fim. A equipe técnica da FIERGS será responsável por ler os dados deste banco e gerenciar/enviar para o ERP Protheus, que irá executar funcionalidades nativas, sendo validadas todas as regras de negócios, para que os dados sejam inseridos/atualizados no banco de dados do ERP Protheus.
Para importação de dados, o TOTVS Educacional irá ler informações das tabelas do mesmo banco de dados através de Views e executar funcionalidades nativas, sendo validadas todas as regras de negócios, para que os dados sejam inseridos/atualizados no banco de dados do TOTVS Educacional.
Este documento visa orientar sobre os passos iniciais para utilização da Customização.

...

• Sistema base: TOTVS Educacional
• Banco de dados: Oracle
• Versão do ERP: 12.1.17

...

...

• Executar o script 'TOTVS_Custom_Register_Action.sql';
• Executar o script 'TOTVS_Custom_Consolidate_All_Parte2.sql;

...

• O usuário deve acessar o RM.exe em X:\totvs\CorporeRM\RM.Net.
• Acessar TOTVS Serviços Globais | Segurança | Usuário.
• No campo (Sistema: ) selecione o produto correto.
• Busque pelo usuário desejado e clique em editar.
• Navegue até a aba Segurança.
• Verifique qual é o perfil do usuário (Como mostra na imagem exemplo abaixo o perfil é DBA).

...

• TOTVS Serviços Globais | Segurança | Perfis.
• No campo (Sistema: ) selecione o produto correto.
• Busque pelo perfil desejado e clique em editar (como no exemplo acima o perfil será DBA).
• Navegue até a aba Acesso a Menus.
• Procure pelas customizações e selecione as desejadas.
• Clique em Permitir Acesso e depois em Ok.

Image Removed
Fig. 08 – Liberando acesso

...

Para o correto funcionamento do Novo Gerenciador de Jobs algumas configurações devem ser observadas. Dentro da pasta "X:\totvs\CorporeRM\RM.Net" cinco arquivos precisam ser verificados. São eles:

• RM.Host.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Adicionar: <add key="IsolateProcess" value="true" />
Adicionar: <add key="EnableProcessIsolation" value="true" />

• RM.Host.Service.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Adicionar: <add key="IsolateProcess" value="true" />
Adicionar: <add key="EnableProcessIsolation" value="true" />

• RM.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.

• Alias.dat.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Servidores de (Servidores de JOB e APP) para que as customizações sejam carregadas: <RunService>true</RunService>.

• RM.Host.JobRunner.exe.config (SOMENTE SERVIDORES JOB).

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Para carregar os plug-ins de processos customizados: <add key="LoadCustomSlave" value="true" />.

...

de Cancelamento de Lançamento Financeiro (TOTVS RM  Protheus)
6.5. Alteração – Int. Parte 1 – Req. 03 – Processo Automático de Importação de Cadastros Básicos (Protheus => SGE) - Natureza

Âncora
_Toc500863180 _Toc500863180

5.1.

Âncora
_Toc486488235 _Toc486488235

Âncora
_Toc488661479 _Toc488661479

Req. 01 – Anexo customizado de Dados Financeiros no cadastro do Processo Seletivo

Este requisito detalha a disponibilização do anexo customizado "Dados financeiros – Integração Protheus". O processo não apresenta diferenças entre as Coligadas do SESI e SENAI.

5.1.1 Pré-Requisitos / Parametrizações

1. Executar o processo de Importação de Cadastros Básicos, disponível no menu Educacional | Customização para importação dos cadastros de Itens Contábeis, Classes de Valor e Centros de Custo.

5.1.2 Descrição do Processo

O Anexo "Dados financeiros – Integração Protheus" está disponível no menu Processo Seletivo | Cadastros | Processo Seletivo | Anexo Dados Financeiros – Integração Protheus.

Nesta tela teremos três campos que farão referência às tabelas SITEMCONTABILPROTHEUS, SCLASSEVALORPROTHEUS e SSERVICO filtrados pela Coligada do contexto. As informações definidas aqui serão gravadas na tabela customizada ZIPPSDADOSFINANCEIROS e serão utilizadas no processo de Exportação de Lançamentos Financeiros (Pedido de Venda) para o Protheus.
Para cada Processo Seletivo poderá ser vinculado apenas um Item Contábil, uma Classe de Valor e um Serviço.
O Centro de Custo deverá ser informado no campo nativo do cadastro do Processo Seletivo.

Âncora
_Toc500863181 _Toc500863181

5.2. Req. 02 – Criação de Campos Customizados no Cadastro do Contrato

Este requisito detalha a disponibilização de campos customizados no cadastro do Contrato Educacional. O processo não apresenta diferenças entre as Coligadas do SESI e SENAI.

5.2.1 Pré-Requisitos / Parametrizações

1. Criação da tabela dinâmica BANDEIRACC, para cada Coligada. Os itens da tabela deverão ser inseridos com o código correspondente no Protheus. Exemplo:

BANRICOMPRAS 002- MASTERCARD 003- VISA 006- VERDECARD
O Script para criação dessa tabela com os itens acima está contido no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql.
Para manipular os itens da tabela dinâmica, acesse o Módulo Serviços Globais, menu Administração |Tabela Dinâmica. Seleciona a tabela BANDEIRACC e adicione quantos itens forem necessários no Anexo Item de Tabela dinâmica.

5.2.2 Descrição do Processo

Os campos customizados estarão disponíveis na interface nativa de Contrato no TOTVS Educacional disponível em TOTVS Educacional | Financeiro/Contábil | Contratos.

Estas informações serão relevantes para quando o Aluno ou Responsável optar pelo pagamento do Curso, objeto do Contrato Educacional, via cartão de crédito ao realizar a Matrícula pela Secretaria. Em ocasiões como esta é necessário que os dados sejam enviados para o Protheus durante a integração de Pedido de Venda.
Segue abaixo o detalhamento dos 3 campos:

...

• Não está prevista nenhuma rotina para preenchimento automático dos campos. O usuário deve preenchê-los manualmente, somente quando o pagamento for realizado com Cartão de Crédito.
• Não está prevista nenhuma rotina para integrar as Bandeiras dos Cartões de Crédito. Os registros deverão ser inseridos no TOTVS RM manualmente na tabela dinâmica espelhando o cadastro no Protheus (mesmos códigos).
• Ao salvar um Contrato cuja opção Pagamento com Cartão de Crédito esteja marcada, o usuário será informado que os dados da baixa serão enviados ao Protheus e que, portanto, as informações não poderão mais sofrer alterações após geração dos lançamentos financeiros. A partir desse momento os campos referentes ao cartão ficarão desabilitados e não poderão mais ser alterados.

Âncora
_Toc500863182 _Toc500863182

5.3. Req. 03 – Exportação de Clientes (TOTVS RM  Protheus)

Este requisito detalha a exportação do cadastro de Clientes a ser realizada entre o TOTVS Gestão Financeira e o Protheus. O processo não apresenta diferenças entre as Coligadas do SESI e SENAI. Esse processo é automático e não precisa ser agendado.

5.3.1 Pré-Requisitos / Parametrizações

1. Deve ser criado o campo complementar IDINTEGRACAO para a FCFOCOMPL: Alfanumérico, Tamanho 255, Texto. A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql.
2. O RM precisa estar parametrizado para permitir Clientes e Fornecedores Globais (em todas as Coligadas). Esse parâmetro é ajustado no caminho: Módulo BackOffice Gestão Financeira, menu Ambiente  Parâmetros  TOTVS Gestão Financeira  Selecionar Contas a Pagar - Lançamento  Etapa Cliente/Fornecedor e marcar o parâmetro Permite Globais, conforme imagem abaixo. O campo "Default Cli/For Global" também precisa ser marcado para facilitar os cadastros. Abaixo, segue tela da parametrização.

5.3.2 Descrição do Processo

Ao acessar as funcionalidades disponíveis no cadastro do Aluno (Educacional | Currículo e Oferta | Aluno) através dos botões: "Cadastrar ALUNO como responsável", "Cadastrar PAI/MÃE como responsável", "Cadastrar RESPONSÁVEL ACADÊMICO como responsável" ou ao incluir ou editar um Cliente no módulo BackOffice | Gestão Financeira | Cadastros | Clientes/Fornecedores a exportação será acionada.
Na inclusão ou alteração, a customização acionará a função MATA030 (pacote IIFR_CLIENTE_PCK) e neste momento enviará o registro para o Barramento IIF, de onde será lido pelo Protheus.
A inclusão/alteração do Cliente será concretizada no TOTVS independente do retorno recebido pelo Protheus. Caso ocorra erro na integração, o usuário poderá visualizar o erro ocorrido e reenviar o registro através interface de log descrita através do Req. 08. Se for necessário alterar alguma informação no cadastro, ele será integrado novamente de forma automática após alteração. A interface de log mostrará também o pacote que foi enviado ao barramento.
O Cliente no Protheus é compartilhado, ou seja, utiliza um cadastro único para todas as empresas. Portanto, no TOTVS RM o Cliente deve ser global (coligada 0).
O campo complementar IDINTEGRACAO para a FCFOCOMPL receberá o resultado da integração realizada (Id Barramento).
Os campos de Endereço (Principal e Pagamento) são de preenchimento obrigatório, já que são obrigatórios no Protheus. São eles: CEP, Rua, Número, Bairro, Estado, Município e País. O campo Data de Nascimento também é obrigatório. Não será permitido salvar o cadastro sem informar estes campos.
PONTOS DE ATENÇÃO:

• Nenhum anexo do cadastro de Clientes Fornecedores será integrado, tampouco acionará a integração no momento que for salvo.
• Nenhum processo do cadastro de Clientes Fornecedores acionará a integração.
• Os campos que serão integrados neste Requisito podem ser consultados na Especificação Funcional.
• Somente serão exportados dados dos registros classificados como Clientes ou Ambos (FCFO.PAGREC = 1 Cliente ou FCFO.PAGREC = 3 Ambos).
• Somente serão exportados dados de registros globais (coligada 0). Caso seja criado um Cliente não global, a customização irá gerar uma mensagem de erro na interface de log.
• Através deste requisito serão integrados dados de inclusões e atualizações de Clientes. Não faz parte deste escopo a exclusão de registros.
• Todos os campos do tipo texto serão tratados antes de serem enviados ao barramento IIF. Serão retirados alguns caracteres especiais e todo tipo de acentuação. Além disso, o texto será enviado em caixa alta.

Âncora
_Toc500863183 _Toc500863183

5.4. Req. 04 – Exportação de Pedido de Venda (TOTVS RM  Protheus)

Este requisito detalha a exportação de títulos financeiros a ser realizada entre o TOTVS Gestão Financeira e o Protheus. A integração será realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deverá ser agendado no TOTVS Educacional, menu Customização | Exportação de Pedido de Venda.

5.4.1 Pré-Requisitos / Parametrizações

1. Deve ser criado o campo complementar IDINTEGRACAO para a FLANCOMPL: Alfanumérico, Tamanho 255, Texto. Este campo receberá o resultado da integração realizada (Id Barramento). A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql.
2. As Contas Caixas das Filiais e dados dos Convênios para geração do Nosso Número precisam estar configurados para geração dos lançamentos financeiros.
3. Configurar o código do Tipo de Baixa que será exportado para o Protheus no TOTVS Educacional, menu Customização | Parâmetros | Código do Tipo da Baixa – Cartão de Crédito. Esse valor será utilizado no envio da baixa quando os dados do cartão de crédito forem preenchidos.

5.4.2 Descrição do Processo

Ao salvar o Contrato no TOTVS Educacional, a customização preenche uma tabela (ZIPLANCAMENTO) com os dados dos lançamentos gerados por contrato. A rotina de exportação irá consultar a tabela customizada onde estarão armazenadas as chaves dos Lançamentos (títulos financeiros) que foram incluídos no TOTVS RM. A customização acionará a função MATA410 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus. O retorno será salvo em tabela customizada de log. Caso ocorra erro na integração, o usuário poderá reenviar o registro através da interface de log descrita através do Req. 08. . A interface de log mostrará também o pacote que foi enviado ao barramento.
Somente serão integrados os lançamentos originados de contratos educacionais ou taxas de inscrição de Processos Seletivos que ao serem salvos geram um registro na tabela customizada ZIPLANCAMENTO e estão pendentes de envio.
Após o envio, os registros da tabela ZIPLANCAMENTO referentes aos Contratos exportados terão o campo STATUS atualizado para E (Enviado).
Se a flag customizada "Pagamento com Cartão de Crédito" do Contrato estiver marcada, será enviado para o Protheus o Pedido de Venda e Baixa do(s) título(s) no mesmo momento (utilizando o Id Dependência do barramento, para só processar as baixas após processar o Pedido). A baixa utiliza função FINA070. A baixa do Lançamento no TOTVS RM não será realizada pela customização neste momento, mas sim quando o Protheus retorná-la através de rotina de Importação de Baixa, que será detalhada no documento Especificação Anexo I - Detalhamento Funcional - FS007781 - Parte 3.
Somente matrículas realizadas na secretaria poderão ser pagas com Cartão de Crédito. Os demais serviços não possuem esta opção (inscrição no Processo Seletivo, Rematrícula, etc.) e portanto, para eles, não está prevista nenhuma rotina de envio de dados de baixa ao Protheus.
As validações de Item Contábil x Modalidade e Item Contábil x Centro de Custo descritas nos Req. 06 e Req 08 do documento Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1, são realizadas também antes de salvar o Pedido de Venda ao Protheus, impedindo que seja salvo em caso de inconsistência.
O campo complementar IDINTEGRACAO para a FLANCOMPL receberá o resultado da integração realizada (Id Barramento).
Concessão de Bolsas:

...

• Contratos com mais de um Cliente deverão gerar pedidos de venda por Cliente.
• Para contratos de bolsa de 100%, são gerados Lançamentos com o valor zerado no RM, mas esses registros não serão enviados ao Protheus.
• Alterações e exclusões de lançamentos não são cobertas pela Customização.
• Acordos serão tratados no Protheus e portanto, se for identificada a criação de um Contrato no TOTVS RM do tipo acordo (SCONTRATO.TIPOCONTRATO), não será gerado Pedido de Venda no Protheus.

Âncora
_Toc500863184 _Toc500863184

5.5. Req. 05 – Exportação de lançamentos contábeis (TOTVS RM  Protheus)

Este requisito detalha a exportação de lançamentos contábeis a ser realizada entre o TOTVS Gestão Contábil e o Protheus. A integração será automática ao salvar lançamentos contábeis e por isso, não precisa ser agendado. Os lançamentos serão enviados do TOTVS Gestão Contábil para o Protheus.

5.5.1 Pré-Requisitos / Parametrizações

1. Deve ser criado o campo complementar IDINTEGRACAO para a CPARTIDACOMPL: Alfanumérico, Tamanho 255, Texto. A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql.
2. Definir o número dos lotes contábeis que serão utilizados (menu Educacional > Ambiente > Parâmetros > Educacional > Integração > Contabilidade). Eles precisam ter três dígitos, já o Protheus possui limite de 6 caracteres e eles serão enviados concatenados com a Sigla SGE.
3. Informar período contábil válido no menu módulo Gestão Contábil, menu Ambiente > Parâmetros > TOTVS Gestão Contábil > Lançamentos > Manutenção de Lançamentos > Período Contábil. A data atual deve estar contemplada no período definido.
4. Efetuar a liberação do período por usuário no Módulo Globais, menu Serviços Globais > Segurança > Usuários > Gestão Contábil > Anexos > Período para Manutenção de Lançamentos Contábeis.

5.5.2 Descrição do Processo

A integração será realizada de forma automática, no sentido TOTVS RM  Protheus no momento em que o usuário acionar o Processo de Gerar Contabilização. Este processo pode ser acionado pelo usuário através dos menus TOTVS Educacional | Financeiro / Contábil | Contratos | Processos | Gerar Contabilização do TOTVS Educacional | Financeiro / Contábil | Contabilização. Ao ser executada, a rotina customizada executará a exportação que irá recuperar os registros de Lançamentos Contábeis que foram incluídos no TOTVS RM e acionará a função CTBA102 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus. O retorno será salvo em tabela customizada de log. Caso ocorra erro na integração, o usuário poderá reenviar o registro através da interface de log referenciada no Req. 08. A interface de log mostrará também o pacote que foi enviado ao barramento.
Deve ser criado pelo cliente o campo complementar IDINTEGRACAO para a CPARTIDACOMPL: Alfanumérico, Tamanho 255, Texto. Este campo receberá o resultado da integração realizada.
PONTOS DE ATENÇÃO:

• Todos os sublotes precisam fechar débito e crédito, ou seja, cada lançamento contábil tem partidas de débito e crédito que devem ser iguais entre si em termos de valores.
• Todos os campos do tipo texto serão tratados antes de serem enviados ao Protheus. Serão retirados os caracteres especiais e todo tipo de acentuação. Além disso, o texto será enviado em caixa alta.
• As validações de Item Contábil x Modalidade e Item Contábil x Centro de Custo descritas nos Req. 06 e Req. 08 do documento Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1, devem ser realizadas também antes da geração dos Lançamentos Contábeis no RM. Caso haja inconsistência, um erro será gerado no log do processo.
• Processos Seletivos não geram lançamentos contábeis no TOTVS Gestão Contábil.

Âncora
_Toc500863185 _Toc500863185

5.6. Req. 06 – Validação de Inadimplência (Win)

Este requisito detalha a disponibilização um processo customizado para validar a inadimplência do responsável financeiro do aluno no momento da matrícula.

5.6.1 Pré-Requisitos / Parametrizações

Não se aplica.

5.6.2 Descrição do Processo

O processo customizado será acionado quando um usuário matricular um aluno no TOTVS Educacional (SGE).
Serão considerados os seguintes processos de matrícula:

...

Antes da execução dos processos listados acima, um processo customizado irá consultar a visão IIFR_Z0D010_VW do barramento IIF que irá validar se o responsável financeiro do aluno está inadimplente. Caso esteja, uma mensagem informativa será exibida para o usuário, que poderá prosseguir ou não com o processo nativo.

Âncora
_Toc500863186 _Toc500863186

5.7. Req. 07 – Validação de Inadimplência (Web)

Este requisito detalha a disponibilização um processo customizado para validar a inadimplência do responsável financeiro do aluno no momento da matricula/rematrícula através do Portal (acesso do aluno).

5.7.1 Pré-Requisitos / Parametrizações

Não se aplica.

5.7.2 Descrição do Processo

Este requisito detalha a disponibilização um processo customizado para validar a inadimplência do responsável financeiro do aluno no momento da matricula.
O processo customizado será acionado quando um usuário matricular um aluno no TOTVS Educacional (SGE).
Serão considerados os seguintes processos de matrícula:
Coligada SESI:

...

• A visão verifica a situação do responsável financeiro em todas bases dos sistemas FIERGS.

Âncora
_Toc500863187 _Toc500863187

5.8. Req. 08 – Interface de Log e Reenvio de Dados

Este requisito detalha a disponibilização de uma tela de log customizada capaz de apresentar o resultados de todos os registros enviados visível em TOTVS Educacional | Customização | Monitor de log de exportação.

5.8.1 Pré-Requisitos / Parametrizações

Não se aplica.

5.8.2 Descrição do Processo

Os registros que foram exportados e geraram ocorrências de erros, ficando com status "Pendente", poderão ser reprocessados através do processo de 'Reenvio de dados' disponível na visão Monitor de Log de Integrações.
Esta tela não permite inclusão, alteração ou exclusão de registro.
O campo IDFUNCPROC determinará o processo vinculado ao registro de log sendo:

O campo STATUS determinará o status vinculado ao registro de log sendo:
S = Sucesso - Registro integrado com "sucesso".
E = Erro - Registro apresentou "erro" na integração e poderá ser reprocessado.
C = Cancelado - Registro teve seu reprocessamento cancelado e não está disponível para ser integrado.
A interface de log é composta por duas tabelas, cabeçalho do log - LOGINTEGRACAO e item do log - ZITMLOGINTEGRACAO.
Para o processo de reenvio, se o número da tentativa for menor ou igual ao "Limite Tentativas para Reenvio", parametrizado através do Req. 01 – Parâmetros da customização, o processo de reenvio de dados será executado na tentativa de integrar o registro novamente. Neste caso, não será gerado novo log para o registro, o log atual será atualizado com os dados do reenvio e com o número de tentativas de integração incidentes sobre o registro.
Caso o número de tentativas seja superior ao limite parametrizado, o processo customizado irá enviar um e-mail para o "Endereço de e-mail responsável' que deverá ser parametrizado através do Req. 01 – Parâmetros da customização, notificando ao usuário que o registro excedeu ao número de tentativas de integração permitido. O registro terá seu status alterado para "Cancelado" e não será reprocessado.

Âncora
_Toc500863188 _Toc500863188

6. Requisitos – Análise de Impacto I

A seguir, serão detalhados os requisitos da Integração Financeira e Contábil entre Contratos Corporativos TOTVS (Turma in Company) e Protheus.

Âncora
_Toc500863189 _Toc500863189

6.1. Novo requisito – Req.01 – Anexo customizado de Dados Financeiros no item de contrato do TOTVS Gestão de Estoque, Compras e Faturamento

Este requisito detalha a disponibilização do anexo customizado "Dados financeiros – Integração Protheus" no item do Contrato Corporativo. O processo não apresenta diferenças entre as Coligadas do SESI e SENAI.

6.1.1 Pré-Requisitos / Parametrizações

1. Executar o processo de Importação de Cadastros Básicos, disponível no menu Educacional | Customização para importação dos cadastros de Itens Contábeis, Classes de Valor e Centros de Custo.

6.1.2 Descrição do Processo

O Anexo "Dados financeiros – Integração Protheus" está disponível no módulo TOTVS Gestão de Estoque, Compras e Faturamento, menu Contratos | Manutenção de Contrato, seleciona o Contrato | Itens | seleciona o Item | Customização | Dados Financeiros – Integração Protheus.

Nesta tela teremos três campos que farão referência às tabelas SITEMCONTABILPROTHEUS, SCLASSEVALORPROTHEUS e SSERVICO filtrados pela Coligada do contexto. As informações definidas aqui serão gravadas na tabela customizada ZIPCTRDADOSFINANCEIROS e serão utilizadas no processo de Exportação de Lançamentos Financeiros – Contrato Corporativo (Pedido de Venda) para o Protheus.
Para cada Item do Contrato poderá ser vinculado apenas um Item Contábil, uma Classe de Valor e um Serviço.
O Centro de Custo deverá ser informado no campo nativo do cadastro do Contrato.

Âncora
_Toc500863190 _Toc500863190

6.2. Novo requisito – Req.02 – Exportação de Pedido de Venda – Contrato Corporativo (TOTVS RM  Protheus)

Este requisito detalha a exportação de títulos financeiros a ser realizada entre o TOTVS Gestão de Estoque Compras e Faturamento / Financeiro e o Protheus. A integração será realizada de forma automática (Job Server), respeitando os intervalos de tempo pré-definidos pelo usuário no agendamento. O Processo deverá ser agendado no TOTVS Educacional, menu Customização | Exportação de Pedido de Venda.

6.2.1 Pré-Requisitos / Parametrizações

1. Deve ser criado o campo complementar IDINTEGRACAO para a FLANCOMPL: Alfanumérico, Tamanho 255, Texto. Este campo receberá o resultado da integração realizada (Id Barramento). A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql.
2. As Contas Caixas das Filiais e dados dos Convênios para geração do Nosso Número precisam estar configurados para geração dos lançamentos financeiros.

6.2.2 Descrição do Processo

Ao Faturar uma medição de um Contrato Corporativo do TOTVS Gestão de Estoque, Compras e Faturamento, a customização preenche uma tabela (ZIPLANCAMENTO) com os dados dos lançamentos gerados pelo contrato. A rotina de exportação irá consultar a tabela customizada onde estarão armazenadas as chaves dos Lançamentos (títulos financeiros) que foram incluídos no TOTVS RM. A customização acionará a função MATA410 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus. O retorno será salvo em tabela customizada de log. Caso ocorra erro na integração, o usuário poderá reenviar o registro através da interface de log descrita através do Req. 08.. A interface de log mostrará também o pacote que foi enviado ao barramento.
Além dos lançamentos financeiros originados de Contratos Educacionais ou taxas de inscrição de Processos Seletivos, serão integrados também os lançamentos originados de Contratos Corporativos (Turma In Company) que ao serem salvos geram um registro na tabela customizada ZIPLANCAMENTO e estão pendentes de envio.
Após o envio, os registros da tabela ZIPLANCAMENTO referentes aos Contratos exportados terão o campo STATUS atualizado para E (Enviado).
Antes de enviar os lançamentos para o Protheus, a customização acionará automaticamente o processo de Inclusão de Boleto disponível em Lançamentos | Processos | Boleto, para que sejam gerados os Boletos referentes aos Lançamentos do Contrato Corporativo, sem necessidade de intervenção do usuário.
Para que o Contrato Corporativo gere o Pedido de Venda no Protheus, são necessários os seguintes passos:
Passo 1 – Criar um Contrato e seu Item:

• Acessar o menu Contratos | Manutenção de Contrato | Incluir um novo Contrato.
• Clicar na aba Itens e incluir um novo Item. Preencha os dados do Item. O tipo de faturamento do Item tem que ser "Por Medição".

• Inclua a Medição em Informações Adicionais, selecione o tipo de Medição "Por Valor" e clique em Incluir. Depois disso, o item poderá ser salvo.
• Após salvar o Item, preencha os dados financeiros no botão Customização, na mesma tela.
• Salve o Item e o Contrato.

Passo 2 – Faturar a Medição do Contrato (Movimento 2.1.01):

• Localize o contrato salvo na visão, clique em Anexos | Visualizar Medições do Contrato. Selecione a Medição do Contrato e clique em Faturar Medição.

• Na tela que será exibida, o campo Tipo de Movimento estará preenchido com o valor 2.1.01 (caso não esteja, selecione este número) e clique em Executar.
• Neste momento será gerado o movimento do tipo 2.1.01 que efetuará a geração dos Lançamentos financeiros (Pedido de venda) e a Contabilização da apropriação do Contrato.
• Se o Job do Pedido de Venda não estiver agendado para execução automática, é necessário executá-lo manualmente no Educacional, menu Customização | Exportação de Pedido de Venda.

...

ExECSQL ('NATINSS');
     SE (RESULTSQL ('NATINSS', 'CONT') > 0
       E KQT * KPU > 91)
       ENTAO KQT * KPU
         SENAO 0
       FIMSE

1. Criação da Fórmula 000009 (utilizada na sentença SQL)

TABITM('IDCNT','S')

Âncora
_Toc500863191 _Toc500863191

6.3. Novo requisito – Req.03 – Exportação de Lançamentos Contábeis (TOTVS RM  Protheus)

Este requisito detalha a exportação de lançamentos contábeis a ser realizada entre o TOTVS Gestão Contábil e o Protheus. A integração será automática ao Faturar a Medição do Contrato Corporativo (2.1.01) e ao Incluir Movimento para Contabilização da Competência (2.2.01). Por isso, este processo não precisa ser agendado. Os lançamentos serão enviados do TOTVS Gestão Contábil para o Protheus.

6.3.1 Pré-Requisitos / Parametrizações

1. Deve ser criado o campo complementar IDINTEGRACAO para a CPARTIDACOMPL: Alfanumérico, Tamanho 255, Texto. A criação deste campo já está contemplada no arquivo TOTVS_Custom_Consolidate_All_Parte2.sql.
2. Definir o número dos lotes contábeis que serão utilizados (menu Educacional > Ambiente > Parâmetros > Educacional > Integração > Contabilidade). Eles precisam ter três dígitos, já o Protheus possui limite de 6 caracteres e eles serão enviados concatenados com a Sigla SGE.
3. Definir o número dos lotes contábeis que serão utilizados (TOTVS Gestão de Estoque, Compras e Faturamento > Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > Etapa Vendas > Faturamento – Configurar para os Tipos de Movimentos 2.1.01 e 2.2.01). Eles precisam ter três dígitos, já o Protheus possui limite de 6 caracteres e eles serão enviados concatenados com a Sigla SGE.
4. Informar período contábil válido no menu módulo Gestão Contábil, menu Ambiente > Parâmetros > TOTVS Gestão Contábil > Lançamentos > Manutenção de Lançamentos > Período Contábil. A data atual deve estar contemplada no período definido.
5. Efetuar a liberação do período por usuário no Módulo Globais, menu Serviços Globais > Segurança > Usuários > Gestão Contábil > Anexos > Período para Manutenção de Lançamentos Contábeis.

6.3.2 Descrição do Processo

Ao efetuar o faturamento da medição do contrato, são criados lançamentos contábeis referentes à apropriação do contrato. Além desses, ao faturar os movimentos de medição do contrato, são gerados lançamentos referentes à contabilização das competências do contrato (processo precisa ser feito mensalmente). Todos os lançamentos contábeis gerados são exportados para o Protheus, no momento em que são criados no RM.
A integração será realizada de forma automática, no sentido TOTVS RM  Protheus no momento que o movimento for salvo (faturamento da medição do contrato ou movimento de geração da contabilização). Ao ser executada, a rotina customizada acionará a exportação que irá recuperar os registros de Lançamentos Contábeis que foram incluídos no TOTVS RM e acionará a função CTBA102 para enviar os dados para o barramento IIF de onde serão lidos pelo Protheus. O retorno será salvo em tabela customizada de log. Caso ocorra erro na integração, o usuário poderá reenviar o registro através da interface de log.
Os lançamentos contábeis da apropriação do Contrato são gerados no momento em que a medição do Contrato for Faturada (geração do movimento 2.1.01 – conforme descrito no detalhamento do Requisito anterior). Os lançamentos contábeis da competência serão gerados através da criação do movimento de contabilização do contrato (faturamento do movimento 2.1.01 para o 2.2.01). Para isso, é necessário seguir os passos abaixo:
Criar o Movimento para Contabilização da Competência do Contrato (2.2.01):

• Para contabilização da Competência, é necessário entrar no módulo BackOffice – Gestão de Estoque Compras e Faturamento, menu Vendas | Faturamento | Movimentação:

• Informe o tipo de movimento 2.1.01 e a Filial informada no Contrato. Será exibida lista dos movimentos gerados a partir das Medições de contratos.

...

• Todos os sublotes precisam fechar débito e crédito, ou seja, cada lançamento contábil tem partidas de débito e crédito que devem ser iguais entre si em termos de valores.
• Todos os campos do tipo texto serão tratados antes de serem enviados ao Protheus. Serão retirados os caracteres especiais e todo tipo de acentuação. Além disso, o texto será enviado em caixa alta.
• As validações de Item Contábil x Modalidade e Item Contábil x Centro de Custo descritas nos Req. 06 e Req. 08 do documento Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1, devem ser realizadas também antes da geração dos Lançamentos Contábeis no RM. Caso haja inconsistência, um erro será gerado no log do processo.

Âncora
_Toc500863192 _Toc500863192

6.4. Novo requisito – Req.04[ – Exportação de Cancelamento de Lançamento Financeiro (TOTVS RM  Protheus)|_Toc489351592]

Este requisito detalha a exportação de cancelamento de títulos financeiros originados por Contratos Corporativos a ser realizada entre TOTVS RM e Protheus. Esse processo é automático e não precisa ser agendado.

6.4.1 Pré-Requisitos / Parametrizações

1- Configurar o código do Tipo de Baixa que será exportado para o Protheus no TOTVS Educacional, menu Customização | Parâmetros | Código do Tipo da Baixa – Cancelamento. Esse valor será utilizado no envio do cancelamento (baixa) para o Protheus.

6.4.2 Descrição do Processo

A customização acionará a função FINA070 (pacote IIFR_CLIENTE_PCK) quando um Lançamento for cancelado no sentido TOTVS RM  Protheus. Neste momento a integração enviará um registro de Baixa por Cancelamento para o Barramento IIF de onde serão lidos pelo Protheus.
Ao cancelar um movimento de faturamento de medição de Contrato Corporativo - 2.1.01 (caminho: TOTVS Gestão de Estoque, Compras e Faturamento, menu Vendas | Faturamento | Movimento 2.1.01 | Selecionar o movimento e clicar em Processos | Cancelar ou Excluir), os lançamentos financeiros serão cancelados no RM e com isso, a customização será acionada.
O cancelamento do Lançamento será concretizado no TOTVS independente do retorno recebido pelo Protheus. Caso ocorra erro na integração, o usuário poderá efetuar o reenvio do registro através da interface de log.

• Se for identificado que um Lançamento cancelado no RM já foi baixado no Protheus, ficará a cargo do usuário resolver a situação manualmente.

Âncora
_Toc500863193 _Toc500863193

6.5. Alteração – Int. Parte 1 – Req. 03 – Processo Automático de Importação de Cadastros Básicos (Protheus => SGE) - Natureza

Este requisito detalha a alteração no Requisito de Importação de Cadastros Básicos (Req.03) que consta no documento "Especificação Anexo I - Detalhamento Funcional - FS007779 - Parte 1", no que diz respeito a importação da Natureza Financeira.

6.5.1 Pré-Requisitos / Parametrizações

Não se aplica.

6.5.2 Descrição do Processo

Ao efetuar a importação do cadastro de Natureza Financeira do Protheus para o RM, o campo ED_CALCINS disponível na visão de Naturezas IIFR_SED010_VW será copiado para o RM. Quando preenchido com 'S', o campo 'Campo Livre' do cadastro da Natureza (TTBORCAMENTO.CAMPOLIVRE) será preenchido com o valor 'RETEMINSS'. Quando o campo estiver preenchido com 'N' ou vazio, o campo 'Campo Livre' ficará vazio.

Essa informação é utilizada para que o SGE identifique quando o imposto INSS precisará ser calculado no Contrato Corporativo. Quando a Natureza com essa configuração estiver associada ao Serviço (Anexo de Dados Financeiros – Item do Contrato Corporativo), o imposto será calculado. A Natureza do Contrato não será utilizada para este cálculo.
O percentual de alíquota do imposto não será importado, já que no TOTVS RM não existe um campo na Natureza para armazenar a informação. A alíquota será parametrizada no TOTVS RM, no Tipo de Movimento gerado a partir do faturamento/medição do contrato.

Âncora
_Toc500863194 _Toc500863194

7. Histórico de Atualização do Documento

Âncora
_Toc500863195 _Toc500863195

7.1. Histórico de Versões

Âncora
_Toc500863196 _Toc500863196

7.2. Aprovação