馃挕Definici贸n
La programaci贸n de cita inteligente es uno de los 3 m茅todos de programaci贸n de cita propuestos por Woop. Se refiere a los transportistas que optimizan sus rutas a trav茅s del m贸dulo Route Planner y consiste en recuperar los horarios de entrega disponibles en funci贸n de la capacidad real de las flotas utilizadas.
鈿欙笍 Configuraci贸n
Para utilizar la programaci贸n de cita inteligente, es necesario realizar las siguientes configuraciones:
1/ Configurar la suscripci贸n a nivel del transportista
- Ve a la ficha del "Transportista" correspondiente
- Haz clic en la pesta帽a "T茅cnica"
- Agrega la suscripci贸n "Prise de RDV"
- Introduce la URL: http://woop-connector.woop/bookings
2/ Activar la programaci贸n de cita a nivel del par cadena comercial/transportista
- Ve a tu ficha "Cadena comercial"
- Haz clic en el "Transportista" correspondiente
- Haz clic en la pesta帽a "T茅cnica"
- Marca la opci贸n "Programaci贸n de cita externa"
3/ Configurar los tipos de horarios:
- Ve a la ficha del "Transportista" correspondiente
- Haz clic en la pesta帽a "Red de entrega"
- Configura los tipos de horarios seg煤n el modo deseado:
- Por duraci贸n/frecuencia
- Por franja horaria
- Para los horarios de tipo franja horaria, existen 2 categor铆as de horarios posibles:
- Est谩ndar : que aparecen por defecto al buscar los horarios disponibles)
- Premium : que aparecen solo si se solicita a trav茅s de los datos adicionales (ver m谩s abajo).
馃摑 Funcionamiento
A continuaci贸n, se presentan las diferentes llamadas API que deben realizarse para reservar un horario inteligente:
1锔忊儯 post/timeSlot (aqu铆)
Esta primera llamada API permite consultar el motor de optimizaci贸n para verificar la disponibilidad de cada uno de los horarios en el rango de fechas solicitado.
Los datos requeridos en el cuerpo son:
- La lista de transportistas elegibles
- Los lugares de recogida y entrega
- Las fechas/horas de recogida y entrega (cf promesa calculada en el paso anterior).
- El contenido del pedido (detalle de los paquetes y productos)
- Los servicios de entrega
鈿狅笍 Es importante establecer la opci贸n "promise" en "true" para tener en cuenta las restricciones de calendario de los transportistas (corte, plazos de entrega, per铆odos de actividad, ...).
馃挕 Tambi茅n es posible agregar "datos adicionales" en forma de claves/valores que se transformar谩n en par谩metros para el motor de optimizaci贸n. Las claves gestionadas son:
- OPTIONS = lista de opciones de veh铆culos (ej: "Gr煤a", "Elevador", "Refrigerado", ...)
- SKILLS = lista de competencias de conductores (ej: "Instalaci贸n", ...)
- SLOT_CATEGORY = "Premium_first" = esto permite recuperar 煤nicamente los horarios de tipo "premium" Y para los cuales es posible posicionar el pedido primero en la ruta de un veh铆culo.
En respuesta, el post/timeSlot devuelve para cada transportista la lista de horarios disponibles con un Id asociado.
2锔忊儯 post/booking (aqu铆)
Esta segunda llamada API permite reservar el horario elegido por el cliente final.
Para ello, basta con enviar el Id del horario proporcionado en el paso anterior. A cambio, se obtiene un Id de booking. Por defecto, el horario se reservar谩 durante 30 minutos, pero es posible ajustar este plazo a trav茅s del campo expiredAt (con un l铆mite m谩ximo de 100 d铆as).
3锔忊儯 post/order (aqu铆)
Esta tercera y 煤ltima llamada API permite crear la orden de transporte en Woop. Es necesario proporcionar un Id de booking v谩lido para confirmar la reserva definitiva del horario.