Descripción general

Esta guía describe los pasos para gestionar el enrutamiento dentro de la integración de la API OneRail OmniPoint, centrándose tanto en el enrutamiento manual como en la optimización automática de rutas. También explica cómo gestionar flotas internas y externas, y cómo usar ventanas de entrega cuando corresponda.

Primero, se debe determinar si los pedidos/entregas se crearán manualmente a través de la interfaz web de la plataforma o mediante la integración de la API. Esta guía abordará cómo crear pedidos/entregas mediante la API. Para obtener más información sobre la creación manual de pedidos y entregas, consulte el siguiente artículo: Creación de un pedido de entrega - Creación manual.

Proceso de creación de entrega o pedido

Antes de iniciar el enrutamiento, es fundamental entender la diferencia entre realizar una entrega y crear un pedido dentro del sistema OneRail. Estas diferencias influyen en cómo se configuran el enrutamiento y la optimización.

Creación de un pedido

/order/create

Un pedido representa una transacción o solicitud iniciada por un cliente. Típicamente incluye una lista de artículos adquiridos, datos del cliente y cualquier instrucción adicional relacionada con la transacción. Los pedidos son más amplios y, a menudo, preceden a las entregas. Organizan y rastrean los detalles transaccionales, que eventualmente pueden derivar en una o más entregas.

Generalmente, los pedidos se sincronizan en el sistema OneRail desde sistemas de comercio electrónico o ERP externos mediante APIs o herramientas de integración.

Para obtener más información sobre este endpoint, consulte el siguiente enlace: Swagger - Crear un pedido

Creación de una entrega

/delivery/create

Una entrega se centra en transportar mercancías desde un punto de recogida hasta un punto de entrega. Incluye información logística detallada, como dimensiones de los artículos, pesos, ventanas de entrega e información del cliente.

Las entregas son posteriores y contienen especificaciones operativas como compromisos de SLA, detalles del transportista y requisitos de enrutamiento.

Para obtener más información sobre este endpoint, consulte el siguiente enlace: Swagger - Crear una entrega

Enrutamiento a través de la API

El enrutamiento implica definir la secuencia específica de paradas y pedidos para las entregas usando el endpoint /v1/routes.

Pasos para el enrutamiento con la API:

1. Identificar los pedidos para enrutamiento:

   • Seleccione los pedidos que necesiten incluirse en la ruta.
   • Prepare los detalles necesarios del pedido, como ubicaciones de recogida y entrega, ventanas de entrega y niveles de servicio.

2. Crear la ruta (POST /v1/routes):

   • Use el atributo skipOptimizer para controlar si el sistema debe optimizar la secuencia de paradas o mantenerla tal como se proporciona.
   • Defina la secuencia de entregas explícitamente en la matriz orders.
   • Swagger - Crear una ruta

3. Actualizar rutas según sea necesario (PUT /v1/routes):

   • Modifique rutas existentes agregando, eliminando o reordenando pedidos usando la misma configuración de skipOptimizer.

Funcionalidad del optimizador de rutas

La API de OneRail proporciona potentes capacidades de optimización de rutas para agilizar las operaciones de entrega. El optimizador reordena las paradas dentro de una ruta según factores como distancia, ventanas de entrega y restricciones logísticas.

Controlar el optimizador con skipOptimizer

• Atributo: skipOptimizer
  • Tipo: Booleano
  • Propósito: Determina si el optimizador de rutas está habilitado para una ruta.
    • true: Se omite el optimizador de rutas y se respeta la secuencia de entregas tal como se proporcionó en la matriz orders.
    • false: El optimizador reordena automáticamente las entregas para minimizar la distancia y el tiempo de viaje.

Beneficios del optimizador de rutas

• Reduce el tiempo de viaje y los costos de combustible en general.
• Garantiza el cumplimiento de las ventanas de entrega y otras restricciones.
• Ajusta automáticamente las rutas para optimizar la eficiencia sin intervención manual.

Casos de uso de skipOptimizer

1. Enrutamiento preciso:
   Establezca skipOptimizer: true cuando necesite control total sobre la secuencia de entrega para escenarios como entregas urgentes o basadas en prioridad.

2. Optimización de eficiencia:
   Establezca skipOptimizer: false para que el sistema reordene las paradas y logre la máxima eficiencia, especialmente en operaciones de alto volumen o rutas complejas.

Ejemplo de uso de skipOptimizer

• Solicitud con la optimización desactivada (skipOptimizer: true):

  {
  "routes": [
    {
      "id": "ROUTE456",
      "skipOptimizer": true,
      "orders": [ /* Custom sequence */ ]
    }
  ]
}  

• Solicitud con la optimización activada (skipOptimizer: false):

  {
  "routes": [
    {
      "id": "ROUTE456",
      "skipOptimizer": false,
      "orders": [ /* System-reordered sequence */ ]
    }
  ]
}  

Flota interna vs. flota externa

El tipo de flota utilizada influye significativamente en la configuración, el enrutamiento y los procesos de optimización. Es importante comprender los requisitos y las diferencias de enrutamiento para gestionar flotas internas y externas.

Flota interna

Si su organización gestiona su propia flota de vehículos de entrega, se requiere una configuración adicional para garantizar una planificación de rutas eficiente y una integración operativa.

Requisitos de configuración

1. Configuración de mercado:

   • Defina el área geográfica o las zonas donde opera su flota.
   • Especifique las restricciones operativas, como los horarios límite de entrega y las horas de servicio.
   • Los mercados se configuran para alinearse con las regiones de entrega específicas de su organización.

2. Activos de la flota:

   • Registre todos los vehículos de su flota, incluidos detalles como la capacidad, los límites de peso y los tipos de vehículos.
   • Asegúrese de que cada vehículo esté vinculado a su mercado correspondiente para mantener la precisión en las rutas.

3. Acuerdos de Nivel de Servicio (SLAs):

   • Defina los compromisos de recogida y entrega, incluidos los tiempos de margen para retrasos y los plazos de fin de jornada.
   • Los SLAs ayudan a garantizar la calidad de servicio esperada y las métricas de rendimiento basadas en el tiempo.

Enrutamiento para flotas internas

• El enrutamiento y la optimización tienen en cuenta las capacidades y restricciones específicas de su flota.
• Las rutas se diseñan con base en:
  • La capacidad y la carga de los vehículos.
  • Los requisitos de SLA para los horarios de recogida y entrega.
  • Las restricciones geográficas dentro de los mercados definidos.

Flota externa

Si utiliza proveedores de entrega de terceros (transportistas), la configuración y los procesos de enrutamiento se simplifican, ya que OneRail gestiona la integración con los transportistas.

Proceso de integración

1. Configuración de transportistas:

   • Asegúrese de que los transportistas seleccionados estén integrados en la plataforma OneRail.
   • Confirme que los contratos y los niveles de servicio con los transportistas estén configurados adecuadamente.

2. Enrutamiento con flotas externas:

   • OneRail se encarga de las decisiones de enrutamiento utilizando los datos de los transportistas, que incluyen la disponibilidad de flotas, la cobertura geográfica y las restricciones de SLA.
   • El sistema selecciona al transportista más adecuado en función de los requisitos de entrega y la rentabilidad.

Ventajas de utilizar flotas externas

• No es necesario gestionar el registro de vehículos, el mantenimiento ni las configuraciones de mercado.
• Operaciones simplificadas con una configuración mínima.
• Mayor flexibilidad al aprovechar varios transportistas para una cobertura geográfica más amplia.