Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
ÍNDICE

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

Deck of Cards
iddeck-sobre
Card
idsobre-aprovacao
labelAprobaciones

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.


Deck of Cards
iddeck-aprovacoes
Card
idaprovacoes-pedido-de-compras
labelPedido de compras

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


Informações
titleImportante

Cuando están configuradas pertinencias del tipo Pedido de compras (PC), el comportamiento estándar de la aplicación Mi Protheus es mostar un card para cada ítem existente en el pedido.
Este comportamiento ocurre tanto para las pertinencias donde el tipo es PC o IP.

Card
idaprovacoes-solicitacao-de-compras
labelSolicitud de compras

Solicitação de compras

La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de solicitud de compras.

Card
idaprovacoes-solicitacao-de-armazem
labelSolicitud de almacén

Solicitud de almacén

La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de Solicitud de almacén (SIGAEST).

Card
idaprovacoes-prestacao-de-contas
labelRendición de cuentas

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

Aviso
titleImportante

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.

Card
idaprovacoes-de-contratos
labelContratos

Contratos

La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de contratos (SIGAGCT).

Card
idaprovacoes-medicao-de-contratos
labelMedición de contratos

Medición de contratos

La aplicación Mi Protheus permite el análisis (Aprobación / Reprobación) de mediciones de contratos (SIGAGCT).

Card
idsobre-eventos
labelEventos

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

Aviso
titleNota

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

Dica

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 

Card
idsobre-mult
labelMultisucursales

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.

Aviso
titleNota

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


Painel
borderStylenone
titleConozca Mi Protheus
Column
width500

Conector de Widget
width500
urlhttps://www.youtube.com/watch?v=lQwh3MVBrbs
height500

02. REQUISITOS PREVIOS MÍNIMOS


Aviso

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

Informações
titleObservació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


Deck of Cards
iddeck-aprobaciones
Card
idconfiguracao-aprovacao
labelAprobaciones

Aprobaciones

Para el alcance de aprobaciones:

  1. Configure el Rest Protheus
  2. Si usted fuera el cliente, solicite un alias por el Mingle o cree por el Asistente de configuración Mobile.
  3. Proceso de pertinencias de Compras o Viajes 
Card
idconfiguracao-eventos
labelEventos

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                                                                                                       

Deck of Cards
iddetalles-configuración-eventos
Card
iddetalhes-configuracao-eventos-ambiente
labelEntorno

Entorno


Para
el alcance de eventos:

  1. Configure el Rest Protheus
  2. Si usted fuera el cliente, solicite un alias por el Mingle o cree por el Asistente de configuración Mobile.
  3. Complete con el Token de acceso, el parámetro MV_MINGKEY.
    1. Acceda al módulo Configurador (SIGACFG)
    2. Acceda a la rutina Base de datos > Diccionario > Base de datos. 
    3. Haga clic sobre el ícono + para expandir las opciones y haga clic en Parámetros.
    4. Haga clic sobre la lupa y busque por MV_MINGKEY.
    5. Complete los campos Cont. Por, Cont. Ing, Cont. Esp con el Token.                                                                                                

                                                                                                                    

                                                                                                        

                                                                                                                       



Dica
titleSugerencia

El Token se encaminará al solicitar el alias por el Mingle o por el AppLinker .

Aviso
titleNota

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

Card
defaulttrue
effectDuration0.5
iddetalhes-configuracao-eventos-permissao
labelConfiguración del usuario
titleConfiguração do usuário
effectTypeslide

Verificar el permiso de usuario

  1. Acceda al módulo Configurador (SIGACFG)
  2. Acceda a la rutina Usuario > Contraseñas > Usuarios. 
  3. Busque por el usuario que se modificará.
  4. Seleccione el usuario y haga clic en modificar.
  5. Seleccione la solapa Restricciones de acceso > Solapa Accesos.
  6. Habilite el permiso 174 - Acceso a la inscripción en los Eventos del Event Viewer.


Painel
borderStylenone
titleValide a permissão 174 do usuário

Card
defaulttrue
effectDuration0.5
iddetalhes-configuracao-eventos-padrao
labelEvent Viewer - Estándar
titleEvent Viewer
effectTypeslide

Inscribir en el Event Viewer

  1. Acceda a Miscelánea > Inscr. Event Viewer en cualquier módulo.
  2. Haga clic en Incluir.
  3. Seleccione el canal 002.
  4. Seleccione la categoría 001.
  5. Seleccione el evento deseado.
  6. Seleccione Sí en el campo Json.

