Unleashed integration features
The Unleashed integration supports these features:
Order sync (including order export from Mintsoft).
Purchase order import.
Stock and product sync.
Despatch updates (status and tracking information).
Warehouse transfer sync.
Shipment import.
Assembly import.
Video Overview
Document Overview
This document gives you an overview of the Mintsoft and Unleashed connector.
Prerequisites
Generate an API key
Note: You need the Unleashed Medium Package for API access.
Before adding your account on Mintsoft, you need to generate an API key:
Log in to Unleashed.
Click Integration then Unleashed API Access.
Copy the API ID and API Key.
You'll need these details to set up the connection.
Set up stock adjustment reasons
Stock sync requires an adjustment reason. To set this up:
In Unleashed, click Settings.
Click System then Adjustment Reasons.
In the Adjustment Reason field, enter Mintsoft then click Add.
Find your warehouse code
Unleashed uses MAIN as the default warehouse code. Understanding warehouse codes is critical, as they act as unique identifiers for stock locations in Unleashed and Mintsoft. Any mismatch in these codes can disrupt synchronization and lead to errors, such as unmapped warehouse issues.
To view your warehouse list if you have multiple warehouses:
In Unleashed, click Settings.
Click System then Warehouses.
Note: To import orders from multiple warehouses, create a separate connection for each warehouse.
Add your account on Mintsoft
After generating your API key and adding a stock adjustment reason, add your account on Mintsoft:
In Mintsoft, click Connect.
Click Order Integrations then Unleashed.
Click Add Account.
(3PL Only) Select the Client.
Choose the Warehouse.
Choose the Channel.
This is the channel orders import against.
You can create additional channels.
Paste the API ID and API Key into the relevant fields.
Enter your Unleashed Warehouse Code the default is MAIN.
Make Active when ready.
Due to Unleashed's configuration options, the remaining setup is split into sections. After configuring all settings, click Add once to save all changes.
Configure the connection
General tab
This tab contains:
Frequency (Minutes) - Minutes between order import syncs (minimum 15).
Order Status To Import - Choose one or multiple statuses (separate with commas). Standard statuses:
Open (This is default if the field is blank)
Placed
Parked
Backordered
Completed
Custom Order Status To Import - Overrides standard status filter if provided. Separate multiple statuses with commas.
Orders Prefix - Adds a prefix to imported order numbers. For example, order 12345 with prefix 'UNL-' becomes UNL-12345.
Use Webhooks? - Enables real-time data transfer. Webhooks support:
Sales order deletion sync.
Product creation and updates.
Product deletion (marks as discontinued in Mintsoft).
Map Source ID to Channel - Shows imported orders under their original channel (e.g., Amazon) rather than Unleashed.
Default Country - Applied when orders import without country details.
Connection IOSS - Overrides IOSS if required.
Sync New Products - Creates products on Mintsoft automatically.
Sync Product Updates - Updates barcode, weight and image URL fields.
Further information can be found at the bottom of this article.
Enable Serial / Batch Tracking - Syncs batch and serial numbers between systems.
Stock Sync Manual Adjustment Auto Sync - When enabled this switches to incremental stock sync mode, sending only manual stock adjustments to Unleashed. Stock should generally be aligned between systems due to goods in and orders out, so this accounts for extras.
Stock Sync Full Once Per Day - If you are using manual adjustment auto sync, once per day this will run a full sync at the selected time. Bringing the stock levels inline, irrespective of if there has been a manual adjustment. If you are not using manual adjustment auto sync, it just does a stock sync once per day.
Stock Sync Once Per Day Time -Sets sync time when using once per day sync.
Stock Sync Exclude Bundles - Option to skip bundles.
ASNs Import as Awaiting Delivery - If this is enabled we confirm the ASN's and these are marked as Awaiting Delivery.
Warning: Always schedule the once per day stock sync outside of working hours when synchronising inventory with Unleashed. This is essential for system performance.
PO Import tab
This tab contains:
PurchaseOrder Import to ASNs - Imports purchase orders as ASNs for receiving.
PurchaseOrder Status' To Import to ASNs - Specifies which PO status to import (default: Placed).
Custom Purchase Order Status to Import (Overrides the above)- This allows filtering Purchase rders by Unleashed's custom order status field instead of the standard order status field.
Create Product from PO if it doesn't exist - Creates new products for SKUs that don't yet exist in Mintsoft.
Update the Unleashed PO with ASN data? (Will Error if Over-Received)- This enables receipting of PO's in Unleashed.
Auto Increase PO Line Quantities if Over- Received - This positively adjusts ASN Quantity, allowing POs to be over receipted in Unleashed. This will reduce issues caused when trying to despatch orders, where the reciept has failed due to a quantity discrepancy. But you must be aware we will be positively adjusting your PO's in Unleashed.
Order Export tab
This tab contains:
Export Orders - Activates order export from Mintsoft to Unleashed.
Export Orders Frequency (Minutes) - Sets export frequency.
Export Orders Since - Backdates order exports from specific date/time. (If in doubt set it to Now, to avoid exporting old data.)
Export Orders in Channel - Exports orders from specific channels only.
Order Statuses To Export Orders In - Specifies which order statuses to export. For example you may only wish to export orders once they have been despatched.
Group Sales By Bundle When Exporting - Exports only bundle SKUs (ignores components).
Group By Channel on Export - Groups the Sales Orders by the channel so the customer in Unleashed appears to be the channel.
Carriage Description - Title for shipping charges in Unleashed.
Send Accounting Journal Only - Sends journal entries instead of full invoices.
Assembly Import tab
This tab contains:
Import Assemblies - Create Order to Pick Components - Creates pickable orders for assembly components.
Import Assemblies - Create ASN to Receive Final Products - Creates ASNs to receive finished assemblies.
Assembly Status To Import - Enter 'Parked'.
Custom Assembly Status To Import - Overrides standard assembly status.
Courier Service To Import Assembly Orders As - Assigns specific courier service.
Shipment Import tab
This tab contains:
Shipment To Order Import - Imports order shipments from Unleashed (use with caution).
Shipment Status To Import - Specifies shipment statuses to import (separate with commas).
Enable Splitting Post Import - Updates shipments if processing hasn't begun in Mintsoft.
Allow Shipment Warehouse to Differ from Order- This toggle controls whether the Shipment to Order import feature will allow a shipment to import if the Sales Order belongs to a different warehouse than the one configured on the connector.
Warehouse Transfer Sync tab
This tab contains:
Import Warehouse Transfers As Orders to Pick at Source - When enabled, the system creates a picking order in Mintsoft at the source warehouse for each Warehouse Transfer imported from Unleashed. The order is assigned to the source warehouse (where the stock is being transferred FROM), and the delivery address is set to the destination warehouse's address.
Import Warehouse Transfers as ASN to Receieve At Destination - When enabled, the system creates an ASN in Mintsoft at the destination warehouse for each Warehouse Transfer imported from Unleashed. Once the ASN is booked in, the system automatically updates the Warehouse Transfer status back to Unleashed and marks it as complete. This setting works in conjunction with the Orders setting above - you can enable both to create a complete transfer workflow (pick at source, receive at destination).
Warehouse Transfer Frequency (Minutes) - Sets sync frequency (minimum 15).
Warehouse Transfer Status To Import - Enter Parked.
Courier Service To Import Warehouse Transfer Orders As - Assigns specific courier service.
Advanced
This tab contains:
Stock Sync Value Type - Choose which stock value to send:
StockLevel (Reccomended): Total quantity (including allocated).
OnHand: Available stock (excluding allocated).
Stock Sync Use Unleashed as Stock Master - Makes Unleashed the stock controller (not recommended). Only to be used when stock is not managed in Mintsoft, and Mintsoft is being used as a tool to distribute stock levels to third party integrations.
Disable Sales Order Completion after Despatch - Option to prevent Mintsoft completing the Sales Orders after despatch.
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.