Skip to main content

Integrating with Shopify for E-commerce Fulfillment

Connect your Shopify store with Sirdab to automatically sync, process, and fulfill your orders.

Overview

The Shopify integration enables Sirdab to automatically capture and fulfill orders placed on your Shopify store. Once connected, every order syncs to Sirdab for storage, processing, and delivery.

Prerequisites

  • An active Sirdab merchant account (sign up at sirdab.app/sign-up)

  • "Wholesale warehousing and E-commerce fulfillment" selected during signup

  • An active Shopify store with admin access

  • Your Shopify store configured for the Saudi Arabia (KSA) market with SAR (ر.س) as the store currency

  • A SKU code set on every Shopify product/variant before connecting — Sirdab uses SKU codes to match products

Step 1: Configure Shopify Market & Currency

Sirdab fulfills orders for the KSA market. Before connecting, make sure Shopify is set up accordingly.

  1. In your Shopify admin, go to Settings → Markets and ensure Saudi Arabia is set as your primary market.

  2. Go to Settings → Store details and confirm the store currency is SAR (ر.س). Change it if needed.

⚠️ Orders priced in USD or any non-SAR currency may not sync correctly with Sirdab.

Step 2: Add SKU Codes to Your Products

Sirdab links each Shopify product/variant to a SKU or Bundle in Sirdab using the SKU field. Without SKUs, orders cannot be fulfilled.

  1. In Shopify, go to Products and open each product.

  2. In the Inventory section, fill in the SKU field with the same SKU value you use in Sirdab (the Merchant SKU).

  3. If your product has variants (size, color, etc.), set a unique SKU on every variant.

  4. Click Save.

💡 SKU codes are case-sensitive and must match exactly between Shopify and Sirdab.

Step 3: Connect Shopify from Sirdab

  1. Log in to your Sirdab Merchant Portal.

  2. Go to Dashboard → Fulfillment → Integrations.

  3. Find the Shopify card under Available Integrations and click Connect.
    ​

  4. In the Configure Shopify Integration modal, enter your Shopify Shop Name — just the store name, not the full URL.

  5. Click Connect. You'll be redirected to Shopify to authorize the Sirdab app.
    ​

  6. Review the requested permissions:

    • Read and write assigned fulfillment orders

    • Read and write fulfillments

    • Read and write inventory

    • Read locations

    • Read and write returns

  7. Click Install app. You'll be redirected back to Sirdab.

Step 4: Verify the Connection

  1. Back in Sirdab, go to Fulfillment → Integrations.

  2. Your Shopify store should now appear under Connected Integrations with:

    • 🟢 A green dot showing Integrated

    • Your store name displayed

    • A Manage button for further configuration

Step 5: Verify Product Mapping

  1. Click Manage on the Shopify integration card.

  2. Open the Mapped Products section.

  3. Confirm:

    • Products show as Mapped

    • SKU codes match between Shopify and Sirdab

    • All variants are mapped

If any product appears as Unmapped, click Map next to it and select the matching SKU from your Sirdab inventory.

Saudi National Address (Optional but Recommended)

Shopify's standard checkout does not have a dedicated field for the Saudi National Address Short Code (e.g. RIYD2929). Orders are delivered fine without it using the standard address fields, but including it improves delivery accuracy in dense urban areas and reduces failed deliveries.

How to capture it

Ask your customers to include their Short Code in the Apartment, suite, etc. field at checkout, after the district name. For example:

  • Olaya District, RIYD2929

  • Al Hamra, JEDH5678

