Histórico da Página
CONTEÚDO
- Visão Geral
- Implantação
- Wizard de Configuração
- Schedule
- Log da integração
- Demais Configurações
- Entidades Contábeis
- Moedas
- 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.Após
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.
Aviso |
---|
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
...
Deck of Cards | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||
|
Referências
|
...
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.
Informações | ||
---|---|---|
| ||
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. |
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.
É 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
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:
- 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
- Schedule - Como agendar a execução de rotinas
- Implementação - Campo de controle adicional no DBAccess - S_T_A_M_P_
- Campos UUID no DBAccess
- Fluxo Provisionamento Mais Prazo: Diagrama de Sequência do Fluxo
- Documentação Protheus: Integrações TECHFIN#1485879772