CONTEÚDO

01. VISÃO GERAL

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

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

Aprovações

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


Pedido de Compras

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

Quando são configuradas alçadas do tipo Pedido de Compras (PC), o comportamento padrão do aplicativo Meu Protheus é exibir um card individual para cada item do pedido.
Esse comportamento se aplica tanto às alçadas do tipo PC quanto às do tipo IP.

Observação: Caso o usuário tenha mais de um aprovador cadastrado no mesmo Grupo de Aprovação, o sistema poderá exibir o mesmo Pedido de Compras mais de uma vez, pois a listagem é realizada por documento gerado e por aprovador.

Solicitação de Compras

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de solicitação de compras.

Solicitação de Armazém

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de solicitação de Armazém (SIGAEST).

Prestação de Contas

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de prestação de contas (Controle de Viagens).

Caso o participante informado na inclusão da prestação de contas, contenha em seu cadastro o tipo "Externo", a aprovação deverá ser realizada exclusivamente pelo ERP.

Contratos

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de contratos (SIGAGCT).

Medição de Contratos

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de medições de contratos (SIGAGCT).

Eventos

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

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

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

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

Caso o usuário logado esteja integrado ao Active Directory (usuário de rede), as notificações não estarão disponíveis. Atualmente esse recurso não é suportado pelo  serviço responsável por gerenciar as notificações (Push Notification).

Os eventos possuem descrição e o nome da rotina acionada, facilitando a identificação da ação que foi disparada ao realizar determinado evento e, consequentemente, o que foi realizado na atividade.

Eles podem ser divididos em duas modalidades: 

  • Pré-definidos

São os eventos padrões configurados por meio da inscrição na rotina do Event Viewer.

Utilizando o aplicativo Meu Protheus os eventos registrados são recebidos por meio de notificações para celular (Push notifications).  

  • Personalizados

São eventos que podem ser criados especificamente para uso em rotinas customizadas.  



Multi-Filiais

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

Por definição estrutural da camada de segurança, o processo de multi-filiais possibilita configurar no máximo 160 filiais por operação. Caso tenha um número maior de filiais será necessário realizar a configuração e as aprovações estabelecendo intervalos que comportem a quantidade máxima informada.


Se você utiliza essas funcionalidades do Protheus pelo SmartClient, por meio do Aplicativo você poderá acessar essas funcionalidades em qualquer lugar na palma da mão.

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

02. PRÉ-REQUISITOS MÍNIMOS


Credenciais: É preciso um usuário e senha do Protheus (a partir da versão 12.1.17) para utilizá-lo.

Configurador: Ter a rotina Event Viewer no módulo implantada e funcional.

Lib: A lib com a funcionalidade precisa ser igual ou superior a 20180216.

Para o correto funcionamento do App Meu Protheus na Jornada de Compras, deve ser aplicado o pacote de Expedição Contínua do Mobile, por conter os fontes responsáveis pelo funcionamento do App Meu Protheus. Baixe o pacote de expedição contínua no link: Pacotes de Atualização - Mobile

Licenças: Em relação ao Meu Protheus, as requisições recebidas via Mingle seguem um tratamento diferente, onde não se utilizam de licenças TOTVS I e sim as licenças de Apps, desta forma, a lista de APIs não serão exibidas ao abrir a URL do Rest, porém pode seguir em frente com a configuração e as requisições do App serão atendidas sem problemas.   

03. CONFIGURAÇÕES


Aprovações

Para o escopo de aprovações:

  1. Configure o Rest Protheus
  2. Se você é cliente solicite um alias pelo Mingle ou crie pelo Assistente de Configuração Mobile.
  3. Processo de alçadas de Compras ou Viagens 

Eventos
O Meu Protheus pode ser utilizado tambem como um recurso para visualizar eventos do ERP , onde podemos utilizar eventos pré-definidos(padrão) ou customizados                                                    

Ambiente


Para o escopo de eventos:

  1. Configure o Rest Protheus
  2. Se você é cliente solicite um alias pelo Mingle ou crie pelo Assistente de Configuração Mobile.
  3. Preencha com o Token de acesso o parâmetro MV_MINGKEY.

    1. Acesse o módulo Configurador (SIGACFG)

    2. Acesse a rotina Base de Dados > Dicionário > Base de Dados. 
    3. Clique sobre o ícone + para expandir as opções e clique em Parâmetros.
    4. Clique sobre a lupa e pesquisar por MV_MINGKEY.
    5. Preencha nos campos Cont. Por, Cont. Ing, Cont. Esp com o Token.

                                                                                                         

                                                                                                                       



