Linha Microsiga Protheus

Árvore de páginas

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 versão mínima da LIB necessária para o 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, 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".

  • Estoque e Compras

    • Ter, no mínimo, 2 anos de histórico de movimentações de estoque ( SD3 ) 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].

    Etapa 1

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


    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.

    Importante

    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

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

    Evoluçõ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 UPDBATCH no campo Programa Inicial e, nos demais campos, insira as informações do seu ambiente.
      • Selecione as empresas as quais deseja aplicar a nova funcionalidade.
        • O recomendável é aplicar a atualização do dicionário em todas as empresas cadastradas.
      • Caso tenha dúvidas de como executar a atualização, verifique a documentação:  Atualizador de dicionário e base de dados - UPDDISTR e UPDBATCH - Atualização de pacotes.
      • Após o término da atualização, verifique cuidadosamente se todas as tabelas necessárias foram criadas.

        Exemplo: 

    SELECT * FROM SX2010 WHERE X2_CHAVE = 'I19'

SELECT * FROM SX3010 WHERE X3_ARQUIVO = 'I19'



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

    Etapa 2

    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


    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

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

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

    Etapa 3

    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.

    Etapa 4

    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.

    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 está utilizando as chaves (clientId e clientSecret) corretas para o Protheus Insights ao executar o WIZSMARBA.