ÍNDICE
01. VISIÓN GENERAL
Mi Protheus es una aplicación de la compañía TOTVS que tiene integración con el entorno de ERP PROTHEUS.
El alcance de la aplicación puede dividirse entre dos funcionalidades principales: Aprobaciones y eventos.
Aprobaciones
La aplicación Mi Protheus permite al usuario realizar aprobaciones de procesos ocurridos en el ERP por medio del smartphone y a continuación se listan los procesos adherentes a este mecanismo de aprobaciones.
Pedido de compras
La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de pedidos de compra de forma adherente al proceso estándar de liberación de documentos (MATA094).
Importante
Cuando se configuran pertinencias del tipo Pedido de compras (PC), el comportamiento estándar de la aplicación Mi Protheus es mostar un card individual para cada ítem del pedido.
Este comportamiento se aplica tanto para las pertinencias del tipo PC como las del tipo IP.
Observación: Si el usuario tuviera más de un aprobador registrado en el mismo Grupo de aprobación, el sistema podrá mostrar el mismo Pedido de compras más de una vez, pues la lista se realiza por documento generado y por aprobador.
Solicitação de compras
La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de solicitud de compras.
Solicitud de almacén
La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de Solicitud de almacén (SIGAEST).
Rendición de cuentas
La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de rendición de cuentas (Control de viajes).
Importante
Si el participante informado en la inclusión de la rendición de cuentas, contenga en su registro el tipo "Externo", la aprobación debe realizarse exclusivamente por el ERP.
Contratos
La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de contratos (SIGAGCT).
Medición de contratos
La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de mediciones de contratos (SIGAGCT).
Eventos
El objetivo de los eventos es permitir que el usuario pueda ser informado sobre eventos e interactuar con aprobaciones que ocurren en su entorno del ERP PROTHEUS por medio de notificaciones recibidas por la aplicación.
La aplicación tiene eventos definidos previamente en su integración con el ERP, de acuerdo con los siguientes ejemplos:
- Ver eventos que se iniciaron, terminaron o que tuvieron algún problema al procesarse por medio de notificaciones.
- Filtrar visualización de eventos.
- Procesamiento de la planilla de haberes.
- Final del recálculo del costo medio.
- Procesamiento de contabilidad.
- Aprobación del presupuesto.
- Producto alcanzó punto de pedido.
- Lote de producto vencido.
Entre muchos otros eventos que están registrados ne la tabla genérica E3 - Eventos (SX5).
Nota
Si el usuario conectado estuviera integrado al Active Directory (usuario de red), las notificaciones no estarán disponibles. Actualmente este recurso no es compatible con el servicio responsable por administrar las notificaciones (Push Notification).
Los eventos tienen la descripción y el nombre de la rutina incluida, facilitando la identificación de la acción que fue activada al realizar determinado evento, y consecuentemente, lo que se realizó en la actividad.
Estos pueden dividirse en dos modalidades:
- Definidos previamente
Son los eventos estándar configurados por medio de la inscripción en la rutina del Event Viewer.
Al utilizar la aplicación Mi Protheus los eventos registrados se receben por medio de notificaciones para celular (Push notifications).
- Personalizados
Son eventos que pueden crearse específicamente para uso en rutinas personalizadas.
Multisucursales
La aplicación Mi Protheus permite al usuario realizar aprobaciones de múltiples sucursales de los procesos ocurridos en el ERP por medio de smartphone y a continuación están listados los procesos adherentes a este mecanismo de aprobaciones.
Nota
Por definición estructural del nivel de seguridad, el proceso de multisucursales permite configurar como máximo 160 sucursales por operación. Si tuviera un número mayor de sucursales será necesario realizar la configuración y las aprobaciones estableciendo intervalos que incluyan la cantidad máxima informada.
Si usted utiliza estas funcionalidades del Protheus por el SmartClient, por medio de la Aplicación podrá acceder a estas funcionalidades en cualquier lugar en la palma de la mano.
Para conocer más sobre Mi Protheus vea el vídeo:
Conozca Mi Protheus
02. REQUISITOS PREVIOS MÍNIMOS
Credenciales: Es necesario un usuario y contraseña del Protheus (a partir de la versión 12.1.17) para utilizarlo.
Configurador: Tener la rutina Event Viewer en el módulo implantada y funcional.
Lib: La lib con la funcionalidad debe ser igual o superior a 20180216.
Para el correcto funcionamiento del App Mi Protheus en la Jornada de Compras, debe aplicarse el paquete de Expedición continua del Mobile, por contener los fuentes responsables por el funcionamiento del App Mi Protheus. Descargue el paquete de expedición continua en el enlace: Paquetes de actualización - Mobile
Observación
Licenças: Con relación a Mi Protheus, las requisiciones recibidas vía Mingle siguen un tratamiento diferente, donde no se utilizan licencias TOTVS I y sí las licencias de Apps, de esta manera, la lista de API no se mostrará al abrir la URL del Rest, sin embargo, puede seguir adelante con la configuración y las requisiciones del App se atenderán sin problemas.
03. CONFIGURACIONES
Aprobaciones
Para el alcance de aprobaciones:
- Configure el Rest Protheus
- Si usted fuera el cliente, solicite un alias por el Mingle o cree por el Asistente de configuración Mobile.
- Proceso de pertinencias de Compras o Viajes
Eventos
Mi Protheus también puede utilizarse como un recurso para ver los eventos del ERP, donde podemos utilizar eventos definidos previamente(estándar) o personalizados
Entorno
Para el alcance de eventos:
- Configure el Rest Protheus
- Si usted fuera el cliente, solicite un alias por el Mingle o cree por el Asistente de configuración Mobile.
- Complete con el Token de acceso, el parámetro MV_MINGKEY.
- Acceda al módulo Configurador (SIGACFG)
- Acceda a la rutina Base de datos > Diccionario > Base de datos.
- Haga clic sobre el ícono + para expandir las opciones y haga clic en Parámetros.
- Haga clic sobre la lupa y busque por MV_MINGKEY.
- Complete los campos Cont. Por, Cont. Ing, Cont. Esp con el Token.
Sugerencia
El Token se encaminará al solicitar el alias por el Mingle o por el AppLinker .
Nota
Si el usuario conectado estuviera integrado al Active Directory (usuario de red), las notificaciones no estarán disponibles. Actualmente este recurso no es compatible con el servicio responsable por administrar las notificaciones (Push Notification).
Verificar el permiso de usuario
- Acceda al módulo Configurador (SIGACFG)
- Acceda a la rutina Usuario > Contraseñas > Usuarios.
- Busque por el usuario que se modificará.
- Seleccione el usuario y haga clic en modificar.
- Seleccione la solapa Restricciones de acceso > Solapa Accesos.
- Habilite el permiso 174 - Acceso a la inscripción en los Eventos del Event Viewer.
Valide a permissão 174 do usuário
Inscribir en el Event Viewer
- Acceda a Miscelánea > Inscr. Event Viewer en cualquier módulo.
- Haga clic en Incluir.
- Seleccione el canal 002.
- Seleccione la categoría 001.
- Seleccione el evento deseado.
- Seleccione Sí en el campo Json.
Para informaciones sobre el Event Viewer, haga clic aquí.
Inscripción del Event Viewer
Creación del evento
- Acceda al módulo Configurador (SIGACFG)
- Acceda a la rutina Entorno > Registro > Tablas.
- Busque por la tabla (E3).
- Haga clic en la opción Editar.
- Incluya el nuevo Evento.
Crie o evento
Compilación y envío de notificación
Para que usted reciba una notificación en Mi Protheus incluya la función EventInsert en la rutina que realice la activación de la notificación.
A continuación verá un ejemplo de cómo ejecutar estos pasos.
Los siguientes ejemplos solamente son modelos para fines de estudio y visualización rápida de las notificaciones. Procure implantar los pasos adecuándose a su negocio y necesidad.
El siguiente código solamente es un ejemplo y podrá personalizarlo de la mejor manera. A continuación un ejemplo del Event Insert.
Ejemplo para envío de notificación
#include 'PROTHEUS.CH'
#include 'FWEVENTVIEWCONSTS.CH'
/**
* AUTOR: USER
* DATA: 00/00/0000
* HORA: 12:19
* FINALIDAD DEL PROGRAMA: CREAR EVENTO PERSONALIZADO. RECORDANDO QUE ESTE FUENTE DEBE INCLUIRSE EN SU FUNCIÓN PERSONALIZADA PARA QUE EN EL MOMENTO QUE LA FUNCIÓN SE ACTIVE EJECUTE EL EVENTO
*/
User Function MOBILE0000()
Local cEventId := "Z00"
Local cMensagem := "Evento enviado!"
Local cTitulo := "Prueba del evento" + Time() //FUNCIÓN EQUIPO TOMA EL HORARIO ACTUAL BASEADO EN S.O
RPCSETENV("99", "01") //APERTURA DEL ENTORNO PASANDO LOS ARGUMENTOS EMPRESA Y SUCURSAL RESPECTIVAMENTE
EventInsert(FW_EV_CHANEL_ENVIRONMENT, FW_EV_CATEGORY_MODULES, cEventId, FW_EV_LEVEL_INFO, "", cTitulo, cMensagem, .T.) //ACTIVACIÓN DEL EVENTO
Return Nil
Usted podrá modificar el cuarto argumento pasado en la función EventInsert por cualquiera de los valores listados a continuación. Mantenga las otras constantes, pues es el estándar.
PALABRA CLAVE |
SIGNIFICADO |
COLOR |
|---|---|---|
FW_EV_LEVEL_INFO |
MENSAJE DE INFORMACIÓN |
GRIS |
FW_EV_LEVEL_ERROR |
MENSAJE DE ERROR |
ROJO |
FW_EV_LEVEL_WARNING |
MENSAJE DE ATENCIÓN |
AMARILLO |
Después que el código fuente esté compilado, active la rutina. A continuación sigue un ejemplo para activar la función compilada en el RPO.
Existen innumerables formas de ejecutar una función. Ejecute esta de la forma que crea mejor.
ACTIVE LA FUNCIÓN
Configuración por medio de la Web
Asistente de configuración Mobile
Conozca el Asistente de configuración Mobile.
Con el Asistente de configuración Mobile es posible configurar todos los pasos hasta la utilización del app.
El Asistente de configuración Mobile está disponible en la web. Haga clic aquí para acceder.
Funcionalidad "Validar fuentes"
La funcionalidad "Validar fuentes" no está disponible en el entorno web, solamente en el Protheus.
Pantalla inicial
- En la pantalla inicial, tendrá acceso a los insights (novedades / noticias) que quedarán disponibles con contenido informativo sobre nuestras soluciones. También es posible visualizar las aplicaciones que están disponibles para configuración en su entorno.
- Explore la solapa de navegación "Funcionalidades" en la página del Asistente de configuración Mobile no TDN, para saber más sobre el ACM (Asistente de configuración Mobile).
Cómo instalar en su celular
Mi Protheus está disponible en las dos principales tiendas de distribución de aplicaciones.
Puede ir a la tienda para buscar por Mi Protheus, haga clic sobre este e instale.
Haga clic sobre el ícono de su sistema operativo para ser encaminado a la tienda.
Sistemas operativos (Versiones compatibles) - Aplicaciones Mi Protheus
La Aplicación Mi Protheus está disponible para dispositivos con sistemas operativos Andorid e IOS.
Igual o superior a Android 11
Igual o superior a IOS 13
Disponible en Android e IOS
QR Code Android e IOS
Licencias
Para utilizar la aplicación Mi Protheus, es necesario que su empresa tenga una licencia compatible con el uso de esta.
Las licencias compatibles con el uso de la aplicación Mi Protheus están listadas a continuación:
| Aplicación Mi Protheus | |
|---|---|
| TOTVS I |  |
| Corporativa | |
| App Backoffice | |
04. NOTAS DE VERSIÓN
El cronograma de publicaciones de nuevas versiones de la aplicación en la tiendas oficiales seguirá de acuerdo con la siguiente tabla.
App Store Google Play Store 
TOTVS Expedición continua Mobile
Observación:
Si no existieran actualizaciones dentro del mes que necesiten de una nueva versión, la publicación no se realizará.
Publicado 
No publicado
| Entregas del mes | Publicación - Nueva versión |
|
|
|
|---|---|---|---|---|
Enero |
15 de Febrero |
|
|
|
Febrero |
15 de Marzo |
|||
Marzo |
15 de Abril |
|||
Abril |
15 de Mayo |
|||
Mayo |
15 de Junio |
|||
Junio |
15 de Julio |
|||
Julio |
15 de Agosto |
|||
Agosto |
15 de Septiembre |
|||
Septiembre |
15 de Octubre |
|||
Octubre |
15 de Noviembre |
|
|
|
Noviembre |
15 de Diciembre |
|
|
|
Diciembre |
15 de Enero |
3.9.0
- Lentitud APP Mi Protheus
- Corrección en la fecha presentada en el historial de compras productos
- Ajustes en los mensajes de Help
- Corrección de los filtros y navegación del APP
3.9.4
- Dashboard del aprobador
- Visualización de archivos adjuntos para los documentos (Solicitud de compra, Medición de contratos, Contratos y Solicitud al almacén)
- Mejoras y correcciones de bugs
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.4
- Dashboard del aprobador
- Visualización de archivos adjuntos para los documentos (Solicitud de compra, Medición de contratos, Contratos y Solicitud al almacén)
- Mejoras y correcciones de bugs
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.7
Novedades de la nueva versión
- Mejora en los filtros.
- Mejora en el proceso de login.
- Correcciones de bugs.
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.7
Novedades de la nueva versión
- Mejora en los filtros.
- Mejora en el proceso de login.
- Correcciones de bugs.
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el 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
- Lentitud APP Mi Protheus
- Corrección en la fecha presentada en el historial de compras productos
- Ajustes en los mensajes de Help
- Corrección de los filtros y navegación del APP
3.9.4
- Dashboard del aprobador
- Visualización de archivos adjuntos para los documentos (Solicitud de compra, Medición de contratos, Contratos y Solicitud al almacén)
- Mejoras y correcciones de bugs
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.4
- Dashboard del aprobador
- Visualización de archivos adjuntos para los documentos (Solicitud de compra, Medición de contratos, Contratos y Solicitud al almacén)
- Mejoras y correcciones de bugs
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.7
Novedades de la nueva versión
- Mejora en los filtros.
- Mejora en el proceso de login.
- Correcciones de bugs.
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.7
Novedades de la nueva versión
- Mejora en los filtros.
- Mejora en el proceso de login.
- Correcciones de bugs.
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.7
Novedades de la nueva versión
- Mejora en los filtros.
- Mejora en el proceso de login.
- Correcciones de bugs.
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.7
Novedades de la nueva versión
- Mejora en los filtros.
- Mejora en el proceso de login.
- Correcciones de bugs.
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.7
Novedades de la nueva versión
- Mejora en los filtros.
- Mejora en el proceso de login.
- Correcciones de bugs.
Para el pleno funcionamiento de esta versión es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
3.9.9
- Nueva página inicial con diseño actualizado
- Ahora usted puede personalizar los cards de su pantalla inicial
- Nueva opción para consultar prorrateos en pedidos y solicitudes de compra
- Correcciones de bugs y mejoras generales
Importante: Para tener acceso a estas nuevas funcionalidades, es necesario aplicar la expedición continua de la aplicación.¡Actualice para aprovechar las novedades!
3.9.9
- Nueva página inicial con diseño actualizado
- Ahora usted puede personalizar los cards de su pantalla inicial
- Nueva opción para consultar prorrateos en pedidos y solicitudes de compra
- Correcciones de bugs y mejoras generales
Importante: Para tener acceso a estas nuevas funcionalidades, es necesario aplicar la expedición continua de la aplicación.¡Actualice para aprovechar las novedades!
3.9.10
Novedades de la nueva versión
- Descripción del centro de costo en el prorrateo
- Nuevo layout en la página de prorrateo
- Mejora en el proceso de apertura de archivos (docx)
- Mejora en el proceso de aprobación cuando existen varios prorrateos por centro de costo (SC)
- Mejora en el proceso de visualización del detalle de pedido y solicitud de compra vía notificación push
- Mejora en el proceso de visualización de las opciones de aprobación en pantallas de aparatos Android
- Mejora en el proceso de observación cuando existen caracteres especiales en la descripción del motivo en la aprobación/reprobación
- Correcciones de bugs
Para el pleno funcionamiento de esta versión, es necesario aplicar la última expedición continua de la aplicación Mi Protheus puesta a disposición en el portal.
05. TABLAS, PARÁMETROS Y PUNTOS DE ENTRADA
- SCR (Documentos con pertinencia)
- SA2 (Proveedores)
- SA1 (Cliente)
- SB1 (Descripción genérica del producto)
- SC1 (Solicitudes de compra)
- SE4 (Condición de pago)
- CTT (Centro de costo)
- SY1 (Compradores)
- DBM (Ítems de documentos con pertinencia)
- SC7 (Pedido de compra)
- CND (Medición de contratos)
- CNA (Planilla Contrato)
- MV_MINGKEY - Clave utilizada para autenticación en el mingle en el envío de informaciones
- MV_MODEDOC - Configurar la base de conocimiento para almacenar los archivos en la base de datos
Nombre del punto de entrada: MPADDCPO
Objetivo: Muestra informaciones adicionales en la página de detalles del App Mi Protheus.
Documentación: Haga clic aquí - Documentación MPADDCPO
06. DOCUMENTOS ADJUNTOS
En las aprobaciones de Pedido de compra, Solicitud de compra , Solicitud de almacén, Contratos y Medición de contratos, es posible tener acceso a los documentos e imágenes de la base de conocimiento adjuntos al ítem.
Expedición continua
Esté actualizado con la versión más reciente de la expedición continua del mobile.
En el app Mi Protheus es posible visualizar nativamente imágenes incluidas vía Base de conocimiento.
Para los otros tipos de archivos, como .pdf, .txt, .xlsx, dependerá de recursos disponibles en el celular que entienda el respectivo archivo.
A partir de la release 12.1.2310 es posible grabar nuevos archivos directamente en la base de datos, por eso debemos preocuparnos con el parámetro MV_MODEDOC
MV_MODEDOC
1 (Graba los nuevos archivos en el sistema de archivos local).
2 (Graba los nuevos archivos en la base de datos)
Si hubiera modificaciones en el valor del parámetro, es necesario realizar el upload del archivo nuevamente, para que el app consiga visualizar el archivo.
Más informaciones: Banco de conocimiento
07. ASUNTOS RELACIONADOS
Preguntas frecuentes (FAQ)
Materiales auxiliares
Los siguientes materiales tratan del Event Viewer del Protheus y del TOTVS Mingle:
Cómo incluir una rutina de usuario en el Event Viewer
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas