Linha Microsiga Protheus

Á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 de dados do Protheus para o 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.2310


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

IMPORTANTE: Caso o conteúdo do parâmetro citado acima seja inferior a 25 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.


7) Ter liberação do servidor onde o schedule do Protheus é executado para os seguintes end-points:

https://endpoint-registry.totvs.app/api/v1/services
https://admin.rac.totvs.app/totvs.rac/connect/token
https://provisioning.totvs.app/api/carol-definitions/v1/entities
https://ingestion-smartlink.totvs.app
https://app.carol.ai
https://provisioning.totvs.app/api/carol-definitions/v1/carolcredentials
https://link.totvs.app
https://api-smartlink.totvs.app


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 para o Protheus, o mesmo ocorrerá através da configuração do job FWTOTVSLINKJOB, que deverá ser incluído manualmente no schedule. Criar com os mesmos detalhes do FwTechFinJob criado automaticamente.

    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 enviado do Gesplan para o Protheus

    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 


    d) Parâmetros opcionais

    Parâmetro : Zera_Descontada 

    Uma vez configurado como True, define que os títulos do Protheus que estejam em situação de carteira descontada terão os valores previstos com o saldo zerado no ambiente Gesplan e serão considerados como realizados.

    Se configurado como False, o valor previsto dos títulos será mantido com o saldo restante do mesmo no Protheus, campo Saldo do Título (E1_SALDO).

    Quando o parâmetro não estiver configurado, o padrão é False.


    No ambiente Carol, o parâmetro é acessado pela rotina 'Settings'

    O parâmetro pode ser alterado pelo botão na coluna Value, alternando o valor entre True e False e para salvar, basta clicar em 'Save'.

    Referências