Painel

borderStyle	none
title	PROTHEUS INSIGHTS

Dica

title	Central Colaborativa

Deseja sugerir alguma melhoria para soluções mobile do Backoffice Protheus? Acesse a Central Colaborativa da TOTVS.

Vá em Totvs Backoffice > Linha Protheus > Aplicativos Móveis > [ Escolha o app ]

Quer dar alguma sugestão para o Protheus Insights? Acesse aqui para publicar sua ideia.

Deck of Cards

effectDuration	0.5
id	cabecalho
effectType	slide

Card

default	true
effectDuration	0.5
id	protheus-insights
label	Protheus Insights
title	Protheus Insights
effectType	slide

Deck of Cards

effectDuration	0.5
id	tudo-sobre
effectType	slide

Card

effectDuration	0.5
id	Sobre
label	Sobre
title	Sobre
effectType	slide

Escopo

Introdução

Comece sua documentação com uma breve introdução ao Protheus Insights. Explique o que é o produto, sua finalidade e os benefícios que ele oferece aos usuários. Destaque como a IA está sendo utilizada para melhorar a tomada de decisões relacionadas a compras e estoque.

Visão Geral:
Forneça uma visão geral das principais funcionalidades do Protheus Insights. Explique como a integração funciona e como a IA é aplicada para gerar insights valiosos. Destaque a importância de dados precisos e como a acurácia é alcançada.

Compras
Dedique uma seção a cada um dos módulos iniciais: Compras e Estoque. Para cada módulo, explique:

Objetivo: Descreva o propósito do módulo, como ele ajuda os usuários a tomar decisões melhores.

Funcionalidades Chave: Liste as funcionalidades específicas disponíveis em cada módulo. Por exemplo, análise preditiva de demanda, otimização de estoque, identificação de padrões de compra etc.

Integração com IA: Explique como a IA é utilizada em cada módulo para fornecer insights. Destaque os algoritmos ou técnicas de IA que são empregados.

Apresentação de Dados: Mencione como os insights são apresentados aos usuários. Isso pode incluir gráficos, tabelas, dashboards etc.

Guia Passo a Passo:
Crie um guia detalhado sobre como os usuários podem começar a usar o Protheus Insights. Inclua instruções claras e passo a passo sobre como configurar a integração com o ERP Protheus, como fornecer os dados necessários, como interpretar os insights gerados e como utilizar os recursos de visualização de dados.

Exemplos de Uso:
Apresente casos de uso práticos para cada módulo. Mostre exemplos de como os insights gerados pela IA podem impactar positivamente as decisões de compra e gestão de estoque. Use cenários reais para ilustrar os benefícios tangíveis do Protheus Insights.

Perguntas Frequentes (FAQ):
Compile uma lista de perguntas frequentes que os usuários podem ter ao usar o Protheus Insights. Isso pode incluir questões sobre segurança dos dados, requisitos técnicos, suporte disponível, entre outros.

Glossário:
Inclua um glossário com os termos técnicos e específicos do produto, para que os usuários possam entender os conceitos abordados na documentação.

Contato e Suporte:
Forneça informações de contato para suporte técnico ou dúvidas relacionadas ao produto. Isso pode incluir e-mails, números de telefone ou links para a equipe de suporte da TOTVS.

Atualizações Futuras:
Finalize a documentação mencionando que o produto está em constante evolução e que atualizações futuras podem trazer novas funcionalidades e melhorias. Incentive os usuários a ficarem atentos a essas atualizações.

Lembre-se de manter a documentação clara, organizada e facilmente navegável. Utilize formatação adequada, como títulos, subtítulos, listas e formatação de código, quando necessário. Ilustre com imagens ou diagramas sempre que possível para melhorar a compreensão visual.

O Protheus Insights é um aplicativo da companhia TOTVS que possui integração com o ambiente do ERP PROTHEUS.

O escopo do aplicativo pode ser dividido entre duas funcionalidades principais: Aprovações e eventos.

Insights Compras

O aplicativo Protheus Insights possibilita ao usuário realizar aprovações de processos ocorridos no ERP através do smartphone e abaixo estão listados os processos aderentes a este mecanismo de aprovações.

Insights Estoque

O aplicativo Protheus Insights permite a análise (Aprovação / Reprovação) de pedidos de compras de forma aderente ao processo padrão de liberação de documentos (MATA094).

Eventos