The format is always 4 uppercase letters followed by 4 digits (LLLL####). Sirdab automatically detects this format anywhere in the address lines, extracts the code, and forwards it to the shipping carrier — your customer doesn't need to put it in any specific position.

💡 Customers can find their Short Code in the العنوان الوطني (National Address) mobile app, or by searching their address at splonline.com.sa.

What if the customer doesn't include it?

The order still flows normally to Sirdab and gets delivered using the postal code, city, district, and street fields — exactly like any other Shopify order.

Order Fulfillment Process

Once your store is connected:

  1. The customer places an order on your Shopify store.

  2. Shopify routes the order to the Sirdab fulfillment location.

  3. The order syncs to Sirdab automatically and a fulfillment order is created.

  4. Sirdab handles picking, packing, and shipping.

  5. Tracking and fulfillment updates are sent back to Shopify so the customer sees real-time status.

Returns

Sirdab supports the full Shopify Returns flow. Returns can be initiated from your Shopify admin, and Sirdab will pick up, inspect, and update the return status back in Shopify automatically.

How a return works

  1. The customer (or you) requests a return in Shopify (Orders → select the order → Return items).

  2. Shopify notifies Sirdab in real time via webhook.

  3. Sirdab creates a corresponding return order and arranges pickup of the items from the customer.

  4. Once the items arrive at the Sirdab warehouse, our team inspects and processes them.

  5. When the return is completed in Sirdab, the Shopify return is automatically closed — and the merchant can issue a refund from Shopify.

  6. If the return is cancelled at any point in Sirdab, the corresponding Shopify return is cancelled automatically.

Return reasons

Sirdab maps internal return reasons to Shopify's standard return reasons:

  • Customer Unreachable → UNWANTED

  • Cancelled order by customer → UNWANTED

  • Damaged Items → DEFECTIVE

  • Incorrect / Missing Items → WRONG_ITEM

  • Other → OTHER

Tracking return status

You can track the status of any return in two places:

  • Shopify admin — open the original order to see the return status (Open / Closed / Cancelled).

  • Sirdab Merchant Portal — go to Fulfillment → Returns for the full pickup, inspection, and warehouse processing details.

💡 Refunds are always issued from your Shopify admin, not from Sirdab. Sirdab only handles the physical return logistics and updates Shopify when the return is closed.

Common issues

  • Return not appearing in Sirdab — confirm the original order was fulfilled by Sirdab. Returns for orders fulfilled elsewhere are not synced.

  • Return shows "Open" in Shopify after Sirdab marks it complete — wait a few minutes for the webhook callback to process. If still open after 10 minutes, contact Sirdab support with the Shopify return ID.

Cancelling Fulfillment

Orders that have already been prepared or shipped cannot be cancelled.

Cancellation can be triggered from either side — Sirdab or Shopify — and the other side syncs automatically:

  • From Shopify — open the order (Orders → select the order → More actions → Cancel order). Shopify notifies Sirdab to cancel the fulfillment.

  • From Sirdab — open the fulfillment order in your Sirdab Merchant Portal and cancel it. Sirdab notifies Shopify to mark the order as cancelled.

Retrying Failed Orders

Orders may fail for two reasons:

  • Inventory shortage — Sirdab does not have enough stock of one of the requested SKUs.

  • Unmapped products — Sirdab does not know which SKU/Bundle the Shopify product corresponds to.

Fix the underlying issue (replenish inventory or map the product), then re-trigger fulfillment from your Shopify order page.

Troubleshooting

Products not syncing to Sirdab

  • Verify SKU codes are added to all product variants in Shopify.

  • Check SKU codes match exactly (case-sensitive) in Sirdab.

  • Ensure products are set to Active in Shopify.

Orders not appearing in Sirdab

  • Verify all products in the order have SKU codes that match Sirdab.

  • Ensure the shipping address is in Saudi Arabia.

  • Verify store currency is set to SAR.

Currency or pricing errors

  • Set store currency to SAR in Settings → Store details.

  • Update product prices to SAR.

SKUs show as "Unmapped"

  • Verify SKU format matches exactly (no extra spaces, correct case).

  • Confirm the SKU exists in Sirdab inventory.

  • Map the product manually from the Shopify integration settings if it doesn't auto-map.

Need Help?

If you run into any issues during setup, contact Sirdab support via the in-app chat or email [email protected], including:

  • Your Shopify store name

  • Affected order numbers

  • A screenshot of the issue

  • The steps you've already tried
    ​

Demo reference: https://www.loom.com/share/1e64d9687b4c4ad2af9740b64bb0f9e4

Did this answer your question?