Integrate your Foodics account with UrbanPiper

This guide outlines the onboarding steps, timelines, and key operational guidelines for completing the UrbanPiper–Foodics integration successfully.

An UrbanPiper Onboarding Manager will be assigned to work alongside the Foodics team and support you throughout the entire integration process.

Onboarding Process Overview

The onboarding process consists of three major phases:

1. Authorization

2. Menu Setup on Foodics

3. Menu Pull & Aggregator Mapping

---

1. Authorization

Follow the steps below to grant integration permissions to UrbanPiper and generate your brand-specific token.

Step 1: Log in to the Foodics Console

• Log in using Owner-level access.

• Navigate to the Marketplace.

Step 2: Search & Open the UrbanPiper App

• Search for UrbanPiper in the Marketplace.

• Click the app to open its details screen.

• Enter the credentials:

Username: xxxx
Password: xxxxxxxxxxx

UrbanPiper Onboarding Manager will assist you with the password during your onboarding process.

Step 3: Authorize the Integration

• On the UrbanPiper screen, click Authorize.

• You will be redirected to Foodics — click Authorize again to complete the process.

---

2. Menu Setup on Foodics

Menu Grouping

• Ensure the entire menu is placed under the UrbanPiper group.

• The group name must match exactly in spelling (case can differ).

Add Products to the UrbanPiper Group

• All products that need to appear on aggregator platforms must be assigned to the UrbanPiper group.

Create Charge IDs

• Create an Open Charge ID.

• Add both Pickup and Delivery charges.

Price Tags (for Differential Pricing)

If the brand has differential pricing, add the following price tags and associate them with the relevant products:

up-talabat
up-toyou
up-mrsool
up-deliveroo
up-radyes
up-eateasy
up-chatfood
up-noonfood
up-hungerstation
up-jahez
up-careem

• Tag names are name-sensitive but not case-sensitive.

Pricing Logic

• If a product has a price tag for a specific aggregator → that price is used.

• If no tag exists → base price is used.

• If no tags at all → base price applies to all aggregators.

---

3. Menu Pull in UrbanPiper

• Once the menu setup is completed and verified in Foodics, UrbanPiper will pull the menu into the UrbanPiper system.

• This initiates the mapping process.

---

4. Aggregator Mapping

After the menu pull, the UrbanPiper Onboarding Manager will coordinate with the various aggregators to map the brand’s locations. This is a manual process, and timelines differ by aggregator.

Mapping Timelines

Aggregator	Mapping Timeline
Deliveroo	24–48 hours from request
Talabat	Requests raised every Sunday/Tuesday; go-live on Wednesday/Thursday
Careem	Mapping raised on Wednesdays; go-live on Thursday
Noon / Smiles	24–48 hours from request
Chatfood	3–4 days
Keeta	Depends on the Keeta mapping team (variable)

---

Completion & Go-Live

• Once the mapping is completed across all aggregators, the UrbanPiper Onboarding Manager will share the final status.

• Orders can then begin flowing through Foodics × UrbanPiper.