Cambios Sistema Recursos Humanos

Versión: OT 004.510.017

Plataforma: ERP

IA/OT: OT 3423, 3443, 3448

Informativo N°24, agosto/2019

 

 

Procesos/Opciones Afectados:

 

Servicio WEB de Captura de Fichas, Variables por persona, Tratos y Servicio WEB de Consulta de Vacaciones

 

 

Objetivo:

Nuestro sistema de Recursos Humanos no permitía la recepción desde otras aplicaciones externas, de la información de Fichas, Valores y Tratos ni tampoco permitía consulta en línea de Vacaciones desde otras aplicaciones, esto sólo se podría realizar de manera manual generando archivos planos para luego capturarlos desde el sistema de Recursos Humanos. Para resolver lo anterior, se incorpora al sistema de Recursos Humanos un PlugIn que incluirá un WebService con tres métodos de captura de datos: captura en línea de fichas de personal, la captura de Valores y captura de Tratos; y otro WebService con un método de consulta de Vacaciones.  Estos métodos estarán disponibles, para que desde otros sistemas puedan ser consumidos, para lo cual el cliente deberá desarrollar programas que permitan la conexión en línea desde sus propios sistemas.

 

Detalle de cambios:

 

Generalidades

 

Para tener la documentación técnica de la instalación de los WebServices que dispondrá Softland, el cliente debe utilizar el documento Manual_de_Intalacion_WebService.pdf, esto porque se deben cumplir condiciones iniciales y junto con configuraciones de nivel técnico para la correcta comunicación entre los sistemas.

 

No es necesario la existencia del sistema de Recursos Humanos en el servidor donde se dejarán instalados los WebServices.

 

Estos WebServices no tienen pantallas gráficas, ya que se trata de una comunicación en línea de 2 aplicaciones.

 

Este módulo funcionará con un PlugIn con la sigla PS, para el sistema de Recursos Humanos.

 

El Servicio constará de 5 librerías que le permitirán validar y grabar la información. Las librerías serán:

1.    Softland.Sw.Captura.General.dll:

2.    Softland.Sw.Captura.Fichas.dll:

3.    Softland.Sw.Captura.Valores.dll

4.    Softland.Sw.Vacaciones.Ws.dll

5.    Softland.Sw.Captura.Tratos.dll

 

Método de General

 

Este método corresponde al envío de la información general a capturar (Fichas, Valores, Tratos).

 

La estructura que debe tener este método es la siguiente:

 

Datos de entrada al servicio

 

Archivo

Base64

Corresponde al archivo TXT.

Extensión

String

Corresponde a la extensión del archivo.

Separador

integer

Separador de columnas donde:

0=Tab / 1=Punto y coma / 2 = Coma / 3 = Pipe

AreaDatos

String

Corresponde al área de datos donde se encuentra la base de datos del cliente.

Usuario

String

Usuario asignado a la captura (Debe estar creado como usuario de RRHH)

Password

String

Password del usuario asignado a la captura.

Datos de salida de la aplicación

BlEstado

Bool

Permitirá indicar si el término del proceso fue exitoso.

StrCausaEstado

String

Texto que corresponderá a mensajes de salidas del proceso.

strResultadoB64

String

Corresponde al archivo TXT con el detalle de problemas encontrados durante el proceso. Solo disponible en caso de errores y/o advertencias.

 

 

Método Captura de Fichas

 

Los datos a capturar deben tener la siguiente estructura:

 

DESCRIPCION

TIPO

EXIGIDO

LARGO

DEC

OBSERVACIONES

1

Ficha del trabajador

Carácter

SI

10

 

 

2

Código del banco sucursal

Carácter

NO

2

 

Código de banco para pago con depósito

3

Código de estudios superiores

Carácter

NO

3

 

 

4

Código caja de compensación

Carácter

NO

3

 

 

5

RUT

Carácter

SI

20

 

Formatos:
99999999X (RUT con dígito verificador y sin guion)
o
99.999.999-X (RUT con puntos, dígito verificador y guion)

6

Dirección

Carácter

NO

60

 

 

7

Código de comuna

Carácter

NO

7

 

 

8

Código de ciudad

Carácter

NO

7

 

 

9

Teléfono 1

Carácter

NO

20

 

 

10

Teléfono 2

Carácter

NO

20

 

 

11

Teléfono 3

Carácter

NO

20

 

 

12

Fax

Carácter

NO

20

 

 

13

Fecha de nacimiento

Carácter

NO

10

 

dd/mm/aaaa cuando no hay valor asume la fecha de la captura

14

Sexo

Carácter

SI

1

 

M: masculino F: femenino

15

Estado civil

Carácter

SI

1

 

