Índice


01. Visión general

Este documento tiene como finalidad mostrar a detalle la generación del informe mensual SUA (Sistema Único de Autodeterminación) usando la herramienta de SmartView. 


Esta solución requiere de un conector nativo y objetos de negocio creados para Protheus a partir de la versión 12.1.2310 y superiores.

02. Sustento legal

Los patrones con 5 o más trabajadores están obligados a efectuar el entero de sus obligaciones por medio del Sistema Único de Autodeterminación (SUA), y para los patrones de 1 a 4 trabajadores el uso del mismo es opcional. 

El Sistema Único de Autodeterminación contempla la emisión de información de los siguientes conceptos:

Para mayor información se recomienda consultar el sitio oficial: https://www.imss.gob.mx/patrones/sua/que-es-sua.

03. Instalación y configuración

3.1 Instalación de SmartView Agent.

•    Descargue el instalador del agente Smart View haciendo clic en este enlace https://smart-view.totvs.app/api/update-manager/releases/treports.agent-installer/win-x64/latest/download.
•    Extraiga todo el contenido del archivo zip y ejecute el archivo SMARTVIEW.AGENTINSTALLER.EXE.
•    Seleccione el directorio de instalación y continúe con el siguiente paso. Recomendamos que la instalación se realice en el directorio C:\TOTVS.
•    Si el directorio SMART-VIEW ya existe, el instalador le preguntará si desea sobrescribir la instalación anterior, en caso contrario deberá ingresar un nuevo directorio. 
•    Una vez completada la instalación, Smart View ahora estará disponible en su entorno y ahora se puede configurar a través del navegador en la dirección http://localhost:7019.

Para más información sobre la instalación de Smart View Agent se recomienda revisar la siguiente documentación: Instalação do Sistema.

3.2 Configuración REST del appserver.

Configurar el archivo appserver.ini para habilitar los servicios REST. Como ejemplo se muestra la siguiente configuración.

[Drivers]
Active=TCP
MultiProtocolPort=1
MultiProtocolPortSecure=1
[GENERAL]
ADVPLVERBOSE=1
ADVPLVERBOSEASERROR=1
InstallPath=C:\TOTVS\appserver\
Consolelog=1
App_Environment=P1212310MNTDBMEX
MAXSTRINGSIZE=10
[HTTPV11]
enable=1
port=23104
path=C:\TOTVS\Protheus_data\http-root
Sockets=HTTPREST
[HTTPREST]
URIs=HTTPENV
Security=1
Port=23105
[HTTPENV]
URL=/rest
prepareIn=T1,D MG 01
instances=5,10
CORSEnable=1
AllowOrigin=*
[HTTPJOB]
MAIN=HTTP_START
Environment=P1212310MNTDBMEX
[OnStart]
Jobs=HTTPJOB
RefreshRate=120

Para más información sobre la configuración REST se recomienda revisar la siguiente documentación: 01. Configuração.

3.4 Configuración inicial del SmartView :

Ingresar a la página http://localhost:7019 (URL asignada por defecto) desde el navegador web (Chrome, Edge o Firefox) y realizar la configuración del SmartView. 

Proveedor de seguridad.

Informar los campos solicitados en pantalla.

* El puerto debe de coincidir con el configurado en la sección [HTTPREST] del archivo appserver.ini.

Dar clic en el botón recuperar emisor.

Informar el usuario “admin” y la contraseña “1234” por ejemplo.

Esperar a que finalice el proceso de conexión.

Servidor de licencias.

Informar los campos solicitados en pantalla.

* Obs: Servidor de uso interno exclusivamente

Almacenamiento de datos

Para un rápido despliegue, usar el almacenamiento de datos SQLite. (No recomendado para ambientes en producción).


Para más información sobre la configuración inicial de Smart View se recomienda revisar la siguiente documentación: Configurações do Sistema.

3.4 Configuración del conector nativo:

  1. Desde el navegador web (Chrome, Edge o Firefox), ingresar al SmartView en la ruta http://localhost:7017/  (URL asignada por defecto).
  2. En el menú lateral, seleccionar la opción conectores y crear un nuevo conector.
  3. Usar la opción de conector nativo.
  4. Llenar los datos solicitados.
    1. Nombre: Ejemplo Protheus
    2. Dirección: Ejemplo http://localhost:23105/rest/.well-known/treports/connector
  5. Validar que la conexión fue exitosa y grabar los cambios.