O objetivo dos eventos é permitir que o usuário possa ser informado sobre eventos e interagir com aprovações que ocorrem no seu ambiente do ERP PROTHEUS por meio de notificações recebidas pelo aplicativo.

O aplicativo possui eventos pré-definidos na sua integração com o ERP, conforme alguns exemplos abaixo:

Visualizar eventos que iniciaram, terminaram ou que tiveram algum problema ao serem processados por meio de notificações.
Filtrar visualização de eventos.
Processamento da folha de pagamento.
Término do recálculo do custo médio.
Processamento de contabilização.
Aprovação de orçamento.
Produto atingiu ponto de pedido.
Lote de produto vencido.

Entre muitos outros eventos que estão cadastrados na tabela genérica E3 - Eventos (SX5).

Para conhecer mais sobre o Protheus Insights assista ao vídeo:

Painel

borderStyle	none
title	Conheça o Meu Protheus

Column

width	500

Conector de Widget

width	500
url	https://www.youtube.com/watch?v=lQwh3MVBrbs
height	500

Card

effectDuration	0.5
id	Configuracao
label	Configuração
title	Configuração
effectType	slide

Passo a passo de configuração

O Protheus Insights é mais uma forma que os usuários têm de conseguirem utilizar o ERP Protheus. Sendo assim, são necessárias algumas configurações específicas para integrar o aplicativo com o ambiente.

A seguir, você encontrará um passo a passo detalhado para configurar o Protheus Insights em seu ERP Protheus. Certifique-se de seguir cada etapa com atenção para garantir uma configuração precisa e bem-sucedida.

Para conhecer mais sobre a configuração necessária, assista ao vídeo.

Aviso

title	Pré-Requisitos

Antes de iniciar a implantação, há uma série de pré-requisitos que devem ser checados e/ou aplicados:

Ter contratado/provisionado a plataforma Carol;
Conter o ultimo dicionário diferencial aplicado aplicado; *** INSERIR QUAL ESPECIFICO
Ter acesso ao ambiente de configuração de schedules;
Ter acesso ao APSDU ou ao gerenciador de seu banco de dados;
Ter acesso a criação e alteração de parâmetros.

Passo 1: Executar o UPDDISTR

Abra o SmartCliente e insira UPDDISTR no campo Programa Inicial, e nos demais as informações do seu ambiente.
Selecione as empresas para as quais deseja aplicar a nova feature.
Verifique cuidadosamente se todas as tabelas necessárias foram criadas corretamente.

~~Aplicamos nas empresas desejadas e analisamos novamente se as tabelas foram criadas corretamente:~~

Passo 2: Aplicar Pacotes e Acessar o Módulo Configurador

Aplique os pacotes relacionados no ambiente de modo exclusivo.
Acesse o módulo configurador do sistema.
Configurador> Schedule>Schedule
(Re)inicie os serviços que foram criados durante a configuração.

Passo 3: Configurar e Iniciar os Agentes

Adicione os agentes relacionados na guia "Agent" do módulo configurador.
Inicie os agentes também no monitor correspondente.

Com os agentes iniciados continue para o passo 4.

Passo 4: Reiniciar o Appserver e Executar o Wizard WIZSMARTBA

Reinicie o serviço do appserver.
Execute o wizard WIZSMARTBA para prosseguir com a configuração.

Dica

title	Dica

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

Passo 5: Verificar Dados e Selecionar Empresas

Na primeira tela do wizard, verifique se todos os itens necessários estão marcados.

Verifique os dados na primeira tela:

Nota
Se não estiver todos os itens checados, ele não avançará.
Selecione as empresas que serão incluídas na configuração.

Passo 6: Aceitar Contrato e Informar Credenciais

Leia atentamente o contrato apresentado.
Caso concorde com os termos, clique em "Eu Concordo".
Certifique-se de que este passo seja realizado somente em um ambiente de produção.

Nota
Esse evento deve-se ser executando exclusivamente em ambiente de produção.
Forneça o "Client Id" e "Client Secret" que foram recebidos por e-mail durante a contratação do serviço.

Passo 7: Validação das Configurações do appserver.ini

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:
  Bloco de código
  language bash
  title appserver.ini
  [Drivers] MultiProtocolPort=1 MultiProtocolPortSecure=0
- Na seção "[LICENSECLIENT]", assegure-se de que o "App_Environment" esteja direcionado para o ambiente principal, por exemplo:

