This guide explains how Jahez is integrated with Sirdab, covering store setup, product management, order flows, and the responsibilities of both systems.
1. Store Creation & Approval
Step 1: Store Creation
You can create your Jahez store directly from the Sirdab platform: navigate to Fulfilment then Integrations, and click Connect in the Jahez section.
Note: if you already have an active Jahez store, please contact our support team so we can connect it to your Sirdab account.
Required details include:
Logo
Store name (Arabic and English)
Description (Arabic and English)
Address details (manual or short code)
Step 2: Submission to Jahez
Once the store is created, a request is sent to the Jahez team for approval.
The request includes your store details, along with the CR and VAT details saved on the Sirdab platform.
The store remains in Pending status during this phase. You will be notified once a response is received from the Jahez team.
Step 3: Approval
Jahez reviews the store information.
Upon approval, the store becomes Connected.
If rejected, the store shows as Rejected and the rejection reason is displayed.
2. Branch Management
Branches are created and managed in Sirdab and mapped to the corresponding branches on Jahez.
During mapping, branch and darkstore addresses, locations, and working hours are synced from Sirdab to Jahez.
3. Product Management
After the store is approved, you can list Sirdab SKUs as products on Jahez and manage the products that are already listed.
Product Listing
Every product listed on Jahez must end up with an image and a description. These can be saved on the SKU page, or provided directly in the Add Products form while listing.
To list new SKUs, click Manage Products.
Step 1: Select SKUs. The Add Products dialog shows a list of all unlisted SKUs. Select the ones you would like to list using the checkboxes, then click Next.
Step 2: Product details. A form is shown for each selected product with the following fields:
Image URL: a link to the product image. If left empty, the SKU's saved image is used.
Product name in English and Arabic: the English name is prefilled with the SKU name; if the Arabic name is left empty, the SKU name is used.
Description in English and Arabic: if left empty, the SKU's saved description is used.
Price (required): must be greater than 0.
Industry (required): select the Jahez industry for the product.
Important: if a branch has 0 inventory of a product, it automatically appears as "Out of Stock" on the Jahez app for that branch.
Product Listing Results
On success: each successfully processed SKU appears in the Products table and is listed on the Jahez store.
On failure: an email with the error details is sent to the organization admins.
Editing a Product
From the Products table, you can edit a listed product's price, name (Arabic and English), description (Arabic and English), and industry.
Fields you leave unchanged keep their current values.
Product images are managed from the SKU page and are not editable from this screen.
Once saved, the updated details are synced to your Jahez store.
4. File Actions
The File Actions menu on the products page groups the file-based operations: Download template, Export products, and Upload new products. Together they let you list many products at once instead of selecting SKUs one by one.
Download Template
Click File Actions then Download template to get an empty Excel sheet with the required columns:
Column | Required | Notes |
type | Yes | sku or bundle |
merchant_sku | Yes | Your own product code, as saved on the Sirdab platform |
name_ar / name_en | No | If left empty, the SKU or bundle name is used |
description_ar / description_en | No | If left empty, the SKU description is used |
price | Yes | A number greater than 0 |
industry | Yes | The Jahez industry name in English, for example Other |
image_url | Only for SKUs without an image | A single image link. If left empty, the SKU's saved image is used. Bundles need an image |
Note: do not rename, reorder, or delete any columns, and keep the header row as is.
Export Products
Click File Actions then Export products to download an Excel file of all products currently listed on Jahez, including their current names, descriptions, prices, industries, and image links.
The export uses the same format and columns as the template, so it doubles as a filled-in example of how upload rows should look.
Every product in the export is already listed on Jahez, so re-uploading it as is creates nothing new: rows for already-listed products are always skipped.
Upload New Products
The file upload creates new products only: it never updates products that are already listed on Jahez. To change a listed product, edit it from the Products table.
Fill one row per new product you would like to list on Jahez, using the template as your starting point (or an export to see how finished rows look).
Click File Actions then Upload new products and choose your file (.xlsx, .xls, or .csv).
Upload results
Valid rows are queued for creation and appear in the Products table once processed and listed on Jahez.
Rows for products that are already listed on Jahez are skipped automatically, so re-uploading the same sheet is safe: it only fills in the missing products.
If some rows have problems, a list of the failed rows is displayed with the row number and the reason (for example, a missing price or an unknown industry). The valid rows are still processed.
If the file itself cannot be read (unsupported file type or missing columns), nothing is processed and the file error is displayed.
5. Controlling Product Visibility
Inventory availability is fully controlled by Sirdab. Each product is controlled through two statuses managed by Sirdab:
1. Sold Out
By default, products are available on all branches selected during store creation.
Inventory availability is managed per branch: if inventory is available, the product is marked as Available for that branch; if not, it is marked as Sold Out.
Inventory is re-checked when adding inventory through an inbound operation (sold-out products become Available again) and when removing the last available inventory through an outbound operation (the product becomes Sold Out).
2. Hidden
From the Sirdab UI, each listed product has a Hidden Branches option.
You can select specific branches where the product should be hidden.
Once hidden, the product is not visible on Jahez for the selected branches.
6. Order Processing Flow
Orders are created on the Jahez store and pushed to Sirdab.
When Sirdab receives an order, it performs several validations before creating it: all products are properly mapped, sufficient inventory is available for the requested quantities, and the warehouse is operational. If any check fails, the order is automatically rejected and the rejection is synced back to Jahez.
After this stage, order status control is handled by Jahez.
Once the Jahez courier picks up the order: Out for Delivery on Jahez and Shipped on Sirdab.
Once delivered: Delivered on both Jahez and Sirdab.
7. Failed Deliveries, Rejected & Cancelled Orders
If a delivery fails, the Jahez courier marks the order as Not Delivered. Sirdab then initiates a return for the order, and the products are returned to the appropriate branch.
If a product is unavailable, the store is closed, or for any other reason, the store operator may reject an order. It is marked as Rejected on Jahez and Cancelled on Sirdab.
8. Status Ownership (Sirdab vs Jahez)
Statuses controlled by Sirdab
Order acceptance and rejection
Preparing and picking
Out-of-stock decisions
Statuses controlled by Jahez
Order placement
Dispatch, delivery, and last-mile status
Order completion or customer-side cancellation