Day slots
# Company OVAC Day Slots (`query`)
Esta operación permite obtener el desglose detallado de los tramos horarios (`slots`) disponibles para una fecha específica. El método cuenta con una regla de filtrado dinámico del pasado: si se consulta el día en curso, el backend omitirá automáticamente los intervalos anteriores y solo devolverá aquellos cuya hora sea posterior a la hora actual de la solicitud.
### Autenticación
> **Tipo:** API Key**
Header:** `x-jwt-token`
**Ubicación:** Header HTTP_
Ejemplo:_ `x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6...`
## Referencia de la API
### Parámetros de Entrada (Variables)
| Parámetro | Descripción | Requerido | Tipo |
| --- | --- | --- | --- |
| companyId | Identificador único de la entidad en OVAC donde se busca la disponibilidad. | SI | Integer |
| statuteId | Identificador interno en OVAC asociado al trámite específico. | NO | Integer |
| date | Fecha de consulta en formato UTC bajo el estándar ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ). | SI | String |
| reservedMode | `true` -> Muestra/aísla los tramos reservados por profesionales. <br>`false` -> Muestra el horario de atención al público habitual (Valor por defecto). | NO | Boolean |
### Campos de Respuesta (Payload)
La consulta devuelve un array directo de objetos con todos los tramos horarios calculados bajo el campo raíz `companyOVACDaySlots`:
| Parámetro | Descripción | Tipo |
| --- | --- | --- |
| companyOVACDaySlots | Array con la colección de todos los slots horarios calculados para el día. | Array |
| companyOVACDaySlots.**length** | Duración de cada intervalo o hueco de cita expresado en minutos. | Integer |
| companyOVACDaySlots.**utcHour** | Hora de inicio del slot en formato UTC decimal (ej. 6.0 = 06:00, 6.5 = 06:30, 6.25 = 06:15). | Float |
| companyOVACDaySlots.**date** | Fecha y hora específica de inicio del slot en formato ISO 8601 UTC. | String |
| companyOVACDaySlots.**disabled** | Estado de bloqueo del slot. true: Deshabilitado (no se puede reservar); false: Habilitado. | Boolean |
| companyOVACDaySlots.**availability** | Número de huecos netos que quedan libres actualmente en este tramo para agendar. | Integer |
| companyOVACDaySlots.**assignedUsers** | Array con los identificadores numéricos de los agentes disponibles en este tramo. En alta concurrencia. | Array |
| companyOVACDaySlots.**totalAvailability** | Capacidad máxima o concurrencia total de citas simultáneas configurada para el slot. | Integer |
💡 **Nota Aclaratoria: Gestión de Agentes según el Tipo de Concurrencia**
Dependiendo de cómo esté parametrizada la agenda de la entidad o trámite en el backend, la API responderá con lógicas distintas para determinar la ocupación:
- **Baja Concurrencia (****`assignedUsers`****):** No se realiza una asignación dinámica en tiempo real. El array `assignedUsers` expone los IDs de los usuarios/agentes que **ya se encuentran ocupados** con una cita en esa franja. Sirve para descartar de forma preventiva a dichos profesionales.
- **Alta Concurrencia (****`users`****):** Se computa la disponibilidad activa por agente en tiempo real. El método puede alternar o exponer un array de usuarios **completamente disponibles**. Este array se ordena automáticamente por carga de trabajo (desde el agente con menos citas hasta el que tiene más) para equilibrar el reparto.
## Ejemplos de Código y Peticiones
### 1\. Consulta GraphQL
``` graphql
query CompanyOVACDaySlots (
$companyId: ID!,
$statuteId: ID,
$date: String!,
$reservedMode: Boolean
){
companyOVACDaySlots(
companyId: $companyId,
statuteId: $statuteId,
date: $date,
reservedMode: $reservedMode
)
}
```
### 2\. Variables de la Petición (JSON Payload)
``` json
{
"companyId": "2191",
"statuteId": "",
"date": "2026-05-19T00:00:00.000Z",
"reservedMode": false
}
```
### 3\. Ejemplo de comando cURL
``` bash
curl --location "https://api.ovac.pre.councilbox.com/graphql" \
--header "Content-Type: application/json" \
--header "x-jwt-token: {{token}}" \
--data '{"query":"query companyOVACDaySlots ($companyId: ID!, $statuteId: ID, $date: String!, $reservedMode: Boolean){ companyOVACDaySlots(companyId: $companyId, statuteId: $statuteId, date: $date, reservedMode: $reservedMode) }","variables":{"companyId":"2191","statuteId":"","date":"2026-05-19T00:00:00.000Z","reservedMode":false}}'
```
### 4\. Respuesta Esperada (200 OK)
``` json
{
"data": {
"companyOVACDaySlots": [
{
"length": 30,
"utcHour": 14.5,
"date": "2026-05-19T14:30:00.000Z",
"disabled": false,
"availability": 1,
"assignedUsers": [],
"totalAvailability": 1
},
{
"length": 30,
"utcHour": 15.0,
"date": "2026-05-19T15:00:00.000Z",
"disabled": true,
"availability": 0,
"assignedUsers": [],
"totalAvailability": 1
},
{
"length": 30,
"utcHour": 15.5,
"date": "2026-05-19T15:30:00.000Z",
"disabled": true,
"availability": 0,
"assignedUsers": [
3477
],
"totalAvailability": 1
},
{
"length": 30,
"utcHour": 16.0,
"date": "2026-05-19T16:00:00.000Z",
"disabled": false,
"availability": 1,
"assignedUsers": [],
"totalAvailability": 1
}
]
}
}
```
> **Nota OpenAPI/Fern:** esta operación GraphQL se documenta como `/graphql/companyovacdayslots` para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es `POST /graphql`.