Recevoir les commandes

Lorsque Uber Direct Bridge est connecté à HubRise, les commandes créées ou mises à jour dans HubRise déclenchent des demandes de devis ou de livraison auprès d'Uber Direct.

Cette page décrit les conditions de déclenchement des demandes de livraison, la synchronisation des statuts de livraison entre Uber Direct et HubRise, et les informations envoyées à Uber Direct lors de l'envoi d'une demande de livraison.

Demandes de devis et de livraisons

A chaque création ou modification de commande dans HubRise, Uber Direct Bridge peut envoyer une demande de devis ou de livraison à Uber Direct en fonction des critères définis dans la page Configuration.

Demande de devis

Si la commande répond aux critères de livraison et qu'aucun devis n'a encore été créé, Uber Direct Bridge :

Demande un devis de livraison à Uber Direct. Voir Informations de livraison envoyées à Uber Direct pour les informations envoyées.
Enregistre le devis dans HubRise en tant que Delivery Quote rattaché à la commande. Les informations enregistrées incluent :
- Le nom du transporteur : Uber Direct
- Le code ref du transporteur : uber_direct
- Le code ref du devis, qui est l'ID unique du devis dans Uber Direct
- Le coût de livraison
- L'heure de récupération
- L'heure de livraison

Réservation de la livraison

Selon le mode de réservation paramétré dans Uber Direct Bridge :

Réservation automatique des livraisons : La livraison est créée immédiatement.
Demander un devis et attendre la confirmation : La livraison est créée uniquement lorsque le devis est accepté.

Lors de l'envoi d'une demande de livraison, Uber Direct Bridge :

Envoie à Uber Direct l'ID du devis et les détails de la commande.
Attache à la commande HubRise une ressource Delivery, qui contient les informations du devis ainsi que les informations complémentaires suivantes :
- Le code ref de la livraison, qui est l'ID unique de la livraison dans Uber Direct
- Le statut de la livraison, initialisé à pending
- Un URL de suivi, pour localiser le coursier en temps réel
- Le nom du coursier
- Le numéro de téléphone du coursier

Informations envoyées à Uber Direct

Lors de la création d'une livraison, Uber Direct Bridge envoie les informations suivantes à Uber Direct :

Informations de récupération

Ces informations proviennent de la configuration d'Uber Direct Bridge.

Nom de l'enseigne
Adresse de récupération, dont la latitude et la longitude
Numéro de téléphone
Instructions pour le coursier

Informations de livraison

Nom complet du client
Numéro de téléphone du client
Adresse de livraison, dont la latitude et la longitude
Notes de livraison de la commande

Informations de commande

Heure de récupération ou de livraison souhaitée, basée sur les champs expected_time et expected_time_pickup. Si asap est égal à true, Uber Direct envoie un livreur aussi tôt que possible
Code de récupération, indiqué dans le champ collection_code
Montant total de la commande
Liste des articles avec libellés, quantités, prix, et options

Paramètres de retour

Ces paramètres sont définis dans la configuration d'Uber Direct Bridge.

Action en cas de non-livraison : déposer devant la porte ou rapporter la commande
Instructions de retour

Statut de livraison

Uber Direct envoie des mises à jour en temps réel sur le statut de livraison via des crochets Web. Le statut de livraison sur Uber Direct est défini par les champs status et courier_imminent. Le champ courier_imminent indique que le coursier se trouve à environ 1 minute du point de récupération ou de livraison.

Uber Direct Bridge met à jour le statut de la commande et de livraison dans HubRise selon le tableau suivant :

Statut Uber Direct	Courier Imminent	Statut de livraison HubRise	Statut de commande HubRise
`pending`	-	`pending`	-
`pickup`	`false`	`pickup_enroute`	-
`pickup`	`true`	`pickup_approaching`	-
`pickup_complete`	-	`pickup_waiting`	`in_delivery`
`dropoff`	`false`	`dropoff_enroute`	-
`dropoff`	`true`	`dropoff_approaching`	-
`delivered`	-	`delivered`	`completed`
`canceled`	-	`cancelled`	`delivery_failed`
`returned`	-	-	`delivery_failed`

Position du coursier

Pendant le déplacement du coursier, Uber Direct envoie des mises à jour de position toutes les 20 secondes environ.

A réception de ces mises à jour, Uber Direct Bridge modifier les champs suivants dans la ressource Delivery rattachée à la commande HubRise :

Le téléphone et le code d'accès du coursier, dès que disponibles
La latitude et la longitude du coursier

Livraison simulée

Uber Direct propose une fonctionnalité permettant de simuler des livraisons réelles à des fins de test. Dans ce mode, Uber Direct simule le cycle de vie complet d'une livraison, y compris les changements de statut et les mises à jour de position du coursier.

Pour activer les tests automatisés, ajoutez un custom field à votre commande HubRise de la manière suivante :

{  "status": "new",  "service_type": "delivery",  // autres champs de commande...  "custom_fields": {    "uber_direct": {      "robo_courier": {        "mode": "auto"      }    }  }}

Lorsque ce custom field est présent, Uber Direct simule le cycle de vie de la livraison, y compris les changements de statut de pending à delivered.

Dans le custom field robo_courier, vous pouvez indiquer n'importe quelle valeur robo_courier_specification prise en charge dans la documentation de l'API Uber Direct. Par exemple, vous pouvez définir le mode custom et indiquer les horaires souhaités de changements de statut.

Commentaires sur cette page