Troubleshooting Authentication Issues
If you are encountering connection or authentication problems with the Linnworks-Mintsoft integration, consider the following steps:
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 authorization.
Connection failures originating from Linnworks due to authorization 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 reauthorize.
Reauthorize Linnworks:
Log in to Linnworks.
Access the authorization section for third-party apps.
Follow the authorization link provided by Linnworks to refresh the integration with Mintsoft.
Generate a New API Token:
During reauthorization, generate a new API token as prompted by Linnworks.
Copy the newly created API token and 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 authorization or connectivity issues.
Keep both Mintsoft and Linnworks platforms updated to minimize bugs related to integration.
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.