Orders Aggregator

Connect your POS to supported delivery marketplaces through Orders Aggregator powered by Kitchen Hub. Once connected, you can publish your menu, receive marketplace orders directly in POS, manage order status, and track marketplace sales in your Back Office.

Before you begin

Before setting up Orders Aggregator, make sure the following requirements are met:

• You have Administrator access, or a user role with permission to manage Apps and Inventory.
• The Orders Aggregator app is installed.
• The older Orders Aggregator (OO) application is not installed.
• Your store has a valid State, ZIP Code, address, and business hours (in Store Settings) configured.
• At least one active POS register is assigned to the store.
• You have login credentials for the delivery provider you want to connect.
• Your products, pricing, modifiers, images, and business hours are ready for publication.
• Both Back Office and your POS register are connected to the internet.
• (Optional) Kitchen printer or KDS is configured if you plan to print kitchen tickets or send orders to a Kitchen Display System.

Quick setup

Complete setup in the following order:

1. Install Orders Aggregator in App Directory > Apps.
2. Verify your store information.
3. Select products for your marketplace menu.
4. Create an Orders Aggregator location.
5. Connect your delivery provider.
6. Synchronize your menu.
7. Refresh your POS register and place a test order.

Install Orders Aggregator

1. Sign in to Back Office.
2. Open Apps or App Directory.
3. Find Orders Aggregator.
4. Select Install or Buy, depending on your subscription.
5. Complete the installation.

Once installed, Orders Aggregator appears in the Apps menu.

Note: If you don't see the app, verify that you're signed in as an Administrator and that your subscription includes Orders Aggregator. If 

Verify store settings

1. Open Settings > Stores.
2. Select the store that will receive marketplace orders.
3. Verify:
   • State
   • ZIP Code
   • Store address
   • Time zone
   • Business hours
4. Save any changes.

Important: Orders Aggregator cannot create a location if the store is missing a State or ZIP Code. Store hours are synchronized with supported providers.

Add products to your marketplace menu

Products are only published to marketplaces if they are explicitly included.

For each product:

1. Open Inventory.
2. Select the product.
3. Open the Integrations tab.
4. Enable Include in Orders Aggregator.
5. Save the product.

Supported products

Products must:

• Have a fixed price
• Be active
• Belong to an active category and department
• Have valid pricing
• Use active modifier groups and modifier options
• Have clear product names and descriptions

Orders Aggregator does not support:

• Variant products
• Serialized products
• Prepaid products
• Products with manually entered prices
• Products or modifier options with negative prices

Tip: Square product images provide the best appearance on marketplace menus. If an integration image is available, Orders Aggregator uses it automatically.

Create an Orders Aggregator location

1. Open Apps > Orders Aggregator.
2. Select Add Location.
3. Complete the location settings.

Configure:

Note: Product price increases do not apply to modifier prices.

After saving, you'll be taken to the Providers tab.

Connect a delivery provider

Orders Aggregator supports:

• DoorDash
• Uber Eats
• Grubhub

To connect:

1. Open your Orders Aggregator location.
2. Select the Providers tab.
3. Click Select a provider.
4. Choose your provider.
5. Select Connect.
6. Sign in using your provider credentials.
7. Authorize the connection.

After authorization, synchronize your menu immediately or return later.

Important: Allow browser pop-ups before connecting your provider.

Pause or resume a provider

Use Pause when you want to temporarily stop receiving marketplace orders without removing the connection.

To pause:

1. Open the Orders Aggregator location.
2. Open the Providers tab.
3. Select Pause.

Select Resume to begin accepting orders again.

Tip: Use Disconnect only if you intend to permanently remove the provider connection.

Synchronize your menu

Once your products are ready:

1. Open Apps > Orders Aggregator.
2. Open the location.
3. Select Sync Inventory.
4. Wait for synchronization to complete.
5. Review the synchronization results.

If Unsynced Items are listed:

1. Open the list.
2. Correct each issue.
3. Synchronize again.

Note: Manual synchronization is limited to 10 times per 24 hours.

Synchronization status

Prepare your POS

After configuration:

• Verify the selected register is online.
• Refresh or sign back into POS.
• Confirm order notifications appear.
• Verify sound notifications.
• Test kitchen printing (if enabled).
• Test KDS routing (if enabled).

No Kitchen Hub credentials are required inside POS.

Manage marketplace orders

Receive orders

When a new marketplace order arrives, POS can:

• Display a notification
• Play a sound
• Print a kitchen receipt
• Send the order to KDS
• Display provider information
• Display customer information
• Show order notes and modifiers
• Display scheduled pickup or delivery time
• Display courier information when available

Provider cancellations

If the provider cancels an order:

• Select Open to review the order.
• Select Close to dismiss the notification.

The canceled status is saved automatically.

Accept or decline orders

Most marketplace orders are accepted automatically.

If an order requires manual action:

• Select Accept and choose a preparation time.
• Or select Decline to reject the order.

The selected status is immediately sent to the marketplace provider.

Mark an order as Ready

When an order is prepared:

1. Open the order.
2. Select Ready.
3. Confirm.

Orders Aggregator sends the updated status to the marketplace.

The order is marked Prepared after the provider confirms the update.

Void or refund marketplace orders

Marketplace refunds should always begin with the delivery provider.

1. Cancel, refund, or void the order through the provider dashboard.
2. Open the order in POS.
3. Select Manual Void.
4. Confirm.

Important: Manual Void only updates the local POS order. It does not notify the provider or process a refund.

Verify your setup

Before opening your menu to customers, place a test order and verify:

• The order reaches the correct register.
• Products and pricing are accurate.
• Modifiers appear correctly.
• Scheduled times are correct.
• Kitchen printing and KDS work.
• Ready status updates successfully.
• Pause and Resume function correctly.
• Orders appear in reporting.

Reports and taxes

Marketplace sales appear in standard Back Office reports.

Orders Aggregator automatically creates a protected Provider Tax for marketplace orders.

This tax:

• Appears in Tax Report
• Cannot be edited or deleted
• Cannot be assigned to products
• Cannot be added to combined taxes

On customer receipts, the provider tax simply appears as Tax.

Troubleshooting

Orders Aggregator doesn't appear

Verify:

• The app is installed.
• You have permission to manage Apps.
• The older Orders Aggregator (OO) application is not installed.

Menu won't synchronize

Verify:

• Products are marked Include in Orders Aggregator.
• Products and modifiers do not use negative prices.
• Products, categories, departments, and modifiers are active.
• Store hours are configured correctly.

Orders don't appear in POS

Verify:

• The correct register is assigned.
• POS is online.
• The register has been refreshed after setup.
• Notification settings are enabled.

Kitchen tickets or KDS don't work

Verify:

• Kitchen printing is enabled.
• A kitchen printer is configured.
• KDS is enabled and online.
• Categories and routing are configured correctly.

Best practices

• Connect one Orders Aggregator location per store.
• Finish configuring products before your first synchronization.
• Test your menu before going live.
• Use Pause instead of disconnecting a provider when temporarily stopping online orders.
• Always process marketplace refunds through the delivery provider before using Manual Void in POS.