Integration Handle for Meraki

This article explains what are factors to be checked when a POS already live on HUB and is about to go-live with UP OMS platforms.

Written By Ops UrbanPiper (Collaborator)

Updated at May 4th, 2021

If you are reading this article, that means your POS application must be already integrated with UrbanPiper for HUB. The merchants you have onboarded to UrbanPiper for HUB should have been already live on aggregators platforms.

In order to onboard a merchant who wishes to go live on UrbanPiper powered Meraki platforms like website, android/iOS APPs, Satellite Order Tracker then you need to handle few cases to make sure the implementations are covered in the existing integration for the orders placed through OMS platforms.

Adding/Updating Stores API

  1. All the attributes will become the required ones and make sure you send accurate information. Each and every attribute is significant to control the data of the stores.
  2. Understand the importance of each attribute and accordingly pass the correct data after checking with the merchant.
  3. If you want to enable the store only for Meraki and not for HUB then make use of "excluded_platforms" to exclude the aggregators. If you want to exclude the Meraki platform but to keep only Hub platforms, then use "urbanpiper" as platform name to pass it under "excluded_platforms".

Managing Catalogue API

  1. Understand the menu to be sold on the Meraki platform by the merchant. Accordingly, sync to the UP system.
  2. If there are any items to be part of Meraki and not part of the HUB then use the "excluded_platforms"/ "included_platforms" to exclude/include the aggregators while syncing the menu. similarly, for vice-versa.
  3. If there is any price difference between HUB and Meraki menu, make sure of the "external_price" - to pass the aggregator menu price and "price" - to pass the Meraki menu price.
  4. The information you sync to the UrbanPiper system will be displayed on front end.

Store Actions API

  1. To temporarily disable/enable the store for receiving orders via Meraki platforms, pass the platform value as - "urbanpiper" under the "platforms" array.
  2. If you want to disable the store for all the available platforms, then pass all the active platform values applicable for the store under the "platforms" array.
  3. No webhook callback will be sent for the actions made for this API.

Items Actions API

  1. There is no platform-specific item enable/disable for this API.
  2. No webhook callback will be sent for actions made for this API.

Order Relay Webhook

  1. For Meraki orders, the "channel" values will be one of the following — web, app_android, app_ios, satellite.
  2. Make sure UrbanPiper Order "order.details.id" is displayed on POS UI for Meraki orders.
  3. Make sure to show the details of customer - "name", "phone", "address", payment - "option", "order_type", "created" time, "delivery_datetime" on POS application.
  4. If any coupon code is applied by the customer, show the "coupon" name on the order details page of your POS application.
  5. When the Spilt payment scenario is provided, show both the payment "option"s on the POS application.
  6. Based on the payment "option" present in the Meraki order, accordingly, the delivery rider collects the money from the customer.
  7. Payment "option"s supported for OMS orders are — prepaid, payment_gateway, cash, paytm, wallet-credit, simpl, paypal.

Order Status Update - PUT API

  1. Order status update remains the same except, all the order states are expected to be passed to the Urbanpiper system from the POS application.
  2. Available order states — Acknowledged, Food Ready, Dispatched, Completed, Cancelled.

Order Status Update Webhook

  1. In the case of Meraki order, what all order states you pass to the UP system through Order Status Update API, the same will be triggered again back to your system through this webhook.


In case, if you have any further doubts regarding the same, feel free to email us at [email protected]



Was this article helpful?