Image Removed

Informaçõestip

title	Importante

O aplicativo Protheus Event Viewer agora se chama Meu Protheus.

Painel

borderStyle	none

Column

width	80%

	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.

Aviso

title	Funcionalidade "Validar Fontes"

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

Dica

title	Central Colaborativa

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

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

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

Aviso

title	Notificações

As notificações destinadas a um único usuário serão recebidas apenas durante o último acesso. Em outras palavras, se o mesmo usuário estiver conectado em dois dispositivos simultaneamente, ele só receberá a notificação no dispositivo que foi acessado por último.

Painel

borderColor	orange
titleColor	orange
borderWidth	2
titleBGColor	white
borderStyle	solid
title	Novas funcionalidades

A partir da versão 3.6.4, O Meu Protheus terá:

Aprovação múltipla de Solicitação de Compras e Pedido de Compra
Aprovação múltipla de Medição de Contratos
Seleção de múltiplas filiais para visualização e aprovação das pendências

Atualize o Protheus com a expedição contínua do app para usufruir das novas funcionalidades.

Painel

borderStyle	none

Image Added

Deck of Cards

effectDuration	0.5
id	CABECALHO
effectType	slide

Card

default	true
effectDuration	0.5
id	MEU_PROTHEUS
label	MEU PROTHEUS
title	MEU PROTHEUS
effectType	slide

Deck of Cards

effectDuration	0.5
id	TUDO-SOBRE
effectType	slide

Card

default	true
effectDuration	0.5
id	INTRODUCAO
label	INTRODUÇÃO
title	INTRODUÇÃO
effectType	slide

Column

Introdução

Este documento possui o intuito de conscientizar os clientes, analistas e desenvolvedores, que utilizam ou que querem aderir na sua rotina de trabalho as funcionalidades que são disponibilizadas pelo App Meu Protheus.

Aqui você entenderá:

O que é o App Meu Protheus.
Entenderá o que são Eventos e Aprovações.
Como configurar todos os passos para utilizar o Meu Protheus.
Verá o escopo e as interfaces do App em pequenas demonstrações para ter melhor visibilidade do produto.

Column

Image Removed Carddefaulttrue

id
effectDuration	0.5

SOBRE

cabecalho

label

effectType

SOBRE

slide

SOBRE

Card

default	true
effectDuration	0.5
id	meu-protheus
label	Meu Protheus
title	Meu Protheus

title


effectType	slide

Image Removed

Deck of Cards

effectDuration	0.5
id	tudo-sobre
effectType	slide

Card

default	true
effectDuration	0.5
id	Introducao
label	Introdução
title	Introdução
effectType	slide

Column

Conteúdo

Este documento possui o intuito de ser um guia para os clientes, analistas e desenvolvedores, que utilizam ou que querem aderir na sua rotina de trabalho as funcionalidades que são disponibilizadas pelo aplicativo Meu Protheus.

Aqui você verá:

O que é o aplicativo Meu Protheus.
O que são eventos e aprovações.
Todos os passos para configurar e utilizar o Meu Protheus.
Verá o escopo e as interfaces do aplicativo em pequenas demonstrações para melhor visibilidade do produto.

Sobre

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

O principal objetivo do Meu Protheus é permitir com que o usuário possa ser informado sobre eventos que ocorrem no seu ambiente do ERP PROTHEUS por meio de notificações enviadas pelo aplicativo.

O aplicativo possui um escopo gerencial focado em:

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

Ou seja, se você utiliza essas funcionalidades do PROTHEUS pelo SMARTCLIENT, por meio do APP você terá condições de acessar essas funcionalidades em qualquer lugar na palma da mão.

Para conhecermos mais sobre o Meu Protheus veja o vídeo a seguir:

Card

effectDuration	0.5
id	Sobre
label	Sobre
title	Sobre
effectType	slide

Escopo

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.

Deck of Cards

id	deck-sobre
effectType	slide

Card

id	sobre-aprovacao
label	Aprovações

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.

Card

id	sobre-pedido-de-compra
label	Pedido de Compras

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

Card

id	sobre-solicitacao-de-compra
label	Solicitação de Compras

Solicitação de Compras

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

Card

id	sobre-prestacao-de-contas
label	Prestação de Contas

Prestação de Contas

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

Card

id	sobre-medicao-de-contratos
label	Medição de Contratos

