Coordinalo
Disponibilidad
Configurar horarios y disponibilidad de proveedores
Disponibilidad
Gestiona los horarios en que tus proveedores están disponibles para atender. Coordinalo soporta sincronización bidireccional con Google Calendar.
Conceptos
Disponibilidad recurrente
Horarios que se repiten cada semana (ej: "Lunes de 9:00 a 13:00").
Bloqueos
Períodos donde el proveedor no está disponible (vacaciones, feriados, etc.).
Slots disponibles
Horarios específicos donde se puede agendar una sesión.
Configurar disponibilidad recurrente
POST /api/v1/providers/:providerId/availabilityCuerpo de la solicitud
{
"dayOfWeek": 1,
"startTime": "09:00",
"endTime": "13:00",
"locationId": "loc_abc123"
}dayOfWeek usa el estándar ISO: 1 = Lunes, 7 = Domingo.
Obtener slots disponibles
GET /api/v1/providers/:providerId/slotsParámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
from | string | Fecha inicio (obligatorio) |
to | string | Fecha fin (obligatorio) |
serviceId | string | Servicio (para calcular duración) |
Respuesta
{
"slots": [
{
"start": "2026-01-15T09:00:00Z",
"end": "2026-01-15T10:00:00Z",
"available": true
},
{
"start": "2026-01-15T10:00:00Z",
"end": "2026-01-15T11:00:00Z",
"available": false,
"reason": "session_booked"
}
]
}Crear bloqueo
POST /api/v1/providers/:providerId/blocksCuerpo de la solicitud
{
"startTime": "2026-02-01T00:00:00Z",
"endTime": "2026-02-15T23:59:59Z",
"reason": "Vacaciones"
}Agenda pública
Para booking público (sin autenticación):
GET /api/v1/public/agenda/:agendaSlug/slotsRetorna solo slots disponibles, sin información sensible del proveedor.
Sincronización con Google Calendar
Coordinalo sincroniza de forma bidireccional con Google Calendar:
- Coordinalo → Google: Las sesiones creadas aparecen automáticamente en el calendario del proveedor
- Google → Coordinalo: Eventos externos bloquean automáticamente la disponibilidad
Configurar sincronización
POST /api/v1/providers/:providerId/calendar/connect{
"provider": "google",
"calendarId": "primary"
}La sincronización requiere que el proveedor autorice el acceso a su cuenta de Google.