Aperçu

Ce guide explique comment utiliser l'API OneRail pour déterminer les tarifs d'expédition pour une livraison potentielle et mettre progressivement à jour une commande à l'aide de mises à jour partielles. Ces actions sont essentielles pour tarifer dynamiquement les livraisons et gérer efficacement le flux de travail de livraison.

L'utilisation du point de terminaison /delivery/get-rates permet aux organisations de créer des brouillons de commandes de livraison à partir des informations tarifaires récupérées auprès des transporteurs admissibles. Par la suite, les mises à jour partielles garantissent que, lorsque des données plus précises (telles que les coûts finaux ou les affectations de transporteurs) deviennent disponibles, elles peuvent être reflétées sans avoir à soumettre à nouveau l'intégralité de la charge utile de livraison.

Flux de création de livraison utilisant l'obtention de tarifs et les mises à jour partielles

/delivery/get-rates

Ce point de terminaison récupère les tarifs de livraison auprès des transporteurs disponibles en fonction des détails de livraison fournis. Cela est influencé par la configuration des partenaires logistiques (LP) et les paramètres organisationnels, tels que les définitions de colis.

• Seuls les transporteurs qui répondent avec succès sont pris en compte ; les transporteurs qui ne répondent pas sont exclus des résultats.
• Les tarifs renvoyés peuvent être utilisés pour créer une commande brouillon et présenter des options à l'utilisateur final.
• La configuration des LP est gérée via les paramètres de contrat de l'expéditeur et la logique d'achat des LP.

Pour des détails complets sur l'implémentation, reportez-vous à : Swagger - Get Rates

/order/{orderID}/partial-update

Après avoir obtenu le fournisseur le moins coûteux, ce point de terminaison est utilisé pour mettre à jour une livraison brouillon existante avec des informations finalisées, telles que la sélection du transporteur, la ventilation des prix ou la génération d'étiquettes.

• Le moment de la génération des étiquettes est crucial ; s'il est nécessaire immédiatement, la requête de mise à jour doit inclure un indicateur requestLabel: true.
• Permet un contrôle précis de la progression de la livraison, de la demande de devis jusqu'à l'état prêt pour l'envoi.
• Idéal pour les systèmes où la création et l'exécution des commandes se déroulent par étapes.

Pour des détails complets sur l'implémentation, reportez-vous à : Swagger - Partial Update

Flux de travail de bout en bout

1. Comparaison des tarifs : Utilisez /delivery/get-rates pour prévisualiser les options de livraison potentielles et leur tarification.
2. Créer une livraison brouillon : En fonction des tarifs préférés, initiez un objet de livraison avec des informations partielles (par exemple, sans étiquettes ni coûts finaux).
3. Mettre à jour la livraison : Lorsque les décisions sont finalisées, utilisez /delivery/partial-update pour refléter le choix du transporteur, mettre à jour les coûts et déclencher la génération des étiquettes.
4. Finaliser l'envoi : Une fois tous les champs renseignés, faites passer l'état de la livraison à READY_TO_DISPATCH.

Avantages

• Sépare la tarification de la soumission finale de la livraison.
• Réduit la charge dans les comparaisons de tarifs des transporteurs.
• Prend en charge des scénarios d'exécution agiles grâce à des mises à jour dynamiques.