Índice

01. Visión General

El informe Carta Finiquitos (GPER140COL) tiene como finalidad generar un documento por empleado con los devengos, deducciones y bases del cálculo de la rescisión realizado.

Formato de la carta:

02. Instalación y Configuración

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

2.2 Configuración REST del appserver

Configurar el archivo appserver.ini para habilitar los servicios REST con la siguiente información sugerida.

[Drivers]
Active=TCP
MultiProtocolPort=1
MultiProtocolPortSecure=1
[GENERAL]
ADVPLVERBOSE=1
ADVPLVERBOSEASERROR=1
InstallPath=C:\TOTVS\appserver\
Consolelog=1
App_Environment=P1212310MNTDBCOL
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=P1212310MNTDBCOL
[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.

2.3 Configuración inicial del SmartView

Ingresar a la página http://localhost:7019 desde el navegador web 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 licencia

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.

2.4 Configuración del conector nativo

1. Desde el navegador web, ingresar al SmartView en la ruta http://localhost:7017/ .
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

03. Ejemplo de Utilización

Pre-condiciones

1. Respaldar el repositorio (RPO).
2. Aplicar el parche correspondiente a la issue DRHROTPRT-13775.
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. 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.

5. Cambiar la extensión del archivo RH.SV.GPE.GPER140.DEFAULT.REP.COL.TRP a RH.SV.GPE.GPER140.DEFAULT.REP.COL.ZIP.

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

7. Seleccionar el objeto de negocio (Carta finiquitos).

8. Validar que el informe fue importado.

9. Contar con información en los catálogos utilizados en el Cálculo de Rescisión.
   • Tipos de Procedimiento.
     • Contar con el procedimiento FIN - Liquidación de Contratos.
   • Procesos.
   • Conceptos.
   • Conceptos por proceso.
   • Fórmulas.
   • Mnemónicos.
   • Criterios de Acumulación.
   • Periodos.
   • Tablas Alfanuméricas.
   • Empleados.
     
10. Realizar el Cálculo de la Rescisión.

Procedimiento

1. Desde el navegador web, ingresar al SmartView en la ruta http://localhost:7017/.
2. En el menú lateral, ingresar a la opción Informes.
3. Seleccionar el informe Carta finiquito 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.

04. Información del Encabezado

05. Información del Detalle

El informe cuenta con tres secciones en el detalle, la primera de ellas son los devengos, segundo deducciones y por último bases:

04. Parámetros del Informe

El informe carta finiquitos contiene los siguientes parámetros.

06. Configuración del Informe en el Menú

Para agregar el informe "carta finiquitos" 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 Carta Finiquitos 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 "Carta finiquitos".
13. En el campo Módulo, seleccionar la opción Gestión de Personal.
14. Grabar los cambios.
15. Ingresar a la rutina Carta Finiquitos Smart View desde el menu del modulo SIGAGPE.

07. Tablas Utilizadas

• SRA - Empleados.
• SM0 - Sucursales.
• SRJ - Funciones.
• CCT - Centro de Costo.
• SQB - Departamento.
• RCE - Sindicatos.
• SQ3 - Cargos.
• SRC - Movimiento del Período.
• SRD - Historial de Movimientos.
• SRV - Conceptos.

08. 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 Colombia: https://tdn.totvs.com/pages/viewpage.action?pageId=574685123