Skip to main content
All CollectionsHow-to Guides
Integrating with Salla for Ecommerce Fulfillment
Integrating with Salla for Ecommerce Fulfillment
Updated over a week ago

Overview

The Salla integration allows Sirdab to capture orders you receive on your Salla store and fulfill them on your behalf.

Product Mapping

In order to fulfill your Salla orders, Sirdab needs to know which SKU or Bundle in Sirdab corresponds to your products or product variants in Salla. This process is called Product Mapping. It’s extremely important that all your products are mapped before Sirdab can fulfill your orders.

If Sirdab receives a fulfillment order with an unidentified product, it will delay fulfillment for your customers until the products have been mapped.

Recommended approach: use an SKU number for all your products on Sirdab and Salla

The recommended flow for mapping products is:

  1. Make sure to create all the SKUs or Bundles on Sirdab’s platform corresponding to all your Salla products, and

  2. Use the SKU number field on both Salla and Sirdab to identify products

By default, Sirdab tries to auto-link your Salla product to an SKU or Bundle on the Sirdab platform using Salla’s product sku field (رمز التخزين). Sirdab looks for a Bundle or SKU whose SKU Number number field matches Salla’s sku field.

For this reason, we highly recommend that you use the SKU number field on both Salla and Sirdab when creating SKUs to minimize product mapping errors.

Manual mapping

While we highly recommend against this approach for products, if for some reason you cannot use SKU numbers, then you can still tell Sirdab how to link products manually by visiting the manage integration page and either manually mapping your products to an existing SKU or bundle, or creating a new SKU and mapping it to it.

What does Sirdab do if it receives an order with unmapped products?

If we receive an order containing products which cannot be mapped to SKUs or Bundles on Salla, we will not be able to fulfill them. You will receive an email telling you which order was rejected and containing the ID of the unmapped product so you can take action.

Once you fixed the issue, if you are using make sure to retry the failed order using the instructions listed under the “Retrying failed orders” below.

How Sirdab Fulfills your orders

Sirdab can fulfill your orders using one of two modes:

  1. Complete fulfillment: We fulfill all the orders you receive on your Salla store.

  2. Selective fulfillment: You tell us explicitly which orders to fulfill.

By default, your integration will be using complete fulfillment. If you want to use Selective Fulfillment please reach out to customer support and it will be adjusted.

Sirdab will not process orders whose status on Salla is Under Review (تحت المراجعةـ). This is because the intention of that status is for you the Merchant to review the order on Salla before committing to fulfill it for the user.

If you are using complete fulfillment, simply change the status of an order from Under Review (تحت المراجعة) to In progress (قيد التنفيذ) or in delivery in progress (جاري التوصيل) then save the order.

If you are using selective fulfillment, first add a “sirdab” tag to your order on Salla, then change the status of an order from Under Review (تحت المراجعة) to In progress (قيد التنفيذ) or in delivery in progress (جاري التوصيل), and save the order. See this demo video to understand how selective fulfillment works

Cancelling Sirdab’s fulfillment of orders

Please note that we cannot cancel orders which have already left the warehouse or which have already been prepared. If we’re unable to cancel an order, we’ll email you with the reason why.

The mechanism for cancelling orders depends on whether you are using complete or selective fulfillment.

Cancelling an order if you’re using Complete Fulfillment

Simply mark the order as cancelled on Salla or delete it.

Cancelling an order if you’re using Selective Fulfillment

Either cancel or delete the order on Salla, or remove the Sirdab tag then change the order status back to Under Review (تحت المراجعة). It’s very important that you change the order status back to Under Review (تحت المراجعة), otherwise Salla will not inform Sirdab that the tag was removed. Once you do this, you can change the order status however you like as long as the tag is removed. Here is a demo example:

Retrying failed orders

When Sirdab receives your orders from Salla, there are two main reasons they could fail

  1. Lack of inventory. Sirdab does not have the Salla order’s products in stock

  2. Unmapped products. Sirdab does not know which SKUs or Bundles correspond to the Salla products in the order

If this happens, you need to address the cause of the failure either by sending inventory to Sirdab in an inbound or mapping the unmapped products like described.

Once you have fixed the root cause, you’ll need to retry the order.

To retry failed orders, you need to take the following actions on Salla:

  1. If you are using selective fulfillment, first ensure the order has the sirdab tag

  2. Change the status of the order in salla to “under review” (”تحت المراجعة”) then save the order.

  3. Change the status of the order to in progress (قيد التنفيذ) or in delivery (جاري التوصيل) then save the order.

Did this answer your question?