The following information applies to the Unleashed integration with Mintsoft.
Stock Sync
Serial and Batch Numbers
The Unleashed integration on Mintsoft supports Serial Number and Batch Number sync for products. Logging batch number is supported for the integration.
The batch number quantity and the shipment quantity for batch tracked products must match.
The following error in Mintsoft (Error: {"Description":"The batch number quantity and the shipment quantity for batch tracked products must match. Please select the required quantity of batch numbers.","DebugInformation":null}) occurs when some of the stock on the order is batch and/or serial tracked, but the serial and/or batch numbers do not exist in both Mintsoft and Unleashed. To fix this issue, make sure that Mintsoft and Unleashed have matching serial and/or batch numbers for the relevant products.
Never Diminishing Products
If you see products in Mintsoft showing as Unleashed-NDP against their alt code. Please ensure Never Diminishing is disabled against the product within Unleashed, without this enabled we will not synchronise the product stock level.
Note: NDP stands for Never Diminishing Products in Unleashed.
Orders not importing
If orders from Unleashed are not importing into Mintsoft but all other aspects of the integration are working, please ensure the Order Status To Import (Alternatively, Custom Order Status To Import) field is populated with at least one status if the field is left blank it will only import orders in Open status.
Troubleshooting User Access Issues
When a user cannot update orders even after their user roles have been updated, follow these steps:
Identify the Scope of the Issue:
Determine if the issue is specific to Unleashed orders or applies to all orders.
Verify if the issue occurs with orders from other sales channels (e.g., Shopify) or manual entries. For instance, if users can update Shopify orders but not Unleashed orders, the problem is likely specific to Unleashed.
Check for Unauthorized Access Messages:
Investigate whether the user encounters an unauthorized access error when updating Unleashed orders.
General Troubleshooting:
Ask the user to clear their browser cache and cookies.
Ensure they are using a supported browser like Chrome, as these steps might resolve basic technical issues.
Product Data Import and Updates
Data and information from Products (SKUs) can be imported from Unleashed into Mintsoft. The product data initially imported from Unleashed into Mintsoft is:
SKU.
Name.
Weight.
Dimensions.
Barcode.
Image URL.
Default Purchase Price (Average Landed Cost).
Changes made to products in Unleashed after the initial import can also be synchronised into Mintsoft. The following attributes can sync from Unleashed into Mintsoft after the initial import:
Barcode.
Image URL.
Weight.
Default Purchase Price (Average Landed Cost).
Note: New products and amendments to products made in Mintsoft are not pushed to Unleashed.
Moving from a Trial or Sandbox Environment to a Live Environment
If you are moving from a Sandbox or Trial Environment of Unleashed to a Live Environment and a MintSoft connection is already in place, please speak with the Mintsoft support team or raise a support ticket and request the Product GUIDs be cleared, as this can cause issues with Stock Syncing to Unleashed and Orders Importing from Unleashed.
Using special characters for SKUs
We recommend not using special characters (&,%,#, etc.) for the SKU as this can cause issues with stock syncing and orders importing into Mintsoft.
External Courier Names
We recommend setting up External Courier Service Names for Unleashed orders when dispatching from Mintsoft.
Parked Stock Adjustments
If there is insufficient stock available for us to complete the stock adjustment on Unleashed - the stock updates will go into Parked status.
We recommend committing stock adjustments using the Stock Level in Mintsoft, as this corresponds to the Onhand level in Unleashed.
Invalid Adjustment Reason. Could not find Adjustment Reason Mintsoft.
If you encounter the following error in Mintsoft (Stock Update failed API Error: {"Items [{"Field":"AdjustmentReason","Description":"Invalid AdjustmentReason. Could not find AdjustmentReason Mintsoft.","ErrorCode":0}]}) please verify that you have correctly set up a Stock Adjustment Reason in Unleashed. More information can be found in our Unleashed integration help guide.
Stock Adjustment Values
To submit a stock adjustment to Unleashed, we have to provide a cost price.
This will be sent from the Mintsoft cost price field against the product - if the item does not have a cost price, the value will default to 1.
Purchase Orders and ASN's
Amendments to POs in Unleashed are not picked up in Mintsoft once they have been imported as an ASN
POs cannot be over-receipted, If the ASN is under-receipted on Mintsoft this will create an additional PO on Unleashed for the balance of the stock, the PO won't be completed for you as part of this process, this will need to be done manually.
Purchase orders created on Unleashed containing a Bundle will not be imported to Mintsoft, the PO can only contain the components, not the actual bundle.
Note: The ASN can be over-receipted on Mintsoft but the PO update will fail when a sync is performed.
Error: You cannot complete this assembly, as it contains the following product(s) on a receipted purchase order: . Please complete the purchase order first.
Additional Criteria for Purchase Order Imports
Date Restrictions:
POs must have a creation date within the 60-day lookback window. POs created more than 60 days ago will not be imported, even if the delivery date is current.
Status Matching:
Ensure the PO status in Unleashed matches the import settings selected for ASNs in Mintsoft. Commonly used statuses include "Placed."
API Connection and Sync Frequency:
Verify the API connection between Unleashed and Mintsoft is active and configured properly.
Confirm that sync frequency settings meet the minimum intervals required (e.g., 15 minutes).
If you receive the above error when completing an assembly, please do the following:
Within Unleashed click Settings then Company.
Toggle ON - Use Receipted Stock In Assemblies.
Click Save.
Sales Order Shipments
Amendments to shipments on Unleashed (item quantities etc) can be picked up from Mintsoft, provided the related orders in Mintsoft have not gone into any picking statuses.
Sales Order Exports
Once an order has been exported to Unleashed from Mintsoft – no further amendments can be posted to the order from Mintsoft. Because of this – we recommend the trigger status to be despatched in Mintsoft
Warehouse Transfers
Warehouse transfers on Unleashed can be imported to Mintsoft as two separate workflows:
An order to pick up the transfer from the Outbound Warehouse.
An ASN to receive at the Inbound Warehouse.
Once the ASN part of the transfer has been Booked on Mintsoft – this will update and complete the Unleashed Warehouse Transfer. Updates and changes to Warehouse Transfers on Unleashed are not picked up in Mintsoft once imported to Mintsoft.