Aperçu

Ce guide décrit les étapes de gestion du routage dans l’intégration OneRail OmniPoint API, en mettant l’accent à la fois sur le routage manuel et l’optimisation automatisée des itinéraires. Il explique également la gestion des flottes internes et externes, ainsi que l’utilisation de fenêtres de livraison lorsque cela est approprié.

Tout d’abord, il convient de déterminer si les commandes/livraisons seront créées manuellement via l’interface web de la plateforme ou par intégration API. Ce guide expliquera comment créer des commandes/livraisons via l’API. Pour plus d’informations sur la création manuelle de commandes et de livraisons, consultez l’article suivant : Créer une commande de livraison - Création manuelle.

Processus de création de livraison ou de commande

Avant de procéder au routage, il est essentiel de comprendre la différence entre la création d’une livraison et la création d’une commande dans le système OneRail. Ces distinctions influent sur la configuration du routage et de l’optimisation.

Création d’une commande

/order/create

Une commande représente une transaction ou une demande initiée par un client. Elle inclut généralement une liste d’articles achetés, les coordonnées du client et toute instruction supplémentaire liée à la transaction. Les commandes sont plus générales et précèdent souvent les livraisons. Elles organisent et suivent les détails transactionnels, qui peuvent éventuellement aboutir à une ou plusieurs livraisons.

Les commandes sont généralement synchronisées dans le système OneRail à partir de systèmes de commerce électronique ou ERP externes à l’aide d’API ou d’outils d’intégration.

Pour plus d’informations sur ce point de terminaison, consultez le lien suivant : Swagger - Créer une commande

Création d’une livraison

/delivery/create

Une livraison porte sur le transport de marchandises depuis un point de retrait jusqu’à un point de dépôt. Elle inclut des informations logistiques détaillées, telles que les dimensions et poids des articles, les fenêtres de livraison et les informations du client.

Les livraisons sont en aval et incluent des spécifications opérationnelles telles que les engagements SLA, les détails du transporteur et les exigences de routage.

Pour plus d’informations sur ce point de terminaison, consultez le lien suivant : Swagger - Créer une livraison

Routage via l’API

Le routage consiste à définir la séquence spécifique des arrêts et des commandes pour les livraisons en utilisant le point de terminaison /v1/routes.

Étapes pour le routage à l’aide de l’API :

1. Identifier les commandes à router :

   • Sélectionnez les commandes devant être incluses dans l’itinéraire.
   • Préparez les détails nécessaires de la commande, tels que les points de retrait et de dépôt, les fenêtres de livraison et les niveaux de service.

2. Créer l’itinéraire (POST /v1/routes) :

   • Utilisez l’attribut skipOptimizer pour déterminer si la séquence d’arrêts doit être optimisée par le système ou conservée telle quelle.
   • Définissez explicitement la séquence de livraisons dans le tableau orders.
   • Swagger - Créer un itinéraire

3. Mettre à jour les itinéraires selon les besoins (PUT /v1/routes) :

   • Modifiez les itinéraires existants en ajoutant, en supprimant ou en réorganisant les commandes à l’aide de la même configuration skipOptimizer.

Fonctionnalité d’optimisation de l’itinéraire

L’API OneRail offre de puissantes capacités d’optimisation d’itinéraire pour rationaliser les opérations de livraison. L’optimiseur réorganise les arrêts dans un itinéraire en fonction de facteurs tels que la distance, les fenêtres de livraison et les contraintes logistiques.

Contrôler l’optimiseur avec skipOptimizer

• Attribut : skipOptimizer
  • Type : Booléen
  • Objectif : Détermine si l’optimiseur d’itinéraire est activé pour un itinéraire.
    • true : L’optimiseur d’itinéraire est contourné, et la séquence des livraisons est respectée telle que fournie dans le tableau orders.
    • false : L’optimiseur réorganise automatiquement les livraisons afin de réduire la distance et le temps de trajet.

Avantages de l’optimiseur d’itinéraire

• Réduit le temps de trajet global et les coûts de carburant.
• Garantit le respect des fenêtres de livraison et d’autres contraintes.
• Ajuste automatiquement les itinéraires pour plus d’efficacité sans intervention manuelle.

Cas d’utilisation de skipOptimizer

1. Routage précis :
   Définissez skipOptimizer: true lorsque vous avez besoin d’un contrôle total sur la séquence des livraisons pour des scénarios tels que les livraisons urgentes ou prioritaires.

2. Optimisation de l’efficacité :
   Définissez skipOptimizer: false pour permettre au système de réorganiser les arrêts pour une efficacité maximale, en particulier pour les opérations à fort volume ou les itinéraires complexes.

Exemple d’utilisation de skipOptimizer

• Requête avec optimisation désactivée (skipOptimizer: true) :

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

• Requête avec optimisation activée (skipOptimizer: false) :

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

Flotte interne vs. flotte externe

Le type de flotte utilisé a un impact significatif sur la configuration, le routage et les processus d’optimisation. Il est important de comprendre les exigences et les différences de routage lors de la gestion des flottes internes et externes.

Flotte interne

Si votre organisation gère sa propre flotte de véhicules de livraison, une configuration supplémentaire est nécessaire pour garantir un routage efficace et une intégration opérationnelle.

Exigences de configuration

1. Configuration du marché :

   • Définissez la zone géographique ou les zones dans lesquelles votre flotte opère.
   • Spécifiez les contraintes opérationnelles telles que les heures limites de livraison et les heures de service.
   • Les marchés sont configurés pour s’aligner sur les régions de livraison spécifiques à votre organisation.

2. Ressources de la flotte :

   • Enregistrez tous les véhicules de votre flotte, y compris les détails tels que la capacité, les limites de poids et les types de véhicules.
   • Assurez-vous que chaque véhicule est associé à son marché respectif pour maintenir un routage précis.

3. Accords de niveau de service (SLAs) :

   • Définissez les engagements de ramassage et de dépôt, y compris les marges de retard et les échéances de fin de journée.
   • Les SLA contribuent à faire respecter la qualité de service attendue et les indicateurs de performance basés sur le temps.

Routage pour les flottes internes

• Le routage et l’optimisation tiennent compte des capacités et des contraintes spécifiques de votre flotte.
• Les itinéraires sont adaptés en fonction de :
  • La capacité et la charge du véhicule.
  • Les exigences SLA pour les horaires de ramassage et de livraison.
  • Les contraintes géographiques dans les marchés définis.

Flotte externe

Si vous faites appel à des prestataires de livraison tiers (transporteurs), les processus de configuration et de routage sont simplifiés car OneRail gère l’intégration des transporteurs.

Processus d’intégration

1. Configuration des transporteurs :

   • Assurez-vous que les transporteurs que vous avez choisis sont intégrés à la plateforme OneRail.
   • Confirmez que les contrats et les niveaux de service avec les transporteurs sont correctement configurés.

2. Routage avec des flottes externes :

   • Les décisions de routage sont prises par OneRail à l’aide des données des transporteurs, qui incluent la disponibilité de la flotte, la couverture géographique et les contraintes SLA.
   • Le système sélectionne le transporteur le plus adapté en fonction des exigences de livraison et de la rentabilité.

Avantages de l’utilisation de flottes externes

• Aucun besoin de gérer l’immatriculation des véhicules, la maintenance ou les configurations de marché.
• Des opérations simplifiées avec une configuration minimale.
• Une plus grande flexibilité en faisant appel à plusieurs transporteurs pour une couverture géographique plus étendue.