Marketplace Inventory Management feature overview

Edit on GitHub

The Marketplace Inventory Management feature enables maintaining stock and availability of merchant products and product offers that are sold in the Marketplace. In the context of inventory management, the warehouse is the physical place where your products are stored, and stock is the number of products available in the warehouse.

Marketplace warehouse management

When a merchant is created, the corresponding warehouse is created for this merchant. The warehouse name is composed of the following parts: merchant name + merchant reference + warehouse + index (starting with 1, 2).


“Spryker MER000001 Warehouse 1” where Spryker is the merchant name, MER000001 is a merchant reference, and the index is 1 as it is the first warehouse created.

A warehouse can be assigned to a single store or shared between several stores. For details about how you can manage warehouses and stores in the Back Office, see Managing warehouses.

Marketplace stock management

The stock for product offers is defined in the corresponding merchant warehouse. The stock does not reflect the actual availability of products, as not all the items available in stock are available for sale. For example, when there are pending orders with offers, these order items are reserved, so they are not available for ordering, even if they are physically on hand.

Merchants can define product offer stock in the Merchant Portal. For details, see Managing product offers.

Also, you can do the following using the data import:

Marketplace availability management

The difference between the current quantity of items in stock and the quantity of these items in the pending orders is called the availability of products.

Product offer availability calculation differs from the calculation of concrete products availability:

Formula: Concrete product availability = Concrete product quantity - Concrete product reservations Formula: Offer availability = Offer quantity - Offer reservations

Offer availability is considered on the Storefront:

  • On the product details page: While adding the offer to cart.
  • On the cart page: The product stays in the cart if the attached offer is not available anymore, and a hint is shown.
  • During the checkout: When clicking Buy now, the availability is rechecked.

Let’s assume that a merchant has defined quantity 10 for product offer 1. A customer adds 8 items of the product offer 1 to cart and later updates the quantity to 12. In such a situation, the availability of the product offer 1 is checked, and the customer is notified to update the quantity of the product offer to the available number to proceed with the purchase.

Managing product offers Managing warehouses
Install the Marketplace Inventory Management feature File details: merchant_stock.csv
Install the Marketplace Inventory Management Glue API File details: product_offer_stock.csv
Install the Marketplace Inventory Management + Order Management feature File details: combined_merchant_product_offer.csv
Install the Marketplace Product + Inventory Management feature
Install the Marketplace Inventory Management + Packaging Units feature