Ir al contenido

Crear un calendario

POST/api/calendar

Crea un calendario. El servidor lo guarda con estado activo y asigna al usuario autenticado como creador (create_user_id). Responde 201 con el registro creado. Si default es verdadero, los demás calendarios pasan a default falso.

namestringobligatorio

Nombre del calendario. Máximo 100 caracteres.

holiday_idintegerobligatorio

Lista de feriados del calendario. Es obligatoria; no se valida que exista.

descriptionstringobligatorio

Descripción. Máximo 500 caracteres.

defaultbooleanobligatorio

Indica si es el calendario por defecto. Si es verdadero, los demás calendarios pasan a default falso.

working_daysarrayobligatorio

Días laborales. Cada elemento lleva day, name, start_hour, end_hour y check.

working_days.*.dayintegerobligatorio

Día de la semana, de 0 (domingo) a 6 (sábado).

working_days.*.namestringobligatorio

Nombre del día.

working_days.*.start_hourstringobligatorio

Hora de inicio con formato HH:MM:SS. Debe ser menor que la hora de fin.

working_days.*.end_hourstringobligatorio

Hora de fin con formato HH:MM:SS.

working_days.*.checkbooleanobligatorio

Indica si el día es laborable.

cashbox.configuration.create, que se valida en CalendarPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/calendar" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "CALENDARIO GENERAL",
"holiday_id": 1,
"description": "Lunes a viernes de 8 a 17 horas",
"default": true,
"working_days": [
{
"day": 1,
"name": "Lunes",
"start_hour": "08:00:00",
"end_hour": "17:00:00",
"check": true
},
{
"day": 6,
"name": "Sábado",
"start_hour": "08:00:00",
"end_hour": "13:00:00",
"check": false
}
]
}'
Calendario creado201
{
"id": 1,
"holiday_id": 1,
"name": "CALENDARIO GENERAL",
"description": "Lunes a viernes de 8 a 17 horas",
"working_days": [
{
"day": 1,
"name": "Lunes",
"start_hour": "08:00:00",
"end_hour": "17:00:00",
"check": true
},
{
"day": 6,
"name": "Sábado",
"start_hour": "08:00:00",
"end_hour": "13:00:00",
"check": false
}
],
"default": true,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Error de validación422
{
"message": "La hora de inicio debe ser menor que la hora de fin para el día Lunes.",
"errors": {
"working_days.0.start_hour": [
"La hora de inicio debe ser menor que la hora de fin para el día Lunes."
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}