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

Importante

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

Importante

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

Nota

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.

Nota

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:

Conheça o Meu Protheus

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

Observação

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:

Configure o Rest Protheus
Se você é cliente solicite um alias pelo Mingle ou crie pelo Assistente de Configuração Mobile.
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:

Configure o Rest Protheus
Se você é cliente solicite um alias pelo Mingle ou crie pelo Assistente de Configuração Mobile.
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.

Dica

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

Nota

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

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

Valide a permissão 174 do usuário

Inscrever no Event Viewer

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

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

Inscrição do Event Viewer

Criando o evento

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

Crie o 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.

Exemplo para envio de notificação.

#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 CHAVE	SIGNIFICADO	COR
FW_EV_LEVEL_INFO	MENSAGEM DE INFORMACÃO	CINZA
FW_EV_LEVEL_ERROR	MENSAGEM DE ERRO	VERMELHO
FW_EV_LEVEL_WARNING	MENSAGEM DE ATENÇÃO	AMARELO

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.

DISPARE A FUNÇÃO

SmartClient chamando a função

Configurando pela Web

Assistente de Configuração Mobile

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.

Funcionalidade "Validar Fontes"

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

Tela inicial

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.

Sistemas Operacionais (Versões compativeis) - Aplicativos Meu Protheus

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

Disponível em Android e IOS

QR Code Android e 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
Corporativa
App Backoffice

04. NOTAS DE VERSÃO

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

App Store Google Play Store 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.

Publicado Não Publicado

Entregas do mês	Publicação - Nova Versão
Janeiro	15 de Fevereiro
Fevereiro	15 de Março
Março	15 de Abril
Abril	15 de Maio
Maio	15 de Junho
Junho	15 de Julho
Julho	15 de Agosto
Agosto	15 de Setembro
Setembro	15 de Outubro
Outubro	15 de Novembro
Novembro	15 de Dezembro
Dezembro	15 de Janeiro

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

Expedição continua

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)

Qual o meu Usuário e Senha?

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

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

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

O que é o Alias?

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

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

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

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

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

Quais eventos eu visualizo?

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

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

Quais os status dos eventos?

Os status dos Eventos são:

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

Como compartilho um Evento?

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

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

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

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

É possível trazer informações adicionais da aprovação de pedido de compras?

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

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

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

Como sair do Aplicativo?

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

Materiais Auxiliares

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

Configurar Event Viewer

Como adicionar uma rotina de usuário no Event Viewer

Árvore de páginas

Meu Protheus: Guia de Referência - Gestão de Compras - P12

01. VISÃO GERAL

02. PRÉ-REQUISITOS MÍNIMOS

03. CONFIGURAÇÕES

04. NOTAS DE VERSÃO

05. TABELAS, PARÂMETROS E PONTOS DE ENTRADA

06. ANEXOS

07. ASSUNTOS RELACIONADOS