Skip to content

FoodZaps Integration

YQueue provides an integration with FoodZaps for our Kiosk and Online Ordering applications.

Installation

Before You Get Started

You should be aware of the below points before activating the integration. If you have any questions, please contact your account manager for assistance.

  • We do not support the FoodZaps concept of a "Set Meal"
  • You cannot activate the FoodZaps integration if you have an existing POS integration configured against your merchant profile
  • You cannot activate the FoodZaps integration if your merchant profile has more than one linked outlet
  • You cannot activate the FoodZaps integration if you have any outstanding orders at your outlet (mark any in-progress orders as complete to proceed)
  • You cannot activate the FoodZaps integration if you are accepting delivery orders via Rida, or if you're not accepting in-house delivery orders automatically
  • You will not be able to use YQueue OMS (any existing OMS terminals will be unlinked)
  • You will not be able to use YQueue's reports
  • Your catalog (except taxes) will be wiped and replaced with the contents of your FoodZaps menu
  • After activating the integration you must ensure that you configure your taxes in the YQueue merchant console to match what is configured in FoodZaps
  • FoodZaps will not communicate the status of orders back to YQueue after the POS terminal initially accepts the order
  • FoodZaps does not communicate inventory information back to YQueue
  • FoodZaps will not pass refund information back to YQueue, so you must refund transactions on both the FoodZaps terminal as well as in the YQueue merchant console
  • If you wish to accept orders online, before activating the integration you should set online delivery orders to "automatically accepted" (even if you do not wish to accept delivery orders)

Warning

You must not configure discounts or surcharges on your FoodZaps POS terminal as FoodZaps cannot sync this information to YQueue, which would result in customers being charged the incorrect amount.

Step 1: YQueue Configuration

Navigate to the merchant console and follow the below steps:

  1. Click Integrations in the navigation bar
  2. Click FoodZaps in the list of supported integrations
  3. Click Set Up on the outlet you wish to activate the integration against
  4. Enter the Controller, Username & Password provided by FoodZaps

Step 2: FoodZaps Configuration

  1. Create tables with the following names in the FoodZaps POS (even if you do not offer all service types):
  2. Dine In
  3. Take Away
  4. Delivery

  5. Create a payment method called YQueue in the in the FoodZaps POS with the following configuration:

  6. Name: YQueue

  7. Sales Type: S2
  8. Payment Type: Direct
  9. Template: None
  10. Bill Discount: Disable
  11. Tax: Disable or Fixed Value
  12. Total Bill Rounding: Disable
  13. Cash Management: Not Applicable

  14. Change Management: No change given

  15. Enable the YQueue menu sync endpoint in the FoodZaps interface

  16. Navigate to Settings -> Online Online Channels -> Customization -> YQueue Endpoint
  17. Toggle the setting to Enable
  18. Where prompted for a URL, enter: https://api.yqueue.tech/v1.0/
  19. Hit Publish

Using The Integration

After the integration has been successfully configured all orders placed via YQueue Kiosk or Online Ordering will automatically be sent to FoodZaps (usually within 30 seconds).

We'll automatically retry sending orders to FoodZaps for up to 5 minutes if there are any issues. If after 5 minutes we're still unable to send the order to FoodZaps, we'll notify the merchant that something has gone wrong. If the POS explicitly rejects the order during this time, we'll cancel and refund the order automatically. We will not cancel and refund an order if the issue is purely connectivity related.

Any changes to your FoodZaps menu(s) will be automatically synced with YQueue Kiosk and Online Ordering, usually within 60 seconds of FoodZaps notifying us of the change.

FoodZaps supports the concept of excluding items from discounts by placing [ND] in the item name. During the menu syncing process YQueue will create a product group titled "Discountable Items" which should be associated with any discounts you manually create in the YQueue merchant console to ensure that items with [ND] are excluded from the discount.

Unsupported Features

When the FoodZaps integration is enabled the following features will be disabled on your merchant profile:

  • GTO integrations (as the POS will be responsible for GTO)
  • Pickup Display
  • The following catalog types cannot be edited:
  • Menus
  • Categories
  • Items
  • Modifiers
  • Modifier roups
  • Meals
  • Schedules
  • Tags
  • Reports