O Token será encaminhado ao solicitar o alias pelo Mingle ou pelo AppLinker .

Caso o usuário logado esteja integrado ao Active Directory (usuário de rede), as notificações não estarão disponíveis. Atualmente esse recurso não é suportado pelo  serviço responsável por gerenciar as notificações (Push Notification).

Verificar a permissão de usuário

  1. Acesse o módulo Configurador (SIGACFG)
  2. Acesse a rotina Usuário > Senhas > Usuários. 
  3. Pesquise pelo usuário que será alterado.
  4. Selecione o usuário e clique em alterar.
  5. Selecione a aba Restrições de Acesso > Aba Acessos.
  6. Habilite a permissão 174 - Acesso a inscrição nos Eventos do Event Viewer.


Inscrever no Event Viewer

  1. Acesse  Miscelânea > Inscr. Event Viewer em qualquer módulo.
  2. Clique em Incluir.
  3. Selecione o canal 002.
  4. Selecione categoria 001.
  5. Selecione o evento desejado.
  6. Selecione Sim no campo Json.

Para informações sobre o Event Viewer, clique aqui. 



Criando o evento

  1. Acesse o módulo Configurador (SIGACFG)
  2. Acesse a rotina Ambiente > Cadastro > Tabelas.
  3. Pesquise pela tabela (E3).
  4. Clique no botão Editar.
  5. Inclua o novo Evento.



Compilando e enviando notificação

Para que você receba uma notificação no Meu Protheus inserir a função EventInsert na rotina que realize o disparo da notificação. 

A seguir você verá um exemplo de como realizar esses passos. 


Os exemplos a seguir são apenas modelos para fins de estudo e visualização rápida das notificações. Procure implantar os passos se adequando ao seu negócio e necessidade. 

O código a seguir é apenas um exemplo e você poderá customizar ele da melhor forma. Segue a um exemplo do Event Insert.  

#include 'PROTHEUS.CH'

#include 'FWEVENTVIEWCONSTS.CH'

/**
* AUTOR: USER
* DATA: 00/00/0000
* HORA: 12:19
* FINALIDADE DO PROGRAMA: CRIAR EVENTO CUSTOMIZADO. LEMBRANDO QUE ESTE FONTE PRECISA SER ADIONADO NA SUA FUNCAO CUSTOMIZADA PARA QUE NO MOMENTO QUE FUNCAO SER CHAMADA EXECUTE O EVENTO  
*/

User Function MOBILE0000()

    Local cEventId := "Z00"

    Local cMensagem := "Evento enviado!"

    Local cTitulo := "Teste do Evento" + Time() //FUNCAO TIME PEGA O HORARIO ATUAL BASEADO NO S.O

    RPCSETENV("99", "01") //ABERTURA DO AMBIENTE PASSANDO OS ARGUMENTOS EMPRESA E FILIAL RESPECTIVAMENTE
    
    EventInsert(FW_EV_CHANEL_ENVIRONMENT, FW_EV_CATEGORY_MODULES, cEventId, FW_EV_LEVEL_INFO, "", cTitulo, cMensagem, .T.) //CHAMADA DO EVENTO

Return Nil

Você poderá alterar o quarto argumento passado na função EventInsert por qualquer um dos valores listados abaixo. As outras constantes mantenha pois é padrão.  

PALAVRA CHAVESIGNIFICADOCOR
FW_EV_LEVEL_INFOMENSAGEM DE INFORMACÃOCINZA
FW_EV_LEVEL_ERRORMENSAGEM DE ERROVERMELHO
FW_EV_LEVEL_WARNINGMENSAGEM DE ATENÇÃOAMARELO

Após o código fonte compilado acione a rotina. A seguir segue um exemplo para acionar a função compilada no RPO.


Existem inúmeras formas de executar uma função. Execute ela do jeito que achar melhor. 

SmartClient chamando a função

                                                                                               

                                                                                                                                      

Configurando pela Web

Conheça o Assistente de Configuração Mobile.

Com o Assistente de Configuração Mobile é possível configurar todos os passos até a utilização do app. 

O Assistente de Configuração Mobile está disponível na web. Clique aqui para acessar.  

