This article addresses frequently asked questions about the Linnworks-Mintsoft integration, including troubleshooting authentication issues, printing requirements, tracking information limitations, product import settings, and generating Amazon Prime labels.
Troubleshooting authentication issues
If you're encountering connection or authentication problems with the Linnworks-Mintsoft integration, follow the steps below.
Overview of common issues
Authentication issues between Mintsoft and Linnworks often occur due to:
Incorrect credentials entered on the Mintsoft connection page.
Expired or invalid API tokens used for authorisation.
Connection failures originating from Linnworks due to authorisation problems.
Steps to resolve authentication issues
Verify credentials
Ensure that the credentials entered in the Linnworks integration settings within Mintsoft are accurate.
Double-check both the username and API token.
If issues persist, proceed to reauthorise.
Reauthorise Linnworks
Log in to Linnworks.
Access the authorisation section for third-party apps.
Follow the authorisation link provided by Linnworks to refresh the integration with Mintsoft.
Generate a new API token
During reauthorisation, generate a new API token as prompted by Linnworks.
Copy the newly created API token.
Update the connection settings in Mintsoft to ensure a refreshed connection.
Tips for maintaining a stable connection
Regularly review and update your API tokens to avoid authentication failures.
Check for any alerts or notifications in Linnworks that might indicate authorisation or connectivity issues.
Keep both Mintsoft and Linnworks platforms updated to minimise bugs related to integration.
The order requires an invoice to be printed before processing
If you're seeing this error, it's because the order needs to be marked as printed in Linnworks. To learn more about this, please review the Linnworks Support Page on legacy order processing settings.
What tracking information does Mintsoft support with Linnworks?
Currently, Mintsoft can only send the 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.
Do you need to have stock sync enabled for products to import from Linnworks?
No, you don't need stock sync enabled for products to import from Linnworks. Products are automatically created when orders come in if the "automatically import new products" setting is on.
Generating Prime labels for Amazon orders imported from Linnworks
Note: This only works for UK marketplaces.
If you're looking to generate Prime labels for Amazon orders that are imported from Linnworks, follow these steps:
Set up the Amazon account in Mintsoft and authorise it. Please review our Amazon Integration article for more information.
Don't 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.