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.
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 on our Integrations directory to get started.
2. Generate API credentials in ROLLER
- Go to Venue Manager › Settings › Integrations › API keys
- Select Create a client key
- Name it Yellow Dog, then select Create
- Copy the Client ID and Client secret and store them securely
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)
- 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.
- Products sync to ROLLER as individual products (no variants). Pricing, descriptions, barcodes, tax codes, and reporting categories sync from Yellow Dog.
- Make sales/refunds in ROLLER POS. Sales reduce stock in Yellow Dog; refunds restore it.
F&B (one‑way)
- Create menu items in ROLLER (e.g., Cheeseburger, Large Soda).
- Build recipes in Yellow Dog with ingredient items (e.g., bun, patty, pickle slices) and link them to the corresponding POS items.
- 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.
Limitations
- 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
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)