Dica

title	Dica

Bloco de código

title	appserver.ini

[General]
App_Environment=Insira_o_nome_do_seu_ambiente

Aviso

title	Observações:

Se a configuração do "totvstechfin" estiver presente, o wizard fornecerá o "Client Id" e "Secret Id" dessa configuração anterior. Caso haja alterações, solicite um novo provisionamento para atualizar esses dados.
Se precisar refazer o processo de instalação, remova os registros da tabela "sys_app_param" que contenham referências à "FWCarol".
Verifique sempre a existência de outros jobs cadastrados, pois isso pode impactar a fila de processamento do sistema.
Após a instalação, monitore a tabela "sys_app_param" para garantir que os dados estejam sendo transmitidos corretamente com o prefixo "FWCarol":

Bloco de código

language	sql
title	TABELA sys_app_param

SELECT * FROM SYS_APP_PARAM WHERE APP_PARAM like '%FWCarol%'

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.

Card

effectDuration	0.5
id	insights-compras
label	Insights Compras
title	insights-compras
effectType	slide

Card

default	true
effectDuration	0.5
id	insights-compras
label	Insights Compras
title	insights-compras
effectType	slide

Insights Compras

Para realizar o seu acesso utilize:

Usuário
Senha
Alias

Nos campos Usuário e Senha, informe os mesmos dados que você utiliza quando acessa o seu ambiente no ERP Protheus via SmartClient.

No campo Alias, informe o seu identificador no Mingle ou AppLinker.

Card

effectDuration	0.5
id	insights-estoque
label	Insights Estoque
title	insights-estoque
effectType	slide

Card

effectDuration	0.5
id	insights-estoque
label	Insights Estoque
title	insights-estoque
effectType	slide

Insights Estoque

Após a instalação e adicionadas as permissões de usuários acesse o módulo de Estoque e Custos>Atualizações>Produtos.

Na tela de cadastro de produtos deverá ser exibido no botão “Outras Ações” a nova opção chamada de “Ruptura de Produtos N+” onde N é a quantidade de alertas disponíveis para análise sendo que, quando N menor que 10 será exibida a quantidade de registros, caso contrário será representado pelo acumulado “+”.

Ao clicar na rotina será aberta uma nova tela em PO-UI com as seguintes informações:

Tabela com os produtos que possuem uma previsão de ruptura do estoque;
Filtro com as opções:
- Tipo de produto;
- Grupo de Produto;

Ao clicar em um produto da lista será exibido um gráfico com as seguintes informações:

Ponto de reposição**;
Estoque de segurança**;
Ponto de ruptura;
Histórico de estoque*;
Previsão de saldo;
Intervalo de confiança;
Acurácia da projeção.

* O Histórico de Estoque será exibido quando os modelos de aprendizagem conseguirem carregar dados sobre a movimentação do produto, caso contrário ele será omitido e exibida somente a projeção da Previsão de Saldo.

** Os pontos de Reposição e Estoque de Segurança serão informados caso cadastrados na tabela de configuração de produtos nos seguintes campos:

Campo	Descrição
B1_EMAX	Estoque Máximo
B1_EMIN	Ponto de Pedido
B1_ESTFOR	Fórmula do Estoque de Segurança
B1_ESTSEG	Estoque de Segurança
B1_FORPRZ	Fórmula Cálculo do Prazo
B1_PE	Prazo de Entrega
B1_QTDINIC	Quantidade Inicial do Mês
B1_TOLER	Tolerância

Caso esses campos tenham sido preenchidos será respeitada a regra calculada pelo ERP.

Na falta dessa parametrização será utilizada a seguinte fórmula:

Estoque de segurança = Fator de serviço x Raiz(((desvio padrão Demanda)^2 * média lead time)+((desvio padrão lead time)^2 * (média Demanda)^2))

HTML

<!DOCTYPE html>
<html>
<head>
    <script type="text/javascript" async
        src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-MML-AM_CHTML">
    </script>
</head>
<body>
    A fórmula é: \(ES = z \times \sqrt{\sigma_d^2 \times t + \sigma_t^2 \times d^2}\)
</body>
</html>

Caso não seja possível calcular o lead time ou ele tenda a zero será aplicada a fórmula simplificada:

Estoque de segurança = Fator de serviço x desvio padrão Demanda x Raiz(Tempo de entrega)

HTML

