Árvore de páginas

Versões comparadas

Chave

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


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 x para o Gesplan, através da plataforma Carol.

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

...

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:

...

Release Protheus a partir da 12.1.22102310


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.

...

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 2125

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

...

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

Deck of Cards
historyfalse
idteste
Card
labelPasso 1

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

Card
labelPasso 2

Clicar em Avançar

Card
labelPasso 3

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

Card
labelPasso 4

Selecionar o produto Gesplan

Card
labelPasso 5

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

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

Card
labelPasso 6

Informar credenciais do RAC recebidos por e-mail

Card
labelPasso 7

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.

...

Aviso

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.

...

Aviso

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

...

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. 

...

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 Zera_Descontada(zera_descontada): Define-se que os títulos do Protheus que esteja estejam em situação de carteira descontada terão os valores previstos com o saldo zerado no Previsto e será considerado como realizado.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 true = Zera o Saldo, false = compõe o saldo restante em Saldo do Título (E1_SALDO).

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


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

O parâmetro pode ser alterado pelo botão na coluna Value, alternando o valor entre true e false(quando não configurado pelo usuário, o padrão será false), True e False e para salvar, basta clicar em 'Save'.

Referências