--- title: "ROLLER + Yellow Dog integration" slug: "roller-yellow-dog-integration" description: "Streamline your retail and F&B inventory management by integrating Yellow Dog with ROLLER POS for seamless sales and stock updates." tags: ["Reference"] updated: 2026-07-21T04:20:58Z published: 2026-07-21T04:20:58Z 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. # ROLLER + Yellow Dog integration Manage retail and food & beverage (F&B) inventory in Yellow Dog while using ROLLER for POS. This guide explains how to connect the systems, configure your products and verify everything is working. > [!NOTE] > To connect the Yellow Dog integration, you must have a **Premium or higher** ROLLER subscription and the **ROLLER API Access Add-on**. ## When to use this guide Use this guide if: - You’re a ROLLER customer with retail and/or F&B operations and want Yellow Dog to be the source of truth for inventory. - You want POS sales and refunds in ROLLER to automatically update inventory levels in Yellow Dog. ## What the integration does - **Inventory source of truth:** All inventory management occurs in Yellow Dog. - **Retail (two‑way):** Yellow Dog → product data to ROLLER; ROLLER POS sales/refunds → inventory adjustments in Yellow Dog. - **F&B (one‑way):** ROLLER manages POS menu items; Yellow Dog manages ingredients/recipes and depletes stock based on POS sales. ## Before you begin - In Venue Manager, create required **reporting categories** and confirm **tax rates** (tax‑inclusive amounts) are configured. - For **Retail**, plan SKUs, barcodes, pricing, and outlet assignments in Yellow Dog. - For **F&B**, plan recipes and ingredients in Yellow Dog; plan menu items in ROLLER. ## Configure your Yellow Dog integration ### 1. Create/confirm your Yellow Dog account You need an active Yellow Dog subscription. If you don’t have one, complete the [**Yellow Dog contact form**](https://www.roller.software/integrations/partner/yellow-dog-software/contact) on our Integrations directory to get started. ### 2. Generate API credentials in ROLLER 1. Go to **Venue Manager › Settings › Integrations › API keys** 2. Select **Create a client key** 3. Name it **Yellow Dog**, then select **Create** 4. Copy the **Client ID** and **Client secret** and store them securely > [!NOTE] > To learn more about creating an API key in ROLLER, including how to define the scope of your API key, read the guide API overview. ### 3. Enter credentials in Yellow Dog In your Yellow Dog account, provide: - **Name** (optional) - **Location** (inventory outlet to map to) - **Client ID** (from ROLLER) - **Client secret** (from ROLLER) **Important:** If you add new POS devices in ROLLER, tell Yellow Dog so each device is mapped to the correct inventory outlet. Sales from unmapped devices won’t sync to Yellow Dog. ### 4. Configure products **Retail (two‑way sync)** 1. Create products in Yellow Dog with: **Product Name**, **POS Description**, **Barcode** (UPC or auto‑generated SKU), **Retail Price**, **Tax Code**, **Reporting Category**, and **Outlet assignments**. 2. Products sync to ROLLER as **individual products** (no variants). Pricing, descriptions, barcodes, tax codes, and reporting categories sync from Yellow Dog. 3. Make sales/refunds in ROLLER POS. Sales reduce stock in Yellow Dog; refunds restore it. **F&B (one‑way)** 1. Create **menu items in ROLLER** (e.g., Cheeseburger, Large Soda). 2. Build **recipes in Yellow Dog** with ingredient items (e.g., bun, patty, pickle slices) and link them to the corresponding POS items. 3. Sales in ROLLER **deplete ingredients** in Yellow Dog and contribute to COGS. Use Yellow Dog for purchasing, receiving, transfers, waste, and counts. **Migrating existing retail items:** If you already built retail products in ROLLER, archive them and rebuild in Yellow Dog so Yellow Dog becomes the source of truth. ### 5. Test your integration Run end‑to‑end checks before go‑live: - **Product availability** – Retail items appear in ROLLER with correct names, prices, tax, and categories. - **POS device mapping** – All ROLLER POS devices are mapped to the right Yellow Dog outlets. - **Test sale** – Make a sale in ROLLER and confirm stock reduces in Yellow Dog. - **Refund test** – Process a refund in ROLLER and confirm stock restores in Yellow Dog. - **Inventory count** – Perform a quick count with the Yellow Dog mobile app. - **Spot‑checks** – Verify price/tax parity between systems. ## Considerations - **Online sales:** Not supported through ROLLER. - **Product variations:** No parent/child variants in ROLLER; each size or color is a separate SKU. - **Deactivation:** Archiving in Yellow Dog does not disable the product in ROLLER; deactivate in ROLLER manually. - **POS device mapping:** New ROLLER devices are not auto‑mapped in Yellow Dog; notify Yellow Dog to map them. - **F&B item push:** Yellow Dog does not push menu items to ROLLER. - **Multi‑currency:** Not supported within a single enterprise account (use separate accounts if required). - **OS support:** Yellow Dog is a Windows client; Mac requires remote desktop or a VM. ## Reporting - Use **Yellow Dog** for inventory, purchasing, label printing, waste, and COGS reporting. - Ensure **reporting categories** and **tax settings** are configured in ROLLER before onboarding to support downstream reporting. ## Troubleshooting **Items aren’t syncing from Yellow Dog to ROLLER (retail)** - Confirm **Client ID** and **Client secret** in Yellow Dog - Ensure products have required fields and outlet assignments - Verify **POS device mapping** with Yellow Dog - If issues persist, contact [Yellow Dog Support](https://www.yellowdogsoftware.com/customer-portal) **Inventory didn’t change after a POS sale** - Confirm the sale was made on a mapped POS device - Check that the product is Yellow Dog‑managed (retail) or that the recipe link exists (F&B) ## Learn more - [Yellow Dog × ROLLER overview](https://www.yellowdogsoftware.com/roller) - [Yellow Dog technical docs](https://help.yellowdogsoftware.com/roller) - [ROLLER API overview](/v1/docs/api-overview) - [Partner directory (Yellow Dog)](https://roller.software/integrations/partner/yellow-dog-software) ## Related - [API overview](/api-overview.md) - [Extend your capabilities with our integrations](/extend-your-capabilities-with-our-integrations.md) - [Set up reporting categories and GL codes](/set-up-and-manage-reporting-categories-and-gl-codes.md) - [Create stock products](/create-your-stock-products.md)