<!DOCTYPE html>
<html>
<head>
    <title>Formula Example</title>
    <script type="text/javascript" async
        src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-MML-AM_CHTML">
    </script>
</head>
<body>
    A fórmula é: \(ES = z \times \sigma_d \times \sqrt{t}\)
</body>
</html>

Com o estoque de segurança calculado podemos realizar o cálculo do ponto de reposição através da fórmula:

Ponto de Reposição = (média lead time * média consumo) + Estoque de Segurança

HTML

<!DOCTYPE html>
<html>
<head>
    <title>Formula Example</title>
    <script type="text/javascript" async
        src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-MML-AM_CHTML">
    </script>
</head>
<body>
    A fórmula é: \(PR = (\mu_L \times \mu_D) + ES\)
</body>
</html>

É realizada uma nova carga diariamente atualizando os dados da projeção, caso tenha efetuado as ações necessárias para a correção da possível ruptura será executado nova predição e atualizado na próxima carga.

Card

default	true
effectDuration	0.5
id	Suporte
label	Suporte
effectType	slide

Perguntas Frequentes (FAQs)

Expandir

title	Qual o meu Usuário e Senha?

Correspondem ao mesmo usuário e senha que você utiliza para fazer acesso no Protheus via SmartClient.

Expandir

title	Existe limite de tamanho para PDF nos anexos do pedido de compra?

Existe! Porém, a limitação é para arquivos com mais de 5MB.

Expandir

title	O que é o Alias?

Um alias é um identificador único do cliente na TOTVS. Cada cliente pode ter mais de um alias e cada alias corresponde a um Protheus instalado.

O alias é a chave para que o aplicativo consiga encontrar o Protheus e assim realizar a comunicação.

Se você ainda não possui um alias, solicite o seu através da abertura de um chamado no Portal do Cliente ou acesse AQUI.

Expandir

title	Esqueci o meu Usuário e/ou Senha. O que faço?

Sua senha pode ser redefinida somente através do Protheus.

Expandir

title	Quais eventos eu visualizo?

No aplicativo são visualizados somente os eventos a que o usuário do Protheus está cadastrado na inscrição do Event Viewer.

Os eventos são enviados para o aplicativo através da notificação e também na home do aplicativo.

Expandir

title	Quais os status dos eventos?

Os status dos Eventos são:

Cinza: Informação
Amarelo: Alerta
Vermelho: Erro

Expandir

title	Como compartilho um Evento?

Na tela do Protheus Insights, selecione o evento e clique no botão compartilhar.

Expandir

title	Qual configuração é necessária para aprovar pedidos de compras no aplicativo?

Não existe nenhuma configuração específica para que os pedidos de compra possam ser analisados pelo aplicativo. Com o provisionamento do ambiente (REST e Mingle), basta que o usuário com perfil de Aprovador acesso o aplicativo.

Observando que a aprovação de pedido de compras é aderente ao processo padrão de liberação de documentos (MATA094).

Expandir

title	É possível customizar a aprovação de pedido de compras?

No aplicativo existe uma área chama "Ver mais" onde é possível inserir informações customizadas que sejam relevantes para a tomada de decisão do aprovador. É possível inserir novas informações nesta área através do Ponto de Entrada MT094CPC (https://tdn.totvs.com/x/gXAPEQ), onde os campos informados no Ponto de Entrada serão exibidos no aplicativo.

Expandir

title	Há limite no tamanho de arquivo na visualização de anexo de pedido de compra?

Não necessariamente um limite, mas arquivos com tamanho maior de 5MB podem não ser visualizados dependendo da infraestrutura em que o ambiente Protheus se encontra.

Expandir

title	Como sair do Aplicativo?

Na tela de Configurações, clicar no botão Sair.

Materiais Auxiliares

Os materiais abaixo dizem respeito ao Event Viewer do Protheus e ao TOTVS Mingle:

Configurar Event Viewer

Como adicionar uma rotina de usuário no Event Viewer

Acesso Aplicativos Móveis

Árvore de páginas

Versões comparadas

Versão antiga 28

Nova versão 29

Chave

Escopo

Passo a passo de configuração

Insights Compras

Para realizar o seu acesso utilize:

Insights Estoque

Materiais Auxiliares

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 28

Nova versão 29

Chave

Escopo

Passo a passo de configuração

Insights Compras

Para realizar o seu acesso utilize:

Insights Estoque

Materiais Auxiliares