Para informaciones sobre el Event Viewer, haga clic aquí. 


Painel
borderStylenone
titleInscripción del Event Viewer


Card
iddetalhes-configuracao-eventos-custom
labelEvent Viewer - Personalizado
Deck of Cards
idevents-custom
Card
defaulttrue
effectDuration0.5
idcriacao-evento
labelCreación del evento
titleCriação do evento
effectTypeslide

Creación del evento

  1. Acceda al módulo Configurador (SIGACFG)
  2. Acceda a la rutina Entorno > Registro > Tablas.
  3. Busque por la tabla (E3).
  4. Haga clic en la opción Editar.
  5. Incluya el nuevo Evento.



Painel
borderStylenone
titleCrie o evento

Card
defaulttrue
effectDuration0.5
idnotificacao
labelNotificación
titleNotificação
effectTypeslide

Compilando y enviando 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


Aviso

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. 

Deck of Cards
effectDuration0.5
idnotificaciones
effectTypeslide
Card
defaulttrue
effectDuration0.5
idCompilando
labelCompilando
titleCompilando
effectTypeslide
Dica

El siguiente código solamente es un ejemplo y podrá personalizarlo de la mejor manera. A continuación un ejemplo del Event Insert.  

Bloco de código
languagejs
themeRDark
firstline0
titleEjemplo para envío de notificación
linenumberstrue
#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

Dica

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

Card
defaulttrue
effectDuration0.5
idchamando-evento
labelActivando el evento
titleChamando o Evento
effectTypeslide

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.


Dica

Existen innumerables formas de ejecutar una función. Ejecute esta de la forma que crea mejor. 

Painel
borderStylenone
titleACTIVE LA FUNCIÓN

SmartClient chamando a função

                                                                                               

                                                                                                                                      

Card
idconfiguracao-acm
labelACM
titleACM
classPrincipal
effectTypeslide

Configurando por la Web

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

Aviso
titleFuncionalidad "Validar fuentes"

La funcionalidad "Validar fuentes" no está disponible en el entorno web, solamente en el Protheus.

Painel
borderStylenone
titlePantalla 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).



Card
effectDuration0.5
idinstalacao
labelInstalación
titleInstalação
effectTypeslide

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


Informações
titleSistemas 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



Painel
borderStylenone
titleDisponible en Android e IOS
Column
width250

Android

Column
width250

IOS

Painel
borderStylenone
titleQR Code Android e IOS
Column
width250

Column
width250

Card
idconfiguracao-licencas
labelLicencias

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(seleção)
Corporativa(seleção)
App Backoffice(seleção)

04. NOTAS DE VERSIÓN

Deck of Cards
idreleases-note
Card
idreleases-note-calendar
labelCronograma de publicaciones - Nuevas versiones

El cronograma de publicaciones de nuevas versiones de la aplicación en la tiendas oficiales seguirá de acuerdo con la siguiente tabla. 

AppleApp Store     Android Google Play Store    Expedição Continua 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á. 

(seleção) Publicado  (menos) No publicado

Entregas del mes Publicación - Nueva versión

Apple

Android

Expedição Continua

Enero

15 de Febrero

(seleção)(seleção)(seleção)

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

(menos)(seleção)(seleção)

Noviembre

15 de Diciembre

(seleção)(seleção)(seleção)

Diciembre

15 de Enero




Card
idtipo-notes-inovação
labelInnovación
Deck of Cards
idrelease-inovação
Card
idreleases-note-2024
labelRelease - 2024
Deck of Cards
idreleases-notes-months
Card
idreleases-note-11
labelNoviembre


Card
idreleases-note-12
labelDiciembre
Card
idreleases-note-2025
labelRelease - 2025
Deck of Cards
idreleases-notes-months
Card
idreleases-note-janeiro
labelEnero


Card
idreleases-note-02
labelFebrero
Card
idreleases-note-03
labelMarzo


Card
idreleases-note-04
labelAbril


Card
idreleases-note-05
labelMayo


Card
idreleases-note-06
labelJunio


Card
idreleases-note-07
labelJulio


Card
idreleases-note-08
labelAgosto


Card
idreleases-note-09
labelSeptiembre


Card
idreleases-note-10
labelOctubre


Card
idreleases-note-11
labelNoviembre


Card
idreleases-note-12
labelDiciembre





