Skip to main content
Installation and Integration Guide for Salla Platform (V.2)
Updated over a week ago

📢 This article explains "how to install and integrate with Salla (version 2)", which is being gradually rolled out to all customers. You can check the installed version on your platform through the Orders page. If you are using version 1, click [here] to view the relevant articles.

Rewaa enables you to connect and manage all your sales channels from a single interface. You can link your location inventory with your online store, helping to reduce errors related to out-of-stock products.

Rewaa supports integration with the most popular e-commerce platforms (Salla, Zid), allowing you to synchronize inventory, receive orders, and manage sales efficiently.

This article explains the installation and integration process for Salla.

Prerequisites for Integrating Salla with Rewaa

  • Salla Pro Subscription Plan.

  • An online store on Salla that has NOT been previously linked to Rewaa.

  • Integration applies to one location only, which you must select during installation.

    • Example: If you have multiple locations in Rewaa, you must choose one location to sync its inventory with your Salla store.

Products You Can Sync with Salla

  • Simple Products

  • Variable Products (multiple options)

  • Weighted products

  • Service-based products (services)

Rewaa's Default Currency

⚠️ Rewaa's default currency is SAR (Saudi Riyal).

Rewaa does NOT automatically convert currency values from other e-commerce platforms.

For example, if an order is placed on Salla for 6 Kuwaiti Dinars, it will be reflected on Rewaa as 6 SAR, without currency conversion.

Pre-Integration Checklist

If your products already exist on Salla, verify the following before proceeding with the integration:

  • Product prices are available on Salla.

  • Cost prices are available on Rewaa.

  • Inventory quantities are correct on Rewaa.

  • Product SKU codes match on both platforms. If SKUs do not match, integration errors will occur, affecting stock updates.

  • For multi-variant products, SKUs must match for each variant.

    Example: If you have a product (Glass Cup) with different colors (Red, Blue, Green), each color must have the same SKU on both platforms.

ℹ️ It is recommended to temporarily disable sales on Salla (by putting the store in maintenance mode) or schedule the integration during low order times to ensure a smooth process.

Example: If there are no orders at 6 AM, perform the integration at this time to ensure proper synchronization.

Integration Steps

Step 1: Verify Tax Settings on Both Platforms

⚠️ Tax settings must match on Rewaa and Salla to ensure correct pricing.

  • On Rewaa:

    Navigate to Settings > Configuration > Sell Tax Status.

  • ℹ️ Set the tax status according to your business process. Click [here] for details.

  • On Salla:

    Navigate to Store Settings > Advanced Settings > Tax Settings.

Ensure VAT settings match between both platforms before proceeding.

ℹ️ Additional Tax Settings:

  • Enter your tax registration number on Salla to enable tax settings correctly.

  • Shipping tax settings on Salla:

    • Shipping fees and taxes will sync with Rewaa when an order is placed.

    • You can view these details in Order Details or on the Invoice.

    • Shipping fees in Rewaa will be recorded as sales but can be manually categorized as expenses.

Step 2: Install the Salla App

  • Navigate to Applications > Available Apps > Salla > Click Install.

  • Click Connect Salla account.

  • Enter your Salla account email and password, then click Login.

  • Grant authorization by clicking Allow to proceed.

    ⚠️ Clicking Deny will cancel the integration process.

  • Select the location where inventory should sync with Salla. Click Next.

  • Click Link and Install.

ℹ️ Once installed, Rewaa will automatically sync inventory for products with matching SKUs on both platforms.

  • Synchronization time:

  • The process may take a few minutes, depending on the number of products.

  • Wait until synchronization is complete, then click "Next."

Integration is now complete!

  • Review the next steps, then click Finish to start receiving orders and managing invoices correctly.

Managing Products in Rewaa & Salla

During the integration process, products are matched by SKU but are linked using a Product ID.

ℹ️ Product ID is an invisible, system-generated number used to uniquely identify products.

Product ID Benefits:

  • If you change an SKU for a linked product, the integration remains active (manual unlinking is required).

  • If an SKU is changed for a linked product, the new SKU is automatically updated on the other platform.
    ⚠️ if the product is not linked, the SKU update will not be reflected on the other platform.

To check product sync status:

  1. Navigate to Applications > My Apps > Salla > Click Product Management.

  2. Ensure products are marked as Linked to sync orders correctly

  • After linking, Salla orders will appear in:

    Sales & Customers > E-commerce Orders

ℹ️ Only new orders (after integration) will sync. Past orders will NOT be imported.

Product Sync Status

1- Linked

  • The product exists on both platforms with a matching SKU and has been successfully linked.

    ℹ️ Only the inventory from the linked Rewaa branch will sync. Any quantity updates on Salla will not reflect on Rewaa.

2- Unlinked

  • The product exists on both platforms with a matching SKU but has not been linked yet.

  • To link: Click Link to sync stock from Rewaa to Salla.

    ⚠️ Stock changes on Rewaa will not sync to Salla until linked.

    ℹ️ A product may be unlinked in these cases:

  • It was created on Salla, then added manually to Rewaa.

  • It was created on Rewaa, then added manually to Salla.

  • The link was manually removed.

3- Not Found

  • The product exists on Salla but not on Rewaa.

    Solution: Add the product to Rewaa Inventory, then click Link. then click Link to sync.

    ℹ️ If the product is simple, you can click (Create) under the (Filter) column to add it directly to Rewaa Inventory.

⚠️ Composite and package product linking with Salla is temporarily disabled and will be restored soon.


FAQs

1. How can I verify a product's SKU before integration?

  • On Rewaa: Go to Products & Inventory > Products > Product Name > Main Information > SKU.

  • On Salla: Go to Products > Product Data > Storage Code.

2️- What if products on Salla have missing or incorrect SKUs before linking?

To ensure successful integration, SKUs must be added and matched:

  • Add missing SKUs to products on Salla.

  • Update mismatched SKUs on either Salla or Rewaa to ensure they are identical.

3️- How do I check if my products and stock quantities are linked correctly?

  1. Navigate to Apps > My Apps > Manage Products

  2. Search for a product by name or SKU

  3. Check the Status Column to confirm if the product is linked

  4. Click the product name to view the quantity and all related details.

4- Can batch-tracked, serial-tracked, or digital products be linked with Salla?

No, Rewaa currently does not support linking these product types with Salla. Submit your suggestions here.

5- Does a new product added in Rewaa sync automatically to Salla?

No, you need to click Publish Product to sync it to Zid. Learn more here.

6- Why didn’t my new product from Salla appear in Product Management?

Click Sync Data and wait a few minutes for the product data and stock quantities to sync. Once the sync is complete, search for the product in Product Management, it will appear.

ℹ️ Linked product quantities are updated based on Rewaa's inventory.

7. What if variable products don’t appear in Rewaa after being added to Salla?

Ensure SKUs for all variants are correctly entered on Salla.

  • Go to Products, click Options & Quantity.

  • Scroll to the bottom of the page under Variant Details, then click the (+) icon next to the variant name.

  • Make sure to add the SKU in the SKU field.

  • Go to Rewaa, click Sync, and once the sync is complete, search for the product in Product Management.

Did this answer your question?