Árvore de páginas

Versões comparadas

Chave

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

Checklist de

...

pré-requisitos para

...

utilizar o Protheus Insights

Para garantir uma experiência ótima e obter previsões precisas, verifique se você atende aos seguintes pré-requisitos:

  • LIB ATUALIZADA:

    • A data versão mínima da LIB necessária para a LIB é 08/04/2024o funcionamento é 20250407. Recomenda-se sempre utilizar a versão mais recente disponível no portal de downloads.
  • Pacote Smartlink:

    • A versão mínima do pacote do Smartlink necessária para o funcionamento é 2.6.0. Recomenda-se sempre utilizar a versão mais recente disponível no portal de downloads.
  • Financeiro:
    • Novo Gestor Financeiro configurado conforme as orientações da documentação  (FINA710).
    • Possuir, no mínimo, 11 semanas ou 11 meses de transações na tabela FK5, categorizadas por tipo de movimentação (FK5_RECPAG)2 anos de movimentação e 11 meses de movimentação consecutivas nas tabelas FK1 e FK2. Além disso, as tabelas SE1 e SE2 devem conter os campos E1_FLUXO e E2_FLUXO, ambos com o valor "S".
  • Conciliador Backoffice configurado conforme as orientações da documentação CTBA940
  • Execução da opção 4 do WizardUUID para preenchimento dos campos MDUIDT
  • Estoque e Compras

    • Ter, no mínimo, 2 anos de histórico de movimentações de estoque ( SD3 ) .
  • Contabilidade
    • e notas fiscais ( SD1 e SD2 ).

Certifique-se de que todos os itens acima estão atendidos para utilizar o Protheus Insights de maneira eficiente. Para qualquer dúvida ou assistência, entre em contato conosco em [email protected].

Deck of Cards
startHiddenfalse
idstep-config
Card
defaulttrue
effectDuration0.5
idetapa1
labelEtapa 1
effectTypeslide

Etapa 1

Informações
iconfalse

1.1 Solicitar clientId e clientSecret

1.2 Verificar regras de firewall

1.3 Aplicar pacotes

Pacote Protheus Insights

Smartlink

1.4 Executar o "UPDDISTR " ou "UPDBATCH" do pacoteDiferencial BA acumulado do arquivo de dicionário contido no pacote Protheus Insights  (em modo exclusivo)

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 Verificar as Regras de Firewall:

Verifique e ajuste suas configurações de firewall conforme necessário para garantir a conectividade adequada com os serviços mencionados abaixo, caso haja alguma regra de bloqueio de firewall, por favor, liberar os seguintes endereços:

https://app.carol.ai
https://provisioning.totvs.app
https://link.totvs.app
https://api-smartlink
https://admin.rac.totvs.app
https://provisioning.totvs.app
https://api-maisprazo.totvs.app
https://totvstechfin.carol.ai/api

1.3 Aplicar Pacotes

É 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 envie email para [email protected]

  •  Pacotes de Correção:

Correção Financeiro:

1057108

Atualizações:

    12.1.2310: 
  •  Pacote LIB:

    • Utilizar a versão mais atualizada disponível no portal do cliente
      • BIN Harpia:
  • Pacote diferencial BA acumulado:

  • 1152428

1.4 Executar o "UPDDISTR" ou "UPDBATCH"

Aplique os pacotes relacionados no ambiente de modo exclusivo:


Nota

Lembre-se sempre de realizar um backup completo do ambiente antes de realizar atualizações no repositório e\ou base de dados, para garantir a segurança do ambiente e a possibilidade de restauração em caso de necessidade.

Dica
titleImportante

Para garantir o correto funcionamento, é fundamental que os pacotes de expedição contínua dos módulos que utilizam o Protheus Insights estejam atualizados. Esses módulos incluem:  Compras, Estoque e Financeiro e estão disponíveis no pacote de expedição contínua do Backoffice.

Pacote de Atualização - Backoffice - 12.1.2310

Pacote de Atualização - Backoffice - 12.1.2410

Nota
titleAmbientes com múltiplos RPOs

Caso o ambiente do cliente possua vários appservers configurados, é necessário aplicar os pacotes em todos os repositórios, incluindo o repositório do scheduler.

Dica
titleEvoluções do Protheus Insights

O produto Protheus Insights está em constante evolução e para manter a compatibilidade entre o dicionário de dados e o repositório é imprescindível realizar a atualização do dicionário sempre que o pacote do Protheus Insights é aplicado.


1.4 Executar o UPDDISTR ou UPDBATCH


  • Dicionário do pacote Protheus Insights.

    • Abra o SmartClient e insira
"
    • UPDDISTR
