Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Painel
borderStylenone
titlePROTHEUS INSIGHTS
Deck of Cards
effectDuration0.5
idcabecalhoguia
effectTypeslide
Image RemovedImage Removed

Image RemovedConfigurar 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.

 Image Removed

Image Removed

Inicie os agentes também no monitor correspondente.

Image Removed

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.) :

Image Removed
Image RemovedCom 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:

Image Removed
Image Removed
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.

Image Removed

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:

Card
effectDuration0.5
idprotheus-insights
labelProtheus Insights
titleProtheus Insights
effectTypeslide
Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
ARIMA+ é um algoritmo criado pela googlepara modelagem de séries temporais.Dentre as suas funcionalidades podemos destacar: 
  • Componentes para modelagem de tendência e sazonalidade;
  • Ajuste de efeitos de feriados;
  • Detecção e limpeza de outliers;
  • Ajuste automático de hiperparâmetros;
  • Capacidade de trabalhar com até 100.000.000 séries temporais simultaneamente.
Image Removed
**Imagem retirada da documentação oficial do google para referencia sobre o ARIMA+, Você pode consultar mais sobre ARIMA+ na própria documentação do Google:  ARIMA+
Você pode consultar mais sobre ARIMA+ na própria documentação do Google:  ARIMA+
Card
effectDuration0.5
idSobre
labelSobre
titleSobre
effectTypeslide

Introdução ao Protheus Insights

O Protheus Insights é uma solução que utiliza inteligência artificial para aprimorar seu ERP Protheus. Com a tecnologia avançada da Carol, nossa plataforma de IA, o Protheus Insights oferece análises e previsões, que permitem tomadas de decisões com confiança, impulsionando a eficiência operacional da sua empresa.

Como o Protheus Insights Funciona

Após a configuração do Protheus Insights, o ERP Protheus inicia o envio de dados à Plataforma Carol, por meio do job FWTECHFINJOB. 

Com essas informações, o modelo de IA realiza análises, identifica padrões e tendências e gera projeções confiáveis que serão devolvidas ao ERP Protheus,  por meio de um outro serviço, o FWTOTVSLINKJOB,  que utiliza o Smartlink.

No Protheus, esses insights são apresentados em forma de alertas, relatórios e gráficos, auxiliando o cliente na tomada de decisão. E esta rotina se repete todo domingo.


Image Modified


Metodologia de Algoritimos de IA

Como funciona o Protheus

Insight

Insights no Novo Gestor Financeiro (FINA710)

O Protheus Insights apresenta uma nova funcionalidade de Previsão de Fluxo de Caixa integrada ao já existente Novo Gestor Financeiro (FINA710), elevando o nível de valor agregado por meio da inteligência artificial. Essa adição não apenas enriquece as funcionalidades já disponíveis no Protheus, mas também demonstra o compromisso contínuo com a inovação, permitindo que as empresas aproveitem ao máximo as tecnologias mais avançadas para otimizar suas operações financeiras.

O processo começa com a construção das séries temporais das entradas e saídas de caixa, utilizando dados da tabela de movimentações bancárias (SE5).

Utilizando o modelo estatístico ARIMA+ ou Prophet, são identificados padrões de tendência e sazonalidade nas séries temporais, permitindo a projeção das entradas e saídas de caixa para os próximos meses. Com base nessas previsões, é conduzida uma análise para identificar saldos insuficientes ou excessivos. Caso os valores projetados estejam fora da média histórica, um alerta é enviado para o ERP.

O Protheus Insights recebe o histórico de dados e executa o modelo de IA. A partir disso, são construídas as séries temporais e são geradas previsões utilizando o ARIMA+ ou Prophet. Além disso, são enviados alertas de insights se detectar saldos incomuns, seja um saldo extra ou insuficiente.

Image Modified



Para saber mais sobre o Novo Gestor Financeiro com IA, clique aqui

Como funciona o Protheus

Insight

Insights no Cadastro de Produtos (MATA010)


O Protheus

Insight

Insights traz uma nova funcionalidade de Ruptura de

Estoque integrado ao

Produtos integrado ao já existente Cadastro de Produtos (MATA010), oferecendo otimizações significativas para o gerenciamento de estoque e demanda no ERP.

O processo inicia-se com a reconstrução do histórico de demanda, utilizando as tabelas de movimentos (SD3) e notas fiscais (SD1 e SD2) para determinar a demanda diária. Em seguida, o modelo Arima+ é empregado para identificar padrões de tendência e sazonalidade e fazer a previsão de demanda para os próximos meses. Com base nessa previsão de demanda, juntamente com os saldos em estoque e movimentos de entrada futuros, é realizada a previsão de estoque.

Caso o cliente não possua os indicadores de estoque de segurança e ponto de reposição cadastrados no ERP, são calculados utilizando o lead time e a demanda média diária. Após o cálculo desses indicadores, é verificado se, em algum momento, a previsão de estoque atinge o ponto de reposição. Se isso ocorrer, um alerta de ruptura de estoque é imediatamente enviado ao ERP.

Image Removed

, desde que seja alcançado 70% de acuracidade nos cálculos para gerar as previsões.


Image AddedPara saber mais sobre Ruptura de Produtos, clique aqui

Como funciona o Protheus

Insight

Insights na Solicitação de Compras (MATA110)


O Protheus Insights traz uma nova funcionalidade de Ruptura Demanda de Estoque Produtos integrado ao já existente Cadastro Solicitações de Produtos Compras(MATA010MATA110), oferecendo otimizações significativas para o gerenciamento de estoque e demanda no ERP.

O processo inicia-se com a reconstrução do histórico de demanda, utilizando as tabelas de movimentos (SD3) e notas fiscais (SD1 e SD2) para determinar a demanda diária. Em seguida, o modelo Arima+ é empregado para identificar padrões de tendência e sazonalidade e fazer a previsão de demanda para os próximos meses. Com base nessa previsão de demanda, juntamente com os saldos em estoque e movimentos de entrada futuros, é realizada a previsão de estoque.

Caso o cliente não possua os indicadores de estoque de segurança e ponto de reposição cadastrados no ERP, são calculados utilizando o lead time e a demanda média diária. Após o cálculo desses indicadores, é verificado se, em algum momento, a previsão de estoque atinge o ponto de reposição. Se isso ocorrer, um alerta de ruptura de estoque é imediatamente enviado ao ERP.

A seguir, o Protheus Insights gera uma Solicitação de Compras (MATA110)um alerta para os produtos com previsão de rupturademanda, disponibilizando-a no ERP, dessa forma a área de Compras da empresa ganha em eficiência operacional.

Image Removed

Como funciona o Protheus Insight no Conciliador Backoffice (CTBA940)

Essa é a metodologia que será utilizada para implementar a conciliação com o uso de Inteligência Artificial no Protheus Insights, com o objetivo de lidar com os registros "perdidos" e melhorar a precisão do processo de conciliação.
Conciliação Contábil:

Através da tabela de rastreio, é possível identificar a origem dos registros contábeis.

          Image Removed

O problema a ser resolvido é que nem todos os registros que entram na CT2 passam pela CV3 e, em alguns casos, a CV3 pode ser perdida.

        Image Removed

A solução usa a Inteligência Artificial (IA) para realizar a conciliação dos registros que foram considerados "perdidos".

Modelo de Roteamento:

Este modelo aprende a origem dos registros contábeis. É o primeiro passo para fazer o casamento (match) entre os registros.

A triagem inicial é feita ao analisar apenas os registros na CT2.
            Image Removed

Modelo de Árvores com Boosting de Gradiente (GBM):

Consiste em um comitê formado por várias pequenas árvores de decisão.

Cada nova árvore aprende com os erros das árvores anteriores.

O resultado final do comitê leva em consideração a decisão de todas as árvores.

Este modelo é rápido para treinar e suas decisões são de fácil explicação, o que facilita a compreensão do modelo.

Modelo de Matching por Regras:

Este modelo aprende regras de lançamento para cada par de registros.

Por exemplo, a regra CT2_VALOR ← D1_TOTAL - D1_VALIPI é uma das regras que podem ser aprendidas.

Cada par de registros terá suas próprias regras definidas.
Image Removed

Predição:

Neste estágio, uma regra previamente definida é aplicada a todos os registros de origem.

Por exemplo, a regra CT2_VALOR ← D1_TOTAL - D1_VALIPI é aplicada a todos os registros da origem.

O modelo então gera uma previsão de acordo com a regra aplicada.
Image Removed

Busca no Espaço de Combinações Lineares:

Este passo envolve a busca por combinações lineares entre os campos de origem para determinar o valor da CT2_VALOR.

A fórmula pode ser algo como CT2_VALOR = PESOCAMPO1 + PESOCAMPO2 + PESO*CAMPO3..., onde os pesos podem ser -1, +1 ou 0.

Os campos são extraídos da tabela de origem.

Processos:

Existem três principais processos:

a. train_rules: Este processo envolve a busca de regras para todos os clientes, filiais e grupos em todas as tabelas de origem. Cada cliente pode ter regras específicas de contabilidade.

b. train_router: Aqui, um modelo de roteamento é treinado para cada cliente. Cada cliente pode ter maneiras diferentes de preencher os campos da CT2.

c. predict: Este processo aplica o modelo de roteamento e as regras aprendidas para fazer a conciliação contábil.

Perguntas Frequentes (FAQs)  Sobre Metodologia de Algoritmos de IA e Tráfego de dados

Expandir
titleComo o Novo Gestor Financeiro lida com saldos insuficientes ou excedentes projetados?

Se os valores projetados estiverem fora da média histórica, é enviado um alerta ao ERP para que a situação seja corrigida.

Expandir
titleO que é o algoritmo ARIMA+ da Google ?
Expandir
titleComo a Inteligência Artificial Rotina Estoque - Cadastro de Produtos ajuda a evitar Rupturas de Estoque?

A rotina começa reconstruindo o histórico de demanda a partir de movimentos e notas fiscais. Em seguida, utiliza o modelo Arima+ para prever a demanda futura. Com base nessa previsão, são feitas projeções de estoque.

Expandir
title que é Machine Learning (ML) e como ele se relaciona com a Inteligência Artificial (IA)?

Machine Learning é um subcampo da Inteligência Artificial que se concentra no desenvolvimento de algoritmos capazes de aprender e fazer previsões a partir de dados. A IA, por sua vez, é um campo mais amplo que engloba diversas técnicas, incluindo o ML, para criar sistemas capazes de realizar tarefas inteligentes.

Expandir
titleComo Funciona o processo de Upstream de dados?

O processo de Upstream de dados ocorre através da utilização da tecnologia Smartlink, a qual identifica as tabelas do sistema Protheus que estão associadas ao aplicativo instalado. Por exemplo, ao considerarmos o aplicativo Protheus Insights, essa identificação é realizada mediante o uso das credenciais especificadas no Wizard do produto.

Uma vez que as tabelas relevantes são identificadas, o Wizard procede com a criação da coluna "S_T_A_M_P_" em todas as tabelas que serão submetidas ao processo de envio. Essa coluna desempenha um papel crucial no controle de registros que já foram transmitidos.

Ao término da execução do Wizard, é automaticamente gerado um Job no scheduler, denominado "FWTECHFINJOB". Este componente assume a responsabilidade de executar a tarefa de envio das tabelas para o Smartlink.

Os dados criptografados são encaminhados para a fila de atividades do Smartlink, que então os direciona para o ambiente exclusivo do cliente no sistema Carol, associado ao respectivo cliente Protheus.

Image Removed 

Expandir
titleComo funciona o processamento de Modelos de IA?

Após a conclusão do processo de Upstream de dados para o ambiente exclusivo do cliente Protheus, os dados são replicados para um ambiente Carol centralizado que unifica todas as informações do produto. Após essa replicação, realizamos a padronização e relacionamento desses dados.

Com os dados devidamente tratados e relacionados, procedemos à execução dos scripts de treinamento de modelos de Inteligência Artificial. Esses modelos geram previsões e as registram em tabelas de insights na plataforma Carol.

Image Removed

Expandir
titleComo Funciona o processo de Downstream de dados?

Dentro da plataforma TotvsApps, operamos nosso sistema de tráfego de insights.

Nossa aplicação TotvsApps é incumbida de executar consultas diárias aos dados produzidos pelos modelos de Inteligência Artificial, referentes ao período vigente. Após essa consulta, os dados correspondentes são registrados em uma base de dados interna na plataforma TotvsApps. Posteriormente a essa etapa, procedemos com a distribuição dos insights para os respectivos clientes por meio do SmartLink.

O SmartLink, equiparado a uma fila para o processo de Upstream de dados, também dispõe de uma fila para o Downstream de dados, onde cada cliente é designado a uma fila exclusiva.

Uma vez que a mensagem é enfileirada, efetuamos o consumo dessas mensagens através do cadastro do job FWTOTVSLINKJOB dentro do Protheus. Após a detecção de um novo registro proveniente do FWTOTVSLINKJOB, nossas funções internas no RPO Protheus são acionadas para a serialização dos dados e posterior gravação nas tabelas Protheus pertinentes, para posterior consumo e visualização.

(Obs: As mensagens no SmartLink são removidas da fila somente após a confirmação de consumo e gravação pelo Protheus).

Image Removed

Expandir
titleO que é TotvsApps?

A plataforma TOTVS Apps é um ecossistema projetado para acelerar os produtos cloud native da TOTVS.

É uma plataforma referência em inovação e modernização de aplicativos na TOTVS, provendo aos times de desenvolvimento economia, segurança e autonomia para otimizar seus processos e atingir seus objetivos por meio de soluções integradas, automatizadas e simplificadas na nuvem.

Objetivo:

