Gérez les stocks de vente au détail et de restauration (F&B) dans Yellow Dog tout en utilisant ROLLER pour le point de vente (POS). Ce guide explique comment connecter les systèmes, configurer vos produits et vérifier que tout fonctionne correctement.
Pour connecter l'intégration Yellow Dog, vous devez disposer d'un abonnement ROLLER Premium ou supérieur et du module complémentaire ROLLER API Access.
Quand utiliser ce guide
Utilisez ce guide si :
Vous êtes client ROLLER avec des activités de vente au détail et/ou de restauration F&B et souhaitez que Yellow Dog soit la source de référence pour les stocks.
Vous souhaitez que les ventes et remboursements POS dans ROLLER mettent automatiquement à jour les niveaux de stock dans Yellow Dog.
Ce que fait l'intégration
Source de référence pour les stocks : toute la gestion des stocks s'effectue dans Yellow Dog.
Vente au détail (bidirectionnel) : Yellow Dog → données produit vers ROLLER ; ventes/remboursements POS ROLLER → ajustements des stocks dans Yellow Dog.
F&B (unidirectionnel) : ROLLER gère les articles du menu POS ; Yellow Dog gère les ingrédients/recettes et diminue le stock en fonction des ventes POS.
Avant de commencer
Dans Venue Manager, créez les catégories de rapport requises et vérifiez que les taux de taxe (montants toutes taxes comprises) sont configurés.
Pour la vente au détail, planifiez les SKU, codes-barres, tarifs et affectations aux points de vente dans Yellow Dog.
Pour la restauration F&B, planifiez les recettes et ingrédients dans Yellow Dog ; planifiez les articles du menu dans ROLLER.
Configurer votre intégration Yellow Dog
1. Créer/confirmer votre compte Yellow Dog
Vous avez besoin d'un abonnement Yellow Dog actif. Si vous n'en avez pas, remplissez le formulaire de contact Yellow Dog dans notre répertoire d'intégrations pour commencer.
2. Générer des identifiants API dans ROLLER
Accédez à Venue Manager › Paramètres › Intégrations › Clés API
Sélectionnez Créer une clé client
Nommez-la Yellow Dog, puis sélectionnez Créer
Copiez l'ID client et le Secret client et conservez-les en lieu sûr
Pour en savoir plus sur la création d'une clé API dans ROLLER, notamment sur la façon de définir la portée de votre clé API, consultez le guide Présentation de l'API.
3. Saisir les identifiants dans Yellow Dog
Dans votre compte Yellow Dog, renseignez :
Nom (facultatif)
Emplacement (point de vente d'inventaire à associer)
ID client (depuis ROLLER)
Secret client (depuis ROLLER)
Important : si vous ajoutez de nouveaux appareils POS dans ROLLER, informez Yellow Dog afin que chaque appareil soit associé au bon point de vente d'inventaire. Les ventes effectuées depuis des appareils non associés ne seront pas synchronisées avec Yellow Dog.
4. Configurer les produits
Retail (synchronisation bidirectionnelle)
Créez des produits dans Yellow Dog avec : Nom du produit, Description POS, Code-barres (UPC ou SKU généré automatiquement), Prix de vente, Code de taxe, Catégorie de rapport et Affectations aux points de vente.
Les produits se synchronisent vers ROLLER en tant que produits individuels (sans variantes). Les tarifs, descriptions, codes-barres, codes de taxe et catégories de rapport sont synchronisés depuis Yellow Dog.
Effectuez des ventes/remboursements dans ROLLER POS. Les ventes réduisent le stock dans Yellow Dog ; les remboursements le restaurent.
F&B (unidirectionnel)
Créez des éléments de menu dans ROLLER (par exemple, Cheeseburger, Grand soda).
Créez des recettes dans Yellow Dog avec des ingrédients (par exemple, pain, steak haché, tranches de cornichon) et associez-les aux éléments POS correspondants.
Les ventes dans ROLLER réduisent les ingrédients dans Yellow Dog et contribuent au COGS. Utilisez Yellow Dog pour les achats, la réception, les transferts, les pertes et les inventaires.
Migration des articles retail existants : si vous avez déjà créé des produits retail dans ROLLER, archivez-les et recréez-les dans Yellow Dog afin que Yellow Dog devienne la source de référence.
5. Tester votre intégration
Effectuez des vérifications de bout en bout avant la mise en production :
Disponibilité des produits – Les articles retail apparaissent dans ROLLER avec les noms, prix, taxes et catégories corrects.
Association des appareils POS – Tous les appareils ROLLER POS sont associés aux bons points de vente Yellow Dog.
Test de vente – Effectuez une vente dans ROLLER et confirmez que le stock diminue dans Yellow Dog.
Test de remboursement – Traitez un remboursement dans ROLLER et confirmez que le stock est restauré dans Yellow Dog.
Comptage d'inventaire – Effectuez un comptage rapide avec l'application mobile Yellow Dog.
Vérifications ponctuelles – Vérifiez la parité des prix et des taxes entre les systèmes.
Considérations
Ventes en ligne : Non pris en charge via ROLLER.
Variantes de produit : Pas de variantes parent/enfant dans ROLLER ; chaque taille ou couleur est un SKU distinct.
Désactivation : Archiver dans Yellow Dog ne désactive pas le produit dans ROLLER ; désactivez-le manuellement dans ROLLER.
Mappage des appareils POS : Les nouveaux appareils ROLLER ne sont pas mappés automatiquement dans Yellow Dog ; informez Yellow Dog pour les mapper.
Envoi des articles F&B : Yellow Dog ne pousse pas les articles de menu vers ROLLER.
Multi-devises : Non pris en charge dans un seul compte entreprise (utilisez des comptes distincts si nécessaire).
Compatibilité OS : Yellow Dog est un client Windows ; Mac nécessite un bureau à distance ou une VM.
Rapports
Utilisez Yellow Dog pour la gestion des stocks, les achats, l'impression d'étiquettes, les pertes et les rapports COGS.
Assurez-vous que les catégories de rapport et les paramètres de taxes sont configurés dans ROLLER avant l'intégration afin de prendre en charge les rapports en aval.
Résolution des problèmes
Les articles ne se synchronisent pas de Yellow Dog vers ROLLER (vente au détail)
Confirmez le Client ID et le Client secret dans Yellow Dog
Assurez-vous que les produits comportent les champs obligatoires et les assignations de point de vente
Vérifiez le mappage des appareils POS avec Yellow Dog
Si le problème persiste, contactez le support Yellow Dog
L'inventaire n'a pas changé après une vente POS
Confirmez que la vente a été effectuée sur un appareil POS mappé
Vérifiez que le produit est géré par Yellow Dog (vente au détail) ou que le lien de recette existe (F&B)