Para más información sobre la configuración de conectores se recomienda revisar la siguiente documentación: Configurando Conectores

04. Ejemplo de utilización

Pre-condiciones

  1. Respaldar el repositorio (RPO).
  2. Aplicar el parche correspondiente a la issue DNOMI-1883.
  3. Verificar que las rutinas se encuentren actualizadas en el repositorio y verificar que coincidan con las descritas en el encabezado del presente documento técnico, considerando que las fechas sean iguales o superiores.
  4. Contar con información en los catálogos utilizados en el Cálculo de SUA.
  5. A través de la rutina Cálculo de SUA (GPEA450) ubicada en el módulo SIGAGPE | Miscelánea | SUA,  realizar el Cálculo de movimientos SUA.

  6. Ingresar al smartview desde el navegador web en la ruta http://localhost:7017/. En el menú lateral, ingresar a la opción Informes. Dar clic en la opción importar informe.

  7. Cambiar la extensión del archivo RH.SV.GPE.GPER650.DEFAULT.REP.MEX.TRP a RH.SV.GPE.GPER650.DEFAULT.REP.MEX.ZIP.

  8. Seleccionar el informe a importar ya con extensión ZIP.

  9. Seleccionar el objeto de negocio (Informe mensual SUA).

  10. Validar que el informe fue importado.


El archivo RH.SV.GPE.GPER650.DEFAULT.REP.MEX.TRP se pondrá a disposición posteriormente por el canal correspondiente.


Procedimiento

  1. Desde el navegador web (Chrome, Edge o Firefox), ingresar al SmartView en la ruta http://localhost:7017/.
  2. En el menú lateral, ingresar a la opción Informes.
  3. Seleccionar el informe "Informe mensual" y dar clic en la opción Visualizar.
  4. Informar los parámetros solicitados. Utilizar la información generada en las "Pre-condiciones".
  5. Dar clic en enviar y esperar a que el informe sea generado.
  6. Validar que la información mostrada sea correcta. Para más detalle, puede consultar la sección 04. Información del encabezado y 05. Información del detalle.

05. Parámetros

El informe "Informe mensual SUA" contiene los siguientes parámetros.

Orden Pregunta español Tipo Tamaño DecimalesValidación 

Consulta estándar

Opciones

01¿Mes/Año?C60--
02¿Registro patronal?C500-RCO
03¿Tipo de informe?C10--1 = Analitico; 2 = Resumen
04¿Orden?C10--1 = Nombre;2 = Apellido; 3= Matrícula

06. Estructura del informe

El informe "Informe mensual SUA" consta de 2 tipos.

Informe tipo analitico.

Encabezado

Detalle

Pie de página

Informe tipo resumen.

Encabezado

Detalle

07. Configuración del informe en menú

Para agregar el informe "Informe mensual SUA" al menú de protheus es necesario realizar la siguiente configuración.

  1. Ingresar a la rutina "Configuración SmartView" (FWTREPPARM) ubicada en el módulo configurador - SIGACFG | Entorno | Archivos.
  2. Seleccionar el tipo de autenticación Token Protheus. Avanzar.
  3. Informar la URL Base del SmartView. Por ejemplo, http://localhost:7017/.
  4. Probar la conexión y confirmar el registro.
  5. Ingresar a la rutina "Menús" ubicada en SIGACFG | Entorno | Archivos.
  6. Seleccionar el módulo Gestión de personal.
  7. Adicionar el menú existente del módulo SIGAGPE.
  8. Seleccionar una carpeta en donde desee crear la opción del menú y agregar un nuevo ítem.
  9. Informar la descripción de la rutina. Por ejemplo Informe mensual Smart View.
  10. En el campo de Tipo seleccionar la opción SmartView.
  11. Llenar el campo Programa dando clic en el botón "...".
  12. Seleccionar el objeto de negocio "Informe mensual SUA".
  13. En el campo Módulo, seleccionar la opción Gestión de Personal.
  14. Grabar los cambios.
  15. Ingresar a la rutina Informe mensual Smart View desde el menu del modulo SIGAGPE.

08. TABLAS UTILIZADAS

09. Asuntos relacionados