--- title: "Intégration ROLLER + Yellow Dog" slug: "roller-yellow-dog-integration" updated: 2026-07-28T00:59:42Z published: 2026-07-28T00:59:42Z canonical: "mysupport.roller.software/roller-yellow-dog-integration" --- > ## Documentation Index > Fetch the complete documentation index at: https://mysupport.roller.software/llms.txt > Use this file to discover all available pages before exploring further. # Intégration ROLLER + Yellow Dog 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. > [!NOTE] > 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**](https://www.roller.software/integrations/partner/yellow-dog-software/contact) dans notre répertoire d'intégrations pour commencer. ### 2. Générer des identifiants API dans ROLLER 1. Accédez à **Venue Manager › Paramètres › Intégrations › Clés API** 2. Sélectionnez **Créer une clé client** 3. Nommez-la **Yellow Dog**, puis sélectionnez **Créer** 4. Copiez l'**ID client** et le **Secret client** et conservez-les en lieu sûr > [!NOTE] > 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)** 1. 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**. 2. 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. 3. Effectuez des ventes/remboursements dans ROLLER POS. Les ventes réduisent le stock dans Yellow Dog ; les remboursements le restaurent. **F&B (unidirectionnel)** 1. Créez des **éléments de menu dans ROLLER** (par exemple, Cheeseburger, Grand soda). 2. 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. 3. 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](https://www.yellowdogsoftware.com/customer-portal) **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) ## En savoir plus - [Vue d'ensemble Yellow Dog × ROLLER](https://www.yellowdogsoftware.com/roller) - [Documentation technique Yellow Dog](https://help.yellowdogsoftware.com/roller) - [Présentation de l'API ROLLER](/v1/docs/fr/api-overview) - [Répertoire des partenaires (Yellow Dog)](https://roller.software/integrations/partner/yellow-dog-software)