Skip to content

Linnworks

Steps for

What it does

Linnworks (opens in a new tab) is a multi-channel platform for running eCommerce operations, from inventory and stock to order management and fulfilment.

SparkLayer has a direct integration with Linnworks. You keep your B2B prices, including price breaks and units of measure, on your Linnworks inventory items, and SparkLayer adds them to your price lists.

How data flows between Linnworks, SparkLayer and your store

Linnworks

B2B prices in extended properties named b2b-…
(this flows forward)

SparkLayer

Imports prices into your price lists every hour
(this flows forward)

Your store

Signed-in B2B customers see their prices
(this flows forward)

Linnworks

Orders arrive through your existing Linnworks integration

What syncs and in which direction

Only prices sync, one way, from Linnworks into SparkLayer every hour. Orders go to Linnworks through your own Linnworks integration, not through SparkLayer.

DataDirectionDetails
PricesLinnworks to SparkLayerProduct prices come from extended properties on Linnworks inventory items.
OrdersSparkLayer to your store to LinnworksOrders placed through SparkLayer reach Linnworks through your existing Linnworks integration, with your B2B prices.
CustomersNot syncedYou manage customers on your eCommerce platform as usual.

To check the prices SparkLayer has received for a product, use Product data lookup in Product sync.

Set up Linnworks

Check the requirements and connect Linnworks. Then create your price lists in SparkLayer, add their prices in Linnworks and assign them to customers.

Requirements

Connect Linnworks

  1. Sign in to your Linnworks account.
  2. Open the SparkLayer app authorisation page (opens in a new tab) to install the SparkLayer app. You're given an authorisation token.
  3. In the SparkLayer Dashboard, go to Integrations,Partners (opens in your SparkLayer Dashboard in a new tab).
  4. Under Multi-channel management, turn on the switch next to Linnworks.
  5. Paste the authorisation token into Token and click Save.

Create price lists in SparkLayer

With Linnworks, you create the price lists in SparkLayer first, then add prices to them from Linnworks. Price lists decide which prices each customer sees when they sign in.

  1. In the Dashboard, go to Pricing,Price lists (opens in your SparkLayer Dashboard in a new tab).
  2. Click Create Price List.
  3. Enter a Handle (a short, unique ID you'll use in Linnworks) and a Name, then save.
  4. Repeat for each price list you need.

Make a note of each handle: you'll use it in Linnworks.

Add B2B prices in Linnworks

You add B2B prices with Linnworks' extended properties feature. See Linnworks' guide to extended properties (opens in a new tab).

  1. In Linnworks, open a product and go to the Extended properties tab.
  2. Click Add New.
  3. Fill in the Name, Value and Type as shown below.
  4. Repeat for each price list the product belongs to.
FieldWhat to enter
Nameb2b- followed by the price list's handle in SparkLayer. For example, for the handle base-list, enter b2b-base-list.
ValueThe prices, separated by commas (see below).
TypeOther

Format the price value

Separate prices with commas. The first price is always the price for one item.

To setHow to write itExample
A single priceThe price for one item.7.00
Price breaks (tiered pricing)Add each tier as the quantity, a plus sign and the price.£7.00 for one item and £5.00 for 10 or more: 7.00,10+5.00
Units of measureAdd a plus sign and a unit key after a tier. See unit of measure pricing.10 items make a box at £5.00 each and 100 make a crate at £4.00 each: 7.00,10+5.00+box,100+4.00+crate

For example, a product on 2 price lists could have these extended properties:

NameValueType
b2b-base-list10,5+7.50Other
b2b-uk-vip7.50,10+5.75,50+5Other

Update prices in bulk

To change many prices at once, use Linnworks' bulk import tools. See Linnworks' guide to importing and exporting data (opens in a new tab).

Assign prices to customers

Customers see the Linnworks prices once their customer group uses the right price list. Set this up in Customers,Groups (opens in your SparkLayer Dashboard in a new tab).

To test it, sign in to your store as a B2B customer and open a product. You should see the price you set in Linnworks.

Limitations

  • Customers don't sync. You manage them on your eCommerce platform.
  • Orders don't go through SparkLayer. They reach Linnworks through your existing Linnworks integration.
  • Price changes take up to an hour to reach SparkLayer, because prices sync every hour.

Troubleshooting

Was this page helpful?

Last updated