Linnworks Integration Summary
Imports sales orders in paid status from Linnworks.
Option to import purchase orders from Linnworks as ASNS.
Option to create new products from a Linnworks Purchase Order or ASN.
Option to send back returns data processed on Mintsoft.
Option to filter and sync data by location (warehouse).
Linnworks Fulfilment Centre Locations
The Linnworks integration with Mintsoft will not work with locations tagged as Fulfilment Centre on Linnworks. This will prevent the integration from importing orders and marking them as despatched as it puts the orders in Parked status. You need to make sure that the locations are normal locations on Mintsoft (even if used at a fulfilment centre). Linnworks fulfilment centre locations can only be used with FTP export processes.
Prerequisite - Generate Linnworks API Key
Before adding the Linnworks integration to Mintsoft, you must generate API Keys. To do so, please follow the steps below:
Click here and Log in using your Linnworks.net Account credentials.
On the Application Installed dialog, click Copy.
Take note of the API Token, as you will need this later.
Now you can add the connection to Mintsoft.
Adding a Linnworks connection
Once you have the Linnworks API Keys, the next step is to add the account to Mintsoft. To add a Linnworks account, please do the following:
Click Connect then Order Integrations.
Next, click Linnworks.
Click Create New.
(3PL Only) Choose the Client.
Select the Warehouse and Channel.
Paste the API Token.
Paste 00000000-0000-0000-0000-000000000000 into the Location field.
However, if you have multiple locations, please review the Multiple Locations section below.
Set the Frequency to import orders and sync dispatch updates back to Linnworks.
(Optional) Enable AutomaticallyImportNewProducts.
This only imports/ creates the product(s) if the item on a Linnworks PO (ASN) doesn't already exist in Mintsoft.
(Optional) Enable Import Purchase Order as ASN.
This will import purchase orders from Linnworks as ASNs on Mintsoft.
(Optional) Enable Export Returns.
This will export returns from Mintsoft to Linnworks.
This will follow the Frequency set on Step 8.
(Recommended for 3PLs) Set an OrderPrefix.
(Optional) Enable IgnoreParkedOrders.
By default, Mintsoft will import orders set as Parked on Linnworks, enabling this will stop this import.
(Optional) Enable LogAPIRequests.
(3PL Only) This will email any client users listed in the Connect Notifications field on the Client Notifications page with import errors relating to orders coming from Linnworks.
This is turned off after 48 hours to prevent overuse.
(Optional) Enable MapSubSourceToChannel.
This means Linnworks will automatically map the Channel within Mintsoft to the Original Source field on the Linnworks order, provided both values match exactly e.g. eBay. This feature works with both source and sub-source values.
(Optional) Enable WeightInGrams.
If enabled, this will import the product weight as grams from Linnworks.
(Optional) Enable Import Required Despatch Date.
If enabled, this will import the required despatch date from Linnworks.
Enable SyncStockLevels and set the Stock Sync Frequency.
Choose the StockSyncValueType -
OnHand: This syncs the OnHand level within Mintsoft.
Stock Level: This includes OnHand and Allocated.
Make the connection Active when ready.
Finally, click Add.
Multiple Locations
If you have multiple locations on Linnworks you fulfil from you can choose which location, you want for the Mintsoft connection. Once you have added the Linnworks account to Mintsoft, please do the following:
Scroll to the right of the newly added connection and click View Locations.
This will show you the full list of locations.
Copy the required Location ID.
Click Back then click Edit against the connection.
Paste in the correct Location ID.
Click Update.
Linnworks FAQ
The order requires an invoice to be printed before processing
If you are seeing the above error this is because the order needs to be marked as Printed in Linnworks. To learn more about this please review the Linnworks Support Page.
What tracking information does Mintsoft support with Linnworks?
Currently Mintsoft can only send tracking number back to Linnworks when an order gets despatched. Linnworks doesn't offer any fields in the despatch update API endpoint for Mintsoft to provide the tracking URL.
Generating Prime labels for Amazon orders imported from Linnworks
Note: this only works for UK marketplace now.
If you are looking to generate Prime labels for Amazon orders that are imported from Linnworks, please do the following:
Set up the Amazon account in Mintsoft and Authorize it.
Please review our Amazon Integration article for more information.
Dont make the connection Active.
This means orders won't import from Amazon and Mintsoft won't perform a stock sync. Instead, Mintsoft would import the orders from Linnworks and then use the Order ID to request Prime labels via the Amazon connection.