Recevoir des commandes

En connectant Wolt à HubRise, vous pouvez recevoir des commandes Wolt directement dans votre logiciel de caisse ou toute autre solution connectée à votre compte HubRise.

Cette page décrit les informations que Wolt envoie à HubRise et la manière dont les informations de livraison sont synchronisées entre les deux plateformes. Elle peut vous aider à comprendre comment les commandes seront reçues dans votre logiciel de caisse et comment fonctionne le suivi des livraisons.

Transmission des commandes

Wolt envoie les commandes à HubRise immédiatement lorsqu'elles sont passées par le client.

Les commandes peuvent être des commandes immédiates ou des précommandes (commandes programmées) :

• Commandes immédiates : doivent être préparées immédiatement et livrées ou récupérées dans le délai de préparation standard.
• Précommandes : ont une heure de retrait ou de livraison programmée spécifiée par le client.

Statuts de commande

---

REMARQUE IMPORTANTE : Dans cette section, nous mettons en majuscule la première lettre des statuts Wolt pour les distinguer plus facilement des noms de statuts HubRise. Par exemple, Created est un statut Wolt, tandis que new est un statut HubRise.

---

Statuts Wolt

Les commandes Wolt passent par plusieurs statuts durant leur cycle de vie :

• Created : la commande a été passée.
• Sent to POS : la commande a été confirmée par le logiciel de caisse. Ce statut est utilisé par Wolt pour l'investigation de problèmes.
• Confirmed (précommandes uniquement) : les précommandes confirmées sont automatiquement acceptées par Wolt à l'approche de l'heure programmée, en fonction du temps de préparation. Wolt ne spécifie pas de délai pour confirmer les précommandes.
• Accepted : les commandes immédiates doivent être acceptées dans les 3 minutes, sinon elles seront automatiquement annulées par Wolt.
• Ready : la commande est en attente de retrait ou de livraison.
• In Delivery (commandes en livraison uniquement) : le livreur a récupéré la commande et est en route vers le client.
• Courier at Customer (livraison par le restaurant uniquement) : le livreur du restaurant est arrivé au domicile du client.
• Delivered : la commande a été livrée au client ou récupérée.
• Canceled : la commande a été annulée par le client, le restaurant ou Wolt.

Lorsque le statut change dans HubRise

Lorsque le statut d'une commande change dans HubRise, Wolt Bridge notifie Wolt du changement selon la correspondance suivante :

Statut HubRise	Statut Wolt
new (création de commande)	Accepted ou Confirmed, si configuré (*).
received	Sent to POS. Peut aussi déclencher Accepted ou Confirmed, si configuré (*).
accepted	Accepted ou Confirmed, si configuré (*).
rejected	Canceled. La commande est refusée avec une raison prédéfinie.
cancelled	Canceled. La commande est annulée avec la raison de seller_notes, ou un message prédéfini.
awaiting_shipment ou awaiting_collection	Ready.
in_delivery (livraison par le restaurant uniquement)	In Delivery.
completed (livraison par le restaurant ou à emporter)	Delivered.

Les autres valeurs de statut HubRise ne sont pas prises en charge et ne sont pas envoyées à Wolt.

(*) : Wolt Bridge vous permet de décider quel statut HubRise déclenche la transition vers le statut Accepted dans la section Statuts de commande de la page Configuration. Les options disponibles sont :

• Immédiatement lorsqu'elles sont envoyées à HubRise.
• Lorsque leur statut HubRise passe à received.
• Lorsque leur statut HubRise passe à accepted.

La manière dont les commandes sont acceptées dépend du type de commande :

• Précommandes : le bridge confirme la précommande, qui est ensuite automatiquement acceptée par Wolt à l'approche de l'heure de livraison, en fonction du temps de préparation.
• Livraison par le restaurant : le bridge accepte la commande avec une heure de livraison optionnelle issue du champ confirmed_time.
• Livraison par Wolt : le bridge accepte la commande avec un ajustement optionnel de l'heure de retrait issu du champ confirmed_time. L'ajustement ne peut pas dépasser 25 minutes par rapport à l'estimation initiale.
• Commandes à emporter : identique aux commandes en livraison par Wolt.

Lorsque le statut change dans Wolt

Lorsque le statut d'une commande change dans Wolt, Wolt Bridge met à jour la commande correspondante dans HubRise :

Statut Wolt	Statut HubRise
Ready (pour les établissements utilisant des tablettes Wolt)	awaiting_shipment (pour la livraison) ou awaiting_collection (pour le retrait)
In Delivery (livraison par Wolt uniquement)	in_delivery
Delivered	completed
Canceled	cancelled

