Etapa 1

1.1 Solicitar clientID e clientSecret

Para garantir o acesso e a integração com a plataforma Carol, é necessário solicitar as credenciais de clientID e clientSecret. Para isso, envie um e-mail para [email protected] com essas informações da empresa na qual deseja implantar o Protheus Insights:

• Razão Social: [Inserir a razão social da sua empresa aqui]
• CNPJ: [Inserir o número do CNPJ da sua empresa aqui]
• Código TOTVS: [Inserir o Código TOTVS da sua empresa aqui]
• LIB: [Inserir a versão da LIB que esta utilizando]

Em até 24 horas úteis, você receberá as credenciais por email.

1.2 Aplicar Pacote de atualização do Protheus Insights:

É necessário atualizar o ERP Protheus com os pacotes abaixo de acordo com a release correspondente ao seu sistema e, em caso de dúvidas técnicas, enviar email para [email protected]

• Pacote Protheus Insights:

  • 12.1.2210:https://suporte.totvs.com/portal/p/10098/download?e=1149982 ;

  • 12.1.2310:https://suporte.totvs.com/portal/p/10098/download?e=1149984 ;

• Pacote Smartlink:

  • Versão: Utilizar a última disponível no portal do cliente
  • Harpia:  https://suporte.totvs.com/portal/p/10098/download?e=1057108
    
    

• Pacote diferencial BA acumulado:

  • Implementação: Utilize o UPDDISTR ou UPDBATCH para implementação.

  • 12.1.2210 - https://suporte.totvs.com/portal/p/10098/download?e=1147235

  • 12.1.2310 - https://suporte.totvs.com/portal/p/10098/download?e=1131099

Regras de Firewall:

Caso haja alguma regra de bloqueio de firewall, por favor, liberar os seguintes endereços:

• Staging Environment:

  • URL: https://totvstechfinstaging.carol.ai/api
  • RAC: https://admin.rac.staging.totvs.app
  • Provisioning: https://provisioning.staging.totvs.app
  • Fluig Staging: https://app.customerfi.com

• Production Environment:

  • URL: https://totvstechfin.carol.ai/api
  • RAC: https://admin.rac.totvs.app
  • Provisioning: https://provisioning.totvs.app
  • Fluig Prod: https://app.fluigidentity.com

Por favor, verifique e ajuste suas configurações de firewall conforme necessário para garantir a conectividade adequada com os serviços mencionados acima.

Executar o UPDDISTR ou UPDBATCH

Abra o SmartClient e insira "UPDDISTR" ou "UPDBATCH" no campo "Programa Inicial" e, nos demais campos, insira as informações do seu ambiente.

Selecione as empresas para as quais deseja aplicar a nova funcionalidade.

IMPORTANTE: Lembre-se sempre de realizar um backup completo do ambiente antes de aplicar pacotes, para garantir a segurança dos dados e a possibilidade de restauração em caso de necessidade e será necessário aplicar o Pacote diferencial BA acumulado no ambiente em modo exclusivo.

Apos executar, verifique se todas as tabelas necessárias foram criadas corretamente.

Exemplo: SELECT * FROM SX3010 WHERE X3_ARQUIVO = 'I14

Após garantir que os itens da Etapa 1 foram concluídos com sucesso, prossiga para a Etapa 2.

ETAPA 2

 2.1 Executar o Wizard WIZSMARTBA

Execute o wizard WIZSMARTBA, selecione servidor (server environment) e a conexão (connection) onde serão criado os os jobs.

Nos "parâmetros iniciais" do SmartClient, os campos "Comunicação no cliente" e "Ambiente no servidor" devem ser preenchidos com informações do seu ambiente. 

Como demonstrado no gif, aqui estão os passos do wizard:

Como demonstrado no gif, aqui estão os passos do wizard:

2.1.1 Verifique os Dados e Selecione as Empresas:

Na primeira tela do wizard, verifique se todos os itens necessários estão marcados. Se não estiverem todos os itens checados, o wizard não avançará.

2. Selecione as Empresas :

Selecione as empresas que serão incluídas na configuração e insira o usuário e senha do administrador.

3. Aceitar Contrato

Leia atentamente o contrato apresentado. Caso concorde com os termos, clique em "Eu Concordo" para avançar.

Certifique-se de que este passo seja realizado em um ambiente de produção, pois a geração dos insights é feita a partir de dados históricos.

4. Informar Credenciais:

Forneça o "Client Id" e "Client Secret". Para receber seu "Client Id" e "Client Secret", envie um e-mail solicitando para [email protected], seguindo as instruções da etapa 1 desta documentação.

5. Ativando a integração:

Conclusão

