Recevoir des commandes

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

Cette page décrit les informations que WeDely envoie à HubRise, ainsi que la manière dont les statuts de commande et les informations de livraison sont synchronisés entre les deux plateformes. Elle peut vous aider à comprendre comment les commandes seront reçues dans votre logiciel de caisse.

Transmission des commandes

WeDely envoie les commandes à HubRise dès qu'elles sont passées par le client.

Par défaut, les commandes arrivent dans HubRise avec le statut new, et votre logiciel de caisse les passe en accepted. Si l'option Acceptation automatique des commandes est cochée, WeDely les crée directement avec le statut accepted, et aucune acceptation supplémentaire n'est nécessaire.

Statuts de commande

---

REMARQUE IMPORTANTE : Dans cette section, nous mettons en majuscule la première lettre des statuts WeDely pour les distinguer plus facilement des noms de statuts HubRise. Par exemple, Accepted (Acceptée) est un statut WeDely, tandis que accepted est un statut HubRise.

---

Statuts WeDely

Les commandes WeDely passent par les statuts suivants :

• Waiting : la commande a été passée et attend d'être acceptée par le restaurant.
• Accepted : la commande a été acceptée par le restaurant.
• Preparing : la commande est en cours de préparation.
• Sent : la commande a quitté le restaurant.
• Delivered : la commande a été livrée au client.
• Refused : la commande a été refusée par le restaurant.
• Cancelled : la commande a été annulée.

Lorsque le statut change dans HubRise

WeDely écoute les mises à jour des commandes HubRise et réagit aux statuts suivants :

Statut HubRise	Effet sur WeDely
accepted	La commande passe au statut Accepted dans WeDely.
cancelled	La commande passe au statut Cancelled dans WeDely.
in_preparation, in_delivery, completed	Commandes livrées par le restaurant uniquement. Utilisés pour informer le client dans l'application mobile WeDely.

Les autres statuts HubRise ne sont pas pris en charge et sont ignorés par WeDely.

Si une commande n'est ni acceptée ni annulée dans un délai raisonnable (quelques minutes), WeDely contacte le point de vente.

Heure confirmée et temps de préparation supplémentaire

Lorsqu'une commande est acceptée avec un confirmed_time, WeDely compare cette heure avec l'heure initialement prévue pour la commande afin de déterminer le temps de préparation supplémentaire demandé par le restaurant. Le client est ensuite informé par e-mail et par notifications push de la nouvelle heure de livraison.

Le temps supplémentaire est géré par tranches de 5 minutes, dans la limite de 60 minutes.

Lorsque le statut change dans WeDely

WeDely met à jour les statuts de commande dans HubRise dans les cas suivants :

• Lorsque le client annule une commande, WeDely la marque immédiatement comme cancelled dans HubRise.
• Pour les commandes livrées par WeDely, le statut passe à in_delivery lorsque le livreur quitte le restaurant, puis à completed une fois la commande livrée.

Suivi de livraison

Pour les commandes livrées par WeDely, WeDely crée une ressource Delivery lorsque le livreur est envoyé. Le champ status de la livraison est mis à jour comme suit :

Étape de livraison WeDely	Statut HubRise Delivery
Un livreur est en route vers le restaurant	pickup_enroute
Le livreur a récupéré la commande	dropoff_enroute
La commande a été livrée	delivered

Aucune information sur le livreur, telle que son nom ou son numéro de téléphone, n'est envoyée à HubRise. Sa position, ainsi que les heures estimées de retrait et de livraison, ne sont pas transmises non plus.

Types de service

WeDely prend en charge deux types de service :

• Livraison à domicile, assurée soit par un livreur WeDely, soit par la flotte du restaurant.
• Retrait en magasin, où le client vient chercher sa commande.

Si les types de service doivent être associés à des codes ref spécifiques dans votre logiciel de caisse, vous pouvez les renseigner dans la section Codes Ref POS - Types de service de la page Configuration. Pour savoir si cela est nécessaire, consultez la documentation de votre logiciel de caisse sur la page Apps.

Horaires des commandes

L'heure transmise dans le champ expected_time dépend de qui livre la commande :

• Livraison par le restaurant : expected_time correspond à l'heure à laquelle le client attend la livraison de sa commande.
• Livraison par WeDely : expected_time correspond à l'heure à laquelle le livreur est attendu au restaurant. Dans ce cas, WeDely positionne également expected_time_pickup à true.

Pour les commandes immédiates, WeDely positionne le champ asap à true. WeDely prend également en charge les commandes programmées, pour lesquelles le client choisit un créneau de livraison plus tard dans la journée, ou un jour suivant.

Pour demander plus de temps afin de préparer une commande, modifiez le champ confirmed_time dans HubRise au moment de l'acceptation de la commande. Pour plus d'informations, voir Heure confirmée et temps de préparation supplémentaire.

Client

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

Pour les commandes livrées par WeDely, les champs suivants sont inclus :

