Árvore de páginas


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


Importante:

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

CampoOrigen de información
LogoLee el archivo llamado lgrl + Código de la Empresa + .bmp; ubicado en la carpeta system.
EmpresaImprime el campo M0_FILIAL de la tabla de Sucursales.
SucursalImprime el campo M0_NOMECOM de la tabla de Sucursales.
NITImprime el campo M0_CGC de la tabla de Sucursales.
MatrículaImprime el campo RA_MAT de la tabla de Empleados (SRA).
NombreImprime el campo RA_NOME de la tabla de Empleados (SRA).
Tipo Id

Imprime el campo RA_TPCIC de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S022.

No. IdImprime el campo RA_CIC de la tabla de Empleados (SRA).
Centro de CostosImprime el campo CTT_DESC01 de la tabla CTT, correspondiente al código informado en el campo RA_CC de la tabla de Empleados (SRA).
DepartamentoImprime el campo QB_DESCRIC de la tabla SQB, correspondiente al código informado en el campo RA_DEPTO de la tabla de Empleados (SRA).
CargoImprime el campo RA_CARGO de la tabla de Empleados (SRA), más la descripción del cargo informada en el camp Q3_DESCSUM de la tabla SQ3.
FunciónImprime el campo RJ_DESC de la tabla SRJ, correspondiente al código informado en el campo RA_CODFUNC de la tabla de Empleados (SRA).
SindicatoImprime el campo RCE_DESCRI de la tabla RCE, correspondiente al código informado en el campo RA_SINDICA de la tabla de Empleados (SRA).
ProcesoImprime el campo RA_PROCES de la tabla de Empleados (SRA), más la descripción del cargo informada en el camp RCJ_DESCRI de la tabla RCJ.
OficioImprime el campo RA_OFICIO de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S017.
Tipo CesantíaImprime el campo RA_OPTLEI de la tabla de Empleados (SRA).
EPSImprime el campo RA_CODRPAT de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S008.
Fecha IngresoImprime el campo RA_ADMISSA de la tabla de Empleados (SRA).
AFPImprime el campo RA_CODAFP de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S008.
Fecha ReconocimientoImprime el campo RA_DTREC de la tabla de Empleados (SRA).
ARLImprime el campo RA_NITARL de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S008.
Último AumentoImprime el campo RA_FECAUM de la tabla de Empleados (SRA).
CCFImprime el campo RA_CXCOMP de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S008.
Fecha RetiroImprime el campo RA_DEMISSA de la tabla de Empleados (SRA).
Horas por mesImprime el campo RA_HRSMES de la tabla de Empleados (SRA).
ReteFte

Imprime "Procedimiento 1" si el campo RA_TIPOPRC de la tabla de Empleados (SRA) tiene el valor 1.

Imprime "Procedimiento 2" si el campo RA_TIPOPRC de la tabla de Empleados (SRA) tiene el valor 2.

% ReteFteImprime el campo RA_PERCIR de la tabla de Empleados (SRA), con el formato "999.99".
Tipos SalarioImprime el campo RA_TIPOSAL de la tabla de Empleados (SRA).
SalarioImprime el campo RA_SALARIO de la tabla de Empleados (SRA), con el formato "999,999,999,999.99".
Motivo RetiroImprime el campo RA_TIPFIN de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S020.
ContratoImprime el campo RA_TIPOCO de la tabla de Empleados (SRA), más la descripción del cargo informada en la tabla S018.

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:

ColumnaOrigen de la información
Código conceptoImprime el campo RV_PD de la tabla conceptos (SRV).
Descripción concepto

Imprime el campo RV_DESC de la tabla conceptos (SRV).

Día/Hora

Imprime el campo RD_HORAS / RC_HORAS de la tabla Historial movimiento (SRD) / Movimiento del periodo (SRC).

Valor

Imprime el campo RD_VALOR / RC_VALOR de la tabla Historial movimiento (SRD) / Movimiento del periodo (SRC).

04. Parámetros del Informe

El informe carta finiquitos contiene los siguientes parámetros.

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

Consulta estándar

01¿Proceso?C50
RCJ
02¿Procedimiento?C30
SRY
03¿Periodo?C60
RCH12
04¿Num Pago?C20

05¿Matricula (s)?C990
SRA
06¿Mensaje?C20
S91COL
07¿Nombre empleador/Represent?C990

08¿Tipo Id Representante?C20

09¿Doc Empleador/Representante?C150

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