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.

Alternative: install from the Shopify App Store

Sirdab Fulfillment is listed on the Shopify App Store (free to install). You can start the connection from the Shopify side instead of from the Sirdab Portal:

  1. Open the Sirdab Fulfillment listing on the Shopify App Store. Click View demo store first if you'd like to preview the integration before installing.

  2. Click Install.

  3. Review the requested permissions and click Install app.

  4. You will be redirected to your Sirdab Merchant Portal — log in with your Sirdab account (or create one if you don't have one yet).

  5. Once logged in, your Shopify store is automatically linked to your Sirdab account. It appears under Fulfillment → Integrations → Connected Integrations.

The end result is identical to the steps above — same scopes, same connection status.

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.

Step 6: Enable the National Address Code Field at Checkout

⚠️ Shopify Plus required. Custom checkout blocks (including the National Address Code field) only work on stores subscribed to Shopify Plus. This is a Shopify limitation, not Sirdab's. See Shopify's documentation.

Sirdab installs a dedicated National Address Code block into your Shopify checkout. This block must be enabled in your Checkout Editor so that customers see the field at checkout. Both the standard shipping address and the National Address Code are required — customers cannot complete checkout without providing them.

📹 Video walkthrough:


​

Enable the block in your Checkout Editor

  1. In your Shopify admin, go to Settings → General.

  2. Click Customize next to your active checkout.

  3. In the left panel, find the Delivery section.

  4. Click + Add block under Delivery.

  5. Select National Address Code from the menu.

  6. Drag the block into position — recommended: directly below the Delivery address block.

  7. Click Save at the top right.

Your checkout will now show a National Address Code field below the address inputs, with the placeholder National Address Code (e.g. RIYD2929).

What customers must provide at checkout

Customers must complete all of the following before they can pay:

  • Country, full name, full shipping address (street, city, postal code)

  • Saudi phone number (entered in the Contact section)

  • National Address Code in the format LLLL#### (4 uppercase letters + 4 digits, e.g. RIYD2929)

If a customer leaves the National Address Code blank or enters an invalid format, the Continue to shipping button is disabled and they will see an inline error: "National Address Code is required" or "Format must be 4 letters followed by 4 digits".

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

What happens after a successful order

The National Address Code is automatically:

  • Saved with the customer's address in Sirdab (visible in Fulfillment → Orders → Location Details).

  • Forwarded to the shipping carrier (Aramex, SMSA, OTO, etc.) for accurate delivery.

  • Stored on the Shopify order's Additional details panel for your reference.

Troubleshooting

  • "National Address Code" doesn't appear in the +Add block menu — the Sirdab app version on your store may be outdated. Go to Settings → Apps and sales channels, click your Sirdab integration, and accept any pending update. Then refresh the Checkout Editor.

  • The block is added but customers don't see the field at checkout — make sure you clicked Save in the Checkout Editor. Hard-refresh the storefront to see the change.

  • Customer says they don't know their Short Code — direct them to the العنوان الوطني mobile app or splonline.com.sa to look it up by address.

Step 7: Enable Automatic Fulfillment Requests

By default, Shopify requires the merchant to manually click Request fulfillment on every new order. Enabling automatic fulfillment routes orders to Sirdab the moment they are paid — no manual click needed.

How to enable

  1. In your Shopify admin, go to Settings → General.

  2. Scroll to the Order processing section.

  3. Under After an order has been paid, enable Automatically fulfill the order's line items.

  4. Click Save.
    ​

What changes

  • New paid orders trigger the fulfillment request to Sirdab automatically.

  • Orders move directly from Paid + Unfulfilled to Fulfillment accepted.

  • The Request fulfillment button is no longer needed for daily operations.

When NOT to enable

If you need manual review on each order (e.g. fraud checks, oversold inventory, special handling), keep this off and process orders one by one.

Step 8: Enable Sirdab as a fulfillment location for online orders

For your storefront to use Sirdab's inventory, the Sirdab fulfillment location must be enabled for online sales. Without this, products may show Sold out even when Sirdab has stock available.

How to enable

  1. In your Shopify admin, go to Settings → Locations.

  2. Click on the Sirdab fulfillment location (e.g. Lama Najd - Jeddah or your warehouse name).

  3. Make sure Fulfill online orders from this location is enabled, and that the location is included in the Online Store sales channel.

  4. (Recommended) Set this as your default fulfillment location so new products default to using Sirdab.

  5. Click Save.


​
​
​

Why this matters

Shopify decides which location can fulfill an order based on which locations have inventory and which locations are enabled for the customer's sales channel. If Sirdab's location has 100 units but isn't enabled for the Online Store channel, your storefront will treat the product as out of stock.

Common symptom

If a product shows Sold out on your storefront but you can see inventory in your Sirdab admin → this setting is the cause. Enable it and refresh the storefront.

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:


- ​How to integrate from shopify side

- How to integrate from sirdab side
​

Did this answer your question?