Medição de Contratos

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

Card

id	sobre-eventos
label	Eventos

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

Aviso

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

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:

Painel

borderStyle	none
title	Conheça o Meu Protheus

Column

width	500

Conector de Widget

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

A seguir você pode encontrar mais informações sobre o as funcionalidades do aplicativo.

Painel

borderStyle	none
title	VIDEO MEU PROTHEUS

Column

width	500

Conector de Widget

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

Column

width	50

Deck of Cards

effectDuration	0.5
id	FUNCIONALIDADES
effectType	slide

Card

default	true
effectDuration	0.5
id	EVENTOS
label	EVENTOS
title	EVENTOS
effectType	slide

Eventos

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

Os eventos podem ser divididos em duas modalidades:

Pré-definidos

São os eventos padrões que são configurados por meio da inscrição do EVENT VIEWER. O EVENT VIEWER registra os eventos que são pré-definidos ocorridos no PROTHEUS enviados por e-mail ou rss.

Personalizados

São os eventos que são customizados. Aderente a qualquer rotina customizada.

Card

default	true
effectDuration	0.5
id	APROVACOES
label	APROVAÇÕES
title	APROVAÇÕES
effectType	slide

Aprovações

As Aprovações são como documentos que precisam de autorização de um órgão superior para serem continuados. Exemplo:

Suponha que um produto tenha atingido o limite máximo no estoque e tenha acionado o pedido de compra.

Pelo Meu Protheus poderá ser liberado a ordem de pedido de compra por meio de uma aprovação.

Caso não seja uma atividade válida o usuário poderá reprovar a solicitação.

Pode-se ver que isso trás uma facilidade muito maior para os usuários do PROTHEUS que agora poderão utilizar o sistema sem estarem conectados via SMARTCLIENT.

Card

default	true
effectDuration	0.5
id	CONFIGURACAO
label	CONFIGURAÇÃO
title	CONFIGURACAO
effectType	slide

Configuração.

O Meu Protheus é mais uma forma que os usuários têm de conseguirem utilizar o ERP PROTHEUS. Por esse motivo é necessário que se crie as configurações necessárias para que exista a integração entre App e o ambiente.

Para conhecermos mais sobre essa configuração veja o vídeo a seguir:

Painel

borderStyle	none
title	VIDEO ENTENDENDO CONFIGURAÇÕES

Column

width	500

Conector de Widget

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

Column

width	50

Image Removed

Deck of Cards

effectDuration	0.5
id	EVENTOS
effectType	slide

CarddefaulttrueeffectDuration0.5idEVENTO-CUSTOMIZADOlabelEVENTO CUSTOMIZADOtitleEVENTO CUSTOMIZADOeffectTypeslide

CONFIGURACAO_MECANISMO

Deck of Cards

id
effectDuration	0.5

Funcionalidades
effectType	slide

AMBIENTE_PROTHEUSAMIBIENTE PROTHEUSAMBIENTE PROTHEUS

Card

id
default	true
effectDuration	0.5

label
Eventos

title
Eventos

Eventos
effectType	slide

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.

Card

effectDuration	0.5
id	Aprovacoes
label	Aprovações
title	Aprovações
effectType	slide

Suponha que um colaborador tenha realizado o fluxo de prestação de contas e essa prestação está pendente para analise.

Pelo Meu Protheus, poderá ser analisado e escolher entre aprovar ou reprovar esse registro.

Aviso

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

Card

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

Passo a passo de configuração

O Meu Protheus é 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.

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

Aviso

title	Pré-Requisitos

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.

Dica

title	Suporte

Para uso antes da liberação de janeiro/2018 do Protheus entre em contato com o suporte da TOTVS e solicite o pacote para atualização do ambiente via UPDDISTR.

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.

Deck of Cards

effectDuration	0.5
id	Container
effectType	slide

Card

default	true
effectDuration	0.5
id	padrao
label	Padrão
title	Padrão
effectType	slide

Deck of Cards

effectDuration	0.5
id	configuracao-2
effectType	slide

Card

default	true
effectDuration	0.5
id	ambiente-protheus
label	Ambiente Protheus
title	Ambiente Protheus
effectType	slide

Aprovações