S: soltero C: casado V: viudo D: divorciado

16

Nacionalidad

Carácter

NO

20

 

 

17

Situación militar al día

Carácter

SI

1

 

S ó N

18

Fecha de Ingreso

Carácter

NO

10

 

dd/mm/aaaa cuando no hay valor asume la fecha de la captura

19

Fecha primer contrato

Carácter

NO

10

 

dd/mm/aaaa cuando no hay valor asume la fecha de la captura

20

Fecha contrato vigente

Carácter

NO

10

 

dd/mm/aaaa cuando no hay valor asume la fecha de la captura

21

Código INE

Carácter

NO

4

 

 

22

Tipo de pago

Carácter

SI

1

 

E: efectivo C: cheque D: depósito V: vale vista

23

Código de ex-caja

Carácter

NO

2

 

Debe ir si cotiza INP

24

Número de cuenta para depósito

Carácter

NO

20

 

 

25

Número tarjeta control horario

Carácter

NO

18

 

 

26

Tiene certificado de sueldos

Carácter

SI

1

 

S ó N

27

Tiene certificado de honorarios

Carácter

SI

1

 

S ó N

28

Tiene certificado de honorarios y participaciones

Carácter

SI

1

 

S ó N

29

Apellido paterno

Carácter

SI

20

 

 

30

Apellido materno

Carácter

NO

20

 

Por defecto blanco

31

Nombres

Carácter

SI

20

 

 

32

Email

Carácter

NO

250

 

 

33

WebSite

Carácter

NO

250

 

 

34

Código de área de negocio

Carácter

NO

3

 

Es exigido si la empresa maneja área de negocio

35

Código de centro de costo

Carácter

NO

8

 

Debe venir a último nivel sin guion, es exigido si la empresa maneja centro de costo

36

Código de cargo

Carácter

NO

4

 

 

37

Código de AFP

Carácter

NO

3

 

 

38

Porcentaje de cotización AFP

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

39

Porcentaje Seguro de Invalidez y Sobrevivencia + Comisión de la AFP

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

40

Monto cotización voluntaria AFP en Pesos

Numérico

NO

15

4

Cuando no hay valor se asume 0 (cero)

41

Monto cotización voluntaria AFP en UF

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

42

Monto cotización voluntaria AFP en Porcentaje

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

43

Código de Isapre

Carácter

NO

3

 

 

44

Monto cotización Isapre (Porcentaje)

Numérico

NO

15

4

Cuando no hay valor se asume 0 (cero)

45

Monto cotización Isapre (Pesos)

Numérico

NO

15

4

Cuando no hay valor se asume 0 (cero)

46

Monto cotización Isapre (UF)

Numérico

NO

15

4

Cuando no hay valor se asume 0 (cero)

47

Ficha tiene derecho al 2%

Carácter

NO

1

 

S ó N, cuando no hay valor asume N

48

Porcentaje a cotizar del 2%

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

49

Monto a cotizar del 2%

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

50

Porcentaje cotización INP

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

51

Código régimen impositivo

Carácter

NO

2

 

Debe ir si cotiza INP

52

Fecha de inicio para el cálculo de vacaciones

Carácter

NO

10

 

dd/mm/aaaa cuando no hay valor asume la fecha de la captura

53

Total de años con otro empleador

Numérico

NO

15

 

Cuando no hay valor se asume 0 (cero)

54

CodSucurBan

Carácter

NO

3

 

 

55

Tipo de cuenta para depósito.

Carácter

NO

3

 

Si el campo 22 es 'D' debe ir el valor:
'001' para Cta.Cte. o
'002' para CrediChile o '003' para Chequera Electrónica BECH o
'004' para Cuenta VISTA o '005' para Cuenta RUT o
'006' para Cuenta de Ahorro (válido sólo para trasferencia electrónica Banco CorpBanca) o
'007' para Cuenta de Intereses (válido sólo para trasferencia electrónica Banco CorpBanca)

56

Tipos de Vale Vista.

Carácter

NO

3

 

Si el campo 22 es 'V' debe ir el valor: '001' Entrega en Mesón/Virtual o '002' Enviado por Correo o '003' Entregado a la Empresa/Impreso.

57

Tipos de Efectivo.

Carácter

NO

3

 

Si el campo 22 es 'E' debe ir el valor: '001' Entregado en Empresa o '002' Entregado en Servipag (válido sólo para transferencia electrónica Banco de Chile) o '003' Orden de Pago(válido sólo para transferencia electrónica Banco CorpBanca).

58

Nº de Días de Vacaciones Anuales

Numérico

SI

3

 

Campo que corresponde al número de días de vacaciones anuales legales que tiene una persona (Normal 15 días hábiles).

