Árvore de páginas


CONTEÚDO

  1. Visão Geral
  2. Implantação
  3. Wizard de Configuração
  4. Schedule
  5. Log da integração
  6. Demais Configurações
    1. Entidades Contábeis
    2. Moedas
    3. Campos customizados - FlexFields

01. VISÃO GERAL

Esse documento apresenta os passos necessários para ativação da integração Protheus x Gesplan, através da plataforma Carol.

Ao adquirir a oferta internamente será iniciado o fluxo de provisionamento.

Finalizado o fluxo de provisionamento, o cliente recebe por e-mail as credenciais do RAC (client_id e client_secret) necessárias para executar o Wizard de configuração no Protheus.

Será necessária a atualização do ambiente seguindo a ordem descrita nos tópicos abaixo.


02. IMPLANTAÇÃO

Para iniciar a implementação da integração será necessário:

1) Verificar os requisitos mínimos:

Todos os artefatos (DbAccess, APPServer e Lib ) deverão estar atualizados com a última versão disponível no portal.

Release Protheus a partir da 12.1.2210


2) Aplicar a última expedição continua do Protheus, juntamente com o diferencial de dicionário através do UPDDISTR, de acordo com a sua versão da Release.


3) Ativar parâmetros no configurador:

MV_FINTGES - Informar conteúdo true = .T. 

MV_PRJOVER - Informar conteúdo true = .T. 

Somente ative o parâmetro MV_FINTGES na implantação da integração. O uso do parâmetro ativado sem a execução do Wizard de configuração, poderá causar falhar nos processos do sistema.


4) Verificar o conteúdo do parâmetro MV_FINFIX. Para que a integração esteja preparada e apta para ser executada, o conteúdo deve ser no mínimo 21. 

IMPORTANTE: Caso o conteúdo do parâmetro citado acima seja inferior a 21 o mesmo NÃO deve ser alterado manualmente. Neste caso a orientação é abertura de um ticket no atendimento, anexando os arquivos error.log e console.log para análise.


5) Para melhor visualizar os motivos de não efetivação de lançamentos contábeis, utilizar o parâmetro MV_CT105MS com conteúdo igual a "S" .


6) Executar o wizard de acordo com os passos listados no próximo tópico.

03. WIZARD DE CONFIGURAÇÃO

    Para iniciar o Wizard de configuração, o usuário deverá informar o programa inicial: WIZARDTF1

    Clicar em Avançar

    Informar um usuário com poder de administrador e marcar as empresas que serão configuradas. Clicar em Avançar.

    Selecionar o produto Gesplan

    Confirmar usuário e senha para execução do UPDDISTR. 

    Serão criados os campos EV_MSUID e EZ_MSUID do tipo uniqueidentifier.

    Informar credenciais do RAC recebidos por e-mail

    Nesse último passo serão criados os campos de controle de alteração (S_T_A_M_P_) em todas as tabelas de integração.



    04. SCHEDULE

    Após execução do Wizard, o job FWTECHFINJOB de integração com a Carol será cadastrado automaticamente no Protheus.

    Se a integração possuir envio de dados por parte da Gesplan, o mesmo ocorrerá através do job FWTOTVSLINKJOB, que deverá ser incluído manualmente no schedule.

    Será necessário finalizar as configurações do schedule de ambos os jobs e iniciar o serviço.

    Recorrência de execução

    Para que não haja delay no envio dos dados para a Carol  a Recorrência do job poderá ser cadastrada como 'Sempre ativo'; entretanto, não há uma regra quanto ao cadastro da recorrência da execução, a decisão quanto a isso depende da necessidade de disponibilidade desses dados, a partir do momento de geração deles. 
    Quanto maior a recorrência e empresas/filiais listadas para execução, maior a necessidade de recursos para processamento dos jobs.

    Inserir a configuração somente no ambiente que estiver em produção.

    Bases de testes que estejam configuradas com o Smartlink interceptarão mensagens enviadas pela Gesplan da mesma forma que a base de produção, fazendo com que os dados sejam gravados na base de testes atualizando o status para a Gesplan como integrado. 

    Integração Gesplan - Movimento Bancário

    Schedule - Como agendar a execução de rotinas

    05. LOG DA INTEGRAÇÃO

    Com o schedule em execução, o job FWTECHFINJOB passa a enviar os registros para as staging tables da Carol. Toda alteração efetuada em qualquer registro no ERP automaticamente atualiza o timestamp, no campo S_T_A_M_P_, dessa forma o job reenvia o registro completo para atualizar a staging table.

    É possível ativar os logs do job, para avaliação do que esta sendo executado e enviado, para isso basta seguir os procedimentos descritos no link abaixo.

    https://tdn.totvs.com/display/public/framework/TechFin+Debug

    É recomendado ativar o log somente quando for necessária alguma avaliação, pois manter o log ligado poderá onerar a performance, além de criar muitos arquivos no rootpath do ambiente.


    06. DEMAIS CONFIGURAÇÕES

    a) Entidades contábeis 

    Serão utilizadas as entidades indicadas no cadastro da Natureza do título a Pagar/Receber, nos campos a seguir:

    • ED_DEBITO - Conta contábil para careira Pagar
    • ED_CREDITO - Conta contábil para careira Receber
    • ED_CCD - Centro de custo para carteira Pagar
    • ED_CCC - Centro de custo para carteira Receber

    Acessar Configurador / Base de Dados e marcar campos como Usado:

    b) Moedas

    A descrição da moeda do título e dos movimentos tem como origem o conteúdo do SX6, cadastro de Parâmetros do Configurador. 

    Irá utilizar o conteúdo do parâmetro MV_MOEDA?.

    Onde "?" (interrogação) representa o código da moeda.

    Ex.:

    Título da moeda 1 = conteúdo informado no parâmetro MV_MOEDA1

    Título da moeda 5 = conteúdo informado no parâmetro MV_MOEDA5


    c) Campos customizados - Flex Fields

    Documentação sobre campos customizados: Integração Gesplan - Dados enviados e Pipelines 

    Referências