Integration Signoff checklist - Ordering Integration

Ensure below list of use-cases are tested/verified before giving the signoff

2d99496b4b52d29fd1cc66db7dbaf182

Written By Ops UrbanPiper (Collaborator)

Updated at June 6th, 2019

Action Pointers

Make sure you have consumed the below APIs before requesting integration team for the sign-off -

  1. Order Relay
  2. Order Status Update from POS to UP
  3. Order Status Update from UP to POS
  4. Rider Status Update
  5. Adding/updating the stores
  6. Store Configuration Callback
  7. Stores Actions API
  8. Stores Actions Callback
  9. Manage Catalogue Update
  10. Catalogue Configuration Callback
  11. Items Action API
  12. Webhook API

Important points to remember while validating the integration development at POS end.

Non-technical Aspects

  1. These pieces of information should show on POS frontend/screen - Order_id of aggregator, channel, delivery_type, payment type, instructions, delivery rider contact details, the current status of the order, the current status of the delivery rider.
  2. Merchant Sponsored Discount = (discount - total_external_discount). Make sure this logic is handled at the POS end for the merchant to show how much merchant sponsored discount has been applied for an order. Also, show the same on the POS screen and bill.
  3. Merchant receivable amount from aggregators = (order_total + total_external_discount)
  4. New orders and cancelled order status from aggregators should show as a pop-notification on POS screen,
  5. Validate order level, as well as item level taxes and charges, are taken care and the same is visible in the POS screen.
  6. Validate the ordered items and quantity is showing correctly on the POS screen.
  7. Check all the mandatory order status update is being passed from the POS system and the status has been updated in UP system.
  8. Food Ready - the status update should be passed as soon as the food is prepared in the kitchen.


Technical Aspects

  1. Check if the requests are being made from https scheme.
  2. Check the time taken to show the orders in the POS screen and time taken for status update happening from POS to the UP system. The changes should reflect within 10 seconds.
  3. Make sure POS has handled the throttling limit for all the APIs.
  4. Make sure the retry mechanism for a failed response should have max. of 3 times only.
  5. The request call to our APIs should always happen as a bulk request. The objects should be sent in bulk while making a request to our system.
  6. Check if the requests for Items Actions API and Store Actions API are being made from https://integrations.urbanpiper.com
  7. If POS doesn't have any data for a given optional attribute in the request, allow null values, NOT the empty string.
  8. If POS doesn't have any data for a given optional array in the request, allow empty array or null, NOT the empty string.
  9. POS should not have the logic  - same items at 2 different locations having the common item ref id should not have a two different prices concept.
  10. The POS Menu catalog IDs for an item should be the same for all the stores for a single brand.
  11. The same item should not have different prices for different aggregators for the same location. Basically, we don't support the differential pricing for aggregators.

Was this article helpful?