You can generate up to 11 API tokens in the Partner Portal. These are bearer tokens which don’t have an expiry date and are applicable at the chain level, meaning a single API key can manage all outlets in a chain

If an existing chain wants to onboard new outlets or scale, what is the process to integration?#

To scale the integration at chain level, following things are to be considered from your side

Verify access to your new stores in Partner Portal and review webhook configurations
(Optional) If you have any internal mapping for your store, it is possible for you to configure directly from the Shop Integrations plug-in. Use the new configured store-id or vendor id in your API requests.

Can I generate API tokens myself?#

Yes, you can generate tokens on your own. You are required to have access to the Shop Integrations plug-in in Partner Portal.

How do I find my Foodpanda Vendor/store ID?#

You can get it directly Partner Portal>Shop Integrations>Settings>Vendor Identifier section or check with your Account manager.

What If I already have internal storeID and I don’t want to use Platform storeID?#

You can configure your internal storeID in Partner Portal>Shop Integrations>Settings>Vendor Identifier section. Please note to use the newly mapped storeID in your API requests.

Request schema and Fields#

Can I use SKU or Barcode for updates?#

Yes, SKU and Barcode are both supported.

How many decimal points can the price go up to?#

Only first three decimals are supported, example: 4.5555555 will lead to 4.555

How to use max_sales_quantity?#

max_sales_quantity is configured at item level, it will limit the number of items a customer can place in one order e.g if the max_sales_quantity for the milk product is set to 5, the customer can place up to 5 quantities of milk in one order.

What is the significance of the quantity field?#

We don’t store the quantity field; it acts as a reference in comparison with the already configured sales buffer in the catalog. It is used for the deactivation or activation of products when the quantity is less or more than the sales buffer respectively.

Eg. if you send quantity as 3 & sales buffer is configured as 5, the product will be deactivated on the front end becasue quantity < sales_buffer

Note

Sales buffer cannot be configured via API, it can be configured only in catalog please reach to Account Manager to configurations

How many SKUs can PUT /catalog request accommodate in a single request?#

We don’t have estimates on the number of SKUs, our services can consume data of 100MB which is a fairly large assortment size for a single store.

Updates and Synchronisation#

How frequently can vendors push assortment API updates?#

The decision regarding frequency of pushing updates lies with the vendor. We suggest to use bulk updates if Partner want to update multiple products, as it provides visibility to Partners on update logs to the configured webhook. Partner can push entire assortment once a day and during the day share only delta changes. Please make sure that your API requests don’t exceed more than 60 per minute.

How much time is required for product updates to be reflected on the frontend?#

Assortment changes will take up to 15 minutes to sync to the Platform App.

How can vendors check the status of the API updates?#

In the Partner Portal shops integration plugin, vendors can get an overview of jobs, any error with respect to SKU will be listed there, if SKU is not found please review the request body for SKUs available on catalog. Assortment API is used for updating the existing products in catalog not for creating new products. If the vendor configures the webhook, they can receive the status of updates at SKU level.

Where can I check my product prices?#

We offer the Store Management plugin, accessible through the store's Partner Portal account that will allow you to check the current product prices.

Access to Partner Portal#

What is Partner Portal and how do I get access?#

Partner Portal is a back office tool by which you can manage your stores. When you are onboarded to our platform our Account Management team will be providing you the access. Depending on your use privileges you can also manage the webhook and token configurations.

Following activities can be managed from Partner portal:

Integration configurations
- Store operations
- Create promotions
- Update product availability & prices
- Review orders across your stores
- Identify issues and perform initial troubleshooting

How do I access the Shops Integrations Plugin?#

All current Shops Partners of any size can access the Shops Integrations plugin in Partner Portal, you will be given access by your Account Manager or during registration with us.
It is advised to limit the access to Shops plugins in Partner Portal to only those who need to perform a function for your business - this is because Partner Portal can contain sensitive information i.e webhook configurations
Please reach out to your account manager if you do not know how to gain access to Partner Portal

Where can I go for further support?#

If you have any questions regarding the integration or if you are facing errors, please contact your Account Manager or drop an email to Key Account integration Team: keyaccountsQC@deliveryhero.com

API≪ Troubleshooting APIOverview ≫

On this page

How do I generate credentials to use Partner API /Catalog?

How many tokens can I generate?

If an existing chain wants to onboard new outlets or scale, what is the process to integration?

Can I generate API tokens myself?

How do I find my Foodpanda Vendor/store ID?

What If I already have internal storeID and I don’t want to use Platform storeID?

Can I use SKU or Barcode for updates?

How many decimal points can the price go up to?

How to use max_sales_quantity?

What is the significance of the quantity field?