ℹ️ Direct link to Linnwork’s documentation

Add Channel

Linnworks

Under the ‘Settings’ menu screen in the bottom right-hand corner navigation menu of Linnworks, please navigate to ‘Channel Integration’.

Click ‘Add New’.

You can find the application by browsing in the window or searching for ‘Refurbed’.

• When asked to give it an ‘Account Name’, name the connection as you see fit. “Refurbed” for example.
• Please ‘agree’ to the Linnworks terms and conditions and click ‘Next’.
• Upon clicking ‘Next’ on Linnworks, you will be prompted to enter your Refurbed API key.

• Access tokens can be requested at integrations@refurbed.com.

Inventory Mapping

Once the integration is added to your account, you should make inventory linking for yourself. You can use Linnworks documentation (stock_item_linking) for this step. After downloading the template, you should fill it according to the example. There are 5 required columns:

• SKU - SKU identifier form Linnworks
• Linked SKU customer Label - SKU identifier from Refurbed
• Source - RefurbedIntegration always. It needs to make a correct mapping
• SubSource - ‘Account Name’ that was input during the integration installation
• Channel Reference ID - SKU identifier from Linnworks

Template - StockItemLinking-Sample

How to Configure

Once the channel is added, click the pen.

Account

• Enabled: tick to allow communication between Linnworks and Refurbed. When unticked, no information is sent to or received from the channel.
• Test: used to confirm the supplied credentials work correctly, allowing communication between Refurbed and Linnworks.

Order

• Despatch Notes: when enabled, Linnworks will send the order processing status, tracking number, and selected shipping service to Refurbed once the order is processed.
  • If the shipping carrier name doesn’t exist in Refurbed, Linnwokrs will return the error Cannot find related Courier Slug for {Shipper Vendor name}. Please contact support if you face this issue.
• Cancellation Notes: when enabled, Linnworks will send order cancellation notes to Refurbed once the order is canceled.
• Refund: when enabled, Linnworks will send the full/partial refund notes to Refurbed once the order is refunded.
• Order sync date: the date and time when Linnworks last synchronized with the channel.
• NOTE: During order downloading, the integration will take only NEW and ACCEPTED orders that weren’t refunded.

Inventory

• Update Inventory: when enabled, Linnworks submits changes in stock levels to the channel.
• Max Listed: specifies the maximum available stock level submitted to the channel.
• Stock Percentage: specifies the percentage of available stock submitted to the channel.
• End: when enabled to force the listing to end when the stock level gets to the specified amount as opposed to the default value of zero.

Price Change

• Price Change: when enabled, Linnworks submits changes in price levels to the channel. For this feature, items should have Additional Info with Min Price and Regional Prices, if needed to change, and items should be linked for channel and contain Channel Reference ID with Linnworks SKU.
  • Price won’t be updated if you don’t have inside Inventory -> Channel SKU -> channel reference ID.
  • Channel reference ID has to be matched with Linnworks SKU
• Regional price: when enabled, Linnworks updates regional prices in any currency for any country. For this feature, items should have an Item extended property.

  • Name: [Market code]_[Currency]. Value: [Cost]. Type: Attribute.

    

    

• Min price: when enabled, Linnworks updates the min price in Refurbed.
  • Name: Refurbed_MinPrice. Value: [Cost]. Type: Attribute

Serial number / IMEI upload

The serial number/IMEI upload can be enabled in Linnworks in the refurbed integration settings.

⚠️If enabled, an IMEI or serial number has to be set for all order items. Otherwise the full despatch, including tracking information, will fail.

This is how it looks like in the order item additional info:

FAQ

Why are my stock and/or price not updating?

Steps to check before reaching out to integrations@refurbed.com for support.

• Make sure that the stock and price updates in the integration settings in Linnworks are enabled.
• The changes may take a couple of minutes after the integration is activated.
• Try changing the price and/or stock of an offer in Linnworks after you activate the integration. Check price and/or stock in our supplier interface to see if the update came through.
• Check that your SKUs are correctly mapped in the Channel SKU tab in Linnworks. Unmapped SKUs or wrongly mapped SKUs can lead to failing updates.

Why is the tracking link sync not working?

Steps to check before reaching out to integrations@refurbed.com for support.

• Make sure that the despatch notes are enabled.
• Please check for errors. Do you get the error ‘Cannot find related Courier Slug for {Shipper Vendor name}'? Then the shipping carrier name does not exist or is not mapped with the available carriers of refurbed. Please contact support.
• Make sure that the ShippingVendor is not NONE. You can check it under Settings → Automation Logs → Category: External, Type: Despatch notification

Why can I not partially cancel my order?

Linnworks does not support the cancellation of only 1 order item. Split the order and then proceed with the cancellation.