Endpoint - Inventory Update

This call is made when inventory is updated in Linnworks and is required to push to the channel.

Request

Post

InventoryUpdateRequest

Field NameTypeDescription
AuthorizationTokenStringAuthorization Token from the customers integration.
ProductsProductInventory[]Array of product inventory that has been updated in Linnworks and is relevant for change.

See Inventory Product table.

ProductInventory

Field NameTypeDescription
SKUStringProduct SKU provided from the mapping call, known as Channel SKU in Linnworks
ReferenceStringReference provided from the mapping call.
QuantityIntNew available quantity. Linnworks calculates stock less what is in open orders (unless the order is locked) and also has settings for max listed, percentage and end when so this figure might not directly match the quantities in Linnworks.

Quantities will never be negative.

Sample

{
	"Products": [
		{
			"SKU": "ABC1234",
			"Reference": "122440",
			"Quantity": 10
		}
	],
	"AuthorizationToken": "4d1aa44d211641a48da9ae269ff68975"
}

Response

InventoryUpdateResponse

Field NameTypeDescription
ErrorStringIf there was a global error with the request.
ProductsProductInventoryError[]Products process result.

If there are no errors the SKU is still expected to be returned, any items not returned may be assumed to be not existing on the marketplace and therefore may be ignored on subsequent updates.

See ProductInventoryError table.

ProductInventoryError

Field NameTypeDescription
SKUStringProduct SKU.
ErrorStringIf there was an error with SKU.

Sample

{
	"Error": null,
	"Products": [
		{
			"Error": "SKU does not exist",
			"SKU": "MyNonExistantSKU"
		},
    {
			"Error": null,
			"SKU": "MySuccessfulSKU"
		}
	]
}