A funcionalidade de "Validar Fontes" não está disponível no ambiente web, apenas no Protheus.

  • Na tela inicial você terá acesso aos insights (novidades / notícias) que ficarão disponíveis com conteúdo informativo sobre nossas soluções. Também é possível visualizar as aplicações que estão disponíveis para configuração no seu ambiente. 
  • Explore a aba de navegação "Funcionalidades" na página do Assistente de Configuração Mobile no TDN, para saber mais sobre o ACM (Assistente de Configuração Mobile).



Instalando no seu celular

O Meu Protheus está disponível nas duas principais lojas de distribuição de aplicativos.

Você poderá ir à loja pesquisar por Meu Protheus, clicar sobre o mesmo e instalar.

Clique sobre o ícone do seu sistema operacional para ser encaminhado para a loja. 

O Aplicativo Meu Protheus está disponível para dispositivos com sistema operacionais Andorid e IOS.

Igual ou superior Android 11
Igual ou superior IOS 13



Android

IOS

Licenças

Para usar o aplicativo Meu Protheus é necessário que sua empresa possua uma licença compatível com o uso do mesmo.
As licenças compatíveis com o uso do aplicativo Meu Protheus estão listadas abaixo:


Aplicativo Meu Protheus
TOTVS I(seleção)
Corporativa(seleção)
App Backoffice(seleção)

04. NOTAS DE VERSÃO

O cronograma de publicações de novas versões do aplicativo nas lojas oficiais seguirá conforme a tabela abaixo. 

AppleApp Store     Android Google Play Store    Expedição Continua TOTVS Expedição Contínua Mobile


Observação: 

Caso não existam atualizações dentro do mês que necessitem de uma nova versão, a publicação não será realizada. 

(seleção) Publicado  (menos) Não Publicado

Entregas do mês Publicação - Nova Versão

Apple

Android

Expedição Continua

Janeiro15 de Fevereiro(seleção)(seleção)(seleção)
Fevereiro15 de Março


Março15 de Abril


Abril15 de Maio


Maio15 de Junho


Junho15 de Julho


Julho15 de Agosto


Agosto15 de Setembro


Setembro15 de Outubro


Outubro15 de Novembro(menos)(seleção)(seleção)
Novembro15 de Dezembro(seleção)(seleção)(seleção)
Dezembro15 de Janeiro(seleção)(seleção)(seleção)


3.9.0
 - Lentidão APP Meu Protheus
 - Correção na data apresentada no histórico de compras produtos
 - Ajustes nas mensagens de Help
 - Correção dos filtros e navegação do APP 

3.9.4
- Dashboard do aprovador
- Visualização de anexos para os documentos (Solicitação de Compra, Medição de Contratos, Contratos e Solicitação ao Armazém)
- Melhorias e correções de bugs
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.4
- Dashboard do aprovador
- Visualização de anexos para os documentos (Solicitação de Compra, Medição de Contratos, Contratos e Solicitação ao Armazém)
- Melhorias e correções de bugs
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.9
- Nova página inicial com design atualizado
- Agora você pode personalizar os cards da sua tela inicial
- Nova opção para consultar rateios em pedidos e solicitações de compra
- Correções de bugs e melhorias gerais

Importante: Para ter acesso a essas novas funcionalidades, é necessário aplicar a expedição contínua do aplicativo.
Atualize para aproveitar as novidades!

3.9.9
- Nova página inicial com design atualizado
- Agora você pode personalizar os cards da sua tela inicial
- Nova opção para consultar rateios em pedidos e solicitações de compra
- Correções de bugs e melhorias gerais

Importante: Para ter acesso a essas novas funcionalidades, é necessário aplicar a expedição contínua do aplicativo.
Atualize para aproveitar as novidades!

3.9.10
Novidades da nova versão

- Descrição do centro de custo no rateio
- Novo layout na página de rateio
- Melhoria no processo de abertura de arquivos (docx)
- Melhoria no processo de aprovação quando há vários rateios por centro de custo (SC)
- Melhoria no processo de visualização do detalhe de pedido e solicitação de compra via notificação push
- Melhoria no processo de visualização dos botões de aprovação em telas de aparelhos Android
- Melhoria no processo de observação quando há caracteres especiais na descrição do motivo na aprovação/reprovação
- Correções de bugs

Para o pleno funcionamento dessa versão, é necessário aplicar a última expedição contínua do aplicativo Meu Protheus disponibilizada no portal.







3.9.0
 - Lentidão APP Meu Protheus
 - Correção na data apresentada no histórico de compras produtos
 - Ajustes nas mensagens de Help
 - Correção dos filtros e navegação do APP 

