Stock Management and Stock API

Stock Management and Stock API

A new stock management system has been added.

Key features include:

  • Makes use of stock products in CPP.
  • The ability to export and import stock levels.
  • Webhooks that allow retailers to receive stock level updates from suppliers in near realtime.
  • Stock levels are updated automatically when new orders get created.
The old stock system is deprecated and should not be used.


Any product in CPP that has Stock set as its type automatically gets tracked by the stock system.

Generally stock products would not be customisable.

Instead, customisable products in CPP should be linked to a base stock product via the Base Stock Product field (visible in CPPv2 only).

The reverse is also true, customisable products would generally not have the stock type set.

This means that hundreds of customisable CPP products can be linked to a single stock base product.

In the case of customisable products that make use of variants, each variant must link to its own base stock product.

In the case of virtual products, the base stock product is derived from the virtual product’s base product.

 Base stock products and virtual product base products (sorry for the wordiness!) are similiar concepts but have been kept separate to give the system more flexibility.
  • Virtual products inherit production properties (e.g. print areas) from their base product.
  • Products inherit stock tracking properties from their base stock product.


With Variants

Let’s say that Supplier A sells T-shirt T01 which comes in 2 sizes, S and L.

In CPP, the supplier would create 3 separate products.

ID SKU Type Variant 1 SKU Variant 1 Base Stock Product ID Variant 2 SKU Variant 2 Base Stock Product ID
100 T01-S Stock N/a N/a    
101 T01-L Stock N/a N/a    
102 T01 Customisable T01-S 100 T01-L 101

When OMS receives orders from a retailer for product 102, it will automatically adjust the stock levels for either product 100 or 101, depending on which variant of 102 was ordered.

Without Variants

Let’s say that Supplier A sells Samsung S7 cases. The recommended approach would be for the supplier to create the following products in CPP.

ID SKU Type Base Stock Product ID
200 S7 Stock N/a
201 S7 Customisable 200

Taking a shortcut, it would also be possible to create a single product.

ID SKU Type Base Stock Product ID
202 S7 Stock & Customisable N/a

However with the shortcut, if the product is duplicated then the supplier will end up with 2 separate stock products that represent the same physical unit.

 The general rule of the thumb is that for a given supplier, all stock products in CPP should have unique SKUs.

Inventory User Interface

Stock levels can be manually updated via the Inventory section of Stock Manager.

Bulk updates are best performed by first exporting a CSV, updating the CSV in a spreadsheet package and then re-importing.

Intentional Limitations

  • Stock products cannot have variants
  • Stock products cannot have a base stock product set
Related Articles
  1. Troubleshooting: Stock Manager - Inventory (INTERNAL ONLY)

    • Related Articles

    • Stock API for the retrieval and setting of stock values

      KornitX provides a Stock API to allow suppliers to provide up-to-date stock information when stock positions change by making a PUT request to the stock update endpoint. A retailer can also use the stock API to retrieve stock information by making a ...
    • Product Integration | Generic API

      Introduction This article has been created to show how to setup the Product integration Kornit X has built to connect to Generic API.  Setup To setup the Generic API integration, please head to your category and within and within the advanced ...
    • KornitX Platform Imports - Simple Stock (Creation Only)

      We offer this quick and easy way for fulfillers to create basic Stock Products which can be used for configurable stock items within variants or just to quickly create stock products to be sold on retailer websites. The headers for this import have ...
    • API Troubleshooting and Errors

      Orders API Documentaiton: List of Error Codes relating to Order API: See video below:
    • Stock Picking Documents - Standard

      An example of the label can be seen below, and in PDF form attached This label contains a Item Description, SKU, Quantity and Item ID Barcode for station scanpoints. Label Dimensions - 110 x 30 MM Examples Purchase Locations -  ...