FAQ
¿Qué es RPS?
Países en los que funciona RPS
¿Qué información se debe registrar para una sucursal?
¿Qué se entiende por "Ubicaciones Físicas" en RPS?
¿Como funciona el parámetro "Permite Negativo"?
¿Cuál es el esquema de respaldo y seguridad de la información de los clientes?
¿En que consiste la matriz diaria como trabaja RPS los cálculos automáticos de tipos de días?
¿Se pueden pagar medios días de vacaciones?
Tablas
Empresa
Generales
Monedas
Estructura Regional
Ubicaciones Físicas
Centros de Costos
Estructura Organizacional
Nivel de Clasificación
Áreas de Desempeño
Cargos
Actividades
Tipos de Contratación
Causas de Ingreso
Causas de Retiro
Razones de Terminación
Niveles Educativos
Contratos
Copiar contrato
Básicas de Nómina
Tipos de Trabajadores
Sindicatos
Ocupaciones
Causas de Aumento
Salarios Mínimos
Tasa de Cambio
Tipo de Inactividad
Tipos de Asistencias
Bancos
Fórmulas
Conceptos
Concepto por Contrato
Conceptos de Gross Up
Grupos de Conceptos
Bases de Valoración
Reporte de Procedencias
Reporte Procedencias Combinadas
Básicas Contables
Empleados
Información Básica
Información del Empleado
Históricos
Datos Por País
Cambio Sucursal
Bancos Transferencia Empleados
Empleados a Tiempo Determinado
Renovación de Empleados a Tiempo Determinado
Datos Teletrabajo
Consulta de Empleados
Reporte Bancos de los Empleados (Interactivo)
Cargas Masivas
Procesos
Ajustes
Descripción
Asistencias y Reporte
Conceptos Trabajadores
Ajuste Fijo por Trabajador
Permisos
Inactividad
Licencias Médicas
Entidades Prestadoras de Salud por Trabajador
Carga de Licencias Médicas
Entidades Prestadoras de Salud (EPS)
Anticipo
Nómina
Vacaciones
Vacaciones Acumulativas
Vacaciones Vencidas
Días Vacaciones
Vacaciones Colectivas
Consulta Ciclo Aprobación Vacaciones Acumulativas
Consulta Ciclo Aprobación Vacaciones Vencidas
Utilidades
Liquidaciones
Pasivo Máximo Teórico
Contabilización
Generación de Asientos Contables e Interfaces
Reportes Contables (Interactivos)
Asiento Contable Estándar (Interactivo)
Cierre Contable
Control de Accesos
Reportes
Tiempo y Labor
Tablas Básicas
Accesos por Nivel
Cargas de Nivel
Parámetros Asistencias
Parámetros Movimientos
Accesos Nivel por Trabajador
Flujo Aprobacion de Sueldos
Integración de Presencias
Registro de Eventos
Compensación
Tablas Basicas
Beneficios por Contrato
Seguros
Beneficios Compartidos
Beneficios por Salarios Minimos
Beneficios por Aniversario
Beneficios Ingresos
Aumentos por Ingreso
Pagos Extras
Retroactivos
Periodo de Cálculo del Retroactivo
Conceptos para calcular en el retroactivo
Cálculo de Retroactivo
Consulta y Modificación de Retroactivo
Rangos por Contrato
Priorización de descuentos
RRHH
Definición
Tablas Básicas
Descripción de Cargos
Reingreso Colaboradores
Trayectoria y Documentación
Expediente
Consultas
Cambio de Empresa
Historia Rehired
Consulta del Histórico de Traslados
Dotaciones
Evaluaciones
Tablas Básicas
Administración
Planilla de Evaluaciones
Reporte de Confirmación de Evaluaciones
Consulta de Evaluaciones Eliminadas
Estadísticas
Metas y Logros
Mantenimiento Tipos de Metas
Periodo de Metas
Metas de Trabajadores
Carga de Logros de Metas
Estadísticas de Metas y Logros
Integración de Metas con Evaluaciones
Dashboards
Reclutamiento y Selección
Tablas Básicas
Motivos de Vacantes
Fase de Selección
Tipo de Selección
Sectores Económicos
Definición Notificaciones
Evaluación Solicitantes
Clientes RRHH
Campos Opcionales en Requisiciones
Logo
Administración
Gestión
Definición
Administrar Requisiciones
Selección de Solicitantes
Consulta avanzada de Solicitantes
Ingreso de Solicitantes a Planilla
Consulta Interactiva de Solicitantes
Calificación Solicitantes
Personal Disponible Seleccion Inmediata
Indicadores
Definición
Requisiciones por País
Requisiciones por Reclutador
Avance por Reclutador
Resumen por País
Valorización
Reporte General
Personal Disponible Selección
Consulta Ciclo Aprobación
Consulta Requisiciones Rechazadas
Estadisticas
Capacitaciones
Autogestión
Administración Autogestión
Administración de Cartas
Definición de Cartas
Parámetros de Cartas
Solicitud de Cartas
Notificación de Cartas por Correo
Verificación de Envio de Correos
Consulta de Cartas Impresas
Términos y Condiciones
Confirmación Recibos de Pago
Confirmación de Curriculum
Confirmación de Descripción de Cargo
Consulta de Ciclo Aprobación Perfiles
Administración de Mi Gestión RRHH
Normas y Procedimientos
Corporativo
Definición
Edades y Antigüedades
Reporte de Empleados e Histórico
Dashboard
Indicadores
Monitor Incidencias
Administración
Firmas Trabajadores
Auditorias
Usuarios del Sistema
Roles de Aplicación
Roles por Usuario
Restricciones
Opciones de Correo
Limpiar Caché de Correo
Reportes Interactivos
Funcionalidades
Seleccionar Columnas
Filtrar
Filas por Página
Formato
Flashback
Guardar Reporte
Restablecer
Ayuda
Descargar
API´s
Aspectos Generales
API Expediente de Personal - V2
Pre-requisitos de información:
Método de Integración
Headers del Método
Body del Método Expediente de Personal
Valores de Retorno
API Histórico Integraciones
Pre-requisitos
Métodos de Integración
Headers del Método.
Body del Método
Valores de Retorno del Método
API Integración Bancos
API Temporal Asistencias
Pre-requisitos
Método de Integración
Header del Método
Body del Método
Valores de Retorno del Método
API Temporal Movimientos
Pre-requisitos
Método de Integración
Header del Método
Body del Método
Valores de Retorno del Método
API Licencia Médica
Pre-requisitos
Header del Método
Valores de Retorno del Método
Body del Método
Valores de Retorno del Método
API Solicitud de Vacaciones Vencidas
Pre-requisitos
Métodos de Integración
Header del Método
Body del Método
Valores del Retorno del Método
API Solicitud de Vacaciones Acumulativas
Pre-requisitos
Método de Integración
Header del Método
Body del Método
Valores de Retorno del Método
API de Nómina v2
Tabla de Contenido
- Todas las Categorias
- API´s
- API Histórico Integraciones
- Valores de Retorno del Método
Valores de Retorno del Método
Actualizado por Richard Smith
El JSON de respuesta del webservice HISTORICOS_INTEGRACION contiene los siguientes atributos:
- servicio: Nombre del servicio web que se está ejecutando. Ejemplo: "HISTORICOS_INTEGRACION".
- fecha_procesado: Contiene la fecha y hora en que fue consumido el servicio. Ejemplo: "2021-12-23T12:57:39Z".
- status: Devuelve el estado de la solicitud. Este campo devuelve 0 (cero) si la solicitud pudo ser procesada, y devuelve 1 (uno) si se produjo algún error general. Cabe destacar este valor de estado indica si se produjo un error consumiendo el WS, pero no indica si los registros fueron insertados o no, ya que los mismo poder ser rechazados por validación de la información.
- success_count: Esta variable indica la cantidad de registros que fueron procesados satisfactoriamente.
- error_count: Esta variable indica le cantidad de errores que se produjeron. Cuando la variable error_count es mayor a cero, se devuelve un arreglo llamado errors con el detalle de los errores producidos. El campo error_count tendrá el número total de registros con error, no se toma en cuenta si un mismo registro tiene varios errores.
- errors: La variable errors contiene un arreglo con el detalle de los registros que produjeron error. El arreglo de errores contiene el primer error encontrado en el registro.
Los campos de los registros de errores son los siguientes:
- record: Número de registro que presentó el error.
- cod_empresa: Código de la empresa asociado al registro.
- cod_trabajador: Código del trabajador asociado al registro.
- vlote: Número de lote. Si no se especifica ningún número de lote en el registro, devuelve los caracteres na
- error: Código de error Oracle.
- vsqlerrm: Detalle del error Oracle.
- fecha_integracion: Valor del campo “FECHA_INTEGRACION” asociado al registro.
- fecha_procesado: Contiene la fecha y hora en que fue consumido el servicio.
- usuario: usuario asociado a la implementación del webservice. Usuario WEBSERVICE
- servicio: Nombre del servicio web que se está ejecutando.
Tipos de errores devueltos por el Web Service
Errores generales: Los errores generales son los que impiden que se procese la totalidad del JSON. Los errores generales pueden deberse a un error en el JSON, al envío de un tipo de dato incorrecto o con un formato incorrecto, etc. Un error general detiene la ejecución del WS y devuelve un mensaje de error con un status 1 sin procesar ningún registro.
Errores de integridad de información: Los errores de integridad de informaciones son errores devueltos por Oracle. Dos ejemplos de este tipo de error pueden ser el error “ORA-00001: unique constraint” que indica que el registro que se está insertando ya existe en la tabla (según la clave primaria), o el error “ORA-02291: integrity constraint” que indica que se está rompiendo un constraint de integridad o foring key. Este tipo de errores no detienen la ejecución del WS y son devueltos en el arreglo errors del JSON de respuesta.
Ejemplos de archivo JSON de respuesta:
Ejemplo de archivo JSON de respuesta cuando se procesaron satisfactoriamente los dos registros enviados. Debido a que no existieron errores no está presente el arreglo errors.
{
"servicio": "HISTORICOS_INTEGRACION",
"fecha_procesado": "2021-12-28T18:18:48Z",
"status": 0,
"success_count": 2,
"error_count": 0
}
Ejemplo de archivo JSON de respuesta con un registro procesado satisfactoriamente y un registro procesado con error. Se puede ver que el arreglo errors contiene el registro de error. Nótese que el valor de la variable status es igual a 0, ya que, a pesar de existir errores de validación, el JSON enviado en el body si pudo ser procesado.
{
"servicio": "HISTORICOS_INTEGRACION",
"fecha_procesado": "2021-12-28T18:22:06Z",
"status": 0,
"success_count": 1,
"error_count": 1,
"errors": [
{
"record": "1",
"cod_empresa": "6",
"cod_trabajador": "7",
"vlote": "na",
"error": "ORA-06512: at line 237\n",
"vsqlerrm": "ORA-00001: unique constraint (RPSCLIENTE.HISTORICOS_INTEGRACION_PK) violated",js
"fecha_integracion": "2020-06-01T11:16:05Z",
"fecha_procesado": "2021-12-28T18:22:06Z",
"usuario": "WEBSERVICES",
"servicio": "HISTORICOS_INTEGRACION"
}
]
}
Ejemplo de archivo JSON de respuesta con los dos registros rechazados por validación de la información. Se puede ver que el arreglo errors contiene los dos registros de error.
{
"servicio": "HISTORICOS_INTEGRACION",
"fecha_procesado": "2021-12-28T18:23:00Z",
"status": 0,
"success_count": 0,
"error_count": 2,
"errors": [
{
"record": "1",
"cod_empresa": "6",
"cod_trabajador": "7",
"vlote": "na",
"error": "ORA-06512: at line 237\n",
"vsqlerrm": "ORA-00001: unique constraint (RPSCLIENTE.HISTORICOS_INTEGRACION_PK) violated",
"fecha_integracion": "2020-06-01T11:16:05Z",
"fecha_procesado": "2021-12-28T18:23:00Z",
"usuario": "WEBSERVICES",
"servicio": "HISTORICOS_INTEGRACION"
},
{
"record": "2",
"cod_empresa": "6",
"cod_trabajador": "8",
"vlote": "na",
"error": "ORA-06512: at line 237\n",
"vsqlerrm": "ORA-00001: unique constraint (RPSCLIENTE.HISTORICOS_INTEGRACION_PK) violated",
"fecha_integracion": "2020-06-01T11:16:05Z",
"fecha_procesado": "2021-12-28T18:23:00Z",
"usuario": "WEBSERVICES",
"servicio": "HISTORICOS_INTEGRACION"
}
]
}
Ejemplo de errores generales:
En el siguiente ejemplo se envió un JSON con un formato incorrecto en el body del WS, y se obtiene el siguiente error:
{
"servicio": "HISTORICOS_INTEGRACION",
"fecha_procesado": "2021-12-28T18:24:03Z",
"status": "1",
"error": "exception general ORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1163\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 401\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 736\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1108\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 898\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1019\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 889\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1087\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1145\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1222\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1256\nORA-06512: at line 121\n-ORA-20987: Error at line 70, col 8: strict mode JSON parser does not allow unquoted literals"
}
En el siguiente ejemplo se envió un carácter no numérico en un campo que solo acepta caracteres numéricos, y se devolvió el siguiente error:
{
"servicio": "HISTORICOS_INTEGRACION",
"fecha_procesado": "2021-12-28T18:25:08Z",
"status": "1",
"error": "exception general ORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1163\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 401\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 736\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 946\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1103\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 898\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1019\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 889\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1087\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1145\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1222\nORA-06512: at \"APEX_200100.WWV_FLOW_JSON\", line 1256\nORA-06512: at line 121\n-ORA-20987: Error at line 59, col 26: strict mode JSON parser does not allow unquoted literals"
}