Skip to main content

Unleashed Integration

Tom Higgs avatar
Written by Tom Higgs
Updated over 2 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.

Video Overview


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

  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 - Any adjustments per the last 24 hours get synced to Unleashed, although orders and ASNs should keep stock in check for the most part. You can click "trigger full stock sync" on the connection, which will cause all SKUs to sync stock, but still only at the time of the once per day trigger

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

  • Update the Unleashed PO with ASN data? (Will Error if Over-Received)- This positively adjusts ASN Quantity, allowing POs to be over receipted in Unleashed which removes issues when trying to despatch orders, but stock doesn't yet exist in Unleashed.

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