No-ops: Produtos e serviços que não dependam de pessoas dedicadas a sua estabilização e operação;

Plug-and-play: Que a entrada de novos produtos e serviços sejam fáceis e permitam que os times de negócio foquem na velocidade de entrega de novas aplicações e funcionalidades ao mercado.

Expandir
titleO que é Carol?

Criada em 2015, a TOTVS Carol é a plataforma de dados e Inteligência Artificial da TOTVS. Desenvolvida e aprimorada constantemente por nossos cientistas de dados, desenvolvedores e demais profissionais tech, a plataforma é uma solução avançada de gestão de dados, capaz de se conectar a todas as suas fontes de dados para analisar informações e apresentar resultados altamente fiéis que apoiem profissionais na tomada de decisões.

Desta forma, a plataforma TOTVS Carol viabiliza estratégias de rastreabilidade de informações, desenvolvimento e deploy de algoritmos de machine learning, ajudando em suas previsões e também projetos de visão computacional e processamento de linguagem natural.

Expandir
titleO que é SmartLink?

O Smartlink permite o recebimento e envio das mensagens entre os ERPs da TOTVS, por meio da nuvem da TOTVS. As mensagens são consumidas em fila, de forma direta, sem precisar de camadas de serviços.

Para obter detalhes específicos sobre a instalação, configuração e uso do Protheus Insights, consulte as seção de configuração. deste guia de documentação.

Image Added


Para saber mais sobre Demanda de Produtos, clique aqui

Sobre os Critérios de projeção e acurácia

Nos tópicos anteriores, dissemos que os alertas referentes ao Novo Gestor Financeiro e ao Módulo de Compras, Produtos e Estoque com IA são enviados para o ERP Protheus, a partir de uma acuracidade superior a 50% e 70%, respectivamente. 

A acurácia é uma medida de quão próximo as previsões do modelo estão dos valores reais. Para entender isso, é útil pensar em como os modelos fazem previsões.

Exemplo: Imagine que você está tentando prever quantas pizzas serão vendidas em uma pizzaria em um determinado dia. O modelo de previsão usa dados históricos, ou seja, informações sobre quantas pizzas foram vendidas em dias anteriores. Ele analisa esses dados em busca de padrões, como tendências (se a demanda está aumentando ou diminuindo ao longo do tempo), sazonalidade (padrões que se repetem em certos períodos, como mais pizzas vendidas nos fins de semana) e ciclicidade (variações que ocorrem em ciclos regulares, mas não necessariamente ligadas a estações do ano).

Então, quando você avalia a acurácia do modelo, está basicamente verificando se as previsões que ele faz correspondem aos números reais de vendas. Se o modelo prevê que serão vendidas 90 pizzas em um dia e na realidade são vendidas 100, então ocorreu um erro de 10% em cima do valor real e dizemos que o modelo possui acurácia de 90%. Quanto mais próximo as previsões estiverem dos valores reais, maior será a acurácia do modelo.

Portanto, a acurácia de um modelo depende de quão bem ele consegue capturar os padrões de tendência, sazonalidade e ciclicidade nos dados históricos. Quanto mais precisamente ele identifica e incorpora esses padrões em suas previsões, mais precisa será sua previsão.

Como funciona o Protheus Insights no Conciliador Backoffice (CTBA940)

Essa é a metodologia que será utilizada para implementar a conciliação com o uso de Inteligência Artificial no Protheus Insights, com o objetivo de lidar com os registros "perdidos" e melhorar a precisão do processo de conciliação.

Conciliação Contábil:

Através da tabela de rastreio, é possível identificar a origem dos registros contábeis.

          Image Added

O problema a ser resolvido é que nem todos os registros que entram na CT2 passam pela CV3 e, em alguns casos, a CV3 pode ser perdida.

        Image Added

A solução usa a Inteligência Artificial (IA) para realizar a conciliação dos registros que foram considerados "perdidos".


Modelo de Roteamento:

Este modelo aprende a origem dos registros contábeis. É o primeiro passo para fazer o casamento (match) entre os registros.

A triagem inicial é feita ao analisar apenas os registros na CT2.

            Image Added

Modelo de Árvores com Boosting de Gradiente (GBM):

Consiste em um comitê formado por várias pequenas árvores de decisão.

Cada nova árvore aprende com os erros das árvores anteriores.

O resultado final do comitê leva em consideração a decisão de todas as árvores.

Este modelo é rápido para treinar e suas decisões são de fácil explicação, o que facilita a compreensão do modelo.

Modelo de Matching por Regras:

Este modelo aprende regras de lançamento para cada par de registros.

Por exemplo, a regra CT2_VALOR ← D1_TOTAL - D1_VALIPI é uma das regras que podem ser aprendidas.

Cada par de registros terá suas próprias regras definidas.

Image Added

Predição:

Neste estágio, uma regra previamente definida é aplicada a todos os registros de origem.

Por exemplo, a regra CT2_VALOR ← D1_TOTAL - D1_VALIPI é aplicada a todos os registros da origem.

O modelo então gera uma previsão de acordo com a regra aplicada.

Image Added


Busca no Espaço de Combinações Lineares:

Este passo envolve a busca por combinações lineares entre os campos de origem para determinar o valor da CT2_VALOR.

A fórmula pode ser algo como CT2_VALOR = PESOCAMPO1 + PESOCAMPO2 + PESO*CAMPO3..., onde os pesos podem ser -1, +1 ou 0.

Os campos são extraídos da tabela de origem.

Processos:

Existem três principais processos:

a. train_rules: Este processo envolve a busca de regras para todos os clientes, filiais e grupos em todas as tabelas de origem. Cada cliente pode ter regras específicas de contabilidade.

b. train_router: Aqui, um modelo de roteamento é treinado para cada cliente. Cada cliente pode ter maneiras diferentes de preencher os campos da CT2.

c. predict: Este processo aplica o modelo de roteamento e as regras aprendidas para fazer a conciliação contábil.

Para saber mais sobre Conciliador Backoffice, clique aqui

Para obter detalhes específicos sobre a instalação, configuração e uso do Protheus Insights, consulte as seção de configuração deste guia de documentação.


Card
defaulttrue
effectDuration0.5
idConfiguracao
labelConfiguração
titleConfiguração
effectTypeslide

Passo a passo de configuração

O Protheus Insights é mais uma forma que os usuários têm de conseguirem utilizar o ERP ProtheusSendo 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.

Vamos dividir os próximos passos em duas etapas principais, Etapa 1 e Etapa 2, garanta que todos os itens dessas etapas sejam atendidos.

ETAPA 1

Dica
iconfalse

1.1 Solicitar clientId e clientSecret

1.2 Aplicar pacote do Protheus Insights

1.3 Aplicar pacote do Smartlink

1.4 Aplicar pacote diferencial (UPDISTR ou UPDBATCH)

1.5 Verificar versão da LIB

1.6 Verificar regras de firewall


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]

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]

Schedule x LIB:

Dica
iconfalse

A partir da LIB 20240408 disponível no portal do cliente, ao iniciar o ambiente, automaticamente implementamos um motor de thread exclusivo para lidar com as tarefas do schedule relacionadas à Techfin/Smartlink. Essas threads são dedicadas exclusivamente a essas tarefas, independentemente do estado da tabela SCHDTSK do cliente. Isso significa que elas não competem com outros processos ou jobs agendados. Essas threads específicas só serão iniciadas e ativadas após cadastrar as rotinas no Schedule. Este mecanismo é válido tanto para o motor antigo (Schedule tradicional) quanto para o novo motor (Smart Schedule) do Schedule.

Caso a LIB seja anterior a LIB 20240408: No caso do schedule tradicional, é recomendável adotar uma prática em que criamos um appserver separado com um nome de ambiente diferente, exclusivamente para a execução dos Jobs FWTECHFINJOB e FWTOTVSLINKJOB.     Isso cria uma nova fila e evita a concorrência de Threads com os demais jobs de outro appserver schedule e outro nome de ambiente que o cliente pode já ter. No entanto, se o cliente estiver utilizando o Smart Schedule, essa configuração adicional não é necessária. A configuração pode ser feita diretamente. Com base em testes anteriores, observamos que quando o FWTECHFINJOB e o FWTOTVSLINKJOB são executados em um servidor de schedule com a mesma porta e nome de ambiente configurado junto com outros agendamentos, pode haver uma grande concorrência de execução. Dependendo de outros jobs em execução, especialmente aqueles que são sempre ativos e consomem muitos recursos de processamento, pode haver lentidão na execução ou a impressão de que o job FWTOTVSLINKJOB está travado ou não está sendo executado. Contudo nós recomendamos o uso da LIB atualizada.


Regras de Firewall:

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

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

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.

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.


Image Added


Verifique cuidadosamente se todas as tabelas necessárias foram criadas corretamente.
Exemplo: SELECT * FROM SX3010 WHERE X3_ARQUIVO = 'I14'

Image Added

Aplique os pacotes relacionados no ambiente de modo exclusivo.

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

ETAPA 2

Dica
iconfalse

2.1 Executar o WIZSMARTBA

2.2 Verificar o schedule FWTECHFINJOB

2.3 Incluir o schedule manualmente FWTOTVSLINKJOB

2.4 Habilitar Parametro MV_INSIGHT

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

2.6 Cadastrar Armazéns no Armazém IA

2.7 Verificar tabela I14 se tem o registro de permissão


 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.

Image Added

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:

Image Added


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


Image Added


2. Selecione as Empresas :

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


Image Added

3. Aceitar Contrato

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


Image Added

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.

Image Added

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.


Aviso
titleIMPORTANTE

Atenção: Uso exclusivo das chaves clientId e clientSecret.

Por favor, note que as chaves clientId e clientSecret são exclusivas e não devem ser compartilhadas. Não as utilize em mais de um ambiente ao mesmo tempo. Se necessário utilizar em um outro ambiente, desative as configurações dos jobs e execute novamente o WIZSMARTBA para uso em outro ambiente.

Outros produtos “techfin” também utilizam esses campos e pode ser que os campos clientId e clientSecret já estejam preenchidos. No entanto, deve-se sempre inserir os novos para que a configuração seja realizada corretamente. Certifique-se de inserir os clientId e clientSecret corretos para a configuração do Protheus Insights.



Image Added



5. Ativando a integração:

Image Added

Conclusão
Image Added

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

Image Added


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.


Deck of Cards
idschedule-config
Card
defaulttrue
idschedule-old-version
labelSchedule
titlePermissões

Image Added

Image Added



Dica

(Re)inicie os serviços que foram criados durante a configuração e certifique-se que eles estejam iniciados. 

Verificar se o Schedule está iniciado (Task Manager e Queue Manager)

Verificar se o agente está iniciado

Deck of Cards
idschedule-config
Card
defaulttrue
idschedule-old-version
labelSchedule
titlePermissões


Image Added


Image Added

Image Added


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.

Deck of Cards
idschedule-config
Card
defaulttrue
idschedule-old-version
labelSchedule
titlePermissões

 Image Added

Image Added


Inicie os agentes também no monitor correspondente.

Image Added


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.) :


Image Added

Image Added

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:

Image Added

Image Added

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.