" ou "
    •  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.
      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
          • O recomendável é aplicar a atualização do dicionário em todas as empresas cadastradas.
        • Caso tenha
      duvidas
        • dúvidas de como executar
      o verificar pacotes  concluído
        • o término da atualização, verifique cuidadosamente se todas as tabelas necessárias foram criadas.

          Exemplo: 

      Bloco de código
      languagesql
      SELECT * FROM SX2010 WHERE X2_CHAVE = 'I14I19'
      
      SELECT * FROM SX3010 WHERE X3_ARQUIVO = 'I14I19'


      Image RemovedImage Added


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

    Card
    effectDuration0.5
    idetapa2
    labelEtapa 2
    effectTypeslide

    Etapa 2

    Informações
    iconfalse

    2.1 Confirmar ativação do PO-UI para uso da nova interface

    2.2 Executar o WIZSMARTBA

    Verificar o schedule FWTECHFINJOB

    Incluir o schedule manualmente FWTOTVSLINKJOB


    Nota

    A partir da lib de Janeiro/2025 os jobs FWTECHFINJOB e FWTOTVSLINKJOB não são/devem ser criados no Schedule.
    Assim que as credenciais forem cadastradas no Protheus via Wizard, os jobs serão iniciados nativamente. Com isso, não haverá o cadastro destes jobs na tabela XX1 - Agendamentos do Schedule.

    A documentação deste item está disponível em https://tdn.totvs.com/pages/releaseview.action?pageId=905609875

    Nota
    titleClientes com ambiente no Cloud da TOTVS

    Quando o cliente possui o ambiente no Cloud da TOTVS a rotina WIZSMARTBA deve ser executada no Tipo de Comunicação WF.


    2.3 Verificar registro de permissão na tabela I14  

    2.1 Confirmar ativação do PO-UI para uso da nova interface

    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

    2.2 Executar o WIZSMARTBA



    Verificar o schedule FWTECHFINJOB

    Após a execução do wizard, ao acessar o schedule no configurador em agendamentos, o job FWTECHFINJOB estará criado automaticamente e habilitado, com a recorrência sempre ativa.

     Incluir o schedule manualmente FWTOTVSLINKJOB

    Após confirmar que o FWTECHFINJOB foi criado automaticamente após a execução do wizard WIZSMARTBA, configure o FWTOTVSLINKJOB clicando no botão "Novo" e inserindo manualmente as configurações necessárias.

    O campo "Dia e hora da primeira execução" será por padrão o horário atual, mas é possível definir um dia e horário específico para a primeira execução.

    Selecione a(s) empresa(s) e filiais de acordo com sua preferência e preencha os demais campos conforme o exemplo da imagem.

    O horário da primeira execução será conforme o que foi definido no agendamento. Após isso, ele permanecerá como sempre ativo, conforme selecionado no agendamento.

    2.4 Verificar registro de permissão na tabela I14  

    Ao realizar a consulta na tabela I14, ela deve apresentar um registro de permissão. Para identificar o campo I14_MODULO igual a 'ALL', o registro deve conter a data atual. Esta permissão é renovada semanalmente de forma automática, atualizando o campo I14_DTRESP.

    Caso ocorra a indicação de que a tabela não existe, possivelmente devido à permissão não ter sido recebida e com isso a tabela ainda não foi criada, verifique se a tabela I14 está presente nas tabelas SX2 e SX3, conforme orientado na etapa 1.4. Se estiver presente, envie um e-mail para [email protected] informando a empresa e o código Totvs que fez a configuração, mas ainda não recebeu a permissão.

    Bloco de código
    languagesql
    titleExemplo
    SELECT * FROM I14010 WHERE I14_MODULO= 'ALL'
    
    





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

    Card
    effectDuration0.5
    idetapa3
    labelEtapa 3
    effectTypeslide

    Etapa 3

    Informações
    iconfalse

    3.1 Habilitar Parametro MV_INSIGHT

    3.2 Adicionar no menu do Estoque e custos o Armazém IA (ARMZIA) 

    3.3 Cadastrar Armazéns no Armazém IA

    3.1 Habilitar Parametro MV_INSIGHT

    3.2 Adicionar no menu do Estoque e custos o Armazém IA (ARMZIA) 

    3.3 Cadastrar Armazéns no Armazém IA

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

    Este cadastro é 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 filtrar quais insights serão gerados. Observa-se que por padrão, os armazéns 01 e 03 já estão cadastrados, podendo ser alterados ou excluídos se não forem utilizados. É necessário cadastrar os armazéns de demanda e produção.

    Atualização: Os registros incluídos pela rotina serão gravados na tabela 4B. Os dados já incluídos na antiga tabela 2B serão migrados automaticamente para a nova tabela.

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

    Card
    effectDuration0.5
    idetapa4
    labelEtapa 4
    effectTypeslide

    Etapa 4

    Informações
    iconfalse

    4.1 Entendendo a execução do modelo de IA

    4.2  Como testar a comunicação Smartlink

    4.1 Entendendo a Execução do modelo de IA

    Aguardando a Execução do Modelo de IA

    Após a conclusão das etapas anteriores, o usuário deve aguardar a próxima execução do modelo de IA, que ocorre semanalmente aos domingos. Durante essa execução, os dados coletados diariamente através do job schedule FWTECHFINJOB são processados e analisados para gerar insights.

    Recebendo os Insights

    Os insights gerados são disponibilizados na segunda-feira de manhã, após a primeira execução do modelo de IA no domingo. Esse processo é realizado através do job schedule FWTOTVSLINKJOB, que habilita outros jobs responsáveis por enviar os insights para o Protheus.

    Importante:

    Os insights podem ser recebidos diariamente, sendo gerados conforme regras específicas para cada tipo.
    É crucial manter os jobs ativos para continuar recebendo atualizações de insights.
    A geração de insights ocorre diariamente, seguindo regras específicas para cada tipo de insight.
    A execução semanal do modelo de IA incorpora aprendizados contínuos, melhorando sua precisão ao longo do tempo.

    Acesse o configurador dentro da pasta Smartlink e clique na opção Parametros de Conexão, caso nao esteja disponível consulte a documentação Comunicação SmartLink para configurar o FwSgdpParm.

    Clique no botão Testar conexão para verificar se esta funcionado a comunicação.



    Atenção, estas informações são sensíveis e caso voce delete e clique em confirmar será necessário executar o wizard novamente.


    Dica
    iconfalse

    Importante:

    As chaves clientId e clientSecret são exclusivas e não devem ser compartilhadas entre ambientes.

    Outros produtos como "techfin", "gesplan", podem usar esses campos credenciais parecidas, então garanta que esta está utilizando as chaves (clientId e clientSecret) corretas para o Protheus Insights ao executar o WIZSMARBA.

    ...