Empleados
GET: Obtener empleados
Descripción del API
Obtiene una lista de empleados según su equipo y, si se proporciona, filtra por fecha de actualización.
Parámetros de entrada
Atributo | Requerido | Tipo | Descripción | Ejemplo |
---|---|---|---|---|
updatedAfter | Opcional | fecha | Fecha a partir de la cual se filtran los resultados. | 2024-01-01 |
costCenterName | Opcional | cadena | Fecha a partir de la cual se filtran los resultados. | FM003 |
workerType | Opcional | cadena | Tipo de trabajador. | workman |
isActive | Opcional | booleano | Indica si el empleado está activo. | true |
JSON de ejemplo (entrada)
- Ejemplo de solicitud con parámetro de entrada:
{
"updatedAfter": "2025-01-01",
"costCenterName": "FM003",
"workerType": "workman",
"isActive": true
}
Método HTTP
GET /api/employees
Parámetros de salida
Atributo | Tipo | Descripción | Ejemplo |
---|---|---|---|
name | cadena | Nombre del empleado. | "Carlos" |
first_lastname | cadena | Primer apellido del empleado. | "Gómez" |
second_lastname | cadena | Segundo apellido del empleado. | "Gómez" |
email | cadena | Correo electrónico del empleado. | "carlos.gomez@example.com" |
profile | cadena | Nombre del perfil asignado al empleado. | "Fiscalizable" |
company | cadena | Nombre de la empresa a la que pertenece el empleado. | "Constructora Delta SAC" |
costcenter | cadena | Centro de costos al que está asignado el empleado. | "FM003" |
position | cadena | Cargo del empleado. | "SUPERVISOR DE RRHH EN OBRA" |
active | booleano | Indica si el empleado está activo. | true |
worker_type | cadena | Tipo de trabajador. | "workman" |
updated_at | fecha | Fecha de la última actualización del empleado. | "2025-01-21T04:05:59.000Z" |
JSON de ejemplo (salida)
- Respuesta 200 OK:
[
{
"name": "Carlos",
"first_lastname": "Gómez",
"second_lastname": "Gómez",
"document_number": "0501199307541",
"email": "carlos.gomez@example.com",
"profile": "Fiscalizable",
"company": "Constructora Delta SAC",
"costcenter": "FM003",
"position": "SUPERVISOR DE RRHH EN OBRA",
"active": true,
"worker_type": "workman",
"updated_at": "2025-01-21T04:05:59.000Z"
},
{
"name": "Sofía",
"first_lastname": "López",
"second_lastname": "López",
"document_number": "0402198806543",
"email": "sofia.lopez@example.com",
"profile": "No Fiscalizable",
"company": "Ingeniería y Obras S.A.",
"costcenter": "FM003",
"position": "SUPERVISOR DE RRHH EN OBRA",
"active": true,
"worker_type": "workman",
"updated_at": "2025-01-20T10:15:30.500Z"
}
]