Após a conclusão do wizard, clique em "Concluir" e acesse o SIGACFG para conferir se os schedules FWTECHFINJOB foram incluídos automaticamente e cadastre o FWTOTVSLINKJOB.
É importante acessar o configurador no mesmo ambiente onde o wizard foi executado.

Acessar o configurador (SIGACFG)

Para acessar o Configurador do sistema e navegar até a opção Schedule, siga os passos abaixo:

Configurador> Schedule>Schedule

Configurar o schedule FWTOTVSLINKJOB

Acesse o Schedule, selecione "Agendamentos", clique no ícone de incluir e adicione o job FWTOTVSLINKJOB no cadastro de agendamentos. Siga as instruções abaixo:

• Acesso ao Schedule:

  • Após acessar o Configurador, navegue até a opção "Schedule" conforme instruído anteriormente.
  • Seleção de Agendamentos:
  • Dentro do Schedule, localize e selecione a opção de "Agendamentos".
  • Inclusão de Novo Agendamento:
    
    
  • Procure pelo ícone de "Incluir"  para criar um novo agendamento. Clique neste ícone para iniciar o processo de inclusão.
  • Configuração do Novo Agendamento FWTOTVSLINKJOB:

  Na tela de inclusão de novo agendamento, preencha os campos necessários conforme demonstrado no exemplo. Em seguida, clique no ícone de recorrência e siga as instruções conforme demonstrado.
  IMPORTANTE: Não se esqueça de clicar no ícone verde para salvar.
  
  

Configurar e Iniciar os Agentes

Adicione o agente relacionado na guia Agent >Cadastro 

Inicie os agentes também no monitor correspondente.

Após concluída a inicialização dos schedules  Pasta Schedule (Task Manager e Queue Manager e iniciado o agente, clique em "Sair" e continue no configurador para incluir um menu no estoque e custos.

Após concluída a inicialização dos schedules Task Manager e Queue Manager e iniciado o agente, clique em "Sair" e continue no configurador.

O próximo passo será:

Habilitar o parâmetro MV_INSIGHT

Pesquise pelo  parâmetro MV_INSIGHT e altere seu conteúdo para verdadeiro (.T.) :

Com o parâmetro alterado, clique em “salvar” para avançar para a próxima etapa, que consiste em:

Incluir um novo item no menu de estoque e custos:

Retorne ao ambiente de configurações no SIGACFG e siga os seguintes passos:

Inclua no menu do módulo de Estoque e Custos a seguinte descrição: "Armazém IA" e o programa correspondente: "ArmzIA", conforme mostrado abaixo:

Importante: Acesse pelo módulo de Estoque e Custos o novo item cadastrado em Produtos > Produto > Armazém IA.

Esta nova opção no menu é de extrema importância, pois você deverá cadastrar os armazéns que têm demanda. Com base nesse cadastro, a inteligência artificial irá considerar os campos-chave (código do armazém) para fazer o filtro de quais insights serão gerados. Observa-se que por padrão já estão cadastrados os armazéns 01 e 03, os quais podem ser alterados ou excluídos caso não sejam utilizados, e é necessário cadastrar os armazéns de demanda e produção.

Observação: os registros incluídos pela rotina eram gravados e incluídos para a tabela 4B, os dados ja incluídos para a tabela 2B serão migrados de forma automática para a nova tabela.


Para garantir que toda a configuração foi feita corretamente, você receberá uma autorização que será gravada na tabela I14.

Faça uma consulta pelo banco de dados ou pela APSDU na tabela I14 e verifique se ela possui um registro onde o campo I14_MODULO está preenchido com o conteúdo 'ALL'.

Verificar as configurações do appserver.ini para o uso do PO-UI no ambiente de produção:

Essas configurações alteram a interface do Protheus, ativando o PO-UI, e devem ser realizadas no ambiente de produção para que todos os usuários tenham acesso.

1. Acesse o arquivo "appserver.ini" e verifique as seguintes configurações:

   • Na seção "[Drivers]", confirme se as linhas "MultiProtocolPort" e "MultiProtocolPortSecure" estão configuradas como:

     [Drivers] MultiProtocolPort=1 MultiProtocolPortSecure=0

   • Na seção "[General]", assegure-se de que o "App_Environment" esteja direcionado para o ambiente principal, por exemplo:
     

     [General] App_Environment= insira_o_nome_do_seu_ambiente

Seguindo essas etapas detalhadas, você poderá configurar o Protheus Insights em seu ERP Protheus de maneira precisa e eficaz. Certifique-se de acompanhar cada passo com atenção e estar ciente das observações importantes para garantir o sucesso da configuração.

ETAPA 2

Etapa 3