Histórico da Página

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

PÁGINA CLONADA DA TECHFIN, EM DESENVOLVIMENTO....

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.

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.

Image Added

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:

Binário a partir da versão xxxxx
DbAccess a partir da versão xxxxxTodos 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.33
Lib a partir da versão xxxx2310

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.

...

MV_PRJOVER - Informar conteúdo true = .T. 

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

...

04. SCHEDULE

Após execução do Wizard, o job FWTECHFINJOB de integração com a Carol será cadastrados 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 da execução do schedule de ambos os jobs e iniciar o serviço.

Schedule - Como agendar a execução de rotinas

Integração Gesplan - Movimento Bancário enviado do Gesplan para o Protheus

Schedule - Como agendar a execução de rotinas Card documentosInformacaoÉ importante que a Recorrência do job seja 'Sempre ativo', para que não haja delay no envio dos dados para a Carol.TituloObservação

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.

...

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

...

...

...

06. DEMAIS CONFIGURAÇÕES

a) Entidades contábeis 

Serão utilizadas as entidades indicadas na 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:

Image RemovedImage Added

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_MOEDA5Cadastro de moeda (é a do CTB).https://tdn.totvs.com/display/public/framework/TechFin+Debug

c) Campos customizados - Flex Fields

Documentas a questão dos campos flexiveis, no financeiro estarão limitas à Cliente/Fornecedor, Natureza e Títulos (pagar e Receber)

Referências

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

Image Added

Referências

• Schedule - Como agendar a execução de rotinas
• Implementação - Campo de controle adicional no DBAccess - S_T_A_M_P_
• Campos UUID no DBAccessLorem Ipsum