How do I connect my Magento store to Supply Lens?

Add Magento

Connect a Magento (Adobe Commerce) store so web orders and credit memos reach your back office, and stock and despatches go back to the shop.

About 6 min

At the end of this guide your Magento store will be connected to Supply Lens, with orders flowing to your ERP and stock and shipments flowing back, tested on one order.

Before you start

Magento admin access, and the connection details the Magento form asks for.
Admin access to Supply Lens, to reach Settings → Integration setup.
Your ERP or IMS already connected, for example Unleashed. See Add an Integration.
SKUs aligned exactly between Magento and your item master. See Align your SKUs.
Some answers from the merchant: which Magento status orders are in when they're ready to fulfil, how guest orders should be booked, and which Magento inventory source the shop sells from.
A Party for guest orders and a Location for fulfilment, if you'll use them. See Add a Party and Add a Location.

Steps

Create and connect

Go to Settings → Integration setup → Integrations.
Click + ADD INTEGRATION, search for Magento and click ADD.
Complete the form and click CONNECT. Leave Activation disabled for now.

Add Configurations

Expand the tile, click Configurations, then + Add. For each document type below, choose the direction, click Create Default JSON, then Save:

Document type Direction What it does
Order Receive Imports web orders
Credit Receive Imports credit memos (refunds)
Inventory Send Sends stock to Magento
Shipment Send Updates Magento shipments with tracking
In Order, set statusesToImport to the status orders are in when ready to fulfil (the default is processing only). Set guestPartyId for guest checkouts and fulfillmentLocationId for the fulfilment Location.
In Inventory, set defaultSourceCode to the source the shop sells from.
In Shipment, decide notify: turn it on only if nobody else emails customers a despatch notice.
Keep useBaseValues the same on Order and Credit.

Document type	Direction	What it does
Order	Receive	Imports web orders
Credit	Receive	Imports credit memos (refunds)
Inventory	Send	Sends stock to Magento
Shipment	Send	Updates Magento shipments with tracking

Add Mappings

Go to Settings → Integration setup → Mappings and click + ADD.
Create the Mappings you need, for example:

Map From To
Order Magento Your ERP
Credit Magento Your ERP
Inventory Your ERP Magento
Shipment Your ERP or 3PL Magento
Set As to Target Data, tick Enabled, and leave Automatic off while you test. Click SAVE.

Map	From	To
Order	Magento	Your ERP
Credit	Magento	Your ERP
Inventory	Your ERP	Magento
Shipment	Your ERP or 3PL	Magento

Test

Set Activation to Enabled, with no schedule.
Place a test order in Magento and move it to the status you chose.
On the Magento tile, click Run Receive under Manual Operation.

Check it worked

The test order appears under Sales → Orders in Supply Lens, with the right customer and lines, and nothing older than your go-live date.
After you process it, the sales order appears in your ERP.
When you're happy, set a Schedule and turn Automatic on for your Mappings.

If something goes wrong

No orders arrive. Orders are in a status not listed in statusesToImport. Add it.
A line fails with an unknown product. See Fix "product does not exist". Remember bundles arrive as their component lines by default (productTypesImportChildren).
Customers get two despatch emails. Turn notify off on the Shipment Configuration.
Stock updates are slow or throttled. Try useBulkEndpoint, or single-product updates with a rate limit. See the Magento settings.