Récupérer le catalogue

Cette page décrit comment récupérer un catalogue depuis Lightspeed dans HubRise et détaille les informations reçues dans HubRise.

Récupérer le catalogue dans HubRise

Il existe deux méthodes pour récupérer un catalogue depuis Lightspeed dans HubRise :

• Via Lightspeed Restaurant Bridge
• Via une solution tierce

Récupération via Lightspeed Restaurant Bridge

Pour récupérer un catalogue via Lightspeed Restaurant Bridge, suivez ces étapes :

1. Depuis la page principale de Lightspeed Restaurant Bridge, sélectionnez l'onglet Actions.
2. Cliquez sur Récupérer le catalogue.
3. Cliquez sur Confirmer lorsque vous y êtes invité.

---

REMARQUE IMPORTANTE : Cette opération remplacera votre catalogue HubRise actuel.

---

Selon la taille du catalogue, la mise à jour complète de votre catalogue HubRise peut durer quelques minutes.

Si l'opération échoue avec une erreur 403 Forbidden, consultez Erreur Forbidden lors de l'import du catalogue pour la résolution.

Récupération via une solution tierce

Certaines solutions intégrées, comme les systèmes de commande en ligne, offrent une fonctionnalité de récupération du catalogue. Si votre solution prend en charge cette fonctionnalité, vous trouverez généralement un bouton intitulé "Mettre à jour le catalogue" ou similaire dans leur back-office.

Pour utiliser cette fonctionnalité :

1. Vérifiez auprès de votre fournisseur de solution s'ils prennent en charge la récupération de catalogue depuis Lightspeed.
2. Si c'est le cas, recherchez l'option de mise à jour du catalogue dans le back-office de votre solution.
3. Utilisez cette option quand vous le souhaitez. La récupération du catalogue peut prendre quelques minutes, selon la taille de votre catalogue.

Informations envoyées à HubRise

Les sections suivantes expliquent en détail comment votre catalogue Lightspeed est associé à HubRise.

Catégories

Les groupes de votre menu Lightspeed sont associés à des catégories de produits sur HubRise. Les groupes imbriqués deviennent des sous-catégories.

Le nom de la catégorie est envoyé à HubRise. Lightspeed ne prend pas en charge les descriptions de catégorie, qui ne sont donc pas importées.

Produits et SKU

Lightspeed prend en charge les SKU, mais pas les produits. Pour chaque article du catalogue Lightspeed, Lightspeed Restaurant Bridge crée une SKU correspondante dans HubRise avec les informations suivantes (si elles sont disponibles) :

• Nom de la SKU
• Code ref de la SKU
• Description
• Images
• Prix et prix par variante (voir Variantes)
• Taux de TVA
• Allergènes et pourcentage d'alcool pour les articles signalés comme contenant de l'alcool
• Options

Variantes

Lightspeed permet de définir plusieurs prix par article. Par exemple, un article peut avoir un prix par défaut, un prix à emporter et un prix pour une plateforme de livraison spécifique.

Chaque nom de prix présent dans votre menu devient une variante dans HubRise.

Options

Lightspeed prend en charge des groupes d'articles, qui sont envoyés à HubRise sous forme d'options et de listes d'options.

Le type d'option HubRise est sélectionné de la manière suivante :

• Un groupe avec la règle de sélection Sélectionner un article exactement est converti en une liste d'options à choix unique.
• Un groupe avec une règle de sélection différente est converti en une liste d'options à choix multiple.

Instructions de production Lightspeed

Lightspeed prend en charge les instructions de production, qui sont généralement des instructions de préparation pour la cuisine. Elles sont envoyées à HubRise sous forme d'options à choix multiple sans prix associé.

Références techniques

Les sections suivantes fournissent des informations techniques sur l'encodage de votre catalogue Lightspeed dans HubRise.

Catégories

Pour chaque catégorie, les champs suivants sont envoyés à HubRise :

• name : nom de la catégorie.
• ref : un numéro séquentiel est automatiquement généré pour chaque catégorie.
• parent_ref : la ref de la catégorie parente, ou vide pour une catégorie de premier niveau.

SKU

Pour chaque SKU, Lightspeed envoie les informations suivantes à HubRise :

• name : nom de la SKU
• description : description de la SKU
• image_ids : liste des ID d'images associées à la SKU
• tax_rate : taux de TVA, appliqué de manière identique à tous les types de service.
• nutrition : informations nutritionnelles, lorsqu'elles sont disponibles.
  • nutrition.allergens : liste des allergènes. Les codes d'allergènes Lightspeed sont associés aux codes HubRise, et les codes génériques (comme "noix" ou "céréales") sont développés en chaque allergène de la famille.
  • nutrition.alcohol_percentage : pourcentage d'alcool, pour les articles signalés comme contenant de l'alcool.
• skus : liste contenant une seule SKU
  • skus[0].ref : code ref de la SKU, transmis dans les commandes
  • skus[0].price : prix par défaut de la SKU
  • skus[0].option_list_refs : liste d'options rattachées à la SKU
  • skus[0].price_overrides : prix par variante de la SKU, voir Variantes.

Variantes

Le tableau data.variants du catalogue liste chaque nom de prix Lightspeed importé comme variante, chacun avec :

• ref : une référence séquentielle.
• name : le nom de prix Lightspeed (par exemple A emporter ou Uber Eats).

Sur chaque SKU de produit, skus[0].price contient le prix par défaut et skus[0].price_overrides contient les prix par variante.

Les remplacements de prix ne sont définis que pour les SKU, pas pour les options.

Options

Les groupes de formule sont créés en tant que listes d'options, avec une ref séquentielle qui commence par deal_. Chaque liste d'options contient des contraintes de sélection :

• min_selections : nombre minimum d'options à sélectionner.
• max_selections : nombre maximum d'options à sélectionner.

Pour chaque option, les informations suivantes sont envoyées à HubRise :

• name : nom de l'option
• ref : code ref de l'option
• price : prix de l'option (la somme de son prix de base et de son prix supplémentaire dans la formule)

Les groupes d'instructions de production sont également associés à des listes d'options, avec max_selections à 1 sauf si plusieurs sélections sont autorisées. Pour chaque instruction, les informations suivantes sont envoyées à HubRise :

• name : nom de l'instruction
• ref : le code ref de l'instruction, précédé d'un signe +.
• price : toujours 0

Inventaire

Si la synchronisation de l'inventaire est activée, la récupération du catalogue actualise également votre inventaire HubRise depuis Lightspeed. Pour plus d'informations, consultez Synchroniser l'inventaire.