Skip to main content

Unleashed Integration

Tom Higgs avatar
Written by Tom Higgs
Updated over 3 weeks ago

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.


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:

  1. Log in to Unleashed.

  2. Click Integration then Unleashed API Access.

  3. 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:

  1. In Unleashed, click Settings.

  2. Click System then Adjustment Reasons.

  3. In the Adjustment Reason field, enter Mintsoft then click Add.

Find your warehouse code

Unleashed uses MAIN as the default warehouse code.

To view your warehouse list if you have multiple warehouses:

  1. In Unleashed, click Settings.

  2. 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:

  1. In Mintsoft, click Connect.

  2. Click Order Integrations then Unleashed.

  3. Click Add Account.

  4. (3PL Only) Select the Client.

  5. Choose the Warehouse.

  6. Choose the Channel.

    • This is the channel orders import against.

    • You can create additional channels.

  7. Paste the API ID and API Key into the relevant fields.

  8. Enter your Unleashed Warehouse Code the default is MAIN.

  9. Make Active when ready.

  10. 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).

  • Disable Sales Order Completion after Despatch - Prevents automatic order completion in Unleashed after dispatch.

  • 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 Once Per Day - Limits sync to once daily.

  • Specified Time to run the StockSync - Sets sync time when using once per day sync.

Warning: Always schedule the once per day stock sync outside of working hours when synchronising inventory with Unleashed. This is essential for system performance.

  • Stock Sync Value Type - Choose which stock value to send:

    • StockLevel: Total quantity (including allocated).

    • OnHand: Available stock (excluding allocated).

  • Exclude Bundles From Stock Sync? - Prevents bundle SKU stock updates.

  • Use Unleashed As Stock Master - Makes Unleashed the stock controller (not recommended).

  • ASNs Import as Awaiting Delivery - Imports ASNs ready to receive (rather than New status).

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).

  • Create Product from PO if it doesn't exist - Creates new products for unknown SKUs.

  • Attempt to Update the Unleashed PO with ASN data? - Marks POs as receipted (with limitations for over/under-receiving).

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.

  • Export Orders in Channel - Exports orders from specific channels only.

  • Order Statuses To Export Orders In - Specifies which order statuses to export.

  • Group Sales By Bundle When Exporting - Exports only bundle SKUs (ignores components).

  • Group By Channel on Export - Uses channel name as customer name in Unleashed.

  • 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:

  • Get Assemblies - Create Order to Pick - Creates pickable orders for assembly components.

  • Get Assemblies - Create ASN to Receive - 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 for easy identification.

Shipment Import tab

This tab contains:

  • Shipment To Order Import - Imports order shipments from Unleashed (use with caution).

  • Shipment To Order Status To Import - Specifies shipment statuses to import (separate with commas).

  • Enable Splitting Post Import - Updates shipments if processing hasn't begun in Mintsoft.

Customer Sync tab

This tab contains:

  • Customer Sync Interval (Hours) - Sets customer data sync frequency (keep default setting).

Warehouse Transfer Sync tab

This tab contains:

  • Import Warehouse Transfers - Creates picking orders and receiving ASNs for transfers.

  • Warehouse Transfer Frequency (Minutes) - Sets sync frequency (minimum 15).

  • Warehouse Transfer Status To Import - Specifies transfer statuses to import (separate with commas).

  • Courier Service To Import Warehouse Transfer Orders As - Assigns specific courier service for identification.


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.

Did this answer your question?