OneHub by Loops

Introduction

Loops is a restaurant operations platform that connects Foodics with multiple third-party delivery platforms through a single integration layer.

The Loops–Foodics integration allows merchants to seamlessly sync branches, menus, and orders from Foodics into Loops. Foodics remains the source of truth for menu and pricing, while Loops distributes the menu to connected delivery platforms and synchronizes order updates in real time.

Once authorized, Loops automatically fetches the merchant’s business details, Foodics branches, and the dedicated menu group configured for the integration.

For more details, you can reach Loops at:

• Website: https://www.loops.sa
• Support Email: info@loops.sa

Business Configuration in Foodics

Before enabling the Loops integration, please ensure the following configurations are completed in your Foodics account:

1. Menu Group
   • Create a dedicated menu group named exactly:
     Onehub Group
     • (e.g., if "OneHub Group" or "onehub group" would fail).
   • Do not create duplicate menu groups with the same name.
   • Only items within this menu group will be synced with Loops.
2. Pricing Method
   • Your Foodics business must use Tax Inclusive Pricing.
   • Loops currently supports only tax-inclusive pricing.
3. Price Tags
   • Do not apply price tags to any menu entities inside the Onehub Group.
   • Support for price tags will be introduced in future releases.
4. Localization
   • Localization is mandatory for certain delivery platforms (e.g., Ninja).
   • Failure to provide both English and Arabic names will result in a sync rejection for Ninja-integrated branches.
   • Enable localization from Foodics Console:
     • Manage → More → Settings → Enable Localization → Save
   • Ensure localized names and descriptions are added for all categories, products, and modifiers inside the Onehub Group.

Enabling the Integration

Note: You must have a Loops account before enabling this integration.
If you do not have an account, please contact Loops support at info@loops.sa or sign up at this link.

Steps to Enable the Integration

1. Log in to your Foodics console at this link using the owner email.

   Non-owner users cannot activate marketplace integrations.

2. Navigate to Marketplace page --> Search for Loops under Ordering Platforms Management category --> Click Install
3. You will be asked to Authorise your Foodics Account.
   • Click Authorize Loops to Access My Account.
4. After authorization you will be redirected to Loops.
5. Sign in to your Loops account and you will be navigated to Foodics Integration page to complete the integration.
   • Select the store or create one, then Click the Sync Store Button, to complete link the Foodics Integration.
6. Branch & Menu Setup
   • Got to Stores List page via this Link.
   • Go to branches list page of Foodics integrated store by clicking Branches Button.
   • Create corresponding branches in Loops.
   • Map each Loops branch to a Foodics branch 1 by 1 on Branch Details page.
     • Branch mapping can be done when creating anew branch or when editing an existing branch.
     • Branch mapping is also available on Foodics Integration page.

⚠️ Unmapped Foodics branches are not supported and will not receive menu or order updates. ❗️Loops neither supports Combos nor the Sub Gruops, so Loops will ignore both entities from targeted MENU Group.

Menu Sync

• Loops fetches only the “Onehub Group” menu from Foodics.
• The initial menu sync happens automatically after successful authorization.
• Any menu changes made in Foodics (categories, products, modifiers) are:
  • Reflected in Loops automatically
  • Synced to connected delivery platforms every 10 minutes, if updates exist
• Menu entities are read-only in Loops and cannot be edited.

⚠️ Important Notes on Menu Sync

• ⏱️ Sync Latency: For certain delivery platforms, menu updates may take up to 30 minutes to reflect.
• 🌍 Language Requirements: You must provide both Arabic and English translations for every entity within the "Onehub Group."
• 🚫 Character Restrictions: Use only alphanumeric characters. Avoid special characters (e.g., *, -, _) as they may cause sync failures.
• ⚠️ Data Validation: Mixing English and Arabic text within the same name field (e.g., putting Arabic text in the English name field) will result in a failed integration.

How to Receive Loops Orders in Foodics Cashier

Loops Orders will be received as explained in the Accept Online Orders Article.

Important Notes

• Foodics is the source of truth for all menu data.
• Menu editing inside Loops is disabled for Foodics-synced items.
• Order actions (Accept, Reject, Ready, etc.) performed in Loops are reflected in Foodics in real time, and vice versa.
• Online orders must be enabled on Foodics cashier devices to receive orders correctly.

• Loops does not support operations on unmapped Foodics branches.

   

FAQ

1. Why can’t I edit Foodics menu items in Loops?

Foodics is the source of truth for menu data.
Allowing edits in Loops could cause inconsistencies and sync issues.

2. What happens if I delete a branch in Foodics?

• The branch mapping is removed in Loops
• The branch becomes a normal Loops branch
• You will be notified if the branch was linked to delivery services

3. Can I re-integrate Foodics later?

Yes.
When re-integrated:

• Branches and menus are fetched again
• A fresh setup is created to avoid conflicts