59

Fecha Certificado Vac. Progresivas

Carácter

NO

10

 

dd/mm/aaaa, dato no exigido.

60

Fecha Término Contrato

Carácter

NO

10

 

dd/mm/aaaa, dato no exigido.
Cuando no hay dato, informar un espacio en blanco

61

Afecto Art. 145L Código del Trabajo

Carácter

NO

1

 

S ó N.
Cuando no hay valor se asume N

 

Las validaciones que se harán en este método son las siguientes:

 

·         Validará la estructura del archivo TXT.

·         Se harán las mismas validaciones de la captura de fichas de Recursos Humanos en forma silenciosa.

·         Si la ficha no existe, se crea en el sistema de Recursos Humanos

·         Si la ficha existe, se actualizan los nuevos datos en el sistema de Recursos Humanos

·         El servicio deja registros de Log(s) en caso que sea requerido.

·         En caso de detectar error en los datos para subir, se detendrá el proceso y se devolverá un mensaje con el detalle del problema detectado.

 

Método Captura de Valores del Personal

 

Los datos a capturar deben tener la siguiente estructura:

 

DESCRIPCION

TIPO

LARGO

DEC

OBSERVACIONES

1

Ficha del trabajador

Carácter

10

 

La ficha debe estar entre comillas dobles

2

Código de la variable

Carácter

4

 

Código de la variable debe estar compuesto por:

Haberes: H001 a H999

Parámetros: P001 a P999

Descuento: D001 a D999

El código de la variable debe estar entre comillas dobles

3

Mes y Año de la variable a capturar

Carácter

7

 

El campo debe tener el siguiente formato mm/yyyy El mes y año debe estar entre comillas dobles

4

Valor de la variable a capturar

Carácter

15

 

Existen las siguientes restricciones:

1.- Variable numérica: El delimitador de decimales debe ser (.)

No debe venir con separador de miles

2.- Variable Fecha: Debe tener el siguiente formato dd/mm/yyyy

3.- Variable Texto: El texto no debe permitir cremilla simple y cremilla doble

El valor debe estar entre comillas dobles

 

Este método “Captura de Valores del Personal” validará en primera instancia el acceso al área de datos enviada, en caso de no poder establecer conexión se devolverá el siguiente mensaje: “No fue posible enlazar la base de datos, verifique PATH de conexión al área de datos.”

 

Además, validará si el usuario tiene los permisos para ejecutar la captura y en caso de que la validación no sea exitosa devolverá el mensaje:

“Usuario no válido o sin permiso de acceso a la opción de captura”

Nota: Esta validación no aplicará para el usuario SOFTLAND.

 

 

Método Captura de Tratos

 

Los datos a capturar deben tener la siguiente estructura:

 

Estructura de datos del Archivo entrada

Campo

Tipo

Largo

Detalle

Ficha

String

10

Código identificador del trabajador

Trato

String

20

Código identificador del tipo de trabajo

CenCos

String

8