Para o escopo de aprovações (Pedido de Compras e Prestação de Contas) não existe nenhuma configuração adicional, bastando apenas que o ambiente esteja provisionado (REST configurado e ALIAS do Mingle gerado).

Após o ambiente configurado, basta que o usuário que é um Aprovador acesse o aplicativo e o mesmo irá visualizar os itens que estão pendentes de sua análise, podendo ser Pedido de Compras ou Prestação de Contas.

Para configurar o envio de notificações do ERP para o aplicativo, siga as instruções abaixo. Observando que os passo abaixo NÃO SÃO obrigatórios para o funcionamento do escopo de aprovações.

Configurando o seu ambiente

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

Painel

borderStyle	none
title	Preencha o parâmetro MV_MINGKEY

Image Added

Card

default	true
effectDuration	0.5
id	configuracao-usuario
label	Configuração do usuário
title	Configuração do usuário
effectType	slide

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.

Painel

borderStyle	none
title	Valide a permissão 174 do usuário

Image Added

Card

default	true
effectDuration	0.5
id	event-viewer
label	Event Viewer
title	Event Viewer
effectType	slide

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.

Painel

borderStyle	none
title	Inscrição do Event Viewer

Image Added

Card

default	true
effectDuration	0.5
id	customizado
label	Customizado
title	Customizado
effectType	slide

Deck of Cards

effectDuration	0.5
id	configuracao
effectType	slide

Card

default	true
effectDuration	0.5
id	ambiente-protheus
label	Ambiente Protheus
title	Ambiente Protheus
effectType	slide

Configurando o seu ambiente

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

Painel

borderStyle	none
title	Preencha o parâmetro MV_MINGKEY

Image Added

Card

default	true
effectDuration	0.5
id	criacao-evento
label	Criação do evento
title	Criação do evento
effectType	slide

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.

Card documentos

Informacao	Para eventos customizados, recomenda-se utilizar o padrão de nomear o código do evento iniciando com a letra <b>Z</b>
Titulo	Importante

Painel

borderStyle	none
title	Crie o evento

Image Added

Card

default	true
effectDuration	0.5
id	configuracao-usuario
label	Configuração do usuário
title	Configuração do usuário
effectType	slide

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.

Painel

borderStyle	none
title	Valide permissão 174 do usuário

Image Added

Card

default	true
effectDuration	0.5
id	event-viewer
label	Event Viewer
title	Event Viewer
effectType	slide

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.

Painel

borderStyle	none
title	Inscrição do Event Viewer

Image Added

Card

default	true
effectDuration	0.5
id	notificacao
label	Notificação
title	Notificação
effectType	slide

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.

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

Deck of Cards

effectDuration	0.5
id	notificacoes
effectType	slide

Card

default	true
effectDuration	0.5
id	Compilando
label	Compilando
title	Compilando
effectType	slide

Para funções customizadas você deverá adicionar algumas linhas de código.

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

Bloco de código

language	js
theme	RDark
firstline	0
title	Exemplo para envio de notificação.
linenumbers	true

#include 'PROTHEUS.CH'

#include 'FWEVENTVIEWCONSTS.CH'

