ItemStockManagement
Stock management configuration of an item. Determines whether and how the item’s stock is managed in warehouses - batch and shelf life tracking, serial number capture, divisibility, buffers and negative stock. This block configures stock management, not whether the item has stock - an item without stock management can still carry stock, it is simply not warehouse-managed. Actual stock levels are read via GET /v2/items//stocks.
ItemStockManagementFields
Indicates whether the item is managed with a shelf life expiration date (SLED, German 'Mindesthaltbarkeitsdatum'). When enabled, every stock posting for this item must carry an expiration date, so perishable goods can be traced and picked by expiry. Mutually exclusive with serial number tracking.
Indicates whether the item is managed in batches (German 'Charge'). When enabled, every stock posting for this item must carry a batch number, so goods can be traced back to the batch they came from. Mutually exclusive with serial number tracking, and freely combinable with shelf life expiration dates.
Determines at which point in the goods flow serial numbers are captured for this item. Any value other than 'None' is mutually exclusive with batch management, shelf life expiration dates and divisible stock.
Determines whether the item's stock is held in whole units or in fractional quantities. Any value other than 'None' is mutually exclusive with serial number tracking. Writing 'None' has a side effect on the item's suppliers that writing a divisible value back does not undo: purchaseInterval and stockLevel are truncated to whole numbers on every supplier of the item, so any fractional part they carried is lost.
Allows selling a higher quantity of the item than is physically in stock. This global setting must be enabled before the platform-specific or sales-channel-specific negative stock settings below take any effect. Defaults to false when omitted.
Safety stock buffer that is held back and not offered for sale. Used when selling across sales channels that synchronise with a delay, so that no more is sold than is actually available. Defaults to 0 when omitted.
Minimum stock level across all warehouses. When the total stock falls below this value, the item is flagged for reordering and appears in order suggestions and low-stock warnings. Defaults to 0 when omitted.
Platform-specific negative stock settings, for example for eBay or Amazon. AllowNegativeStock must be enabled as well for any of these to take effect.
Sales-channel-specific negative stock settings, allowing overselling for individual shops or sales channels. AllowNegativeStock must be enabled as well for any of these to take effect.
Was this page helpful?