Alta de trabajadores (Lite)
Proceso de Contratación Simplificado
POST: Crear un nuevo proceso de contratación (versión lite)
Descripción del API
Este endpoint permite crear un nuevo proceso de contratación para un trabajador de forma simplificada. Los campos con IDs específicos se autoasignan automáticamente en el sistema.
Endpoint
POST /api/hiring-lite/process
Parámetros de entrada
Atributo | Requerido | Tipo | Descripción | Ejemplo |
---|---|---|---|---|
source | Sí | string | Fuente del proceso de contratación | "BREIK" |
worker_document_type | Sí | string | Tipo de documento del trabajador | "DNI" |
worker_document_number | Sí | string | Número del documento del trabajador | "45234567" |
check_attendance | Sí | boolean | Indica si se debe verificar la asistencia del trabajador | true |
worker_names | Sí | string | Nombres del trabajador | "Carlos Alberto" |
worker_surnames | Sí | string | Apellidos del trabajador | "Martínez Gómez" |
contract_type | Sí | string | Tipo de contrato (indeterminate, fixed-term) | "fixed-term" |
multisite | Sí | boolean | Indica si el trabajador estará en múltiples sitios | false |
home_office | Sí | boolean | Indica si el trabajador podrá trabajar desde casa | false |
worker_email | Sí | string | Correo electrónico personal del trabajador | "carlos.martinez@example.com" |
worker_type | Sí | string | Tipo de trabajador (employee, workman) | "employee" |
external_id | Sí | string | ID externo del trabajador | "1023" |
worker_birthdate | No | string | Fecha de nacimiento del trabajador | "1992-07-15T00:00:00" |
corporate_email | No | string | Correo electrónico corporativo del trabajador | "cmartinez@empresa.com" |
worker_cellphone | No | string | Teléfono celular del trabajador | "991234567" |
contract_start | Si | string | Fecha de inicio del contrato | "2024-02-01T00:00:00" |
contract_end | No | string | Fecha de finalización del contrato | "2024-12-31T00:00:00" |
personal_address | No | string | Dirección de la casa del colaborador | "Jr. Junín cdra. 1, Lima 15001" |
corporate_cellphone | No | string | Teléfono celular corporativo del trabajador | "987654321" |
JSON de ejemplo (entrada)
{
"source": "BREIK",
"worker_document_type": "DNI",
"worker_document_number": "45234567",
"check_attendance": true,
"worker_names": "Carlos Alberto",
"worker_surnames": "Martínez Gómez",
"contract_type": "fixed-term",
"multisite": false,
"home_office": false,
"worker_email": "carlos.martinez@example.com",
"worker_type": "employee",
"external_id": "1023",
"worker_birthdate": "1992-07-15T00:00:00",
"corporate_email": "cmartinez@empresa.com",
"worker_cellphone": "991234567",
"contract_start": "2024-02-01T00:00:00",
"contract_end": "2024-12-31T00:00:00",
"personal_address": "Jr. Junín cdra. 1, Lima 15001",
"corporate_cellphone": "987654321",
}
Parámetros de salida
Atributo | Tipo | Descripción | Ejemplo |
---|---|---|---|
userId | entero | Identificador único del usuario. | 7339 |
statusCode | entero | Código de estado de la respuesta. | 200 |
message | cadena | Mensaje general de la respuesta. | "Se procesó la contratación correctamente." |
details.user | cadena | Mensaje sobre la actualización del usuario. | "Usuario creado correctamente" |
details.backgroundUser | cadena | Mensaje sobre la creación del background del usuario. | "Background creado correctamente" |
details.teamResponse.message | cadena | Mensaje sobre la asociación del usuario al equipo. | "El usuario fue asociado al equipo correctamente." |
details.teamResponse.assigned | booleano | Indica si el usuario fue asociado al equipo. | true |
details.autoAssignments.message | cadena | Mensaje sobre las asignaciones automáticas realizadas. | "Se realizaron las asignaciones automáticas correctamente." |
details.autoAssignments.assigned | booleano | Indica si se realizaron las asignaciones automáticas. | true |
details.locationResponse.message | cadena | Mensaje sobre la asignación de lugares de marcación. | "Se asignaron los lugares de marcación al usuario correctamente." |
details.locationResponse.assigned | booleano | Indica si los lugares de marcación fueron asignados al usuario. | true |
details.locationPersonalResponse.assigned | booleano | Indica si se asignó casa del personal en locación. | true |
JSON de ejemplo (salida)
- Respuesta 200 OK:
{
"userId": 7339,
"statusCode": 200,
"message": "Se procesó la contratación correctamente.",
"details": {
"user": "Usuario creado correctamente",
"backgroundUser": "Background creado correctamente",
"teamResponse": {
"message": "El usuario fue asociado al equipo correctamente.",
"assigned": true
},
"autoAssignments": {
"message": "Se realizaron las asignaciones automáticas correctamente.",
"assigned": true
},
"locationResponse": {
"message": "Se asignaron los lugares de marcación al usuario correctamente.",
"assigned": true
},
"locationPersonalResponse": {
"message": "Se asignó casa del personal en locación correctamente.",
"assigned": true
}
}
}