• first_name : prénom du client.
• phone : numéro de téléphone du client. Il s'agit de son numéro réel, et non d'un alias, aucun code d'accès téléphonique n'est donc nécessaire.

Pour les commandes livrées par le restaurant, WeDely fournit :

• first_name : prénom du client. WeDely sépare le nom complet du client en un prénom et un nom de famille.
• last_name : nom de famille du client.
• phone : numéro de téléphone du client.
• address_1 : adresse de livraison complète, code postal et ville inclus. Les champs address_2, postal_code et city ne sont pas utilisés.
• latitude : latitude de l'adresse de livraison.
• longitude : longitude de l'adresse de livraison.
• delivery_notes : instructions de livraison laissées par le client, lorsqu'elles sont présentes.

Articles et options

Encodage des articles

WeDely ne gère pas les SKU : chaque produit constitue un article unique. Pour chaque article de la commande, WeDely fournit les informations suivantes :

• sku_ref : code ref du produit.
• product_name : nom du produit.
• price : prix unitaire de l'article.
• quantity : quantité d'articles incluse dans la commande.
• tax_rate : taux de TVA appliqué à l'article.
• customer_notes : notes de préparation laissées par le client sur cet article, lorsqu'elles sont présentes.
• options : options rattachées à l'article.

Encodage des options

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

• option_list_name : nom de la liste d'options à laquelle l'option appartient.
• name : nom de l'option.
• ref : code ref de l'option.
• price : prix unitaire de l'option.
• quantity : nombre de fois où l'option a été sélectionnée.
• removed : positionné à true pour les options que le client a retirées du produit, par exemple un ingrédient non souhaité.

Promotions

Les promotions ne sont pas prises en charge par WeDely. WeDely ne gère que les remises au niveau de l'article, qui ne sont pas encodées comme des promotions dans les commandes envoyées à HubRise.

Remises

WeDely n'envoie pas les remises sous forme de lignes distinctes. Lorsqu'une remise s'applique, les prix des articles sont directement réduits.

Frais

WeDely inclut les frais de livraison sous forme de frais, uniquement pour les commandes livrées par le restaurant. Les frais de livraison des commandes livrées par WeDely sont encaissés par WeDely, et ne sont donc pas transmis au restaurant.

Les champs disponibles sont les suivants :

• name : nom des frais, Delivery fee par défaut.
• ref : code ref des frais. Sa valeur est définie dans la section Codes Ref POS - Frais de la page Configuration et doit correspondre à la valeur de votre logiciel de caisse.
• price : montant des frais.
• tax_rate : taux de TVA appliqué aux frais.

Aucun autre frais n'est envoyé à HubRise.

Paiements

Les clients WeDely disposent de trois options pour régler leurs commandes :

• Carte de crédit : paiement par carte à la livraison via un terminal de paiement mobile.
• Espèces : paiement en espèces à la livraison.
• Paiement en ligne : paiement en ligne pré-autorisé via Stripe, Apple Pay, Google Pay ou lien de paiement.

Les champs suivants sont inclus pour le paiement :

• name : nom de la méthode de paiement.
• ref : code ref de la méthode de paiement. Sa valeur est définie dans la section Codes Ref POS - Méthodes de paiement de la page Configuration et doit correspondre à la valeur de votre logiciel de caisse.
• amount : montant payé.

Notes de préparation

Les notes au niveau de la commande sont encodées dans le champ customer_notes de la commande. Les notes sur les articles individuels sont encodées dans le champ customer_notes de l'article correspondant.

Les instructions de livraison sont transmises dans le champ delivery_notes de l'objet client.

Code de récupération

WeDely génère un code de récupération unique et court pour chaque commande, par exemple BRD4Z1, et le transmet à HubRise dans le champ collection_code.

Il s'agit de la référence que le client voit dans l'e-mail et le SMS de confirmation de commande, sur la page de suivi de commande, et sur l'écran de détail de la commande dans l'application mobile WeDely.

Mise en pause et temps de préparation

WeDely synchronise les champs opening_hours, order_acceptance et preparation_time de votre point de vente HubRise.

Le champ order_acceptance.mode détermine si la commande en ligne est ouverte sur WeDely :

• normal ou busy : la commande en ligne est ouverte.
• paused : la commande en ligne est fermée. Le motif de la mise en pause n'est pas pris en charge par WeDely, et il est ignoré.

Le temps de préparation envoyé à WeDely est preparation_time en mode normal, ou la somme de preparation_time et de order_acceptance.extra_preparation_time en mode forte affluence. La valeur obtenue est affichée sous le libellé Temps de préparation sur la page de configuration WeDely.

WeDely compare ce temps de préparation avec le Temps de préparation de la zone, qui correspond au temps minimum dont WeDely a besoin pour envoyer un livreur au restaurant, et retient la plus grande des deux valeurs. Pour plus d'informations, voir Temps de préparation.