How to address pending product errors coming from the online store

📢 This article explains how to handle pending product errors when connecting the Riwaa platform with the online store platform (version 2). If you are using the first version and need assistance, contact technical support via live chat.

Pending products appear when there is an error preventing the quantity from being deducted from Riwaa's inventory. These errors do not prevent the issuance of the invoice, but they affect the quantity update until they are resolved. In this article, you will learn all the details to be able to handle the error easily.

#What are pending products?

These are products whose quantities have not been deducted from Riwaa's inventory when the order arrives from the online store platform, due to an error preventing the quantity from being correctly deducted.

#What causes products to be pending?

• The product is not supported in the connection between the two platforms.

• The product is not linked.

• The product is not added on the Riwaa platform.

• The selling price of the product is lower than its cost price, and selling below cost is not allowed.

• The product quantity in the order is higher than the quantity available on the Riwaa platform, and selling in the negative is not allowed.

ℹ️ Note: In case of an error, only the product is pending, not the entire order.

When the error is resolved, the product quantity is deducted from the Riwaa platform.

#Supported and unsupported products in the connection

Product Type

Connection with Salla

Connection with Zed

Single-type product

✅

✅

Multi-type product

✅

✅

Weighted product

✅

✅

Service product (services)

✅

✅

Bundled product

Temporarily paused

❌

Packaged product

✅

✅

Batch-tracked product

❌

❌

Serial-tracked product

❌

❌

---

#Error handling method

#Accessing pending products

1. Go to Sales and Customers > Online Store Orders.

2. When there are pending products, a notification bar appears at the top of the screen.

3. Click on "View Products."

4. All products are displayed, classified by error type.

#Types of errors and handling method

• Errors that can be resolved:

1. Insufficient quantity.

2. Unlinked product.

3. Selling price lower than cost price.

• Error that cannot be resolved:

1. Unsupported product.

---

#First Error: Insufficient Quantity

Reason: The quantity on the Riwaa platform is less than the quantity in the order.

Solution: Balance and match quantities between the two platforms.

ℹ️ Note: When the quantity of the pending product in Riwaa's inventory increases due to: returning purchase invoices, issuing new purchase invoices, stock inventory, inventory transfer, the error will be automatically resolved as the quantity becomes available on Riwaa.

Solution Steps: Click on Update Quantity, then choose the correct quantity source:

• #Quantity on the Riwaa platform:

(Through adding a purchase invoice)

1. Choose: Quantity in Riwaa.

2. Click on Update Quantity > Confirm.

3. Click on "Purchase Invoices."

4. Add the quantity via a purchase invoice > Click on "Complete."

5. The quantity is directly updated in Riwaa, and all product-related errors are automatically resolved.

• #Quantity on the online store platform:

(A stock inventory is automatically created on the Riwaa platform)

1. Choose: Quantity in the online store.

2. Click on Update Quantity > Confirm.

3. The system automatically creates a stock inventory.

4. The quantity is directly updated in Riwaa, and all product-related errors are automatically resolved.

⚠️ Warning: Stock inventory affects net income and cannot be undone.

• #Another quantity:

(A stock inventory is automatically created on the Riwaa platform)

1. Choose: Another quantity.

2. Enter the correct quantity (taking into account adding the pending quantity in the errors to resolve the error).

3. Click on Update Quantity > Confirm.

4. The system automatically creates a stock inventory.

5. The quantity is directly updated in Riwaa, and all product-related errors are automatically resolved.

⚠️ Warning: Stock inventory affects net income and cannot be undone.

---

#Second Error: Unlinked Product

Error Reason: The product is added in the online store without linking or syncing its quantities with Riwaa.

Solution: Link the product and balance the quantities.

Solution Steps: Click on Link Product, then choose the correct quantity source:

• #Quantity on the Riwaa platform:

(The quantity is updated on the online product platform, and the products are linked together. If the quantity is less than the pending quantity, the error is converted from an unlinked product to (insufficient quantity))

1. Choose: Quantity in Riwaa.

2. Click on Update Quantity in Salla > Confirm.

3. The product quantity is updated on the online store platform. This action cannot be undone.

• #Quantity on the online store platform:

(A stock inventory is automatically created on the Riwaa platform)

1. Choose: Quantity in the online store.

2. Click on: Update Quantity in Riwaa > Confirm.

3. The system automatically creates a stock inventory.

4. The quantity is directly updated in Riwaa, and all product-related errors are automatically resolved.

⚠️ Warning: Stock inventory affects net income and cannot be undone.

• #Another quantity:

(A stock inventory is automatically created on the Riwaa platform)

1. Choose: Another quantity.

2. Enter the correct quantity (taking into account adding the pending quantity in the errors to resolve the error).

3. Click on Update Quantity in Riwaa > Confirm.

4. The system automatically creates a stock inventory.

5. The quantity is directly updated in Riwaa, and all product-related errors are automatically resolved.

⚠️ Warning: Stock inventory affects net income and cannot be undone.

---

#Third Error: Selling Price Lower than Cost Price

Error Reason: The price in the order is lower than the cost price in Riwaa.

⚠️ Warning: When there is an order with a currency value greater than the Saudi Riyal, such as "Kuwaiti Dinar," the system will display this error because the platform only supports the Saudi Riyal.

Solution: Ignore the alert or adjust the product price.

Solution Method: Click on "View Details."

To ignore the alert:

1. Click on "Ignore Alert."

2. All errors related to this product are resolved.

To adjust the order price in the online store:

(Before issuing the invoice on the Riwaa platform)

1. Click on the icon (🖊).

2. You will be redirected to the online store platform.

3. Change the price on the online store platform.

4. The error is automatically resolved on the Riwaa platform.

5. Go to the Riwaa platform and refresh the page to ensure the error is resolved.

⚠️ Warning: After issuing the invoice on the Riwaa platform, the modification from the store does not reflect.

ℹ️ Note: When the option "Sell below cost price" is enabled, these errors are automatically resolved.

---

#Fourth Error: Unsupported Product

Error Reason: The product is not supported for connection between the two platforms.

Solution: This type of error cannot be resolved.

Unsupported Products:

Product Type

Connection with Salla

Connection with Zed

Bundled product

Temporarily paused

❌

Packaged product

Temporarily paused

Temporarily paused

Batch-tracked product

❌

❌

Serial-tracked product

❌

❌

---

#Product Not Found

Error Reason: The product is only added on the online store.

Solution: When an order containing a product not found in Riwaa arrives:

• The system automatically creates the product in Riwaa.

• If the SKU is not available, it is automatically generated and reflected on the online store.

• If the product is multi-type, the system creates the product with all its types on the Riwaa platform.

---

#Related Articles

1. How to Issue Invoices for Online Store Orders

2. How to Receive and Manage Online Store Orders

3. How to Set Up Sales Settings for Online Store Orders

---

#Frequently Asked Questions

1. How can I ensure the error is correctly resolved?

   When the error is resolved, the product will be removed from the pending products list and column.