Suivi de livraison

Wolt Bridge maintient Wolt et HubRise synchronisés pour la progression de la livraison. Le sens des mises à jour dépend de qui fournit le livreur.

Livraison par Wolt

Lorsqu'une commande livrée par Wolt est acceptée, Wolt Bridge crée une ressource Delivery dans HubRise avec les informations suivantes :

• carrier : défini sur "Wolt"
• status : défini sur pending
• estimated_pickup_at : heure estimée à laquelle le livreur récupérera la commande

Lorsqu'un livreur Wolt est affecté à la commande, la livraison est mise à jour avec les informations suivantes :

• status : mis à jour à pickup_enroute
• estimated_pickup_at : mis à jour avec l'heure d'arrivée estimée du livreur

Lorsque le livreur récupère la commande, le statut de la commande dans HubRise est mis à jour à in_delivery.

Livraison par le restaurant

Pour les commandes livrées par la propre flotte du restaurant, le bridge relaie les mises à jour de statut de HubRise vers Wolt comme suit :

Statut de commande HubRise	Statut de livraison HubRise	Statut Wolt
in_delivery	-	In Delivery
-	dropoff_waiting	Courier at Customer
completed	-	Delivered

Types de service

Wolt prend en charge trois types de service :

• Livraison par Wolt
• Livraison par le restaurant
• À emporter

Ils sont généralement associés à des codes ref spécifiques dans votre logiciel de caisse, que vous pouvez définir dans la page Configuration du bridge. Pour plus d'informations sur les codes ref, consultez la documentation de votre logiciel de caisse sur notre page Apps.

Horaires des commandes

Les informations d'horaire fournies dans HubRise dépendent du fait que la commande soit une commande immédiate ou une précommande.

Commandes immédiates

Pour les commandes immédiates, le champ expected_time n'est pas renseigné, car ces commandes doivent être préparées le plus rapidement possible. Si la commande est livrée par Wolt, le champ estimated_pickup_at de l'objet Delivery est renseigné avec l'heure de retrait estimée du livreur dès qu'un livreur est affecté.

Pour ajuster l'heure de retrait ou de livraison, mettez à jour le champ confirmed_time dans HubRise avant ou au moment où la commande est acceptée dans Wolt. L'heure ajustée ne peut pas être supérieure de plus de 25 minutes à l'estimation d'origine.

Précommandes

Pour les précommandes (commandes programmées), le champ expected_time est défini sur l'heure de retrait ou de livraison programmée sélectionnée par le client.

L'heure de retrait ou de livraison pour les précommandes ne peut pas être ajustée.

Client

Wolt fournit des informations limitées sur les clients. La quantité d'informations varie selon le type de commande.

Wolt Bridge ne crée pas de clients dans HubRise, mais inclut les coordonnées du client directement dans la commande.

Pour chaque type de commande, Wolt Bridge envoie les informations suivantes dans l'objet client :

