This guide explains how Jahez Restaurants is integrated with Sirdab, covering store setup, menu and product management, order flows, and the responsibilities of both systems.

Note: Jahez Restaurants is a separate integration from Jahez (Shops). If you are looking for the Jahez Shops guide, see the Jahez Integration Guide.

1. Store Setup & Connection

Jahez Restaurants stores are connected by the Sirdab team. To connect your store, please contact our support team.
Once connected, your Jahez store is linked to your Sirdab account and orders start flowing automatically. There is no approval process on your side.

2. Branches

Your Jahez branches are mapped by the Sirdab team to the corresponding Sirdab branches (darkstores).
You can view the list of connected branches on the Sirdab platform, including the branch name, city, district, and location link. Branch mappings are managed by Sirdab and are read-only.

3. Menu Categories

Products on your Jahez Restaurants store are organized under categories that you create and manage in Sirdab.

Creating a Category

Name (Arabic and English): both are required.
Display order: a whole number starting from 1 (defaults to 1). Categories appear on Jahez in this order.

Jahez Grocery Categories (optional)

Grocery stores only: this option applies only to stores registered on Jahez as grocery stores. It has no effect on normal (restaurant) stores.
When creating or editing a category, you can link it to one of Jahez's predefined grocery categories, selected from a list fetched directly from Jahez.
This controls where your products appear in Jahez's grocery browsing sections. It does not change any of your product details.
The linked Jahez category name is displayed next to your category in the categories list.

Editing & Deleting Categories

Categories can be edited at any time (names, display order, excluded branches, Jahez grocery category). Changes are synced to Jahez.
A category can only be deleted if no products are using it. If products are still assigned to it, you will see: "Category is in use by one or more products and cannot be deleted".

4. Product Management

Adding Products

Before adding products, make sure each SKU has the following (editable from the SKU page):

SKU image, used as the product image on Jahez (or provide an image link while adding).
SKU description, used as the product description on Jahez (or provide one while adding).

To add products, select the SKUs you would like to list and provide for each:

Price (required): must be greater than 0.
Category (required): one of the categories you created.
Names and descriptions in Arabic and English (optional): if left empty, the SKU's own name and description are used.
Image link (optional): if left empty, the SKU's saved image is used.

On success: the products are queued and appear on your Jahez store once processed.
If some products fail: a list of the failed products is displayed with the reason for each (for example, a missing image or an invalid category). The valid products are still processed.

Editing a Product

From the products list, you can edit a listed product's price, category, names (Arabic and English), descriptions (Arabic and English), and image.
Fields you leave unchanged keep their current values.
Once saved, the updated details are synced to your Jahez store.

Removing a Product

You can remove a product from your Jahez store at any time. The product is deleted from Jahez and unlisted on Sirdab; the SKU itself is not affected.

5. Bulk Editing Products via File

For larger menus, you can edit many products at once using an Excel file. The file flow edits products that are already listed on Jahez; new products are added from the Add Products screen.

Step 1: Download

Export: downloads an Excel file of all your listed products with their current details. This is the recommended starting point for bulk edits.
Download Template: downloads an empty sheet with the required columns.

Column	Notes
merchant_sku	Identifies the product; do not change it
name_ar / name_en	Product names in Arabic and English
description_ar / description_en	Product descriptions in Arabic and English
price	Product price
image_path	Product image link
category_id	The category the product belongs to

Step 2: Edit the File

Do not rename, reorder, or remove the columns or the header row, and do not change merchant_sku.
Editable fields: names (Arabic and English), descriptions (Arabic and English), price, image link, and category.
A blank cell means "keep the current value"; it does not clear the field.

Step 3: Upload

Upload the edited file (.xlsx, .xls, or .csv).
Rows with no changes are skipped automatically, so re-uploading a file is safe.
On success: the changed rows are queued and synced to Jahez, and you will see how many were updated and how many were unchanged.
If some rows fail: a list of the failed rows is displayed with the row number and the reason (for example, an unknown merchant SKU, or a product that is not listed on Jahez). The valid rows are still processed.
If the file cannot be read (unsupported file type or missing columns): nothing is processed and the file error is displayed.

6. Product Availability (Sold Out)

Availability is fully automatic and controlled by Sirdab per branch:

If a product has inventory at a branch, it is shown as Available on that branch.
If a product has no inventory at a branch, it is marked as Sold Out for that branch.
If a product is out of stock at all branches, it is hidden from the store entirely until stock is added again.
Availability is re-checked automatically whenever inventory changes: receiving stock through an inbound makes products available again, and dispatching the last units marks them sold out.
There is no manual show/hide control for Jahez Restaurants products; availability always follows inventory.

7. Order Processing Flow

Order Creation

Orders are placed on the Jahez store and pushed to Sirdab instantly.
Sirdab automatically accepts or rejects each order at the moment it arrives. There is no manual acceptance step and no acceptance time window.
An order is automatically rejected when: the Jahez branch is not connected to a Sirdab branch, one or more products are completely out of stock, the branch is currently closed, or one or more products are not listed on Sirdab.
The rejection reason is sent back to Jahez.

Accepted Orders

Accepted orders are created in Sirdab as urgent, pre-approved orders, and inventory is reserved immediately for instant picking.
The Jahez courier picks up the order from the branch.

Partial Fulfillment

If a product has some stock but less than the requested quantity, the order is still accepted and shipped with the available quantity.
A comment is added on the order listing the partially fulfilled products with the requested and dispatched quantities.
Refunding the customer for the missing quantities is arranged with your Jahez representative.

Status Sync

When the Jahez courier picks up the order: Out for Delivery on Jahez, Shipped on Sirdab.
When the order is delivered: Delivered on both Jahez and Sirdab.
Jahez's status updates also carry the payment method (known once the order is delivered, for example cash, Mada, or Apple Pay). Sirdab automatically updates the order's payment method on its side when it receives it.
If the order is cancelled, rejected, or timed out on the Jahez side, it is marked as Cancelled on Sirdab.
There is no returns flow for this channel; refunds are handled on the Jahez side.

Integrating with Jahez Restaurants for Ecommerce Fulfillment