Create Request

Create a general request for absence, permission, or remote work

POST /api/solicitudes

Create Request

cURL

curl --request POST \
  --url https://api.example.com/api/solicitudes \
  --header 'Content-Type: application/json' \
  --data '
{
  "id_tipo_solicitud": 123,
  "fecha_inicio": "<string>",
  "fecha_fin": "<string>",
  "descripcion_solicitud": "<string>",
  "documento_url": "<string>"
}
'

400 Bad Request - Invalid Type

{
  "message": "Tipo de solicitud ID 99 inválido."
}

Endpoint

POST /api/solicitudes

This endpoint handles creation of general requests. For vacation requests, use the dedicated vacation endpoint.

Supported Request Types

Absence

Type ID: 3

Report justified absences

Permission

Type ID: 2

Request special permissions

Remote Work

Type ID: 4

Request to work externally

Request Body

id_tipo_solicitud · number · required

Type of request:

• 2: Permission
• 3: Absence
• 4: Remote Work

Note: Use 1 for vacation via /api/solicitudes/crearSolicitudVacaciones

fecha_inicio · string · required

Start date in ISO format or YYYY-MM-DD

Example: "2026-04-01" or "2026-04-01T08:00:00"

fecha_fin · string · required

End date in ISO format or YYYY-MM-DD

Must be equal to or after fecha_inicio

descripcion_solicitud · string · required

Description or reason for the request

Example: "Medical appointment"

documento_url · string

Optional URL to supporting document (e.g., medical certificate)

Response

message · string

Success message indicating the request was created

solicitud · object

Show properties

id_solicitud · number

Unique identifier for the created request

id_empleado · number

Employee who created the request

id_tipo_solicitud · number

Type of request (2, 3, or 4)

id_estado_solicitud · number

Initial state (always 1 for Pending)

fecha_inicio · string

Start date (YYYY-MM-DD HH:mm:ss)

fecha_fin · string

End date (YYYY-MM-DD HH:mm:ss)

dias_solicitados · number

Calculated number of days

descripcion_solicitud · string

Request description

documento_url · string

Document URL if provided

Code Examples

JavaScript

const token = 'your_jwt_token';

const requestData = {
  id_tipo_solicitud: 3,
  fecha_inicio: '2026-04-10',
  fecha_fin: '2026-04-10',
  descripcion_solicitud: 'Medical appointment',
  documento_url: 'https://example.com/docs/certificate.pdf'
};

const response = await fetch('/api/solicitudes', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(requestData)
});

const data = await response.json();
console.log(data);

Response Example

201 Created

{
  "message": "Solicitud de 3 creada exitosamente.",
  "solicitud": {
    "id_solicitud": 456,
    "id_empleado": 78,
    "id_tipo_solicitud": 3,
    "id_estado_solicitud": 1,
    "fecha_inicio": "2026-04-10 00:00:00",
    "fecha_fin": "2026-04-10 00:00:00",
    "dias_solicitados": 1,
    "descripcion_solicitud": "Medical appointment",
    "documento_url": "https://example.com/docs/certificate.pdf"
  }
}

Error Responses

400 Bad Request - Invalid Type

{
  "message": "Tipo de solicitud ID 99 inválido."
}

Notifications

When a request is created, the system automatically sends notifications to all HR administrators (users with Admin role). The notification includes:

• Title: “Nueva Solicitud de Permiso”
• Message: Employee name and request type
• Type: SOLICITUD_NUEVA
• Reference: The created request ID

Business Logic

Day Calculation

The system automatically calculates dias_solicitados based on the date range, excluding weekends and considering business days.

Date Formatting

All dates are stored in MySQL datetime format (YYYY-MM-DD HH:mm:ss) using dayjs library.