Linha Microsiga Protheus

Árvore de páginas


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


Importante

Esta solución requiere de un conector nativo para Smart View y objetos de negocio creados para Protheus a partir de la versión 12.1.2310 o superiores.  Para mayor información, consultar Smart View - Configuração do produto Protheus integrado ao Smart View

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 la 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 Smart View 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 mayor 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 mayor información sobre la configuración REST, se recomienda revisar la siguiente documentación: 01. Configuração.

3.3 Configuración inicial del Smart View

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 Smart View.

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.

* 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 mayor 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 Smart View 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 mayor 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 Smart View 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.


Nota:

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 Smart View en la ruta http://localhost:7017/. (También es posible visualizar el informe desde el smartclienhtml de Protheus, para más información consultar la sección 07. Configuración del Informe en el Menú de este documento).
  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 06. Estructura del Informe.

05. Parámetros

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

Orden Pregunta en 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" = Apellido paterno;"2" = Nombre;"3"= Matrícula

06. Estructura del Informe

El informe "Informe mensual SUA" consta de 2 tipos de impresión; Analítico y Sintético (Resumen):

Informe Tipo Analítico

Encabezado

CampoOrigen de informaciónCampoOrigen de información
Registro patronalImprime el campo RCO_NREPAT de la tabla de Registro patronal.Nombre razón socialImprime el campo RCO_NOME de la tabla de Registro patronal.
RFCImprime el campo M0_CGC de la tabla de Sucursales.Prima de R.T.Imprime el campo RHD_FATRSC de la tabla de Empleados SUA.
ActividadImprime el campo RCO_ATIVID de la tabla de Registro patronal.Mes y año de procesoImprime el parámetro ¿Mes/año? en formato MM/AAAA
Área geográficaImprime el campo RCO_CVEZON de la tabla de Registro patronal.



Detalle

CampoOrigen de la informaciónCampoOrigen de la información
Número de seguridad socialImprime el campo RA_RG de la tabla de Empleados.C.F.Imprime el campo RHC_CFPAT de la tabla de Movimientos SUA.
NombreImprime el campo RA_PRISOBR + RA_SECSOBR + RA_PRINOME + RA_SECNOME de la tabla de Empleados.Enf../Mat. Ex. Pat.Imprime el campo RHC_EXEPAT de la tabla de Movimientos SUA.
R.F.CImprime el campo RA_CIC de la tabla de Empleados.Enf../Mat. Ex. Obr.Imprime el campo RHC_EXETRA de la tabla de Movimientos SUA.
C.U.R.PImprime el campo RA_CURP de la tabla de Empleados.P.D. Pat.Imprime el campo RHC_PDPAT de la tabla de Movimientos SUA.
ClaveImprime el campo RHC_TPMOV de la tabla de Movimientos SUA.P.D. Obr.Imprime el campo RHC_PDTRA de la tabla de Movimientos SUA.
FechaImprime el campo RHC_DTMOV de la tabla de Movimientos SUA.G.M.P. Pat.Imprime el campo RHC_GMPPAT de la tabla de Movimientos SUA.
DíasImprime el campo RHC_NDTRAB de la tabla de Movimientos SUA.G.M.P. Obr.Imprime el campo RHC_GMPTRA de la tabla de Movimientos SUA.
SDIImprime el campo RHC_SALDII de la tabla de Movimientos SUA.R.T.Imprime el campo RHC_RTPAT de la tabla de Movimientos SUA.
Inc.Imprime el campo RHC_NDINC de la tabla de Movimientos SUA.I.V. Pat.Imprime el campo RHC_IVPAT de la tabla de Movimientos SUA.
Aus.Imprime el campo RHC_NDFAL de la tabla de Movimientos SUA.I.V. Obr.Imprime el campo RHC_IVTRA de la tabla de Movimientos SUA.
G.P.S.Imprime el campo RHC_GPSPAT de la tabla de Movimientos SUA.Suma Pat.Imprime la suma del campo RHC_CFPAT + RHC_EXEPAT + RHC_PDPAT + RHC_GMPPAT + RHC_RTPAT + RHC_IVPAT + RHC_GPSPAT de la tabla de Movimientos SUA.
Suma Obr.Imprime la suma del campo RHC_EXETRA + RHC_PDTRA + RHC_GMPTRA + RHC_IVTRA de la tabla de Movimientos SUA.


Pie de página

CampoOrigen de la información
Registro patronalImprime el valor de la tabla alfanumérica S006 Salarios mínimos zona "A".

Informe Tipo Sintético (Resumen)

Encabezado

CampoOrigen de información
Registro patronalImprime el campo RCO_NREPAT de la tabla de Registro patronal.
RFCImprime el campo M0_CGC de la tabla de Sucursales.
Nombre razón socialImprime el campo RCO_NOME de la tabla de Registro patronal.
Mes y año de procesoImprime el parámetro ¿Mes/año? en formato MM/AAAA


Detalle

CampoOrigen de la informaciónCampoOrigen de la información
EmpleadosImprime la suma de empleados vinculados con el registro patronal.Gastos medicos pensionadosImprime el campo RHC_GMPPAT + RHC_GMPTRA de la tabla de Movimientos de SUA.
Días cotizadosImprime el campo RHC_NDTRAB menos los campos RHC_NDFAL y RHC_NDINC de la tabla de Movimientos de SUA.Riesgo de trabajoImprime el campo RHC_RTPAT de la tabla de Movimientos de SUA.
Cuota fijaImprime el campo RHC_CFPAT de la tabla de Movimientos de SUA.Invalidez y vidaImprime el campo RHC_IVPAT + RHC_IVTRA de la tabla de Movimientos de SUA.
Excedente 3 SMGDFImprime el campo RHC_EXEPAT + RHC_EXETRA de la tabla de Movimientos de SUA.Guarderías y pres. soc.Imprime el campo RHC_GPSPAT de la tabla de Movimientos de SUA.
Prestaciones en dineroImprime el campo RHC_PDPAT + RHC_PDTRA de la tabla de Movimientos de SUA.

07. Configuración del Informe en el 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 Smart View" (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 Smart View. 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 Smart View.
  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 menú del módulo SIGAGPE.

08. Tablas Utilizadas

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

09. Asuntos Relacionados

Instalación de Smart View:

https://tdn.totvs.com/pages/viewpage.action?pageId=626636542

Configuración de Smart View:

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