Código de Centros de Costo (Valor puede no ser asignado, este caso deberá venir como entre comillas simples “”

Fecha

String

10

Fecha en que realizó el trabajo. Formato DD/MM/AAAA

Tiempo

String

5

Tiempo si el tipo de trabajo está definido en unidad de medida hora. Formato HH:MM.

Cantidad

String

12

Cantidad si el tipo de trabajo es en unidades. Formato

9999999.9999 (punto como separador de decimales).

Factor

String

6

Formato 0.01 a 999.99 (punto como separador de decimales).

Valor por defecto = 1

 

Ejemplos:

 

1-    Ejemplo con trato definido como unidad de medida hora, Centro de Costo y Factor

“AD001”;”TRA01”;”0001”;”28/11/2018”;”03:05”;””;”1.5”   

 

2-    Ejemplo con trato definido con cantidad en unidades y sin Centro de Costo

“AD002”;”TRA02”;””,”27/11/2018”;””;”129.03”;””

 

Como se observa en el ejemplo todos los datos de tipo Texto o Fechas deberán entre comillas dobles.

La captura de tratos exigirá que el usuario tenga permisos para Agregar o Modificar tratos por Persona

 

La validaciones que hará este método son los siguientes:

·         Se validará que el trato exista y esté correctamente definido

·         Se validará que el registro capturado contenga el código del trato

·         Se validará que el registro capturado contenga una fecha valida

·         El método del servicio solo permitirá el ingreso de Tratos cuya fecha no sea mayor al último periodo preparado, ni anterior al primer mes preparado

·         Se validará que la Ficha se encuentre vigente para la fecha del trato

·         Se validará si la Empresa maneja centro de costo

·         Si la Empresa no maneja centro de costo, y el dato capturado contiene centro de costo, el registro no será grabado

·         El servicio validará que el formato del Tiempo informado sea correcto (HH:MM) y en rango (00:01 a 24:00), esto en el caso que la definición de la fórmula de pago del trato sea por tiempo

·         En el caso que la definición de la fórmula de pago del trato sea por cantidad, se validará que el formato de la Cantidad informada sea correcta (numérica) y en rango (entre 0.0001 y 9999999.9999)

·         En el caso que se informe Factor, se validará que el formato del Factor informado sea correcto (numérica) y en rango (entre 0.01 y 999.99)

·         Se verificará si el trato efectuado que se informa ya se encuentre ingresado

·         En el caso la ficha corresponda a Rol Privado se validará que el usuario que se esté utilizando para la captura

 

Método Consulta de Vacaciones

 

Definición de Parámetros de entrada y salida del método ObtieneResumenVacaciones

 

Parámetros de Entrada

Parámetro

Tipo

Descripción

AreaDatos

String

Correspondiente a la ruta del área de datos de la empresa.

Ficha

String

Ficha de la cual se quiere saber el detalle de las vacaciones

Fecha

DateTime

Fecha a la cual se quiere saber el detalle de las vacaciones.

 

 

Parámetros de Salida

Parámetro

Tipo

Descripción

Ok

boolean

Indica si la consulta tuvo un resultado favorable

Msj

string

En el caso de que la variable OK sea false, entregará por qué no pudo completarse la operación.

UltPeriodoCumpleVac

int

Último periodo de Cumpleaños de Vacaciones

DiasLegalesAnual

decimal

Días Legales Anual

DiasProgresivosUltCumple

decimal

Días Progresivos del último cumpleaños

DiasLegales

decimal

Días Legales

DiasProgresivos

decimal

Días Progresivos

DiasProporcionales

decimal

Días Proporcionales

DiasAdicionales

decimal

Días Adicionales

TotalDiasVacaciones

decimal

Total Días Vacaciones

DiasLegalyAdicionalTomados

decimal

Días Legales y Adicionales Tomados

DiasProgresivosTomados

decimal

Días Progresivos Tomados

TotalDiasVacacionesTomadas

decimal

Total Días Vacaciones Tomados

SaldoDiasLegPropAdic

decimal

Saldo días Legales, Proporcionales y Adicionales

SaldoDiasProgresivos

decimal

Saldo días progresivos

TotalSaldoDiasVacaciones

decimal

Total Saldo días Vacaciones

 

Validaciones que se realizarán en esta captura:

 

·         Falta indicar el área de datos de la empresa

·         Área de datos no válida (si está en red debe indicar path UNC, ejemplo \\equipo\SOFTLAND\DATOS\NOMBREBD). O bien, en la ruta no existe el archivo Sodatos.ini para obtener la cadena de conexión

·         Área de datos inválida, no se pudo obtener la cadena de conexión

·         No se ha podido conectar a la Base de Datos, verifique los servicios de SQL o que el archivo Sodatos.ini esté correcto

·         La base de datos escogida no cuenta con rut de empresa

·         Usted no posee instalado RRHH en la base de datos proporcionada

·         Falta indicar la Ficha del trabajador

·         La fecha ingresada no puede ser menor al año 1900

·         No existe la Ficha para la que intenta obtener los datos

·         No existe fecha de inicio de cálculo

·         La fecha de cálculo (dd/MM/yyyy) no puede ser menor a la fecha de inicio de cálculo de vacaciones (dd/MM/yyyy)

 

 

Diagrama de Captura (Fichas, Valores y Tratos) a través del WebService para Recursos Humanos

 

A continuación, se muestra un diagrama de cómo funciona el WebService de Captura de Datos para Recursos Humanos:

 

 

·         El software externo envía el archivo que viene con la información en la estructura de la “Captura General”, se procede a su validación.

·         Si la validación es correcta se procede a descargar el archivo en un área temporal

·         Dependiendo del tipo de captura (método del WebService gatillado) se procede a usar las componentes de captura específicas, Fichas, Valores o Tratos.

·         Se validan los datos dependiendo de la estructura que viene

·         Si las validaciones son correctas, se sube a la base de datos de Recursos Humanos.

 

Diagrama de Consulta de Vacaciones a través del WebService para Recursos Humanos

 

A continuación, se muestra un diagrama de cómo funciona el WebService de Vacaciones para Recursos Humanos:

 

 

·         El software externo envía el requerimiento de consulta, se procede a su validación.

·         Si la validación es correcta se procede a recuperar la información de vacaciones desde la base de datos de Recursos Humanos y enviar dicha información a la aplicación externa