Image Added

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:

      Bloco de código
      languagebash
      titleappserver.ini
      [Drivers]
      MultiProtocolPort=1
      MultiProtocolPortSecure=0
    • Na seção "[General]", assegure-se de que o "App_Environment" esteja direcionado para o ambiente principal, por exemplo:

      Bloco de código
      languagebash
      [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.


Dica

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 para geração de insights, que ocorre a cada domingo. 
  • Este modelo recebe os dados diariamente através do job schedule FWTECHFINJOB porém o modelo é executado aos Domingos e no próximo dia útil, os usuários já poderão visualizar os insights que forem gerados.

Recebendo os Insights:

  • Após a execução do modelo de IA no domingo, na segunda-feira de manhã, os insights gerados são recebidos. Isso é feito através do job schedule FWTOTVSLINKJOB. Este job é responsável por disponibilizar os insights gerados.

Enquanto os insights são aguardados, os usuários podem explorar as opções disponíveis no modo de demonstração para estoque e compras.


A partir da LIB 20240408 disponível no portal do cliente, ao iniciar o ambiente, automaticamente implementamos um motor de thread exclusivo para lidar com as tarefas do schedule relacionadas à Techfin/Smartlink. Essas threads são dedicadas exclusivamente a essas tarefas, independentemente do estado da tabela SCHDTSK do cliente. Isso significa que elas não competem com outros processos ou jobs agendados.

Essas threads específicas só serão iniciadas e ativadas após cadastrar as rotinas no Schedule.

Este mecanismo é válido tanto para o motor antigo (Schedule tradicional) quanto para o novo motor (Smart Schedule) do Schedule.

Caso a LIB seja anterior a LIB 20240408: No caso do schedule tradicional, é recomendável adotar uma prática em que criamos um appserver separado com um nome de ambiente diferente exclusivamente para a execução dos Jobs FWTECHFINJOB e FWTOTVSLINKJOB. Isso cria uma nova fila e evita a concorrência de Threads com os demais jobs de outro appserver schedule e outro nome de ambiente que o cliente pode já ter.

No entanto, se o cliente estiver utilizando o Smart Schedule, essa configuração adicional não é necessária. A configuração pode ser feita diretamente.

Com base em testes anteriores, observamos que quando o FWTECHFINJOB e o FWTOTVSLINKJOB são executados em um servidor de schedule com a mesma porta e nome de ambiente configurado junto com outros agendamentos, pode haver uma grande concorrência de execução. Dependendo de outros jobs em execução, especialmente aqueles que são sempre ativos e consomem muitos recursos de processamento, pode haver lentidão na execução ou a impressão de que o job FWTOTVSLINKJOB está travado ou não está sendo executado.
Contudo nos recomendamos o uso da LIB atualizada.Regras de Firewall:

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

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

Abra o SmartClient e insira "UPDDISTR" 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.

Image RemovedVerifique cuidadosamente se todas as tabelas necessárias foram criadas corretamente.
Exemplo: SELECT * FROM SX3010 WHERE X3_ARQUIVO = 'I14'

Image Removed

Aplique os pacotes relacionados no ambiente de modo exclusivo.
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.
Após garantir que os itens da Etapa 1 foram concluídos com sucesso, prossiga para a Etapa 2.
ETAPA 2
Card
effectDuration0.5
iddemo
labelModo Demonstração 
effectTypeslide
Card
effectDuration0.5
iddemo
labelDemonstração
effectTypeslide

Demonstração 

O Modo de Demonstração oferece aos usuários a oportunidade de visualizar e interagir com dados simulados, proporcionando uma experiência semelhante ao uso do Protheus Insights. 

No momento, ele se restringe à demonstração do Módulo de Produtos e a ruptura de produtos, mas pretendemos liberar versões demonstrativas para o “Novo Gestor Financeiro com IA” e “Conciliador Backoffice com IA”. Aguardem! 

No Modo de Demonstração, todas as funcionalidades de filtro e interação disponíveis no Protheus Insights - Módulo Produtos estão acessíveis. No entanto, vale ressaltar que essas interações não geram requisições de dados reais.

Para utilizar o Protheus Insights com seus próprios dados e obter insights personalizados, siga o passo a passo de configuração disponível nas configurações.

Uma vez que o Protheus Insights esteja configurado e você tenha insights, o Modo de Demonstração não será mais exibido, dando lugar aos insights baseados em seus próprios dados. 

Como acessar a demonstração:

Para acessar a demonstração, siga os passos abaixo:

Acessar o Compras (02 SIGACOM)

  • Navegue até Atualizações > Solicitações > Solicitações de Compras > Outras Ações > Demanda de Produtos. Se você não possuir dados para os insights, será apresentado um botão para acessar o modo de demonstração. Clique para prosseguir.

  • Ao clicar em “Carregar Dados de Simulação”, você poderá visualizar dados fictícios. Além disso, no topo da tela, onde o título da página é exibido, você verá a indicação “Modo Demonstração’'. Abaixo dos filtros, há um botão “Sair dos Dados de Demonstração” para retornar ao ambiente real.


            Image Added


Acessar o Estoque e Custos ( 04 SIGAEST)

  • Navegue até Atualizações > Cadastro > Produto > Produtos > Outras Ações > Ruptura de Produtos. Se você não possuir dados para os insights, será apresentado um botão para acessar o modo de demonstração. Clique para prosseguir.

Image Added


Dica
iconfalse

Observações sobre a demonstração

  • A demonstração atualmente abrange as demandas de produtos e a ruptura de produtos. Isso significa que os usuários, mesmo que não tenham o Protheus Insights, podem experimentar as funcionalidades relacionadas ao Protheus Insights de forma ativa, pois os dados são simulados. Os usuários podem clicar e visualizar detalhes dos insights, simulando os insights gerados pelo Protheus Insights

Card
defaulttrue
effectDuration0.5
idConfiguracao
labelConfiguração
titleConfiguração
effectTypeslide

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.
Vamos dividir os próximos passos em duas etapas principais, Etapa 1 e Etapa 2, garanta que todos os itens dessas etapas sejam atendidos.
ETAPA 1
Dica
iconfalse
  •  Solicitar clientId e clientSecret
  •  Aplicar pacote do Protheus Insights
  •  Aplicar pacote do Smartlink
  •  Aplicar pacote diferencial (UPDISTR ou UPDBATCH)
  •  Verificar versão da LIB
  •  Verificar regras de firewall

Solicitar o provisionamento na plataforma Carol:

Para garantir o acesso e a integração com a plataforma Carol, é necessário realizar o provisionamento. Por favor, envie um e-mail para [email protected] com as seguintes informações:

  • 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]

Após o processo de provisionamento ser concluído com sucesso, você receberá o clientID e clientSecret, que serão essenciais para a configuração da integração com a plataforma.

Pacotes e Downloads:

