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

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:

• Cuotas obrero patronales a las cuentas individuales de los trabajadores, por concepto del Seguro de Retiro, Cesantía en Edad Avanzada y Vejez.
• Cuotas obrero patronales a los demás ramos del Seguro Social (Riesgos de Trabajo, Enfermedades y Maternidad, Invalidez y Vida y Guarderías y Prestaciones Sociales).
• Aportaciones patronales por concepto de vivienda, que son contabilizadas en las cuentas individuales de los trabajadores.
• Amortización de créditos asignados a los trabajadores por el INFONAVIT.

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.

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.

• • Nombre del proveedor: Ejemplo Protheus.
  • Dirección de creación de token: Ejemplo http://localhost:23105*/rest/api/oauth2/v1/token
  • Dirección de Jwks: Ejemplo http://localhost:23105*/rest/api/oauth2/v1/jwks
  • Dirección base de la Api: Ejemplo http://localhost:23105*/rest/

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

• • Ip del servidor: Ejemplo licensedev.engpro.totvs.com.br *
  • Puerta: Ejemplo 8850
  • Identificación federal: Ejemplo <vacío>

* 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.
   • Empleados.
     
   • Registro patronal.
   • Funciones.
   • Control de ausencias.
   • Crédito Infonavit.
   • Trayectoria laboral.
   • Mantenimiento de tablas.
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.

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.

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

• SRA - Empleados.
• SM0 - Sucursales.
• RHD - Empleados SUA.
• RCO - Registro patronal.
• RHC - Movimientos de SUA.

09. Asuntos relacionados

• Instalación de SmartView: https://tdn.totvs.com/pages/viewpage.action?pageId=626636542
• Configuración de SmartView: https://tdn.totvs.com/pages/viewpage.action?pageId=625443148
• Configuración HTTP REST de protheus: https://tdn.totvs.com/pages/releaseview.action?pageId=185747842
• Configuración de conectores: https://tdn.totvs.com/pages/releaseview.action?pageId=633538858
• Documento de referencia para la localización de México: DT Localización México (SIGAGPE) - Protheus 12