HOhogarsolar
copilot_frontend
citas

Obtener Disponibilidad Completa

Endpoint Orquestador Principal que obtiene toda la información necesaria para gestionar citas.

Este endpoint unifica la lógica de:

  1. Obtener comerciales filtrados por modalidad
  2. Obtener configuración de la modalidad
  3. Obtener eventos existentes del comercial
  4. Buscar slots disponibles para el día

Args: request: Datos de la solicitud (modalidad, fecha, cp_cliente, comercial_email)

Returns: DisponibilidadResponse con: - comerciales: Dict {nombre: email} de comerciales disponibles - modalidad_config: Configuración de la modalidad - slots_por_comercial: Dict {email: [slots]} de slots disponibles por comercial - eventos_por_comercial: Dict {email: [eventos]} de eventos existentes por comercial

🔒 Endpoint Protegido: Requiere autenticación JWT y rol 'ui_comercial', 'ui_citas' o 'admin'

Ejemplo de uso:

POST /crm/citas/obtener-disponibilidad
{
    "modalidad": "visita",
    "fecha": "2025-01-15",
    "cp_cliente": "28001",
    "comercial_email": "comercial@hogarsolar.es"  // Opcional
}
post/api/citas/obtener-disponibilidad

Request

Request body

modalidadstring required
fechastring required
cp_clientestring nullable
comercial_emailstring nullable

Response

Successful Response

comercialesobject required
modalidad_configobject required
slots_por_comercialobject required
eventos_por_comercialobject required

Changes

No recorded changes to this operation across all 2 revisions of this API.