Descubra cómo utilizar nuestra API para permitir la planificación fuera de Urbantz

Al utilizar nuestra API para planificar las entregas, puede, por ejemplo, permitir a sus clientes planificar una entrega mientras finalizan una compra en su sitio web. Esto reduce el número de veces que debe interactuar con sus clientes y ofrece una experiencia agradable e integrada.

Resumen

1. Configuración en Urbantz
2. Documentación API
3. Proceso

1. Configuración en Urbantz

La planificación de entregas por API requiere la existencia de un Flujo de tipo Planificación. Encontrará información detallada en este artículo al respecto.

2. Documentación API

Nuestra documentación API está disponible aquí y comprende cuatro secciones llamadas "Get timeslots" (franjas horarias), "Reserve a timeslot" (reservar una franja horaria), "Confirm a reservation" (confirmar una reserva) y "Cancel a reservation" (Cancelar una reserva) que deben consultarse para la planificación por API.

3. Proceso

Su servicio puede, por ejemplo durante la validación de un pedido en su sitio web, enviar una solicitud de disponibilidad de franja horaria a Urbantz. Esta consulta debe contener ciertos parámetros particulares especificados en nuestra documentación API. Urbantz devolverá una lista de franjas horarias disponibles con un conjunto de información, entre las que se incluyen un identificador de franja horaria y una configuración, un almacén y las características de inicio y parada que deben utilizarse más tarde para reservar una franja horaria, así como información sobre la capacidad ya utilizada.

La reserva de una franja horaria es el siguiente paso. Durante esta etapa se reservará capacidad, pero no se creará ninguna tarea. Urbantz devolverá entre otras cosas un "número de reserva" (timeslotReservationId) correspondiente a la franja horaria elegida que deberá utilizarse durante el anuncio efectivo de la tarea.

ℹ️ Las reservas no se muestran en Urbantz. Estas informaciones no están disponibles más que utilizando consultas API. Una vez que su cliente haya finalizado su compra en su sitio web, puede proceder a un anuncio de tarea utilizando el "número de reserva" (timeslotReservationId). La reserva se transformará en tarea, y los métodos habituales para cambiar las propiedades de la tarea se aplican ahora (eliminar, actualizar etc.).

❗️ Si el proceso de compra es abandonado por su cliente, las franjas horarias deben liberarse activamente utilizando el identificador de reserva, de lo contrario, la capacidad permanecerá bloqueada. No existe un proceso de liberación automática de franjas.

ℹ️ Si se desea, una reserva puede ser forzada para sobrecargar una franja horaria, por ejemplo, si varios clientes intentan reservar la misma franja horaria, pero sólo hay capacidad para una. Este parámetro es por defecto 'false', cámbielo a 'true' si operacionalmente hablando tiene la capacidad de sobrecargar franjas horarias.

Consulte también nuestra documentación API sobre la reserva de franjas horarias aquí.