/**
* AUTOR: GABRIEL GAMELEIRA DOS SANTOS
* DATA: 29/09/2020
* 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

Dica
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

Card

default	true
effectDuration	0.5
id	chamando-evento
label	Chamando o evento
title	Chamando o Evento
effectType	slide

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

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

Painel

borderStyle	none
title	DISPARE A FUNÇÃO

SmartClient chamando a função Image Added

Card

id	acm
label	ACM
title	ACM
class	Principal
effectType	slide

Configurando pela Web

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

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

Painel

borderStyle	none
title	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 disponiveis 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).

Image Added

Card

effectDuration	0.5
id	instalacao
label	Instalação
title	Instalação
effectType	slide

Instalando no seu celular

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

Você poderá ir na 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.

Painel

borderStyle	none
title	Disponível em Android e IOS

Column

width	250

Image Added

Column

width	250

Image Added

Painel

borderStyle	none
title	QR Code Android e IOS

Column

width	250

Image Added

Column

width	250

Image Added

Card

effectDuration	0.5
id	funcionalidades-interfaces
label	Funcionalidades e Interfaces
title	Funcionalidades e Interfaces
effectType	slide

Deck of Cards

effectDuration	0.5
id	todas-funcionalidades
effectType	slide

Image Removed

Card

default	true
effectDuration	0.5
id	acesso
label	Acesso
title	Acesso
effectType	slide

Acesse o seu ambiente

Para realizar o seu acesso utilize:

Usuário
Senha
Alias

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

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

Verificar permissão usuário.

Acessar o módulo Configurador (SIGACFG)
Acessar a rotina Usuário > Senhas > Usuários.
Pesquisar pelo usuário que será alterado.
Abrir a aba Restrições de Acesso > Aba Acessos.
Habilitar a permissão 174.

Painel

borderStyle	none
title	Acesso

Criando o evento.

Acessar o módulo Configurador (SIGACFG)
Acessar a rotina Ambiente > Cadastros > Tabelas.
Pesquisar pela tabela “E3”.
Clicar no botão “Editar”.
Incluir o novo evento.

Column

width	500

Tela de acesso Image Added

Configurando o seu ambiente.

Configurar REST PROTHEUS
Se você é cliente crie um Alias no MINGLE. Se você é TOTVER crie um APPLINKER.
Preencher o parâmetro MV_MINGKEY (Token de acesso).
Reiniciar o APPSERVER com o serviço REST que está de rodando.

Card

default	true
effectDuration	0.5
id	CRIACAO-EVENTO
label	CRIAÇÃO DO EVENTO
title	CRIAÇÃO DO EVENTO
effectType	slide

Painel

borderStyle	none
title	ILUSTRAÇÃO DE INCLUSÃO DE EVENTO

Column
Image Removed

Card

default	true
effectDuration	0.5
id	CONFIGURACAO-USUARIO
label	CONFIGURAÇÃO DO USUÁRIO
title	CONFIGURAÇÃO DO USUÁRIO
effectType	slide

Painel

borderStyle	none
title	ILUSTRAÇÃO DE VALIDAÇÃO DE PERMISSÃO DE USUÁRIO

Column
Image Removed

Card

default	true
effectDuration	0.5
id	INSCRICAO-USUARIO
label	INSCRIÇÃO DO USUÁRIO
title	INSCRIÇÃO DO USUÁRIO
effectType	slide

Inscrever Event Viewer.

Acessar em qualquer módulo, Miscelânea > Inscr. Event Viewer.
Selecionar o canal “002”.
Selecionar categoria “001”.
Selecionar o evento que o usuário.
Selecionar Sim no campo Json.

Se desejar poderá olhar aqui a documentação completa de EVENT VIEWER.

Painel

borderStyle	none
title	ILUSTRAÇÃO DE VALIDAÇÃO DE PERMISSÃO DE USUÁRIO

ENVIOMENSAGEM

Enviar mensagem.

Para funções customizadas você deverá compilar um no RPO o seguinte código.

Card

id
default	true
effectDuration	0.5

solicite-

alias
label	Solicite um alias
title	Solicite um Alias
effectType	slide

Peça um alias

Por meio do aplicativo, na tela de acesso é possível solicitar um alias. Para solicitar um alias clique sobre Solicitar Alias. Será exibido uma tela solicitando:

Nome
Nome da empresa
E-mail
Telefone

Todos os campos solicitados serão utilizados para entrarmos em contato com os clientes que precisam de um alias e que não fizeram seu cadastro por meio do Mingle.

ENVIO DA MENSAGEM

title

ENIVO DE MENSAGEM

effectType

slide

Painel

borderStyle	none
title	Solicite um alias

Image Removed

Column

width	500

Tela de solicitação de Alias Image Added

title

ILUSTRAÇÃO DE CÓDIGO PARA COMPILAR

Card

default	true
effectDuration	0.5
id	EVENTO-PADRAOfilial
label	EVENTO PADRÃOFilial
title	EVENTO PADRÃOFilial
effectType	slide

Deck of Cards

effectDuration	0.5
id	EVENTO-PADRAO
effectType	slide

Card

default	true
effectDuration	0.5
id	AMBIENTE_PROTHEUS
label	AMIBIENTE PROTHEUS
title	AMBIENTE PROTHEUS
effectType	slide

Card

default	true
effectDuration	0.5
id	CONFIGURACAO-USUARIO
label	CONFIGURAÇÃO DO USUÁRIO
title	CONFIGURAÇÃO DO USUÁRIO
effectType	slide

Escolha a filial

Após o acesso, escolha uma filial.

Caso deseje filtrar uma filial da lista de filiais, você poderá encontrar uma filial pesquisando pelo código ou pelo nome no campo de busca.

Painel

borderStyle	none
title	Escolha uma filial

Column

width	500

Image Added{

INSCRICAO-USUARIOINSCRIÇÃO DO USUÁRIOINSCRIÇÃO DO USUÁRIO

Card

id
default	true
effectDuration	0.5

label
Eventos

title
Eventos

Eventos
effectType	slide

Aviso

title	CREDENCIAIS

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

Visualize e interaja com eventos

Com a filial escolhida, você terá acesso aos eventos que ocorrem no seu ambiente do ERP Protheus. Para acessar os Eventos clique na guia de Eventos

Aviso

title	CONFIGURADOR

Ter a rotina EVENT VIEWER do módulo Configurador implantada e funcional.

Aviso

title

LIB

A lib com a funcionalidade precisa ser igual ou superior a 20180216;

Dica

title	SUPORTE

Para uso antes da liberação de janeiro/2018 do Protheus é necessário entrar em contato com o SUPORTE da TOTVS e solicitar o pacote para atualização do ambiente via UPDDISTR.

Card

default	true
effectDuration	0.5
id	INTERFACE
label	FUNCIONALIDADES E INTERFACES
title	FUNCIONALIDADES
effectType	slide

Importante

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

Informações

title	Duração das notificações no app

Atualmente o aplicativo Meu Protheus armazena as notificações por tempo limitado. Ao completar um mês em que uma notificação chegou no app e foi armazenada na aba "Eventos", ela é desprezada/deletada. Esse comportamento preza por manter a área de notificações (Eventos) mais limpa e organizada, sem necessitar que essa limpeza seja feita pelo usuário frequentemente.

Deck of Cards

Deck of Cards

effectDuration	0.5
id	TODAS_FUNCIONALIDADES
effectType	slide

trueACESSOSOLICITAR-ALIASSOLICITAR ALIASSOLICITAR ALIAS

Card

default

id
effectDuration	0.5

ACESSO

label

ACESSO

title

teste
effectType	slide

Acessando o seu ambiente.

Para realizar o seu acesso utilize:

Usuário
Senha
Alias

Nos campos Usuário e Senha deverá ser informado os mesmos dados que você utiliza quando acessa o seu ambiente no ERP PROTHEUS via SMARTCLIENT.

No campo Alias informe o seu identificador no MINGLE ou APPLINKER.

Card

default	true
effectDuration	0.5
id	visualize
label	Visualize
title	Visualize
effectType	slide

Para apresentar mais informações sobre um evento clique sobre a seta para expandir mais informações sobre o evento.

Column

width	500

Image Added{

Painel

borderStyle	none
title	ILUSTRAÇÃO DE ACESSO

Image Removed

Column

width	500

Column

width	50

Image Removed

Card

id
default	true
effectDuration	0.5

label
Filtros

title
Filtros

effectType
Filtros

	slide

Para filtrar um evento clique sobre o funil e escolha a sua condição. É possível realizar o filtro de eventos pelas seguintes condições:

Nome da rotina
Mensagem
Titulo
Período
Criticidade
Tipo do evento

Column

width	500

Image Added{

Card

default	true
effectDuration	0.5
id	Compartilhe
label	Compartilhe
title	Compartilhe
effectType	slide

Para compartilhar um Evento, clique sobre o ícone de compartilhar. Assim que realizar o clique será apresentada a tela de aplicativos que podem ser utilizados para compartilhá-lo.

Column

width	500

Image Added

{

slide

Solicitando um Alias.

Por meio do aplicativo, na tela de acesso é possível solicitar um Alias. Para solicitar um Alias clique sobre Image Removed. Será exibido uma tela solicitando:

Nome
Nome da empresa
E-mail
Telefone

Todos os campos solicitados serão utilizados para entrarmos em contato com os clientes que precisam de um Alias e que não fizeram seu cadastro por meio do MINGLE.

Painel

borderStyle	none
title	ILUSTRAÇÃO DE SOLICITAÇÃO DE ALIAS

Image Removed

Column

Image Removed

Card

default	true
effectDuration	0.5

id

FILIAL

label

FILIAL

title

FILIAL

effectType

slide


id	Links
label	Links
title	Links
effectType	slide

Caso existam links envolvidos no corpo do evento, você poderá clicar sobre o link desejado e ser redirecionado para a página.

Column

width	500

Image Added

{

Escolha uma Filial.

Após o acesso, escolha uma Filial.

Caso deseje filtrar uma Filial da lista de filiais, você poderá encontrar uma Filial pesquisando pelo código ou pelo nome no campo de busca Image Removed.

Painel

borderStyle	none
title	ILUSTRAÇÃO DE COMO ESCOLHER UMA FILIAL

Image Removed{

Column

Image Removed

Card

default	true
effectDuration	0.5
id	EVENTOScard-aprovacoes
label	EVENTOSAprovações
title	EVENTOSAprovações
effectType	slide

Aprove ou reprove

Com a Filial filial escolhida, você terá acesso aos Eventos que ocorrem no seu registros de aprovações que aguardam por sua ação no ambiente do ERP PROTHEUS. Os eventos são exibidos logo após a escolha da Filial. Caso você mude para Aprovações e deseje voltar para Protheus. Para ter acesso a lista de eventos clique no ícone Image Removed.aprovações clique na guia Aprovações.

Nas abas 'Pendentes', 'Aprovados ' e 'Reprovados' é possível visualizar:

teste

Para filtrar um evento clique sobre o ícone Image Removed e escolha a sua condição para filtrar os eventos. É possível realizar o filtro de eventos pelas seguintes condições:

Nome da rotina
Mensagem
Titulo
Período
Criticidade
Tipo do evento

Image Removed{

Deck of Cards

id	types

Painel

borderStyle	none
title	ILUSTRAÇÃO DE VISUALIZAÇÃO DE EVENTOS

Deck of Cards

effectDuration

0.5

id


effectType	slide

0.5VISUALIZAREVENTOS

Para obter mais detalhes sobre um evento clique sobre o ícone Image Removed para expandir mais informações sobre o evento.

Image Removed{

Card

default

true

effectDuration

id

pedido-de-

label
compra

VISUALIZAR EVENTOS

title

VISUALIZAR EVENTOS

effectType

slide

Column

Column
Image Removed

Card

default	true
effectDuration	0.5
id	FILTRAR-EVENTOS
label	FILTRAR EVENTOS
title	FILTRAR EVENTOS
effectType	slide

Column

Column
Image Removed

Card

default	true
effectDuration	0.5
id	APROVACOES
label	APROVAÇÕES
title	APROVAÇÕES
effectType	slide

Aprovações.

Com a Filial escolhida, você terá acesso as Aprovações que ocorrem no seu ambiente do ERP PROTHEUS. Para ter acesso a lista de aprovações clique no ícone Image Removed.

Ao clicar sobre um item na lista de Aprovações você terá duas opções:

Aprovar
Reprovar

Para qualquer uma das situações o Aprovador terá que justificar o motivo da sua escolha.

Painel

borderStyle	none
title	ILUSTRAÇÃO DE APROVAÇÕES

Column
Image Removed

Column
Image Removed

Card

default	true
effectDuration	0.5
id	USUARIO
label	ÚSUARIO
title	ÚSUARIO
effectType	slide

Usuário.

Você poderá ver algumas informações importantes do seu usuário enquanto estiver acessando seu ambiente.

Usuário
Cliente
Empresa
Set
Filial

Painel

borderStyle	none
title	ILUSTRAÇÃO DE ACESSO AS INFORMAÇÕES DE USUÁRIO

Column
Image Removed

Column
Image Removed

Card

default	true
effectDuration	0.5
id	ALERTAS-ERROS
label	ALERTAS E ERROS
title	ALERTAS-ERROS
effectType	slide

Card

default	true
effectDuration	0.5
id	SUPORTE
label	SUPORTE
effectType	slide

Pedido de Compra

Pedidos de Compra
- Informações do card
  - Filial, núm. do pedido, fornecedor, condição de pagamento, data de emissão, comprador e valor total (soma do valor de cada item - SC7);
- Informações da página de Detalhes
  - Núm. do pedido, comprador, valor total
  - Itens do pedido: Descrição do produto (B1_DESC), c. de custo, quantidade, un. de medida, valor unit. e valor total;
    - Ver mais: Data de entrega, quantidade entregue e campos adicionais via ponto de entrada MT094CPC;
    - Anexos: Imagens e / ou PDFs anexados via Banco de Conhecimento. Recomendável que o tamanho do arquivo não exceda 5mb;
    - Histórico: Histórico de compras do produto, mostrando a data em que foi comprado, com qual fornecedor, quantidade e preço por unidade;

Card

id	solicitacao-de-compra
label	Solicitação de Compra

Solicitações de Compras
- Informações do card
  - Filial, núm. da solicitação, data da solicitação, c. de custo, solicitante e valor total (soma do valor de cada item pela SCR);
- Informações da página de Detalhes
  - Núm. da solicitação, data da solicitação, grupo de aprovação e valor total;
  - Itens da solicitação: Descrição do produto (B1_DESC), c. de custo, quantidade, unidade de medida e valor;
    - Histórico: Histórico de compras do produto, mostrando a data em que foi comprado, com qual fornecedor, quantidade e preço por unidade;

Card

id	prestacao-de-conta
label	Prestação de Contas

Prestações de Contas do tipo Viagem e Avulsa
- Informações do card
  - Núm. da prestação de contas, participante, c. de custo, data de início, data final, motivo e valor total (soma de cada despesa pela FLE);
- Informações da página de Detalhes
  - Núm. da prestação de contas, participante, data de início, data final, valor reembolsável e valor não reembolsável;
  - Itens de despesa: Data da despesa, descrição da despesa, local, quantidade e valor total;
    - Anexo: Imagem do comprovante de despesa;
    - Image Added: Alerta de que a despesa teve um custo elevado baseado na região;

Card

id	medicao-de-contratos
label	Medição de Contratos

Medições de contratos
- Informações do card
  - Núm. da medicão, filial, núm. do contrato, data da competencia, núm. da planilha, valor;
- Informações da página de Detalhes
  - Núm. da medicão, filial, núm. da planilha, data da jurisdição, valor e descrição;
  - Itens da solicitação: Descrição do produto (B1_DESC), c. de custo, quantidade, unidade de medida e valor;
    - Histórico: Histórico do produto, mostrando a data de entrega, quantidade e preço por unidade;

Aviso

title	Sobre Aprovados e Reprovados

Hoje somente não é possível visualizar na aba de "Aprovados" e "Reprovados", as Medições de Contrato. Estamos trabalhando para que tenhamos esta funcionalidade disponível em breve.

Deck of Cards

id	aprovacao-simples
effectType	slide

Card

label	Aprovação Por Filial

Painel

borderStyle	none
title	Aprovação Por Filial

Ao clicar sobre um item na lista de itens Pendentes, você pode aprovar ou reprovar a operação.

Independente da ação selecionada, uma tela solicitando uma justifica será apresentada.

Column

width	500

Image Added

Card

label	Aprovação Multifilial

Dica

title	Aprovação Multifilial

Na aprovação Multifilial o usuário pode fazer a aprovação de multiplos documentos de um mesmo TIPO.
Exemplo: Ao fazer o filtro de multiplas filiais e o usário selecionar o documento do tipo Pedidos de Compra, todas as Solicitações de Compra e Medições de Contratos serão desabilitados para seleção, seguindo essa mesma regra para os demais tipos.

Aviso

title	Aviso

Observação importante: Essa nova funcionalidade não inclui filtro de multifiliais e nem a provação de multiplos documentos do tipo Prestações de Contas

Painel

title	Aprovação Multifilial

Ao clicar no Icone no canto superior direito de multifilial e selecionar as filiais desejadas, serão listados todos os documentos (Pedidos de Compras, Solicitações de Compras e Medições de Contratos) pendentes de aprovações, com exceção de prestações de contas, que não é contemplada com essa nova funcionalidade.

Image Added

Painel

title	Aprovação de Multiplus Documentos

Ao selecionar as filiais desejada, será listado todos os documentos pendentes de aprovação (Pedidos de Compras, Solicitações de Compras e Medições de Contratos), podendo ser selecionado vários documentos de um mesmo tipo.

Exemplo: Ao selecionar PEDIDO DE COMPRA, as opções de SOLICITAÇÃO DE COMPRA E MEDIÇÃO DE CONTRATOS serão desabilitados.

Column

width	500

Image Added

Card

default	true
effectDuration	0.5
id	Anexos
label	Anexos
title	Anexos
effectType	slide

Anexos

Nas aprovaçōes de pedido de compra e solicitação de compras, é possível ter acesso aos documentos e imagens anexos ao item.

Aviso

title	Expedição continua

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

Deck of Cards

effectDuration	0.5
id	teste
effectType	slide

Card

default	true
effectDuration	0.5
id	visualize
label	Visualizando os anexos
title	Visualize os anexos
effectType	slide

Para apresentar os anexos clique sobre "Anexos" para visualizar a lista de documentos do item.

Column

width	500

Image Added

{

Column

width	500

Image Added

{

Suporte

Perguntas Frequentes (FAQs)

Expandir

title	Qual o meu Usuário e Senha?

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

Expandir

title	O que é o Alias?

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

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

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

Expandir

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

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

Expandir

title	Quais eventos eu visualizo?

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

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

Expandir

title	Quais os status dos eventos?

Os status dos eventos são:

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

Expandir

title	Como compartilho um Evento?

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

Expandir

title	Como sair do Aplicativo?

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

Materiais Auxiliares

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

Configurar Event Viewer

Como adicionar uma rotina de usuario no Event Viewer

Acesso Aplicativos Móveis

Card

id
default	true
effectDuration	0.5

DESENVOLVEDORES

label
usuario

DESENVOLVEDORES

title
Usuário

DESENVOLVEDORESslide

Usuário
effectType	slide

Deck of Cards

Perfil

Apresenta dados importantes sobre a conexão do aplicativo com o ambiente Protheus.

Usuário
Cliente
Empresa
Set
filial

effectDuration

0.5

id

EQUIPE

effectType

paneltitleColorlaranjaborderStylenone

Painel

borderStyle	none

title

Acesso Perfil

Column

width

column

500

Tela de perfil Image Added

Image Removed

Column
Image Removed

Painel

borderStyle	none

Column
Image Removed

Column
Image Removed

Painel

borderStyle	none

Column
Image Removed

Column
Image Removed

Painel

borderStyle	none

Column
Image Removed

Column
Image Removed

HTML

<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style>

HTML

<style>

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:link, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:visited, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:focus, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:hover, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:active {
color: white;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after {
background: white; !important}

Card

default	true
effectDuration	0.5
id	Suporte
label	Suporte
effectType	slide

Perguntas Frequentes (FAQs)

Expandir

title	Qual o meu Usuário e Senha?

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

Expandir

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

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

Expandir

title	O que é o Alias?

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

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

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

Expandir

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

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

Expandir

title	Quais eventos eu visualizo?

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

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

Expandir

title	Quais os status dos eventos?

Os status dos Eventos são:

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

Expandir

title	Como compartilho um Evento?

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

Expandir

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

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

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

Expandir

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

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

Expandir

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

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

Expandir

title	Como sair do Aplicativo?

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

Materiais Auxiliares

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

Configurar Event Viewer

Como adicionar uma rotina de usuário no Event Viewer

Acesso Aplicativos Móveis

Composition Setup

deck.tab.inactive.background = #e7e7e7 deck.tab.active.background = #252626

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 323

Nova versão 559

Chave

Introdução

Conteúdo

Escopo

Sobre

Eventos

Aprovações

Configuração.

Passo a passo de configuração

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

Aprovações

Verificar a permissão de usuário

Inscrever no Event Viewer

Configurando o seu ambiente

Criando o evento

Verificar a permissão de usuário

Inscrever no Event Viewer

Compilando e enviando notificação

Para funções customizadas você deverá adicionar algumas linhas de código.

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

Configurando pela Web

Instalando no seu celular

Acesse o seu ambiente

Para realizar o seu acesso utilize:

Configurando o seu ambiente.

Criando o evento.

Verificar permissão usuário.

Peça um alias

Por meio do aplicativo, na tela de acesso é possível solicitar um alias. Para solicitar um alias clique sobre Solicitar Alias. Será exibido uma tela solicitando:

Enviar mensagem.

Escolha a filial

Após o acesso, escolha uma filial.

Visualize e interaja com eventos

Acessando o seu ambiente.

Solicitando um Alias.

Escolha uma Filial.

Aprove ou reprove

Aprovações.

Usuário.

Anexos

Suporte

Perguntas Frequentes (FAQs)

Perfil

Materiais Auxiliares