• first_name : prénom du client, ou première partie du nom.
• last_name : le reste du nom du client (si le nom complet est activé) ou simplement l'initiale.
• email : adresse e-mail du client (lorsqu'elle est fournie).
• phone : numéro de téléphone du client (lorsqu'il est fourni).
• company_name : nom de l'entreprise pour les commandes professionnelles (lorsqu'il est fourni).

De plus, pour les commandes en livraison par le restaurant, Wolt Bridge envoie les champs suivants :

• address_1 : adresse de la rue.
• address_2 : numéro d'appartement, formaté comme "Apartment n. X" s'il est fourni.
• postal_code : code postal.
• city : nom de la ville.
• country : code pays ISO à deux lettres.
• latitude : latitude de l'adresse de livraison.
• longitude : longitude de l'adresse de livraison.
• delivery_notes : instructions de livraison du client, extraites du champ d'adresse formatée.

Articles et options

Les commandes Wolt peuvent inclure soit des articles uniques avec options, soit des articles de promotion (offres spéciales qui regroupent plusieurs produits ensemble).

Encodage des articles uniques

Pour chaque article unique de la commande, Wolt Bridge fournit les informations suivantes :

• sku_ref : code ref de l'article.
• product_name : nom du produit.
• price : prix unitaire de l'article, avant remises.
• quantity : quantité d'articles dans la commande.
• tax_rate : pourcentage de TVA.
• options : tableau des options rattachées à l'article.

Encodage des articles de promotion

Lorsqu'une commande contient une promotion (une offre groupée), Wolt Bridge l'encode différemment :

• Chaque produit de la promotion devient un article distinct dans la commande HubRise.
• Tous les articles appartenant à la même promotion sont liés entre eux avec une référence deal_line.
• Le prix minimum de la promotion, calculé à partir de toutes les combinaisons possibles de lignes de promotion, est inclus dans le prix du premier article.
• Chaque article suivant inclut uniquement la différence de prix par rapport au prix minimum de la promotion.

Les informations de promotion sont stockées dans un objet deals avec :

• name : nom de la promotion.
• ref : code ref de la promotion.

Encodage des options

Pour chaque option de la commande, Wolt Bridge fournit les informations suivantes :

• option_list_name : nom du groupe d'options.
• name : nom de l'option.
• ref : code ref de l'option.
• price : prix unitaire d'une option, avant remises.
• quantity : quantité de l'option.

Remises

Les commandes Wolt peuvent inclure deux types de remises : les remises sur le panier et les remises sur les frais de livraison.

Remises sur le panier

Lorsqu'un client bénéficie d'une remise sur les articles de sa commande, Wolt agrège toutes les remises au niveau des articles en une seule remise totale. Wolt Bridge l'encode dans un seul objet de remise avec les champs suivants :

• name : défini sur Remise.
• ref : code ref de la remise. Sa valeur peut être définie depuis la page Configuration et doit correspondre à la valeur de votre logiciel de caisse.
• price_off : montant total de la remise appliquée au panier.

Remises sur les frais de livraison

Lorsqu'une remise sur les frais de livraison est appliquée à une commande, Wolt Bridge encode la remise correspondante avec les champs suivants :

• name : défini sur Remise sur les frais de livraison.
• ref : code ref de la remise sur les frais de livraison. Sa valeur peut être définie depuis la page Configuration et doit correspondre à la valeur de votre logiciel de caisse.
• price_off : montant de la remise sur les frais de livraison.

Frais

Wolt Bridge encode divers types de frais en fonction du type de commande et des frais applicables. Tous les frais incluent les champs suivants :

• name : nom des frais.
• ref : code ref des frais. Sa valeur peut être définie depuis la page Configuration et doit correspondre à la valeur de votre logiciel de caisse.
• price : montant des frais.
• tax_rate : pourcentage de TVA appliqué aux frais.

Frais de livraison

Wolt Bridge encode tous les frais liés à la livraison en utilisant le même code ref, qui peut être configuré dans la page Configuration.

Les frais de livraison peuvent inclure les frais de livraison de base, des frais supplémentaires pour distance supplémentaire et des frais de livraison prioritaire.

Pourboire de livraison

Lorsqu'un client ajoute un pourboire pour le livreur, Wolt Bridge l'encode comme des frais avec le code ref pour les pourboires, configuré dans la page Configuration.

Autres frais

Les autres types de frais qui peuvent être inclus dans les commandes Wolt sont :

• Frais de service
• Supplément petite commande, appliqué lorsque la valeur de la commande est inférieure au montant minimum de commande.
• Frais de campagne marketing

Chacun de ces frais peut avoir son propre code ref configuré séparément dans la page Configuration.

Paiements

Wolt prend en charge deux méthodes de paiement : le paiement en ligne et le paiement en espèces. Wolt Bridge encode les paiements correspondants avec les champs suivants :

• name : soit Paiement en ligne, soit Paiement en espèces.
• ref : code ref de la méthode de paiement. Sa valeur peut être définie depuis la page Configuration et doit correspondre à la valeur de votre logiciel de caisse.
• amount : montant payé avec cette méthode de paiement.

Notes de préparation

Les notes de préparation au niveau de la commande laissées par le client lors du paiement sont encodées dans le champ customer_notes. Ces notes contiennent généralement des demandes spéciales ou des instructions pour le restaurant.

Notez que les instructions de livraison pour les commandes en livraison par le restaurant sont fournies séparément dans le champ delivery_notes de l'objet client, et non dans le champ customer_notes au niveau de la commande.

Mise en pause

Lorsque la synchronisation de l'acceptation des commandes est activée dans la page Configuration, Wolt Bridge synchronise le champ order_acceptance de HubRise vers Wolt.

Le champ order_acceptance.mode contrôle le statut de l'établissement :

• normal ou busy : établissement ouvert
• paused : établissement en pause avec heure de reprise programmée optionnelle

Lorsque l'établissement est en pause, vous pouvez éventuellement spécifier une heure de resume_at dans HubRise, et Wolt rouvrira automatiquement l'établissement à cette heure.

---

REMARQUE IMPORTANTE : Wolt ne prend pas en charge la mise à jour du temps de préparation via l'API. Les temps de préparation doivent être gérés directement dans le tableau de bord Wolt.

---