Puestos

GET: Obtener tipos de ausentismo

Descripción del API
Este servicio proporciona información relacionada con los tipos de ausentismo en el sistema. Permite obtener una lista de las diferentes razones de ausencia registradas para su uso en el sistema.

Método HTTP

GET /api/absence-reasons

Parámetros de Entrada

Atributo	Descripción	Tipo	Requerido

JSON de ejemplo (entrada)

{}

Parámetros de Salida

Atributo	Descripción	Tipo
id	Identificador único del tipo de ausentismo	integer
slug	Nombre descriptivo del tipo de ausentismo	string
type	Tipo de estatus relacionado con el ausentismo	string
code_status_day	Código de estatus del día asociado al ausentismo	integer
type_2	Tipo adicional relacionado con el estatus del ausentismo	string
code_2	Código adicional asociado al estatus del ausentismo	string
name_2	Nombre adicional del tipo de ausentismo (ej. "Permiso Pagado")	string
created_at	Fecha y hora de creación del tipo de ausentismo	timestamp
updated_at	Fecha y hora de la última actualización del tipo de ausentismo	timestamp

JSON de ejemplo (salida)

[
    {
        "id": 9,
        "slug": "paid_permission",
        "type": "LIST_STATUS_FINISH WORKERDAY",
        "code_status_day": 9,
        "type_2": "STATUS_DAY",
        "code_2": "PP",
        "name_2": "Permiso Pagado"
    },
    {
        "id": 10,
        "slug": "permission",
        "type": "LIST_STATUS_FINISH WORKERDAY",
        "code_status_day": 10,
        "type_2": "STATUS_DAY",
        "code_2": "P",
        "name_2": "Permiso No Pagado"
    },
    {
        "id": 11,
        "slug": "vacation",
        "type": "LIST_STATUS_FINISH WORKERDAY",
        "code_status_day": 11,
        "type_2": "STATUS_DAY",
        "code_2": "V",
        "name_2": "Vacaciones"
    }
]

POST: Generar ausentismo

Descripción del API
Este endpoint permite generar un registro de ausentismo para los empleados.

Método HTTP

POST /api/absences

Parámetros de Entrada

Atributo	Descripción	Tipo	Requerido
start_date	Fecha de inicio del ausentismo en formato YYYY-MM-DD.	string	Sí
end_date	Fecha de fin del ausentismo en formato YYYY-MM-DD.	string	Sí
user_id	ID del usuario al que se le registra el ausentismo.	number	Sí
reason_id	ID del motivo de la ausencia.	number	Sí
forced	Indicador si el ausentismo fue forzado (opcional).	boolean	No

JSON de ejemplo (entrada)

{
  "start_date": "2024-12-24",
  "end_date": "2024-12-26",
  "user_id": 123,
  "reason_id": 2,
}

Parámetros de Salida

Atributo	Descripción	Tipo
message	Mensaje que indica el estado del procesamiento.	string
workerDays	Lista de objetos con la información de los días de trabajo procesados.	array
workerDays.date	Fecha en la que se registró el día de trabajo.	string
workerDays.message	Mensaje relacionado con el día de trabajo, indicando si ya existe un registro y si se requiere forzar la sobreescritura.	string

JSON de ejemplo (entrada)

{
    "message": "Procesamiento completado",
    "workerDays": [
        {
            "date": "2024-12-25T00:00:00.000Z",
            "message": "Ya existe un workerDay en esta fecha. Para forzar la sobreescritura, incluir el parámetro \"forced\" en true."
        },
        {
            "date": "2024-12-26T00:00:00.000Z",
            "message": "Ya existe un workerDay en esta fecha. Para forzar la sobreescritura, incluir el parámetro \"forced\" en true."
        },
        {
            "date": "2024-12-27",
            "user_id": 1,
            "team_id": 1,
            "worker_day_status_id": 9,
            "total_hours_worked": null,
            "id": 111,
            "correct_entry": null,
            "early_retirement": null
        }
    ]
}