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 Name

Type

Description

AuthorizationToken

String

Authorization Token from the customers integration.

Products

ProductInventory[]

Array of product inventory that has been updated in Linnworks and is relevant for change.

See Inventory Product table.

ProductInventory

Field Name

Type

Description

SKU

String

Product SKU provided from the mapping call, known as Channel SKU in Linnworks

Reference

String

Reference provided from the mapping call.

Quantity

Int

New 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.

MultiLocationLevels

MultiLocationLevels[]

Multi location levels, only provided when MLI is provided

MultiLocationLevels

Field NameTypeDescription
TagStringLocation tag as provided in the Location Mapping
QuantityIntIndividual MLI quantity.

Sample

{
	"Products": [
		{
			"SKU": "ABC1234",
			"Reference": "122440",
      "Quantity": 10,
			"MultiLocationLevels": [
        {
          "Tag": "1234",
          "Quantity": 5
        },
        {
          "Tag": "9876",
          "Quantity": 2
        },
        {
          "Tag": "ABCD",
          "Quantity": 3
        }
      ]

		}
	],
	"AuthorizationToken": "4d1aa44d211641a48da9ae269ff68975"
}

Response

InventoryUpdateResponse

Field Name

Type

Description

Error

String

If there was a global error with the request.

Products Required

ProductInventoryError[]

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 Name

Type

Description

SKU Required

String

Product SKU.

Error

String

If there was an error with SKU.

Sample

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