Useful 3PL Integration Endpoints

This guide provides information on the endpoints available through the Linnworks API which will be useful when creating a 3PL connection.

This documentation will cover the key endpoints these key areas:

Creating and setting a fulfilment centre
Getting orders
Updating orders
Updating inventory
Notifying the 3PL of inventory changes

Creating and setting a fulfilment centre

The following endpoints are used to create a new location and set it as a fulfilment centre:

Endpoint	Use
Locations/AddLocation	Use this call to add a new location
Locations/UpdateLocation	Use this call to update a location's name and/or details such as setting as a fulfilment centre
Inventory/GetStockLocations	Use this call to get all stock locations from a Linnworks account

Getting orders

Linnworks order management is divided into 2 main parts:

Open orders. Orders that are downloaded from the sources and currently in processing stage. Linnworks user can operate these orders via UI or API and make necessary actions like printing labels, adding notes, change of shipping service etc.
Process orders. Once Linnworks user has packed and prepared an order for the despatch, order is marked as Processed. Once the order is marked as processed Linnworks sends despatch notifications to the relevant channel and can not be amended afterward, except Return/Refund processing, Label/Invoice reprinting and addition of order notes.

When creating fulfilment centre integration, you will have to pull Open Orders.

Endpoint	Use
Orders/GetAllOpenOrders	Get the list of Id's of all open orders (without pagination)
OpenOrders/AssignOrderIdentifier	Add an identifier to an order
Orders/GetOrdersById	Order ids can be passed to return all order information. Retrieves the order detail for a unique system order id identifier (pkOrderId)
Orders/GetOrderById	As above but for a single order ID

Updating orders

These endpoints can be used to update orders as they are being processed.

Endpoint	Use
Orders/CancelOrder	Cancel a specific order
Orders/ChangeStatus	Change the status of an order
Orders/ProcessOrdersInBatch	Moves an order from open to processed to indicate the order has been shipped
Orders/SetExtendedProperties	Set the extended properties of a specific order. This call will replace the existing extended properties, if that is not desirable call Orders/GetExtendedProperties first.
Orders/ProcessOrder	Retrieves the order detail for a unique system order id identifier (pkOrderId)
Orders/ProcessFulfilmentCentreOrder	Process Orders associated with a Fulfilment Centre
Orders/SetOrderCustomerInfo	Update the customer info of a specific order
Orders/SetOrderGeneralInfo	Update the general info of a specific order
Orders/SetOrderNotes	Set the order notes for a specific order. This call will replace the existing notes, if that is not desirable call Orders/GetOrderNotes first.
Orders/SetOrderShippingInfo	Update the shipping info of a specific order (e.g. tracking number)
Orders/UpdateOrderItem	Update an order item

Updating inventory

This endpoints is used to update the stock levels in Linnworks.

Endpoint	Use
Stock/SetStockLevel	Set the stock level of a list of stock items identified by its SKU to the value provided

Notifying the 3PL of inventory changes

In order to notify a 3PL of inventory changes a method of communication would need to be developed as part of your app, the following endpoints will provide useful information that you may want to pass and communicate.

Another option other than using the API is to use the Stock Level Export provided in Linnworks.net, this produces a CSV file and can be set up to run on a schedule to retrieve the relevant information.

Endpoint	Use
Stock/GetStockItems	Retrieves basic stock item data including stock levels for the provided location
Stock/GetStockItemsFullByIds	Retrieves full stock item data (E.g. Extended Properties) based on the provided Stock Item IDs (Not required if only stock levels are needed as the above call will cover this)
Stock/GetStockItemsFull	A paged version of the above

Tips

Using the OpenOrders /AssignOrderIdentifier endpoints will allow you to filter the getAllOrders call so that you can identify already exported orders. Extra information on identifiers can be found in our Linnworks documentation.
Ensure that you update the shipping information before processing an order. Shipping information can not be updated once an order has been processed and a processed order can not be unprocessed.