Pacote Protheus Insights:

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

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

    Pacote Smartlink:

  • Versão: 2.5.2
  • 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.
  • https://suporte.totvs.com/portal/p/10098/download?e=1131099

    Schedule x LIB:

    Dica
    iconfalse
    Dica
    iconfalse
    •  Executar o WIZSMARTBA
    •  Verificar o schedule FWTECHFINJOB
    •  Incluir o schedule manualmente FWTOTVSLINKJOB
    •  Habilitar Parametro MV_INSIGHT
    •  Adicionar no menu do Estoque e custos o Armazém IA (ARMZIA) 
    •  Cadastrar Armazens no Armazém IA
    •  Verificar tabela I14 se tem o registro de permissão
     Executar o Wizard WIZSMARTBA

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

    Image Removed

    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.

    Image Removed

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

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

    Image Removed2. Selecione as Empresas :

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

    Image Removed

    3. Aceitar Contrato

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

    Image RemovedCertifique-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.
    Image Removed

    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.
    Aviso
    titleIMPORTANTE

    Atenção: Uso exclusivo das chaves clientId e clientSecret

    Por favor, note que as chaves clientId e clientSecret são exclusivas e não devem ser compartilhadas. Não as utilize em mais de um ambiente ao mesmo tempo. Se necessário utilizar em um outro ambiente, desative as configurações dos jobs e execute novamente o WIZSMARTBA para uso em outro ambiente.

    Outros produtos também utilizam esses campos e pode ser que os campos clientId e clientSecret já estejam preenchidos. No entanto, deve-se sempre inserir os novos para que a configuração seja realizada corretamente. Certifique-se de inserir os clientId e clientSecret corretos para a configuração do Protheus Insights.

    Image Removed
    5. Ativando a integração:Image Removed
    Conclusão
    Image Removed

    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
    Image Removed

    Configurar o schedule FWTOTVSLINKJOB

    Acessando o schedule, selecione agendamentos clique no icone de incluir e adicione o job FWTOTVSLINKJOB no cadastro de agendamentos siga as instrucoes 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.
    Deck of Cards
    idschedule-config
    Card
    defaulttrue
    idschedule-old-version
    labelSchedule
    titlePermissões

    Image Removed

    Image Removed

    Dica

    (Re)inicie os serviços que foram criados durante a configuração e certifique-se que eles estejam iniciados.

    •  Verificar se o Schedule esta iniciado (Task Manager e Queue Manager)
    •  Verificar se o agente esta iniciado
    •  Verificar se o FWTECHFINJOB e o FWTOTVSLINKJOB estão  iniciados
    Deck of Cards
    idschedule-config
    Card
    defaulttrue
    idschedule-old-version
    labelSchedule
    titlePermissões
    Deck of Cards
    idschedule-config
    Card
    defaulttrue
    idschedule-old-version
    labelSchedule
    titlePermissões
    Bloco de código
    languagebash
    titleappserver.ini
    [Drivers]
    MultiProtocolPort=1
    MultiProtocolPortSecure=0
  • Na seção "[General]", assegure-se de que o "App_Environment" esteja direcionado para o ambiente principal, por exemplo:

    Bloco de código
    languagebash
    [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.
    Dica

    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 para geração de insights. Este modelo recebe os dados diariamente através do job schedule FWTECHFINJOB e o modelo executado  é aos Domingos onde acontece a geração dos insights.

    Recebendo os Insights:

    • Após a execução do modelo de IA no domingo, na segunda-feira de manhã, os insights gerados são recebidos. Isso é feito através do job schedule FWTOTVSLINKJOB. Este job é responsável por disponibilizar os insights gerados.
    Enquanto os insights são aguardados, os usuários podem explorar as opções disponíveis no modo de demonstração para estoque e compras
    • .

    Card
    effectDuration0.5
    iddemoinsights-estoque
    labelInsights Estoque
    titleinsights-estoqueModo Demonstração 
    effectTypeslide
    Demonstração 
    Modo de Demonstração oferece aos usuários a oportunidade de visualizar e interagir com dados simulados, proporcionando uma experiência semelhante ao uso do Protheus Insights. Ao clicar em 'Carregar Dados de Simulação', você poderá visualizar dados fictícios. Além disso, no topo da tela, onde o título da página é exibido, você verá a indicação 'MODO DEMONSTRAÇÃO'. Abaixo dos filtros, há um botão 'Sair dos Dados de Demonstração' para retornar ao ambiente real.
    No Modo de Demonstração, todas as funcionalidades de filtro e interação disponíveis no Protheus Insights estão acessíveis. No entanto, vale ressaltar que essas interações não geram requisições de dados reais.
    Para utilizar o Protheus Insights com seus próprios dados e obter insights personalizados, siga o passo a passo de configuração disponível nas configurações.
    Uma vez que o Protheus Insights esteja configurado e você tenha insights, o Modo de Demonstração não será mais exibido, dando lugar aos insights baseados em seus próprios dados.

    Como acessar a demonstração:

    Para acessar a demonstração, siga os passos abaixo:

    Acessar o Compras (02 SIGACOM)

    • Navegue até Atualizações > Solicitações > Solicitações de Compras > Outras Ações > Demanda de Produtos. Se você não possuir dados para os insights, será apresentado um botão para acessar o modo de demonstração. Clique para prosseguir.
                Image Removed

    Acessar o Estoque e Custos ( 04 SIGAEST)

    Navegue até Atualizações > Cadastro > Produto > Produtos > Outras Ações > Ruptura de Produtos. Se você não possuir dados para os insights, será apresentado um botão para acessar o modo de demonstração. Clique para prosseguir.

    Image Removed

    Card
    effectDuration0.5
    iddemoinsights-estoque
    labelInsights Estoque
    titleinsights-estoqueDemonstração
    effectTypeslide
    Dica
    iconfalse

    Observações sobre a demonstração

    • A demonstração atualmente abrange as demandas de produtos e a ruptura de produtos. Isso significa que os usuários, mesmo que não tenham o Protheus Insights, podem experimentar as funcionalidades relacionadas ao Protheus Insights de forma ativa, pois os dados são simulados. Os usuários podem clicar e visualizar detalhes dos insights, simulando os insights gerados pelo Protheus Insights.

    Card
    effectDuration0.5
    idinsights-estoque
    labelInsights Estoque
    titleinsights-estoque
    effectTypeslide
    Protheus Insights Ruptura de Estoque

    Protheus Insights no Estoque/Custos, CADASTRO DE PRODUTO (MATA010).

    Visão Geral

     O Protheus Insights traz uma nova funcionalidade de Ruptura de Estoque integrado ao já existente Cadastro de Produtos (MATA010), oferecendo otimizações significativas para o gerenciamento de estoque e demanda.

    O processo inicia-se com a reconstrução do histórico de demanda, utilizando as tabelas de movimentos (SD3) e notas fiscais (SD1 e SD2) para determinar a demanda diária. Em seguida, o modelo Arima+ é empregado para identificar padrões de tendência e sazonalidade e fazer a previsão de demanda para os próximos meses. Com base nessa previsão de demanda, juntamente com os saldos em estoque e movimentos de entrada futuros, é realizada a previsão de estoque.

    Caso o cliente não possua os indicadores de estoque de segurança e ponto de reposição cadastrados no ERP, estes são calculados utilizando o lead time e a demanda média diária. Após o cálculo desses indicadores, é verificado se, em algum momento, a previsão de estoque atinge o ponto de reposição. Se isso ocorrer, um alerta de ruptura de estoque é enviado ao Protheus, esse processo acontece diariamente.

    Importante ressaltar que o alerta de ruptura só vai soar se a IA identificar acuracidade acima de 70% nos cálculos. Entendendo que acuracidade é uma medida que aponta quão próxima uma previsão está do cenário real, se a IA identificar que suas previsões estão com precisão acima de 70% em relação ao real, o alerta será enviado ao ERP Protheus. Caso contrário, o alerta não soará.

    Image Added   


    Diferenças entre os modelos de previsão de demanda e ruptura de estoque

    Na gestão de estoques, a ruptura ocorre quando a quantidade de um item de venda se esgota antes que a demanda seja atendida.  Sendo assim, a ruptura se ocupa da possível falta de produtos.
    Já a previsão de demanda se concentra em antecipar as quantidades necessárias para atender à demanda.

    E a principal diferença entre previsão de demanda e a ruptura de estoque está no cálculo da disponibilidade do produto. Enquanto a previsão de demanda se baseia em estimativas para determinar quanto será necessário para atender à demanda futura, a ruptura de estoque considera o saldo atual de estoque, juntamente com as entradas provisionadas e a previsão de demanda, para calcular se haverá falta de produtos.

    A abordagem da Ruptura implica nesta fórmula:

    Previsão de estoque = Saldo atual + Entradas provisionadas − Previsão de demanda

    Onde:

    • O saldo atual representa a quantidade disponível do item em estoque.
    • As entradas provisionadas são as quantidades esperadas a serem adicionadas ao estoque em um determinado período.
    • A previsão de demanda é a estimativa de quantidades necessárias para atender à demanda do período.

    Essa fórmula permite avaliar se a quantidade disponível no estoque será suficiente para atender à demanda prevista. Se o resultado for negativo, indica que não haverá estoque suficiente para atender à demanda, resultando em uma ruptura de estoque.
    Assim, enquanto a previsão de demanda é essencial para antecipar as necessidades futuras, a análise da ruptura de estoque é crucial para evitar que as falhas na oferta prejudiquem a satisfação do cliente e impactem negativamente os resultados do negócio.


    Volume de Dados Necessário para Gerar a Previsão de Demanda

    Para obter melhores resultados do modelo de previsão de ruptura, recomendamos um período de 2 anos de histórico das movimentações de estoque (SD3), no mínimo. Nem sempre os dados possuem os padrões necessários para uma boa previsão, então a fim de garantir uma melhor experiência de uso e qualidade das previsões, só apresentamos no ERP Protheus as previsões que obtiveram um mínimo de 70% de acurácia.

    Dica

    Diariamente, a IA executa os cálculos para gerar insights de ruptura de estoque, mas eles só serão enviados se o critério de 70% de acurácia for alcançado.


    Image Added



    Como acessar: 

    Após concluir a instalação do Protheus Insights e configurar as permissões de usuários, siga as etapas abaixo para acessar os insights de Ruptura de estoque:

    Acesse o Estoque e Custos. "Estoque e Custos > Atualizações > Cadastro > Produto > Produtos.

    Ao acessar a tela de cadastro de produtos, localize o botão "Outras Ações".

    Aqui, você encontrará a opção "Ruptura de Produtos". 

         Image Added

    Detalhes da Análise de Ruptura de Produtos

    Ao selecionar a opção "Ruptura de Produtos", uma nova tela será aberta, oferecendo informações detalhadas sobre a análise de ruptura de estoque.


    Image Added

    Lista de Produtos com Previsão de Ruptura:

    Exibe produtos com previsão de ruptura de estoque que foram gerados pela IA e têm uma a precisão a partir de 70% .

    Filtros:

    Permite filtrar produtos com base em opções como descrição, código do produto, tipo de produto, grupo de produto e periodicidade. Esses filtros ajudam os usuários a personalizar a visualização da lista de produtos de acordo com suas necessidades específicas.

    Gráfico de Detalhes do Produto:

    Ao clicar em um produto, um gráfico exibirá informações, incluindo:

      • Ponto de reposição;
      • Estoque de segurança;
      • Ponto de ruptura;
      • Histórico de estoque (se disponível);
      • Previsão de saldo;
      • Intervalo de confiança;
      • Acurácia da projeção.
         

    Image Added
    Image Added



    Explicação do Gráfico de Ruptura de Produtos (Estoque):

    Titulo: Mostra a periodicidade dos dados, tipo do produto, grupo do produto e descrição do produto.


    Botão de Ativação do Intervalo de Confiança Image Added
    Ao ser ativado Image Added, esse botão habilita uma barra sombreada no gráfico,Image Added
    Mostrando uma projeção que aumenta a acuracidade com base em uma média. Isso oferece uma visão mais precisa da previsão de ruptura.

    Percentual de Acurácia:  Image Added
    Indica o percentual de precisão da previsão gerado pela IA. Isso ajuda a avaliar a confiabilidade das informações apresentadas.

    Linha Tracejada (Previsão de Saldo) Image Added
     
    Identifica a previsão do saldo de estoque, com pontos marcados nas datas de acordo com a periodicidade selecionada (mensal, semanal ou diária). Esses insights são gerados semanalmente, geralmente aos domingos.

    Barra Verde (Ponto de Reposição): Representa o ponto de reposição do estoque, que pode ser especificado no cadastro do produto no campo B1_EMIN. Se esse valor não estiver preenchido, a IA calculará esse ponto.

    Barra Amarela (Estoque de Segurança): Representa a quantidade de estoque de segurança, definida no cadastro do produto no campo B1_ESTSEG. Se não estiver preenchido, a IA usará uma fórmula para determinar essa quantidade.

    Barra Vermelha (Ponto de Ruptura): Indica o ponto de ruptura, o que significa que quando a linha tracejada atingir esse ponto, haverá demanda para o produto, mas o estoque disponível será insuficiente.

    Data do Insight (Abaixo do Gráfico): Indica a data em que o insight de previsão foi gerado, oferecendo informações sobre a atualidade dos dados apresentados no gráfico.


    Nota
    titleObservações Importantes:

     O Histórico de Estoque será exibido quando o cliente tiver dados cadastrados na tabela SB9 somente para as previsões mensais.

    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_EMIN

    Ponto de Pedido

    B1_ESTSEG

    Estoque de Segurança

    Caso esses campos tenham sido preenchidos, será respeitada a regra calculada pelo ERP. Na ausência desses dados, fórmulas serão aplicadas para calcular o Estoque de Segurança e Ponto de Pedido, conforme abaixo.

    Cálculo do Estoque de Segurança:

    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>
        \(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 simplificado = Fator de serviço x desvio padrão Demanda x Raiz(Tempo de entrega)

    Card
    effectDuration0.5
    idinsights-estoque
    labelInsights Estoque
    titleinsights-estoque
    effectTypeslide
    Protheus Insights Ruptura de EstoqueProtheus Insights no Estoque/Custos, CADASTRO DE PRODUTO (MATA010).
    Visão Geral
    O Protheus Insight traz uma nova funcionalidade de Ruptura de Estoque integrado ao já existente Cadastro de Produtos (MATA010), oferecendo otimizações significativas para o gerenciamento de estoque e demanda.

    O processo inicia-se com a reconstrução do histórico de demanda, utilizando as tabelas de movimentos (SD3) e notas fiscais (SD1 e SD2) para determinar a demanda diária. Em seguida, o modelo Arima+ é empregado para identificar padrões de tendência e sazonalidade e fazer a previsão de demanda para os próximos meses. Com base nessa previsão de demanda, juntamente com os saldos em estoque e movimentos de entrada futuros, é realizada a previsão de estoque.

    Caso o cliente não possua os indicadores de estoque de segurança e ponto de reposição cadastrados no ERP, são calculados utilizando o lead time e a demanda média diária. Após o cálculo desses indicadores, é verificado se, em algum momento, a previsão de estoque atinge o ponto de reposição. Se isso ocorrer, um alerta de ruptura de estoque é enviado ao Protheus, esse processo acontece diariamente.
    Diferenças entre os modelos de previsão de demanda e ruptura de estoque
    Na gestão de estoques, a ruptura de estoque ocorre quando a quantidade de um determinado item disponível para venda se esgota antes que a demanda seja atendida. Ao contrário da previsão de demanda, que se concentra em antecipar quantidades necessárias para atender a essa demanda, a ruptura de estoque lida com as consequências quando a oferta não consegue acompanhar a demanda prevista.
    A principal diferença entre a previsão de demanda e a ruptura de estoque está no cálculo da disponibilidade do produto. Enquanto a previsão de demanda se baseia em estimativas para determinar quanto será necessário para atender à demanda futura, a ruptura de estoque considera o saldo atual de estoque, juntamente com as entradas provisionadas e a previsão de demanda, para calcular se haverá falta de produtos.
    Essa abordagem implica uma fórmula:
    Previsão de estoque = Saldo atual + Entradas provisionadas − Previsão de demanda
    Onde:
    • O saldo atual representa a quantidade disponível do item em estoque.
    • As entradas provisionadas são as quantidades esperadas a serem adicionadas ao estoque em um determinado período.
    • A previsão de demanda é a estimativa de quantidades necessárias para atender à demanda do período.
    Essa fórmula permite avaliar se a quantidade disponível no estoque será suficiente para atender à demanda prevista. Se o resultado for negativo, indica que não haverá estoque suficiente para atender à demanda, resultando em uma ruptura de estoque.
    Assim, enquanto a previsão de demanda é essencial para antecipar as necessidades futuras, a análise da ruptura de estoque é crucial para evitar que as falhas na oferta prejudiquem a satisfação do cliente e impactem negativamente os resultados do negócio.
    Volume de Dados Necessário para Gerar a Previsão de Demanda
    Para obter melhores resultados do modelo de previsão de ruptura recomendamos no mínimo um período de 2 anos de histórico das movimentações de estoque (SD3). Nem sempre os dados possuem os padrões necessários para uma boa previsão então a fim de garantir uma melhor experiência de uso e qualidade das previsões apresentamos apenas previsões que tenham obtido um mínimo de 70% de acurácia.
    Dica

    Os alertas de ruptura de estoque são gerados insights e enviados diariamente.

    Image Removed
    Como acessar: 

    Após concluir a instalação do Protheus Insights e configurar as permissões de usuários, siga as etapas abaixo para acessar os insights de Ruptura de estoque:

    Acesse o Estoque e Custos. "Estoque e Custos > Atualizações > Cadastro > Produto > Produtos.

    Ao acessar a tela de cadastro de produtos, localize o botão "Outras Ações".

    Aqui, você encontrará a opção "Ruptura de Produtos".

         Image Removed

    Detalhes da Análise de Ruptura de Produtos

    Ao selecionar a opção "Ruptura de Produtos", uma nova tela será aberta, oferecendo informações detalhadas sobre a análise de ruptura de estoque. A tela inclui os seguintes elementos:

    1. Tabela de Produtos com Previsão de Ruptura:

      • Exibe produtos com previsão de ruptura de estoque que foram gerados pela IA e têm uma a precisão a partir de 70% .
    2. Filtros:

      • Permite filtrar produtos com base em opções como descrição, código do produto, tipo de produto, grupo de produto e periodicidade. Esses filtros ajudam os usuários a personalizar a visualização da lista de produtos de acordo com suas necessidades específicas.
    Image Removed

    Gráfico de Detalhes do Produto:

    Ao clicar em um produto, um gráfico exibirá informações, incluindo:

      • Ponto de reposição;
      • Estoque de segurança;
      • Ponto de ruptura;
      • Histórico de estoque (se disponível);
      • Previsão de saldo;
      • Intervalo de confiança;
      • Acurácia da projeção.
         
    Image Removed
    Image Removed

    Explicação do Gráfico de Ruptura de Produtos (Estoque):

    Barra no Topo: Mostra a periodicidade dos dados, tipo do produto, grupo do produto e descrição do produto.

    Botão de Ativação do Intervalo de Confiança Image Removed
    Ao ser ativado Image Removed, esse botão habilita uma barra sombreada no gráfico,Image Removed
    Mostrando uma projeção que aumenta a acuracidade com base em uma média. Isso oferece uma visão mais precisa da previsão de ruptura.

    Percentual de Acurácia:  Image Removed
    Indica o percentual de precisão da previsão gerado pela IA. Isso ajuda a avaliar a confiabilidade das informações apresentadas.

    Linha Tracejada (Previsão de Saldo) Image Removed
     
    Identifica a previsão do saldo de estoque, com pontos marcados nas datas de acordo com a periodicidade selecionada (mensal, semanal ou diária). Esses insights são gerados semanalmente, geralmente aos domingos.

    Barra Verde (Ponto de Reposição): Representa o ponto de reposição do estoque, que pode ser especificado no cadastro do produto no campo B1_EMIN. Se esse valor não estiver preenchido, a IA calculará esse ponto.

    Barra Amarela (Estoque de Segurança): Representa a quantidade de estoque de segurança, definida no cadastro do produto no campo B1_ESTSEG. Se não estiver preenchido, a IA usará uma fórmula para determinar essa quantidade.

    Barra Vermelha (Ponto de Ruptura): Indica o ponto de ruptura, o que significa que quando a linha tracejada atingir esse ponto, haverá demanda para o produto, mas o estoque disponível será insuficiente.

    Data do Insight (Abaixo do Gráfico): Indica a data em que o insight de previsão foi gerado, oferecendo informações sobre a atualidade dos dados apresentados no gráfico.

    Caso esses campos tenham sido preenchidos será respeitada a regra calculada pelo ERP.
    Nota
    titleObservações Importantes:
    O Histórico de Estoque será exibido quando o cliente tiver dados cadastrados na tabela SB9 somente para as previsoes mensais.
    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_EMIN

    Ponto de Pedido

    B1_ESTSEG

    Estoque de Segurança

    Aviso
    titleImportante
    Na ausência desses dados, fórmulas serão aplicadas para calcular o Estoque de Segurança e Ponto de Pedido.

    Cálculo do Estoque de Segurança:

    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>
        <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>
        \(ES = z \times \sqrt{\sigma_d^2d \times t + \sigma_t^2 \times d^2\sqrt{t}\)
    </body>
    </html>
    
    
    Caso não seja possível calcular o lead time ou ele tenda a zero será aplicada a fórmula simplificada:


    Cálculo do Ponto de Reposição

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

    Estoque de segurança simplificado = Fator de serviço x desvio padrão Demanda x Raiz(Tempo de entrega)
    • 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>
        \(ESPR = z \times \sigma_d(\mu_L \times \sqrt{t}mu_D) + ES\)
    </body>
    </html>
    
    
    Cálculo do Ponto de Reposição
    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>
        \(PR = (\mu_L \times \mu_D) + ES\)
    </body>
    </html>
    
    

    Atualizações Diárias:

    • Uma nova carga diária atualiza os dados da projeção.
    • Após correções para evitar rupturas, uma nova predição é executada e os resultados atualizados na próxima carga todos os domingos.

    Em conclusão, o gráfico de ruptura de produtos fornece uma visão abrangente e detalhada da situação do estoque, ajudando os usuários a entenderem melhor as necessidades de reposição e os possíveis riscos de ruptura. Através da análise visual das previsões de saldo de estoque, pontos de reposição, estoque de segurança e pontos de ruptura, os usuários podem tomar decisões mais informadas sobre o gerenciamento de estoque.

    Além disso, a disponibilidade de informações sobre a acurácia da previsão e a periodicidade dos dados adiciona uma camada adicional de confiança e relevância às análises. Em última análise, o gráfico de ruptura de produtos é uma ferramenta valiosa para otimizar o controle de estoque, garantindo que os produtos estejam disponíveis quando necessário, enquanto se minimizam os riscos de falta ou excesso de estoque. 

    Card
    effectDuration0.5
    idinsights-compras
    labelInsights Compras
    titleinsights-compras
    effectTypeslide
    Card
    effectDuration0.5
    idinsights-compras
    labelInsights Compras
    titleinsights-compras
    effectTypeslide

    Protheus Insights Solicitação de Compras

    Protheus Insights no Compras,  SOLICITAÇÃO DE COMPRAS (MATA110).
    Visão Geral

    O Protheus Insight apresenta uma nova funcionalidade de Demanda de Produtos integrada à Solicitação de Compras (MATA110), oferecendo uma abordagem avançada para o planejamento de compras.

    O processo  inicia-se com a reconstrução do histórico de demanda, utilizando as tabelas de movimentos (SD3) e notas fiscais (SD1 e SD2) para determinar a demanda diária.

    Em seguida, o modelo Arima+ é aplicado para identificar padrões de tendência e sazonalidade, permitindo a previsão de demanda para os próximos meses.

    As previsões de demanda são então enviadas ao ERP diariamente, proporcionando uma visão abrangente e preditiva das necessidades de compra.

    Critérios da projeção e acurácia

    A acurácia de um modelo de previsão de demanda é uma medida de quão próximo as previsões do modelo estão dos valores reais da demanda. Para entender isso, é útil pensar em como os modelos fazem previsões.

    Exemplo: Imagine que você está tentando prever quantas pizzas serão vendidas em uma pizzaria em um determinado dia. O modelo de previsão usa dados históricos, ou seja, informações sobre quantas pizzas foram vendidas em dias anteriores. Ele analisa esses dados em busca de padrões, como tendências (se a demanda está aumentando ou diminuindo ao longo do tempo), sazonalidade (padrões que se repetem em certos períodos, como mais pizzas vendidas nos fins de semana) e ciclicidade (variações que ocorrem em ciclos regulares, mas não necessariamente ligadas a estações do ano).

    Então, quando você avalia a acurácia do modelo, está basicamente verificando se as previsões que ele faz correspondem aos números reais de vendas. Se o modelo prevê que serão vendidas 90 pizzas em um dia e na realidade são vendidas 100, então ocorreu um erro de 10% em cima do valor real e dizemos que o modelo possuí acurácia de 90%. Quanto mais próximo as previsões estiverem dos valores reais, maior será a acurácia do modelo.

    Portanto, a acurácia de um modelo de previsão de demanda depende de quão bem ele consegue capturar esses padrões de tendência, sazonalidade e ciclicidade nos dados históricos. Quanto mais precisamente ele pode identificar e incorporar esses padrões em suas previsões, mais precisa será sua previsão da demanda futura.

    Volume de Dados Necessário para Gerar a Previsão de Demanda

    Para obter melhores resultados do modelo de previsão de demanda recomendamos no mínimo um período de 2 anos de histórico das movimentações de estoque (SD3). Nem sempre os dados possuem os padrões necessários para uma boa previsão então a fim de garantir uma melhor experiência de uso e qualidade das previsões apresentamos apenas previsões que tenham obtido um mínimo de 70% de acurácia.

    Dica

    Os alertas de demanda de produtos são gerados insights e enviados diariamente.

    Image Removed

    A proposta do Protheus Insights na Solicitação de Compras é permitir que as demandas para reposição de estoque sejam provisionadas de maneira eficiente

    A solução oferecida envolve a projeção das tendências de demandas para reposição de estoque. Isso proporciona aos usuários uma visibilidade clara sobre o volume necessário para a reposição e identifica o melhor preço entre os fornecedores, contribuindo para a redução de custos operacionais e a melhoria da gestão de estoque.

    A funcionalidade de projeção de demandas para reposição de estoque apresenta uma lista detalhada das demandas  onde a acurácia das previsões a partir de 70%, e definir um intervalo de confiança que garante um alto índice de assertividade nas projeções.

    Como acessar:

    Instalação e Permissões de Usuários

    Antes de começar a usar Protheus Insights para a gestão de Solicitações de Compras, certifique-se de que o Protheus Insights foi devidamente instalado e que os usuários tenham as permissões necessárias para acessá-lo.
  • Acesso à Tela de Solicitações de Compras

    Para acessar a funcionalidade de Solicitações de Compras, siga os passos abaixo:

    a. Acesse o menu principal do sistema no módulo de Compras.

    b. Navegue até "Atualizações" > "Solicitações" > Solicitações de Compras > botão "Outras Ações" >  Demanda de Produtos

  • Na tela de Solicitações de Compras, você notará a presença do botão "Outras Ações". Dentro desse botão, você encontrará a opção "Demanda de Produtos". 

    Clicar nessa opção abrirá uma nova tela.
    Image Removed

    Tela de Análise

    Ao clicar na opção "Demanda de Produtos":
    Image Removed
  • Informações na Tela

  • Na nova tela, você encontrará as seguintes informações:

      • Uma tabela listando os produtos que possuem previsão de demanda gerada pelos IA, com uma precisão de a partir de 70%.
      • Filtros que permitem personalizar a exibição da lista de produtos:
        • Código e descrição
        • Tipo de Produto
        • Grupo de Produto
        • Periodicidade

    Gráfico de Informações Detalhadas

    Ao clicar em um produto específico da lista, um gráfico detalhado será exibido.
    Esse gráfico conterá as seguintes informações:Previsão de Demanda para o produto selecionado.
    Image RemovedImage Removed
    O gráfico representa a previsão de demanda para um determinado produto.
    Aqui está uma explicação detalhada dos elementos:

    Linha Contínua (Histórico de Demanda): Esta linha mostra o histórico de demanda do produto ao longo do tempo. Cada ponto ao longo da linha representa uma data específica e a quantidade de produtos vendidos nessa data.

    Linha Tracejada (Previsão de Demanda): Esta linha indica a previsão de demanda futura para o produto. É uma projeção baseada em dados históricos e algoritmos de previsão. Cada ponto ao longo da linha representa uma data futura e a quantidade prevista de produtos a serem demandados nessa data.

    Pontos Indicadores no Gráfico: Ao passar o mouse sobre esses pontos, você pode visualizar a quantidade de produtos previstos ou vendidos em uma data específica.

    Informações do Produto : Aqui você pode ver informações sobre a periodicidade dos dados apresentados, o tipo do produto, o grupo e a descrição.

    Botão de Ativação do Intervalo de Confiança: Este botão permite ativar o intervalo de confiança na previsão. Isso significa que além da previsão pontual, é calculada uma margem de erro que representa um intervalo onde a demanda provavelmente estará, com base na confiabilidade do modelo de previsão.

    Percentual de Acurácia : Esse indicador mostra o percentual de acurácia da previsão. É uma medida de quão precisa é a previsão em comparação com os dados reais.

    Data de Geração do Insight de Previsão de Demanda : Esta é a data em que a previsão de demanda foi gerada. Isso ajuda a entender a atualidade e relevância das informações apresentadas no gráfico.

    As informações gráficas fornecidas são uma ferramenta valiosa para os usuários entenderem a situação do produto em relação ao estoque. Ao visualizar o histórico de demanda e a previsão futura, os usuários podem tomar decisões informadas sobre o gerenciamento de estoque, como ajustar os níveis de inventário, planejar compras ou produção e antecipar variações na demanda. Além disso, a inclusão do intervalo de confiança e do percentual de acurácia oferece uma medida de confiabilidade nas previsões, permitindo uma avaliação mais precisa da situação do produto. Em última análise, essas informações gráficas capacitam os usuários a otimizar a gestão de estoque, garantindo que estejam preparados para atender às demandas dos clientes de forma eficiente e eficaz.
    Card
    effectDuration0.5
    idinsights-financeiro
    labelInsights Financeiro
    titleinsights-financeiro
    effectTypeslide
    Card
    effectDuration0.5
    idinsights-financeiro
    labelInsights Financeiro
    titleinsights-financeiro
    effectTypeslide

    Protheus Insights no Novo Gestor Financeiro

    Protheus Insights no NOVO GESTOR FINANCEIRO (FINA710).
    Visão Geral

    O Protheus Insights apresenta uma nova funcionalidade de Previsão de Fluxo de Caixa integrada ao já existente Novo Gestor Financeiro (FINA710), elevando o nível de valor agregado por meio da inteligência artificial. Essa adição não apenas enriquece as funcionalidades já disponíveis no Protheus, mas também demonstra o compromisso contínuo com a inovação, permitindo que as empresas aproveitem ao máximo as tecnologias mais avançadas para otimizar suas operações financeiras.

    O processo começa com a construção das séries temporais das entradas e saídas de caixa, utilizando dados da tabela de movimentações bancárias (FK5).

    Utilizando o modelo de machine learning, são identificados padrões de tendência nas movimentações, permitindo a projeção das entradas e saídas de caixa para períodos futuros para cada filial contida no Protheus que possuem dados históricos o suficiente para encontrar um padrão. Com base nessas previsões, é conduzida uma análise para identificar saldos insuficientes ou extras de acordo com o padrão dos saldos anteriores de cada cliente. Caso os valores projetados estejam fora de comportamento comum observado ao longo do tempo, um alerta é enviado para o ERP.

    • Notificações de Insights:

    O Protheus Insights inclui um sistema de notificação para alertar os usuários sobre novos insights relacionados ao novo gestor financeiro. Essas notificações são exibidas no ícone de sino no topo lateral direita, juntamente com o número de notificações não lidas. Ao clicar no ícone do sino, os usuários podem acessar e analisar as notificações dos insights recentes.

    • Gráfico de Previsão de Fluxo de Caixa:

    O gráfico de previsão de fluxo de caixa, utiliza o histórico de movimentações da tabela FK5 (Movimentos bancários: Registra as movimentações bancárias de títulos a receber, a pagar e individuais) para projetar as entradas e saídas futuras. É importante destacar que a geração desse gráfico leva em consideração os filtros aplicados por filiais e visões semanais e mensais já presentes no novo gestor financeiro.

    Critériosde projeção fluxo de caixa:

    Os dados da tabela FK5 por tipo de movimentação (FK5_RECPAG) são agrupados em duas formas diferentes, mensal e semanal, depois disso é executado um treinamento de um modelo de ML que tentará encontrar um padrão na tendência de movimentação com base na série histórica (algoritmo de regressão). Um requisito importante para que seja possível a identificação desse padrão é a presença de dados em pelo menos 11 nos últimos 12 meses na tabela FK5. Dessa forma, valida-se o requisito mínimo para que a série seja incluída no treinamento.
    Após o passo de treinamento, há uma avaliação que calcula a média do erro de uma predição passada em comparação com o valor esperado. Essa diferença percentual é utilizada para o cálculo da acurácia.

    Projeção do Fluxo de CaixaVisualização das movimentações de entradas e saídas em intervalos semanais e mensais.
     % Acurácia das entradas e saídas, são mostrados insights que tem a partir de 50% de acurácia.
    Intervalo de confiança, é uma margem de valores que a projeção pode oferecer com 95% de certeza, por exemplo, em um determinado mês, a projeção mensal de entrada de caixa foi de 3,541M de reais com uma acurácia de 82%, porém, imagine um negócio que trabalha com uma margem apertada, seria interessante obter uma precisão um pouco melhor, mas devido as limitações do modelo, conseguimos entregar um range de valores onde garantimos que o valor exato de predição esteja dentro dessa faixa com uma certeza de 95%.

    Image Removed

    Alerta

    Alerta sobre movimentações de entradas e saídas com referência a saldo insuficiente e/ou
    saldo extra.
    Aviso para movimentações de entradas e saídas em intervalos semanais até trimestrais.
  • Consulta de histórico dos alertas para revisão e análise retrospectiva.
  • Image Removed

    Instalação e Permissões de Usuários

    Antes de começar a usar Protheus Insights para a gestão de fluxo de caixa, certifique-se de que o Protheus Insights e o novo gestor financeiro foram devidamente instalados e que os critériosde projeção fluxo de caixa  sejam atendidos como a  presença de dados em pelo menos 11 nos últimos 12 meses na tabela FK5  e os usuários têm as permissões necessárias para acessá-lo.

    Acesso à Tela do novo gestor financeiro

    Para acessar a funcionalidade do novo gestor financeiro, siga os passos abaixo:

    Acesse o menu principal do sistema no módulo Financeiro.

    Navegue até "Atualizações > Gestao Financeira > Novo Gestor Financeiro".

    Menu - Movimentos
    Na tela inicial do novo gestor financeiro, você notará a presença do botão "Movimentos" no menu esquerdo. Clicar nessa opção abrirá uma nova tela.
    Image Removed

    Tela de Análise

    Image Removed

    IMPORTANTE: Os filtros como periodicidade e filtros de filiais aplicados são considerados, ao clicar no ícone de previsão de fluxo de caixa as informações retornadas são de acordo com os filtros selecionados de periodicidade e filtro de filais. 

    O período de análise, sendo as possibilidades: Mensal e Semanal, caso selecione o filtro diário o ícone da previsão de fluxo de caixa será apresentado desabilitado pois para a previsão de fluxo de caixa estão disponíveis em modelo Mensal e Semanal.
    Acesso às previsões do período selecionado, no canto superior direito do gráfico de ' Previsão de Fluxo de caixa'
  • Ao clicar no ícone da TOTVS no canto superior direito, por padrão, é possível selecionar filiais. Caso tenha feito esse filtro, a geração do gráfico de previsão de fluxo de caixa também considera esse filtro.
  • Gráfico de Informações Detalhadas

    Ao selecionar um período específico pelo filtro Mensal ou Semanal e clicar no botão de Previsão de fluxo de caixa, um gráfico detalhado será exibido, proporcionando uma análise abrangente do fluxo de caixa.
    Este gráfico conterá as seguintes informações:
      • Histórico de Fluxo de Caixa de Entrada e Saída:

        • Apresenta o registro detalhado das movimentações financeiras de entrada e saída ao longo do período selecionado. Essa visualização permite aos usuários entenderem o padrão de recebimentos e desembolsos ao longo do tempo.
      • Previsão de Fluxo de Caixa de Entrada e Saída:

        • Mostra as projeções futuras de movimentações financeiras de entrada e saída com base nos dados históricos e algoritmos de previsão. Essa previsão ajuda os usuários a anteciparem-se a eventos financeiros e a planejarem suas atividades de forma mais precisa e eficaz.
    •  Image Removed
    A linha verde contínua representa o histórico de movimentações de entrada, mostrando os valores registrados ao longo do tempo. Isso proporciona uma visão clara das tendências passadas em termos de receitas ou entradas financeiras.
    Da mesma forma, a linha vermelha contínua exibe o histórico de movimentações de saída, destacando os valores associados aos gastos ou despesas ao longo do período analisado.
    As linhas pontilhadas, uma verde e outra vermelha, representam as previsões futuras de movimentações financeiras. Essas projeções são baseadas em algoritmos inteligentes que consideram o histórico de movimentações, padrões sazonais e outros fatores relevantes para estimar as entradas e saídas esperadas.
    Ao posicionar o cursor sobre qualquer ponto do gráfico, será exibido um pop-up com os valores específicos para aquele data. Isso permite uma análise detalhada e rápida das informações, facilitando a compreensão das tendências e a tomada de decisões informadas sobre a gestão do fluxo de caixa.
    Informações

    Mensagens de Retorno

    Quando o gráfico não pode ser exibido, o sistema retornará uma mensagem para informar ao usuário o motivo. Essa mensagem será apresentada em um modal para facilitar a compreensão do problema. Além disso, detalhes sobre também serão registrados no console.log para fins de depuração.

    Exemplos de Mensagens de Retorno

    Aqui estão algumas mensagens de retornos possíveis que podem ser encontradas, juntamente com seus motivos correspondentes:

    • Código 404 (Falta de Dados):

      • Mensagem: "Falta de dados: Não foram encontrados dados suficientes de receita e despesas para a previsão."
      • Motivo: Não foi possível localizar as despesas e receitas necessárias para prever o fluxo de caixa.
    • Código 400 (Filtro Vazio):

      • Mensagem: "Filtro Vazio: Não foram encontrados filtros para cálculo da previsão."
      • Motivo: Não foram fornecidos filtros para calcular a previsão.
    • Código 404 (Dados Ausentes):

      • Mensagem: "Falta de dados: Não foram encontrados dados suficientes para a previsão."
      • Motivo: Não há dados disponíveis em nosso banco de dados.
    • Código 404 (Acurácia Baixa):

      • Mensagem: "Acurácia baixa: Não foram encontrados padrões suficientes para previsão."
      • Motivo: Os dados disponíveis não possuem uma acurácia satisfatória para realizar a previsão.
    • Código 500 (Exceção lançada - Previsão Financeira):

      • Mensagem: "Exceção lançada: Exceção na geração da previsão financeira."
      • Motivo: Ocorreu uma exceção durante a geração da previsão financeira.

    Estas mensagens de fornecem uma explicação clara do problema encontrado, permitindo que os usuários entendam o motivo pelo qual o gráfico não está sendo exibido.

    Essas informações gráficas proporcionam aos usuários uma visão mais clara e abrangente do fluxo de caixa, permitindo uma compreensão mais profunda das tendências financeiras da empresa. Com a visualização do histórico de movimentações e das previsões futuras, os gestores podem identificar padrões, antecipar cenários e tomar decisões estratégicas mais informadas.

    Além disso, o auxílio das projeções permite um planejamento financeiro mais eficaz, pois os usuários podem antecipar períodos de disponibilidade ou escassez de recursos e ajustar suas estratégias de acordo. Isso ajuda a mitigar riscos e otimizar o uso dos recursos financeiros da empresa, contribuindo para uma gestão mais eficiente e sustentável.

    Card
    effectDuration0.5
    idconciliador
    labelInsights Conciliador Backoffice
    effectTypeslide
    Card
    effectDuration0.5
    idconciliador
    labelInsights Conciliador Backoffice
    effectTypeslide

    Protheus Insights Conciliador Backoffice

    Protheus Insights  no CONCILIADOR BACKOFFICE (CTBA940).
    Informações
    iconfalse

    IMPORTANTE: Para utilizar as funcionalidades do Protheus Insights no Conciliador Backoffice, é necessário que o cliente já tenha o Conciliador Backoffice configurado conforme as orientações da documentação CTBA940. Além disso, é preciso aplicar um pacote disponível para clientes pilotos. Caso já utilize o Conciliador Backoffice e tenha interesse neste pacote, por favor, entre em contato com a equipe pelo e-mail [email protected], informando que já utiliza o Conciliador Backoffice e deseja utilizar as novas funcionalidades do Protheus Insights no Conciliador. Enviaremos o link para download dos pacotes. Em breve esse pacote será disponibilizado na expedição contínua.

    Esta documentação oferece orientações detalhadas sobre o uso do Protheus Insights no Conciliador Backoffice.
    Nesta seção, você encontrará informações detalhadas sobre como esse módulo ajuda a aprimorar o processo de conciliação, identificando divergências e origens de lançamentos manuais com o uso de inteligência artificial.
    Visão Geral

    Protheus Insights dentro do conciliador backoffice foi desenvolvido para proporcionar maior precisão e eficiência ao processo de conciliação com auxilio da  inteligência artificial da Carol que sugere a conciliação dos registros não identificados automaticamente, aumentando o volume de conciliação automatizada para acelerar a produtividade.

    Image Removed

    Como utilizar o Conciliador Backoffice

    Acesse o modulo 34 Contabilidade Gerencial (SIGACTB)> Atualizações > Mcasp > Rpps > Conciliador.

    Image Removed

    Selecione a Configuração de Conciliação 

    Image Removed

    Clique em "Ver Filtros"
    Image Removed
    Após selecionar os filtros de acordo com sua preferência, clique em "Aplicar"Image RemovedClique na aba "Dados Não Encontrados".

    Image Removed

    Image Removed

    Informações
    iconfalse

    o botão "Aplicar Match Inteligência Artificial", que aparecerá habilitado se houver algum match identificado pela inteligência artificial da Carol. Isso significa que ele só será habilitado se houver algum match na I16 que exista nas temporárias da tabela de origem ou destino.

    Caso o botão esteja habilitado, como na imagem abaixo, clique no botão "Aplicar Match Inteligência Artificial". Lembre-se de que não é necessário selecionar nenhum registro, pois ele será exibido na próxima tela.

    Image Removed

    Uma janela será aberta, apresentando a quantidade de dados que foram encontrados match para Inteligência Artificial (IA) e Inteligência Artificial Divergente (ID), para avançar  clique em  "Avaliar".

    Image Removed

    Na tela, serão apresentadas duas tabelas com os dados. Neste exemplo: Contas a Receber (SE1) e Lançamentos Contábeis (CT2).

    Analise os dados de acordo com o status do tipo de match.

    Selecione os dados desejados para aplicar o match e clique no botão "Aplicar Match".

    Image RemovedOs dados serão atualizados e poderão ser vistos na lista com o tipo de match IA ou ID.

    Image Removed

    Dica

    Observação: O PROTHEUS INSIGHTS incorpora a poderosa Inteligência Artificial (IA) para facilitar a análise de MATCH entre Contas a Receber (SE1) e Lançamentos Contábeis (CT2), conforme demonstrado anteriormente. Ao seguir os passos descritos na rotina CTBA940 do Conciliador Backoffice, você estará habilitado para realizar a conciliação contábil.

    Para uma compreensão mais abrangente sobre a realização da conciliação, recomenda-se utilizar a documentação completa disponível no módulo contábil, acessível através de Conciliador Backoffice (CTBA940) . Este passo a passo tem o objetivo de apresentar a funcionalidade da nova feature de IA do Protheus Insights adicionada ao Conciliador Backoffice.


    Atualizações Diárias:

    •   Uma nova carga diária atualiza os dados da projeção.
    •   Após correções para evitar rupturas, uma nova predição é executada e os resultados atualizados na próxima carga todos os domingos.


    Em conclusão, o gráfico de ruptura de produtos fornece uma visão da situação do estoque, ajudando os usuários a entenderem melhor as necessidades de reposição e os possíveis riscos de ruptura. Através da análise visual das previsões de saldo de estoque, pontos de reposição, estoque de segurança e pontos de ruptura, os usuários podem tomar decisões mais fundamentadas sobre o gerenciamento de estoque.

    Além disso, o padrão de acuracidade utilizado nas previsões e a periodicidade de atualização dos dados, adiciona uma camada de confiança e relevância às análises. 

    Por fim, o gráfico de ruptura de produtos é uma ferramenta valiosa para otimizar o controle de estoque, garantindo que os produtos estejam disponíveis quando necessário, enquanto se minimizam os riscos de falta ou excesso de estoque. 

    Card
    effectDuration0.5
    idinsights-compras
    labelInsights Compras
    titleinsights-compras
    effectTypeslide
    Card
    effectDuration0.5
    idinsights-compras
    labelInsights Compras
    titleinsights-compras
    effectTypeslide

    Protheus Insights Solicitação de Compras

    Protheus Insights no Compras,  SOLICITAÇÃO DE COMPRAS (MATA110).

    Visão Geral

    O Protheus Insights apresenta uma nova funcionalidade de Demanda de Produtos integrada à Solicitação de Compras (MATA110), oferecendo uma abordagem avançada para o planejamento de compras.

    O processo  inicia-se com a reconstrução do histórico de demanda, utilizando as tabelas de movimentos (SD3) e notas fiscais (SD1 e SD2) para determinar a demanda diária.

    Em seguida, o modelo Arima+ é aplicado para identificar padrões de tendência e sazonalidade, permitindo a previsão de demanda para os próximos meses.

    As previsões de demanda são então enviadas ao ERP diariamente, proporcionando uma visão abrangente e preditiva das necessidades de compra.

    Importante ressaltar que o alerta de ruptura só vai soar se a IA identificar acuracidade acima de 70% nos cálculos. Entendendo que acuracidade é uma medida que aponta quão próxima uma previsão está do cenário real, se a IA identificar que suas previsões estão com precisão acima de 70% em relação ao real, o alerta será enviado ao ERP Protheus. Caso contrário, o alerta não soará.  

    Image Added


    Volume de Dados Necessário para Gerar a Previsão de Demanda

    Para obter melhores resultados do modelo de previsão de demanda recomendamos no mínimo um período de 2 anos de histórico das movimentações de estoque (SD3). Nem sempre os dados possuem os padrões necessários para uma boa previsão, então, a fim de garantir uma melhor experiência de uso e qualidade das previsões, apresentamos apenas previsões que tenham obtido um mínimo de 70% de acurácia.

    Os alertas de demanda de produtos são gerados insights e enviados diariamente, desde que haja acuracidade para isso.

    Como funciona a Solicitação de Compras com IA 

    A proposta do Protheus Insights na Solicitação de Compras é permitir que as demandas para reposição de estoque sejam provisionadas a partir da projeção das tendências de demandas, incluindo no cálculo as sazonalidades e ciclicidades dos produtos. Isso proporciona aos usuários uma clareza sobre o volume necessário para reposição e também identifica o melhor preço e o menor tempo de entrega entre os fornecedores.


    Dica

    Diariamente, a IA executa os cálculos para gerar insights de Demanda de produtos, mas eles só serão enviados se o critério de 70% de acurácia for alcançado.

    Image Added



    Como acessar os Insights de Demanda de Produtos:

    1. Instalação e Permissões de Usuários

      Antes de começar a usar Protheus Insights para a gestão de Solicitações de Compras, certifique-se de que o Protheus Insights foi devidamente instalado e que os usuários tenham as permissões necessárias para acessá-lo.

    2. Acesso à Tela de Solicitações de Compras

      1. Para acessar a funcionalidade de Solicitações de Compras, siga os passos abaixo:
        a. Acesse o menu principal do sistema no módulo de Compras.
        b. Navegue até "Atualizações" > "Solicitações" > Solicitações de Compras > botão "Outras Ações" >  Demanda de Produtos

      Na tela de Solicitações de Compras, você notará a presença do botão "Outras Ações". Dentro desse botão, você encontrará a opção "Demanda de Produtos". 

      Clicar nessa opção abrirá uma nova tela.


    Image Added

    Demanda de Produtos



    Image Added


    Informações na Tela

      • Uma relatório listando os produtos que possuem previsão de demanda gerada pela IA, com uma precisão de a partir de 70%.
      • Filtros que permitem personalizar a exibição da lista de produtos:
        • Código e descrição
        • Tipo de Produto
        • Grupo de Produto
        • Periodicidade

    Gráfico de Informações Detalhadas

    Ao clicar em um produto específico da lista, um gráfico detalhado será exibido.

    Esse gráfico conterá as seguintes informações:

    • Previsão de Demanda para o produto selecionado.

    Image Added

    Image Added


    O gráfico representa a previsão de demanda para um determinado produto.

    Aqui está uma explicação detalhada dos elementos:


    Image AddedTítulo: Aqui você pode ver informações sobre a periodicidade dos dados apresentados, o tipo do produto, o grupo e a descrição.
             Botão de Ativação do Intervalo de Confiança: Este botão permite ativar o intervalo de confiança na previsão. Isso significa que além da previsão pontual, é calculada uma margem de erro que representa um intervalo onde a demanda provavelmente estará, com base na confiabilidade do modelo de previsão.

    Image Added Linha Contínua (Histórico de Demanda): Esta linha mostra o histórico de demanda do produto ao longo do tempo. Cada ponto ao longo da linha representa uma data específica e a quantidade de produtos vendidos nessa data.

    Image AddedLinha Tracejada (Previsão de Demanda): Esta linha indica a previsão de demanda futura para o produto. É uma projeção baseada em dados históricos e algoritmos de previsão. Cada ponto ao longo da linha representa uma data futura e a quantidade prevista de produtos a serem demandados nessa data.

    Image AddedPontos Indicadores no Gráfico: Ao passar o mouse sobre esses pontos, você pode visualizar a quantidade de produtos previstos ou vendidos em uma data específica.

    Image AddedPercentual de Acurácia : Esse indicador mostra o percentual de acurácia da previsão. É uma medida de quão precisa é a previsão em comparação com os dados reais.

    Image AddedData de Geração do Insight de Previsão de Demanda : Esta é a data em que a previsão de demanda foi gerada. Isso ajuda a entender a atualidade e relevância das informações apresentadas no gráfico.



    As informações gráficas fornecidas são uma ferramenta valiosa para os usuários entenderem a situação do produto em relação ao estoque. Ao visualizar o histórico de demanda e a previsão futura, os usuários podem tomar decisões sobre o gerenciamento de estoque, como ajustar os níveis de inventário, planejar compras ou produção e antecipar variações na demanda. Além disso, a inclusão do intervalo de confiança e do percentual de acurácia oferece uma medida de confiabilidade nas previsões, permitindo uma avaliação mais precisa da situação do produto. Em última análise, essas informações gráficas capacitam os usuários a otimizar a gestão de estoque, garantindo que estejam preparados para atender às demandas dos clientes de forma eficiente e eficaz.



    Card
    effectDuration0.5
    idinsights-financeiro
    labelInsights Financeiro
    titleinsights-financeiro
    effectTypeslide
    Card
    effectDuration0.5
    idinsights-financeiro
    labelInsights Financeiro
    titleinsights-financeiro
    effectTypeslide

    Protheus Insights no Novo Gestor Financeiro

    Protheus Insights no NOVO GESTOR FINANCEIRO (FINA710).

    Visão Geral

    O Protheus Insights apresenta uma nova funcionalidade de Previsão de Fluxo de Caixa integrada ao já existente Novo Gestor Financeiro (FINA710), elevando o nível de valor agregado por meio da inteligência artificial. Essa adição não apenas enriquece as funcionalidades já disponíveis no Protheus, mas também demonstra o compromisso contínuo com a inovação, permitindo que as empresas aproveitem ao máximo as tecnologias mais avançadas para otimizar suas operações financeiras.

    O processo começa com a construção das séries temporais das entradas e saídas de caixa, utilizando dados da tabela de movimentações bancárias (SE5).

    Utilizando o modelo estatístico ARIMA+ ou Prophet, são identificados padrões de tendência e sazonalidade dos últimos 12 meses, permitindo a projeção das entradas e saídas de caixa para os próximos 3 meses. Com base nessas previsões, a IA identifica os períodos em que poderá haver sobra de dinheiro em caixa ou saldo insuficiente, desde que seja alcançado 50% de acuracidade na geração das previsões. Nessas situações, um alerta é enviado para o ERP, a fim de notificar o usuário em relação ao cenário previsto para o fluxo de caixa.

    Image Added

    Critériosde projeção fluxo de caixa:

    Os dados da tabela FK5 por tipo de movimentação (FK5_RECPAG) são agrupados em duas formas diferentes, mensal e semanal, depois disso é executado um treinamento de um modelo de ML que tentará encontrar um padrão na tendência de movimentação com base na série histórica (algoritmo de regressão). Um requisito importante para que seja possível a identificação desse padrão é a presença de dados em pelo menos 11 nos últimos 12 meses na tabela FK5. Dessa forma, valida-se o requisito mínimo para que a série seja incluída no treinamento.
    Após o passo de treinamento, há uma avaliação que calcula a média do erro de uma predição passada em comparação com o valor esperado. Essa diferença percentual é utilizada para o cálculo da acurácia.


    Projeção do Fluxo de Caixa

    • Visualização das movimentações de entradas e saídas em intervalos semanais e mensais.

    •  % Acurácia das entradas e saídas, são mostrados insights que tem a partir de 50% de acurácia.

    • Intervalo de confiança, é uma margem de valores que a projeção pode oferecer com 95% de certeza, por exemplo, em um determinado mês, a projeção mensal de entrada de caixa foi de 3,541M de reais com uma acurácia de 82%, porém, imagine um negócio que trabalha com uma margem apertada, seria interessante obter uma precisão um pouco melhor, mas devido as limitações do modelo, conseguimos entregar um range de valores onde garantimos que o valor exato de predição esteja dentro dessa faixa com uma certeza de 95%.

    Image Added

    Alerta

    • Alerta sobre movimentações de entradas e saídas com referência a saldo insuficiente e/ou
      saldo extra.

    • Aviso para movimentações de entradas e saídas em intervalos semanais até trimestrais.

    • Consulta de histórico dos alertas para revisão e análise retrospectiva.


    Image Added


    Instalação e Permissões de Usuários

    Antes de começar a usar Protheus Insights para a gestão de fluxo de caixa, certifique-se de que o Protheus Insights e o novo gestor financeiro foram devidamente instalados e que os usuários têm as permissões necessárias para acessá-lo e que os critériosde projeção fluxo de caixa  sejam atendidos como a  presença de dados em pelo menos 11 nos últimos 12 meses na tabela FK5.

    Acesso à Tela do novo gestor financeiro

    Para acessar a funcionalidade do novo gestor financeiro, siga os passos abaixo:

    Acesse o menu principal do sistema no módulo Financeiro.

    Navegue até "Atualizações > Gestão Financeira > Novo Gestor Financeiro".


    Menu - Movimentos

    Na tela inicial do novo gestor financeiro, você notará a presença do botão "Movimentos" no menu esquerdo. Clicar nessa opção carregar uma nova tela.

    Image Added


    Movimentações Financeiras

    Nessa nova tela, você encontrará as seguintes informações em destaque:

    Notificações de Insights:

    O Protheus Insights inclui um sistema de notificação para alertar os usuários sobre novos insights relacionados ao novo gestor financeiro. Essas notificações são exibidas no ícone de sino no topo lateral direita, juntamente com o número de notificações não lidas. Ao clicar no ícone do sino, os usuários podem acessar e analisar as notificações recentes e consultar o histórico de insights. E o requisito para que as notificações sejam mostradas é atingir, no mínimo, 50% de acurácia nas previsões.

    Gráfico de Previsões de Fluxo de Caixa:

    Esse gráfico de previsão de fluxo de caixa, utiliza o histórico de movimentações da tabela FK5 (Movimentos bancários: Registra as movimentações bancárias de títulos a receber, a pagar e individuais) para projetar as entradas e saídas futuras. É importante destacar que a geração desse gráfico leva em consideração os filtros aplicados por filiais e visões semanais e mensais já presentes no novo conciliador financeiro. O requisito para que a IA realize previsões de fluxo de caixa é ter, no mínimo, 11 semanas ou 11 meses de transações na tabela FK5, por tipo de movimentação (FK5_RECPAG). 

    Seletor para exibir o período de análise cujas possibilidades são mensal ou semanal.


    Acesso às previsões do período selecionado, no canto superior direito do gráfico de ' Previsão de Fluxo de caixa' Image Added

    Image Added

    IMPORTANTE: Os filtros como periodicidade e filtros de filiais aplicados são considerados, ao clicar no ícone de previsão de fluxo de caixa as informações retornadas são de acordo com os filtros selecionados de periodicidade e filtro de filais. 

      • O período de análise, sendo as possibilidades: Mensal e Semanal, caso selecione o filtro diário o ícone da previsão de fluxo de caixa será apresentado desabilitado pois para a previsão de fluxo de caixa estão disponíveis em modelo Mensal e Semanal.

      • Ao clicar no ícone da TOTVS no canto superior direito, por padrão, é possível selecionar filiais. Caso tenha feito esse filtro, a geração do gráfico de previsão de fluxo de caixa também considera esse filtro.

    Gráfico de Informações Detalhadas

    Ao selecionar um período específico pelo filtro Mensal ou Semanal e clicar no botão gerador de gráfico, surgirá uma versão detalhada do gráfico que contém as seguintes informações:

    • Histórico de Fluxo de Caixa de Entrada e Saída
      • Apresenta o registro detalhado das movimentações financeiras de entrada e saída ao longo do período selecionado. Essa visualização permite aos usuários entenderem o padrão de recebimentos e desembolsos ao longo do tempo.
    • Previsão de Fluxo de Caixa de Entrada e Saída
      • Mostra as projeções futuras de movimentações financeiras de entrada e saída com base nos dados históricos e algoritmos de previsão. Essa previsão ajuda os usuários a anteciparem-se a eventos financeiros e a planejarem suas atividades de forma mais precisa e eficaz.
    •  Image Added

    A linha verde contínua representa o histórico de movimentações de entrada, mostrando os valores registrados ao longo do tempo. Isso proporciona uma visão clara das tendências passadas em termos de receitas ou entradas financeiras.

    A linha verde contínua representa o histórico de movimentações de entrada, mostrando os valores registrados ao longo do tempo. Isso proporciona uma visão clara das tendências passadas em termos de receitas ou entradas financeiras.

    Da mesma forma, a linha vermelha contínua exibe o histórico de movimentações de saída, destacando os valores associados aos gastos ou despesas ao longo do período analisado.

    As linhas pontilhadas, uma verde e outra vermelha, representam as previsões futuras de movimentações financeiras. Essas projeções são baseadas em algoritmos inteligentes que consideram o histórico de movimentações, padrões sazonais e outros fatores relevantes para estimar as entradas e saídas esperadas.

    Ao posicionar o cursor sobre qualquer ponto do gráfico Image Added, será exibido um pop-up com os valores específicos para aquele período, lembrando que os pontos indicadores do gráfico representam o fim do período analisado. Exemplificando com o gráfico acima, cada ponto indica o último dia do mês, então tem-se: 

    • 31 de outubro de 2022
    • 30 de novembro de 2022
    • 31 de dezembro de 2022
    • 31 de janeiro de 2023 e assim sucessivamente.


    Informações

    Mensagens de Retorno

    Quando o gráfico não pode ser exibido, o sistema retornará uma mensagem para informar ao usuário o motivo. Essa mensagem será apresentada em um modal para facilitar a compreensão do problema. Além disso, detalhes sobre também serão registrados no console.log para fins de depuração.

    Exemplos de Mensagens de Retorno

    Aqui estão algumas mensagens de retornos possíveis que podem ser encontradas, juntamente com seus motivos correspondentes:

    Código 404 (Falta de Dados):

    • Mensagem: "Falta de dados: Não foram encontrados dados suficientes de receita e despesas para a previsão."
    • Motivo: Não foi possível localizar as despesas e receitas necessárias para prever o fluxo de caixa.

    O que você deve fazer nesse caso? Abrir um chamado no Suporte do Protheus Insights pedindo verificação da transmissão de dados entre o ERP Protheus e a plataforma Carol. Quando esta transmissão falha, os dados do ERP Protheus não são enviados à Carol e, consequentemente, os modelos de IA não são processados.  

    Se confirmado pelo Suporte que não há dados sendo transmitidos, acione a área de TI da sua empresa e comunique-lhes este fato para que restaurem a comunicação entre o ERP Protheus e a plataforma de IA Carol. 

    Código 400 (Filtro Vazio):

    • Mensagem: "Filtro Vazio: Não foram encontrados filtros para cálculo da previsão."
    • Motivo: Não foram fornecidos filtros para calcular a previsão.

    O que você deve fazer neste caso? Retornar à tela inicial do Novo Gestor Financeiro e efetuar os filtros.

    Código 404 (Dados Ausentes):

    • Mensagem: "Falta de dados: Não foram encontrados dados suficientes para a previsão."
    • Motivo: Não há dados disponíveis em nosso banco de dados.

    O que você deve fazer neste caso? Abrir um chamado no Suporte do Protheus Insights pedindo verificação da transmissão de dados entre o ERP Protheus e a plataforma Carol. Quando esta transmissão falha, os dados do ERP Protheus não são enviados à Carol e, consequentemente, os modelos de IA não são processados.  

    Se confirmado pelo Suporte que não há dados sendo transmitidos, acione a área de TI da sua empresa e comunique-lhes este fato para que restaurem a comunicação entre o ERP Protheus e a plataforma de IA Carol. 

    Código 404 (Acurácia Baixa):

    • Mensagem: "Acurácia baixa: Não foram encontrados padrões suficientes para previsão."
    • Motivo: Os dados disponíveis estão abaixo da acurácia mínima para realizar a previsão.

    O que você deve fazer neste caso? Não há atuação do usuário neste caso. 

    Código 500 (Exceção lançada - Previsão Financeira):

      • Mensagem: "Exceção lançada: Exceção na geração da previsão financeira."
      • Motivo: Ocorreu uma exceção durante a geração da previsão financeira.

    O que você deve fazer neste caso? Fechar as telas do Novo Gestor Financeiro e retornar posteriormente.


    Conclusão

    Essas informações proporcionam aos usuários uma melhor compreensão das tendências financeiras da empresa, através da análise do fluxo de caixa. Com a visualização do histórico de movimentações e das previsões futuras, os gestores podem identificar padrões, antecipar cenários e tomar decisões estratégicas mais bem fundamentadas.

    Além disso, o auxílio das projeções permite um planejamento financeiro mais eficaz, pois os usuários podem antecipar períodos de disponibilidade ou escassez de recursos e ajustar suas estratégias de acordo. Isso ajuda a mitigar riscos e otimizar o uso dos recursos financeiros da empresa, contribuindo para uma gestão mais eficiente e sustentável.



    Card
    effectDuration0.5
    idconciliador
    labelInsights Conciliador Backoffice
    effectTypeslide
    Card
    effectDuration0.5
    idconciliador
    labelInsights Conciliador Backoffice
    effectTypeslide

    Protheus Insights Conciliador Backoffice

    Protheus Insights  no CONCILIADOR BACKOFFICE (CTBA940).

    Informações
    iconfalse

    IMPORTANTE: Para utilizar as funcionalidades do Protheus Insights no Conciliador Backoffice, é necessário que o cliente já tenha o Conciliador Backoffice configurado conforme as orientações da documentação CTBA940. Além disso, é preciso aplicar um pacote disponível para clientes pilotos. Caso já utilize o Conciliador Backoffice e tenha interesse neste pacote, por favor, entre em contato com a equipe pelo e-mail [email protected], informando que já utiliza o Conciliador Backoffice e deseja utilizar as novas funcionalidades do Protheus Insights no Conciliador. Enviaremos o link para download dos pacotes. Em breve esse pacote será disponibilizado na expedição contínua.


    Requisitos para utilizar o Protheus Insights no Conciliador Backoffice

    Dica
    iconfalse

    Para utilizar o Protheus Insights com o Conciliador Backoffice, é necessário atender a alguns requisitos técnicos e de configuração.

    Um dos passos importantes nesse processo é a execução da opção 4 do WizardUUID para preenchimento dos campos MDUIDT



    Visão Geral


    O Conciliador Backoffice com o auxílio da inteligência artificial, analisa os dados não encontrados, identifica divergências e sugere a conciliação de registros, seja de forma automatizada ou com intervenção humana.

    O principal entregável da funcionalidade de “Aplicar match com Inteligência artificial” é identificar por meio de IA a conciliação dos registros não identificados automaticamente.

    Salienta-se que esta documentação tem o objetivo de apresentar a funcionalidade da nova feature de IA adicionada ao Conciliador Backoffice. Para uma compreensão mais abrangente sobre a realização da conciliação, recomenda-se utilizar a documentação completa disponível no módulo contábil, acessível através de Conciliador Backoffice (CTBA940.


    Image Added


    Como acessar a Rotina do Conciliador Backoffice com IA

    Acesse o modulo 34 Contabilidade Gerencial (SIGACTB)> Atualizações > Mcasp > Rpps > Conciliador.


    Image Added


    Selecione uma opção como no exemplo abaixo:  "0001 - Contas a Receber x Lançamentos Contábeis".

    Image Added


    Clique em "Ver Filtros"

    Image Added

    Após selecionar os filtros de acordo com sua preferência, clique em "Aplicar"


    Image Added


    Clique na aba "Dados Não Encontrados".

    Image Added

    Image Added


    Informações
    iconfalse

    o botão "Aplicar Match Inteligência Artificial", que aparecerá habilitado se houver algum match identificado pela inteligência artificial da Carol. Isso significa que ele só será habilitado se houver algum match na I16 que exista nas temporárias da tabela de origem ou destino.


    Caso o botão esteja habilitado, como na imagem abaixo, clique no botão "Aplicar Match Inteligência Artificial". Lembre-se de que não é necessário selecionar nenhum registro, pois ele será exibido na próxima tela.

    Image Added


    Uma janela modal será aberta, exibindo a quantidade de dados para Inteligência Artificial (IA) e Inteligência Artificial Divergente (ID), para avançar  clique em  "Avaliar".

    Image Added


    Na tela, serão apresentadas duas tabelas com os dados como no exemplo selecionado: 

    Contas a Receber (SE1) e Lançamentos Contábeis (CT2). Analise os dados de acordo com o status de tipo de match.
    Selecione os dados desejados para aplicar o match e clique no botão "Aplicar Match".


    Image Added


    Os dados serão atualizados e poderão ser vistos na lista com o tipo de match IA ou ID.

    Image Added


    Dica

    Observação: O PROTHEUS INSIGHTS incorpora a poderosa Inteligência Artificial (IA) para facilitar a análise de MATCH entre Contas a Receber (SE1) e Lançamentos Contábeis (CT2), conforme demonstrado anteriormente. Ao seguir os passos descritos na rotina CTBA940 do Conciliador Backoffice, você estará habilitado para realizar a conciliação contábil.

    Para uma compreensão mais abrangente sobre a realização da conciliação, recomenda-se utilizar a documentação completa disponível no módulo contábil, acessível através de Conciliador Backoffice (CTBA940) . Este passo a passo tem o objetivo de apresentar a funcionalidade da nova feature de IA do Protheus Insights adicionada ao Conciliador Backoffice.

    Card
    idfaq
    labelPerguntas Frequentes (FAQs)
    Perguntas Frequentes (FAQs)


    Expandir
    titleO que é o Protheus Insights?

    O Protheus Insights é uma solução que utiliza inteligência artificial para aprimorar seu ERP Protheus. Com a tecnologia avançada da Carol, nossa plataforma de IA, o Protheus Insights oferece análises e previsões, que permitem tomadas de decisões com confiança, impulsionando a eficiência operacional da sua empresa.

    Expandir
    titleComo a inteligência artificial é usada no Protheus Insights?

    Após a configuração do Protheus Insights, o ERP Protheus inicia o envio de dados à Plataforma Carol, por meio do job FWTECHFINJOB. 

    Com essas informações, o modelo de IA realiza análises, identifica padrões e tendências e gera projeções confiáveis que serão devolvidas ao ERP Protheus,  por meio de um outro serviço, o FWTOTVSLINKJOB,  que utiliza o Smartlink.

    No Protheus, esses insights são apresentados em forma de alertas, relatórios e gráficos, auxiliando o cliente na tomada de decisão. E esta rotina se repete todo domingo.

    Expandir
    titleComo faço para implementar o Protheus Insights em minha empresa?

    A implementação do Protheus Insights esta detalhada na pagina de configuração: Configuração

    Expandir
    titleComo o Novo Gestor Financeiro lida com saldos insuficientes ou excedentes projetados?

    Se os valores projetados estiverem fora da média histórica, é enviado um alerta ao ERP para que a situação seja corrigida.

    Expandir
    titleO que é o algoritmo ARIMA+ da Google ?

    ARIMA+ é um algoritmo criado pela google para modelagem de séries temporais.


    Dentre as suas funcionalidades podemos destacar: 

    • Componentes para modelagem de tendência e sazonalidade;
    • Ajuste de efeitos de feriados;
    • Detecção e limpeza de outliers;
    • Ajuste automático de hiperparâmetros;
    • Capacidade de trabalhar com até 100.000.000 séries temporais simultaneamente.


    Image Added

    **Imagem retirada da documentação oficial do google para referencia sobre o ARIMA+, Você pode consultar mais sobre ARIMA+ na própria documentação do Google:  ARIMA+

    Expandir
    titleComo a Inteligência Artificial Rotina Estoque - Cadastro de Produtos ajuda a evitar Rupturas de Estoque?

    A rotina começa reconstruindo o histórico de demanda a partir de movimentos e notas fiscais. Em seguida, utiliza o modelo Arima+ para prever a demanda futura. Com base nessa previsão, são feitas projeções de estoque.

    Expandir
    title que é Machine Learning (ML) e como ele se relaciona com a Inteligência Artificial (IA)?

    Machine Learning é um subcampo da Inteligência Artificial que se concentra no desenvolvimento de algoritmos capazes de aprender e fazer previsões a partir de dados. A IA, por sua vez, é um campo mais amplo que engloba diversas técnicas, incluindo o ML, para criar sistemas capazes de realizar tarefas inteligentes.

    Expandir
    titleComo Funciona o processo de Upstream de dados?

    O processo de Upstream de dados ocorre através da utilização da tecnologia Smartlink, a qual identifica as tabelas do sistema Protheus que estão associadas ao aplicativo instalado. Por exemplo, ao considerarmos o aplicativo Protheus Insights, essa identificação é realizada mediante o uso das credenciais especificadas no Wizard do produto.

    Uma vez que as tabelas relevantes são identificadas, o Wizard procede com a criação da coluna "S_T_A_M_P_" em todas as tabelas que serão submetidas ao processo de envio. Essa coluna desempenha um papel crucial no controle de registros que já foram transmitidos.

    Ao término da execução do Wizard, é automaticamente gerado um Job no scheduler, denominado "FWTECHFINJOB". Este componente assume a responsabilidade de executar a tarefa de envio das tabelas para o Smartlink.

    Os dados criptografados são encaminhados para a fila de atividades do Smartlink, que então os direciona para o ambiente exclusivo do cliente no sistema Carol, associado ao respectivo cliente Protheus.

    Image Added 

    Expandir
    titleComo funciona o processamento de Modelos de IA?

    Após a conclusão do processo de Upstream de dados para o ambiente exclusivo do cliente Protheus, os dados são replicados para um ambiente Carol centralizado que unifica todas as informações do produto. Após essa replicação, realizamos a padronização e relacionamento desses dados.

    Com os dados devidamente tratados e relacionados, procedemos à execução dos scripts de treinamento de modelos de Inteligência Artificial. Esses modelos geram previsões e as registram em tabelas de insights na plataforma Carol.

    Image Added

    Expandir
    titleComo Funciona o processo de Downstream de dados?

    Dentro da plataforma TotvsApps, operamos nosso sistema de tráfego de insights.

    Nossa aplicação TotvsApps é incumbida de executar consultas diárias aos dados produzidos pelos modelos de Inteligência Artificial, referentes ao período vigente. Após essa consulta, os dados correspondentes são registrados em uma base de dados interna na plataforma TotvsApps. Posteriormente a essa etapa, procedemos com a distribuição dos insights para os respectivos clientes por meio do SmartLink.

    O SmartLink, equiparado a uma fila para o processo de Upstream de dados, também dispõe de uma fila para o Downstream de dados, onde cada cliente é designado a uma fila exclusiva.

    Uma vez que a mensagem é enfileirada, efetuamos o consumo dessas mensagens através do cadastro do job FWTOTVSLINKJOB dentro do Protheus. Após a detecção de um novo registro proveniente do FWTOTVSLINKJOB, nossas funções internas no RPO Protheus são acionadas para a serialização dos dados e posterior gravação nas tabelas Protheus pertinentes, para posterior consumo e visualização.

    (Obs: As mensagens no SmartLink são removidas da fila somente após a confirmação de consumo e gravação pelo Protheus).

    Image Added

    Expandir
    titleO que é TotvsApps?

    A plataforma TOTVS Apps é um ecossistema projetado para acelerar os produtos cloud native da TOTVS.

    É uma plataforma referência em inovação e modernização de aplicativos na TOTVS, provendo aos times de desenvolvimento economia, segurança e autonomia para otimizar seus processos e atingir seus objetivos por meio de soluções integradas, automatizadas e simplificadas na nuvem.

    Objetivo:

    No-ops: Produtos e serviços que não dependam de pessoas dedicadas a sua estabilização e operação;

    Plug-and-play: Que a entrada de novos produtos e serviços sejam fáceis e permitam que os times de negócio foquem na velocidade de entrega de novas aplicações e funcionalidades ao mercado.

    Expandir
    titleO que é Carol?

    Criada em 2015, a TOTVS Carol é a plataforma de dados e Inteligência Artificial da TOTVS. Desenvolvida e aprimorada constantemente por nossos cientistas de dados, desenvolvedores e demais profissionais tech, a plataforma é uma solução avançada de gestão de dados, capaz de se conectar a todas as suas fontes de dados para analisar informações e apresentar resultados altamente fiéis que apoiem profissionais na tomada de decisões.

    Desta forma, a plataforma TOTVS Carol viabiliza estratégias de rastreabilidade de informações, desenvolvimento e deploy de algoritmos de machine learning, ajudando em suas previsões e também projetos de visão computacional e processamento de linguagem natural.

    Expandir
    titleO que é SmartLink?

    O Smartlink permite o recebimento e envio das mensagens entre os ERPs da TOTVS, por meio da nuvem da TOTVS. As mensagens são consumidas em fila, de forma direta, sem precisar de camadas de serviços.
    Para saber mais consulte a documentação : SmartLink - Compartilhamento de dados e eventos

    Card
    idfaq
    labelPerguntas Frequentes (FAQs)
    Perguntas Frequentes (FAQs)
    Expandir
    titleO que é o Protheus Insights?

    O Protheus Insights é uma solução avançada que utiliza inteligência artificial para otimizar processos dentro do ERP.

    Expandir
    titleComo a inteligência artificial é usada no Protheus Insights?

    A inteligência artificial é incorporada por meio da Carol, nossa IA avançada. Ela analisa dados, identifica padrões e tendências, fornecendo projeções precisas para tomada de decisões informadas.

    Expandir
    titleComo posso acessar os alertas gerados pelo Protheus Insights?

    Você pode acessar os alertas gerados pelos módulos em sua interface do Protheus Insights, onde também poderá verificar o histórico dos alertas.

    Expandir
    titleComo faço para implementar o Protheus Insights em minha empresa?

    A implementação do Protheus Insights varia de acordo com as necessidades de sua empresa. É recomendado entrar em contato com nossa equipe para um planejamento personalizado.


    Recursos Relacionados:

    Carol Inteligencia Artificial

    Conciliador Backoffice - CTBA940

    Novo Gestor Financeiro - FINA710

    Solicitação de Compras (MATA110)

    Estoque - Produtos - MATA010

    Como cadastrar um produto no Protheus - MATA010