Supply Lens

How do I connect my Mintsoft 3PL to Supply Lens?

Add Mintsoft

Connect your 3PL's Mintsoft account so orders and goods-in notices go to the warehouse, and shipments, receipts and stock come back.

About 6 min

At the end of this guide your 3PL's Mintsoft account will be connected to Supply Lens, with orders going out to the warehouse and despatches coming back, tested on one order.

Before you start

  • The Mintsoft connection details from your 3PL. Ask your 3PL for the details the Mintsoft connection form needs, and for your Mintsoft client ID and the warehouse your stock is held in. Mintsoft is multi-client, so the client ID matters.
  • Admin access to Supply Lens, to reach Settings → Integration setup.
  • Your ERP or storefront already connected, for example Unleashed. See Add an Integration.
  • SKUs aligned. Every SKU the warehouse will see must match your item master exactly. See Align your SKUs.
  • Courier services agreed with the 3PL: which Mintsoft courier service each of your delivery methods should become.

Steps

Create and connect

  1. Go to Settings → Integration setup → Integrations.
  2. Click + ADD INTEGRATION, search for Mintsoft and click ADD.
  3. Complete the connection form with the details from your 3PL and click CONNECT.
  4. Expand the new Integration's tile and rename it with the pencil if you like, for example Brookside (Mintsoft). Leave Activation disabled for now.

Add Configurations

  1. On the tile, click Configurations, then + Add.

  2. Add one Configuration for each flow you need, clicking Create Default JSON and then Save for each:

    Settings groupDirection
    Mintsoft OrderSend (Supply Lens creates the order in Mintsoft)
    Mintsoft ShipmentReceive
    Mintsoft Goods InboundSend
    Mintsoft Goods Inbound ReceiptReceive
    Mintsoft InventoryReceive

  3. In the order Configuration, set clientId to your Mintsoft client, and set courierServiceMap to translate your delivery methods into Mintsoft courier services.

  4. In every Receive Configuration, set filterByClientId to your client ID so you only bring back your own records from a shared 3PL account.

Good to know

Send and Receive are from Supply Lens's point of view: orders go to Mintsoft (Send) and shipments come from it (Receive). Most setups only need the sending side of the Mintsoft Order group; its import settings are for orders that reach Mintsoft by another route.

Add master data

  1. On the Location for the 3PL's warehouse, add a Mintsoft Warehouse or Mintsoft Warehouse Id identifier. See Add a Location identifier.
  2. On your own Party, add your Mintsoft Client ID. See Add a Party identifier.

Add Mappings

  1. Go to Settings → Integration setup → Mappings and click + ADD.

  2. Create one Mapping per flow, for example:

    MapFromTo
    Warehouse OrderYour ERPMintsoft
    ShipmentMintsoftYour ERP
    ShipmentMintsoftYour storefront
    Goods InboundYour ERPMintsoft
    Goods Inbound ReceiptMintsoftYour ERP
    InventoryMintsoftYour ERP

  3. Set As to Target Data, tick Enabled, and leave Automatic off while you test. Click SAVE.

Test

  1. Set Activation to Enabled, but leave the schedule off.
  2. Create one test order in your ERP and process it so a warehouse order is produced.
  3. On the Mintsoft tile, click Run Send under Manual Operation.
  4. Ask the 3PL to despatch the test order, then click Run Receive.

Check it worked

  • The order appears in Mintsoft under your client, with the right address and courier service.
  • The despatch comes back as a Shipment in Supply Lens, matched to its order, and the tracking reaches your ERP and storefront.
  • Each Document's target data shows as sent. When you're happy, set a Schedule and turn Automatic on for your Mappings.

If something goes wrong

  • Other clients' shipments or stock appear. filterByClientId is empty on a Receive Configuration. Set it to your client ID.
  • A line fails with an unknown product. The SKU doesn't match. See Fix "product does not exist".
  • Cancelled orders are still picked. Check automaticallyCancelOrders is still on in the order Configuration. If you turn it off, someone must cancel orders in Mintsoft by hand.
  • Shipments don't match their orders. Check the reference type settings, and keep skipBundleProcessing the same on Order and Shipment. See the Mintsoft settings.