Fábrica de Software TOTVS BH

Atalhos

Páginas filhas
  • Manual Operacional da Customização – SGE x Protheus – Parte 2

Versões comparadas

Versão antiga 5

changes.mady.by.user Ana Luiza Martins Moreira

Gravado em

comparado com

Nova versão 6

changes.mady.by.user Ana Luiza Martins Moreira

Gravado em

Chave

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

Manual Operacional da Customização – Integração RM x Protheus – Parte 2 

O objetivo dessa customização é realizar a integração entre SGE e Protheus.

...

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

...

Expandir
titleAnexo customizado de Dados Financeiros no cadastro do Processo Seletivo

Pré-requisitos


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.


Detalhamento 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. O processo não apresenta diferenças entre as Coligadas do SESI e SENAI.



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


Expandir
titleCriação de Campos Customizados no Cadastro do Contrato

Pré-requisitos


Criação da tabela dinâmica BANDEIRACC, para cada Coligada. Os itens da tabela devem 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.


Detalhamento do processo


Os campos customizados estão disponíveis no TOTVS Educacional disponível em TOTVS Educacional | Financeiro/Contábil | Contratos.



Estas informações sã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.

  • Pagamento com Cartão de Crédito: Quando marcado, o NSU e a Bandeira devem ser informados obrigatoriamente.
  • NSU: Número Sequencial Único que identifica a transação realizada com o cartão de crédito, limitado a 8 caracteres.
  • Bandeira: Campo do tipo lista que busca os itens da uma tabela dinâmica (BANDEIRACC) onde o usuário irá cadastrar manualmente os registros de Bandeiras de Cartões de Crédito (VISA, MasterCard, etc.). O campo exibe o código e a descrição da Bandeira do Cartão de Crédito.



Para utilizar o Pagamento por Cartão de Crédito, o usuário deve gerar o Contrato, preencher os campos de Pagamento por Cartão de Crédito e posteriormente executar o processo de Gerar Lançamentos. Após execução deste Processo, não será permitido modificar o valor desses campos.
Importante:
Durante o processo nativo de matrícula, o usuário possui a opção de gerar o Contrato e os Lançamentos Financeiros do Contrato automaticamente. A geração dos Lançamentos automática não deve ser utilizada para os casos de pagamento por Cartão de Crédito, pois o usuário precisa informar o NSU e a Bandeira antes de gerar os Lançamentos. Após geração do Contrato, o usuário deverá acessá-lo, informar os campos do pagamento e executar o processo Gerar Lançamentos.
Se houver um erro por parte do usuário e caso utilize esta opção (Gerar Lançamentos automaticamente no processo da Matrícula), a baixa deverá ser realizada diretamente no Protheus. Após gerar os Lançamentos Financeiros do Contrato estes campos ficarão desabilitados para edição.


Nota
titlePontos de Atenção
  • 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.
Expandir
titleExportação de Clientes (TOTVS RM x Protheus)

Pré-requisitos


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 | Ambiente | Parâmetros | TOTVS Gestão Financeira |

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

  • 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.
    • 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.


    Image Modified

    5.3.2 Descrição do Processo


    Detalhamento do processo


    Esse processo é automático e não precisa ser agendado.

    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á

    aciona a função MATA030 (pacote IIFR_CLIENTE_PCK) e neste momento

    enviará

    envia 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:


    Nota
    titlePontos 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.
    Expandir
    title Exportação de Pedido de Venda (TOTVS RM x Protheus)

    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:

    • Quando bolsas forem concedidas no decorrer do curso, depois que o Contrato já tiver sido integrado com o Protheus, o usuário deve cancelar manualmente os Lançamentos em aberto no TOTVS Gestão Financeira, adicionar a bolsa às parcelas em aberto e gerar os Lançamentos novamente, para que desta forma, eles sejam gerados com um novo Nosso Número. Não está prevista nenhuma rotina customizada para automatizar este processo.


    • Quando forem concedidas bolsas retroativas (FIES), o usuário deve cancelar os Lançamentos em aberto e tratar o montante a pagar diretamente no Protheus. Não está prevista nenhuma rotina customizada para automatizar este processo.


    PONTOS DE ATENÇÃO:

    • 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.


    ...