3.9.4
- Dashboard do aprovador
- Visualização de anexos para os documentos (Solicitação de Compra, Medição de Contratos, Contratos e Solicitação ao Armazém)
- Melhorias e correções de bugs
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.4
- Dashboard do aprovador
- Visualização de anexos para os documentos (Solicitação de Compra, Medição de Contratos, Contratos e Solicitação ao Armazém)
- Melhorias e correções de bugs
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.7
Novidades da nova versão
 - Melhoria nos filtros.
 - Melhoria no processo de login.
 - Correções de bugs.
Para o pleno funcionamento dessa versão é necessário aplicar a ultima expedição contínua do aplicativo Meu Protheus disponibilizada no portal.

3.9.9
- Nova página inicial com design atualizado
- Agora você pode personalizar os cards da sua tela inicial
- Nova opção para consultar rateios em pedidos e solicitações de compra
- Correções de bugs e melhorias gerais

Importante: Para ter acesso a essas novas funcionalidades, é necessário aplicar a expedição contínua do aplicativo.
Atualize para aproveitar as novidades!

3.9.9
- Nova página inicial com design atualizado
- Agora você pode personalizar os cards da sua tela inicial
- Nova opção para consultar rateios em pedidos e solicitações de compra
- Correções de bugs e melhorias gerais

Importante: Para ter acesso a essas novas funcionalidades, é necessário aplicar a expedição contínua do aplicativo.
Atualize para aproveitar as novidades!

3.9.10
Novidades da nova versão

- Descrição do centro de custo no rateio
- Novo layout na página de rateio
- Melhoria no processo de abertura de arquivos (docx)
- Melhoria no processo de aprovação quando há vários rateios por centro de custo (SC)
- Melhoria no processo de visualização do detalhe de pedido e solicitação de compra via notificação push
- Melhoria no processo de visualização dos botões de aprovação em telas de aparelhos Android
- Melhoria no processo de observação quando há caracteres especiais na descrição do motivo na aprovação/reprovação
- Correções de bugs

Para o pleno funcionamento dessa versão, é necessário aplicar a última expedição contínua do aplicativo Meu Protheus disponibilizada no portal.











05. TABELAS, PARÂMETROS E PONTOS DE ENTRADA

  • SCR (Documentos com Alçada)
  • SA2 (Fornecedores)
  • SA1 (Cliente)
  • SB1 (Descrição Genérica do Produto)
  • SC1 (Solicitações de Compra)

  • SE4 (Condição de pagamento)

  • CTT (Centro de Custo)
  • SY1 (Compradores)
  • DBM (Itens de documentos com alçada)
  • SC7 (Pedido de Compra)
  • CND (Medição de Contratos)
  • CNA (Planilha Contrato)
  • MV_MINGKEY    - Chave utilizada para autenticação no mingle no envio de informações 
  • MV_MODEDOC  - Configurar o banco de conhecimento para armazenar os arquivos no banco de dados

Nome do ponto de entrada: MPADDCPO

Objetivo: Exibe informações adicionais na pagina de detalhes do App Meu Protheus.

Documentação: Clique Aqui - Documentação MPADDCPO

06. ANEXOS

Nas aprovações de Pedido de Compra, Solicitação de Compra , Solicitação de Armazém, Contratos e Medição de Contratos, é possível ter acesso aos documentos  e imagens do banco de conhecimento anexos ao item . 

Esteja atualizado com a versão mais recente da expedição continua do mobile. 


No app Meu Protheus é possível visualizar nativamente imagens anexadas via Banco de Conhecimento.
Para os demais tipos de arquivos, como .pdf, .txt, .xlsx, dependera de recursos disponíveis no celular que entenda o respectivo arquivo.

A partir da release 12.1.2310 é possível salvar novos arquivos diretamente no banco de dados, por isso devemos nos atentar ao parametro MV_MODEDOC 

MV_MODEDOC 
1 (Salva os novos arquivos no sistema de arquivos local).
2 (Salva os novos arquivos no banco de dados)

Quando houver alterações no valor do parametro, será necessario fazer o upload do arquivo novamente , para que o app consiga visualizar o arquivo.

Mais Informações: Banco de Conhecimento

07. ASSUNTOS RELACIONADOS


Perguntas Frequentes (FAQs)


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

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

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

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

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

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

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

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

Os status dos Eventos são:

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

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

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

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

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

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

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

Materiais Auxiliares

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

Configurar Event Viewer

Como adicionar uma rotina de usuário no Event Viewer