Card
idtipo-notes-manutencao
labelMantenimiento
Deck of Cards
idrelease-manutencao
Card
idreleases-note-2024
labelRelease - 2024
Deck of Cards
idreleases-notes-months
Card
idreleases-note-11
labelNoviembre


Card
idreleases-note-12
labelDiciembre


Card
idreleases-note-2025
labelRelease - 2025
Deck of Cards
idreleases-notes-months
Card
idreleases-note-janeiro
labelEnero
Card
idreleases-note-02
labelFebrero


Card
idreleases-note-03
labelMarzo


Card
idreleases-note-04
labelAbril


Card
idreleases-note-05
labelMayo


Card
idreleases-note-06
labelJunio


Card
idreleases-note-07
labelJulio


Card
idreleases-note-08
labelAgosto


Card
idreleases-note-09
labelSeptiembre


Card
idreleases-note-10
labelOctubre


Card
idreleases-note-11
labelNoviembre


Card
idreleases-note-12
labelDiciembre











05. TABLAS, PARÁMETROS Y PUNTOS DE ENTRADA

Deck of Cards
idtabelas-parametros
Card
idcard-tabelas
labelTablas
  • 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)
Card
idcard-parametros
labelParámetros
  • 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
Card
idcard-pe
labelPuntos de entrada

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. 

Aviso
titleExpedición continua

Esté actualizado con la versión más reciente de la expedición continua del mobile. 


Informações

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

Card
defaulttrue
effectDuration0.5
idSuporte
labelSoporte
effectTypeslide


Preguntas frecuentes (FAQ)


Expandir
title¿Cuál es mi Usuario y Contraseña?

Corresponden al mismo usuario y contraseña que utiliza para realizar el acceso al Protheus vía SmartClient.

Expandir
title¿Existe límite de tamaño para PDF en los documentos adjuntos del pedido de compra?

¡Existe! Sin embargo, la limitación es para archivos con más de 5MB.

Expandir
title¿Qué es el Alias?

Un alias es un identificador único del cliente en TOTVS. Cada cliente puede tener más de un alias y cada alias corresponde a un Protheus instalado.

El alias es la clave para que la aplicación consiga encontrar el Protheus y de esta manera, realizar la comunicación.

Si usted aún no tiene un alias, solicite el suyo por medio de la apertura de un ticket en el Portal del cliente o acceda AQUÍ.

Expandir
titleOlvidé mi Usuario y/o Contraseña. ¿Qué puedo hacer?

Su contraseña puede ser redefinida solamente por medio del Protheus.

Expandir
title¿Qué eventos puedo visualizar?

En la aplicación se visualizan solamente los eventos en los que el usuario del Protheus está registrado en la inscripción del Event Viewer.

Los eventos se envían a la aplicación por medio de la notificación, así como también a la home de la aplicación.

Expandir
title¿Cuáles son los estatus de los eventos?

Los estatus de los Eventos son:

  • Gris: Información
  • Amarillo Alerta
  • Rojo: Error
Expandir
title¿Cómo comparto un Evento?

En la pantalla de Mi Protheus, seleccione el evento y haga clic en la opción compartir.

Expandir
title¿Qué configuración es necesaria para aprobar pedidos de compra en la aplicación?

No existe ninguna configuración específica para que los pedidos de compra puedan ser analizados por la aplicación. Con el aprovisionamiento del entorno (REST y Mingle), basta que el usuario con perfil de Aprobador acceda a la aplicación. 

Observando que la aprobación del pedido de compras es adherente al proceso estándar de liberación de documentos (MATA094).

Expandir
title¿Es posible traer informaciones adicionales de la aprobación del pedido de compras?

En la aplicación existe un área llama "Vea más" donde es posible incluir informaciones personalizadas que sean relevantes para la toma de decisión del aprobador. Es posible incluir nuevas informaciones en esta área por medio del Punto de entrada  MPADDCPO, donde los campos informados en el Punto de entrada se mostrarán en la aplicación.

Expandir
title¿Existe límite de tamaño del archivo en la visualización del documento adjunto del pedido de compra?

No necesariamente un límite, pero archivos con tamaño mayor de 5MB pueden no visualizarse, dependiendo de la infraestructura en la que se encuentra el entorno Protheus.

Expandir
title¿Cómo salir de la Aplicación?

En la pantalla de Configuraciones, haga clic en la opción Salir.

Materiales auxiliares

Los siguientes materiales tratan del Event Viewer del Protheus y del TOTVS Mingle:

Configurar Event Viewer

Cómo incluir una rutina de usuario en el Event Viewer