Trade Me Linnworks Integration User Manual

Trade Me is the no.1 online shopping platform in New Zealand for auctions & classified ads. Our Trade Me Linnworks integration enables you to manage orders, inventory & push price updates from Linnworks to your Trade Me channel

Trade Me Integration for Linnworks | 1. Installing Trade Me Integration for Linnworks:

Trade Me Channel Integration for Linnworks

The eBusiness Guru Trade Me integration for Linnworks is just £24.99 + VAT per month

New Zealand’s most popular online one-stop shop for auctions and classifieds. Trade Me has thousands of new and used items in a range of categories, including homewares and lifestyle goods, sports equipment, toys and games, motor parts and accessories, clothing, electronics and personal care items.

Commission fees on sales are a low 9.85%. If you’re looking to expand your operations worldwide, Trade Me is one of the easiest as there are no translations required.

If you are interested in selling on Trade Me, and require assistance, contact details are below:

 

United Kingdom (UK) Office

Trade Me’s UK Representative office, Pivot International:

Call: +44 (0) 7500 798 540

Email: [email protected]

 

International Office

Contact David Swift:

Call: +64 9 924 6605 / +64 21 90 8300

Email: [email protected]

 

Useful Resources:

Selling on Trade Me : Your questions Answered | TradeMe tips for UK retailers

 

Integrate the Channel into Linnworks.net:

The Trade Me connector is an application which is embedded into Linnworks, developed and supported by eBusiness Guru.

1. 1. Log into Linnworks.net
   2. Select Settings in the left-hand menu bar
   3. Select the Channel Integration option.
   4. Select Add New to return a list of available Channel Integrations
   5. Locate Trade Me on the list, and click on Integrate.
   6. After reading the warning, click on Accept to move onto the next step of the integration. You can click on the link at the bottom to review the Trade Me Connector Terms and Conditions first.
   7. Enter your Trade Me account name to start the actual integration.After reading the disclaimer, please tick ‘I agree to the terms and conditions’ and click Next to continue integrating Trade Me

Trade Me Integration Guide

To integrate your Trade Me account, you will need the following information:

Get Access Tokens:

1.1. When the config wizard is opened to get Authorisation Token and Authorisation Secret, click on: http://ebusinessguru.it/trademe/OAuth/GetRequestToken
This link is available by clicking on Help symbol “?”

1.2. When you get your temporary token and secret, click on “click here to authorize access to your account” to authorize your temporary token and receive your permanent Authorisation details.

1.3 This URL is hit when Trade Me redirects the user back to this application after they have approved access or logged in

1.4 After login you will receive the final access tokens.

1.5 Copy and paste these into the Trade Me integration screen.

1. To complete the integration, please click on Finish.Your Trade Me integration should now show in Channel Integrations

Edit Channel Details:

Edit Channel Details

Account Status

1. In Linnworks.net, select Settings.
2. Select Channel Integration.
3. Locate the Trade Me entry, and click on the Configuration button.
4. To Enable or Disable the Account, click the Account section.
5. If the Enabled option is un-ticked, the channel will not download or update orders, or provide inventory level updates.
6. The Test button allows you to confirm there are no errors preventing Linnworks and Trade Me communicating. Contact EBG Support if Test reports any errors.
7. Click Save at the bottom of this window to apply any changes.

Channel Inventory Settings

1. 1. In Linnworks.net, select Settings.
   2. Select Channel Integration.
   3. Locate the Trade Me entry, and click on the Configuration button.
   4. In the Inventory section, the first entry is Update Inventory. If this is disabled, then Linnworks will not tell the listings on the Trade Me marketplace when Available Stock Levels change in Linnworks. If enabled, then Linnworks will provide these updates.
   5. Update Inventory only works where a listing has been Mapped to a Linnworks Inventory item. See the end of this document for more information on Mapping.
   6. The Price Change feature allows Linnworks to send new prices directly to the listing when they are correctly imported or updated.
   7. Price Change only works where a listing has been Mapped to a Linnworks Inventory item. See the end of this document for more information on Price Change and Mapping.
   8. Max Listed allows you to filter the highest quantity that Linnworks can/will send to the listings on the Trade Me channel. If Max Listed is set to 50, and your Available Stock moves from 30 to 60, Linnworks can only send 50, and this will not change until the Available Stock level drops below 50.
   9. Stock Percentage acts in a similar fashion, but only updates the listings with the specified percentage of your actual Available Stock level.
   10. End When allows you to set a ‘false zero’ for the channel. This means it will send Out of Stock when the available stock reaches the value set in this value.
   11. Click Save at the bottom of this window to apply any changes.

Channel Listing Settings

Linnworks.net periodically checks the channel for the current listings you have on the channel, their titles and SKUs, so that the Mapping Tool can be used correctly. It can be triggered manually, should you have made changes directly on the channel and outside of Linnworks.

1. In Linnworks.net, select Settings.
2. Select Channel Integration.
3. Locate the Trade Me entry, and click on the Configuration button.
4. In the Listings section, the information reflects the information Linnworks currently has about your listed items on the Trade Me marketplace.
5. If there is a tick by listing download in progress, Linnworks is downloading the current listings, and cannot be interrupted.
6. The Listing Download Start Time value is the time the last download/update was started.
7. The Last Listing Download Completion time value tells you when the last successful download completed and was imported into Linnworks.
8. The Listing Download Estimated Completion reflects Linnworks’ best estimate of when the most recent or current download should complete. The Download Listings button instructs Linnworks to retrieve the latest listing information, and ticks the Listing Download in Progress box. This can only be used once every 4 hours maximum, and will warn you if you try to use it more frequently.
9. Click Save at the bottom of this window to apply any changes.

Order Settings

This section reflects activities affecting the Linnworks Order Sync on your Trade Me channel integration. Linnworks downloads orders from Trade Me with the status Shipping in Progress.

1. In Linnworks.net, Select Settings.
2. Select Channel Integration.
3. Locate the Trade Me entry, and click on the Configuration button.
4. In the Order section, there are two options.
5. Despatch Notes, when enabled, allows Linnworks to send information about orders that have been processed in Linnworks. Orders that are processed in Linnworks are updated to the status Shipped on Trade Me.
6. The Order Sync Date reflects the date and time of the last successful order download and update for the current Trade Me channel integration.
7. Click Save at the bottom of this window to apply any changes.

API Settings

These settings are used to enable Linnworks and your Trade Me account to connect, and are covered in Step 1.

Remember to click Save at the bottom of this window to apply any changes.

Location Mapping: Location Mapping

1. 1. In Linnworks.net, select Settings.
   2. Select Channel Integration.
   3. Locate the Trade Me entry, and click on the Configuration button.
   4. Click the Location Mapping button.
   5. The first option in the Location Mapping window is the Order Download Location. This is initially Default, but can be changed. Click on the dropdown list and select which inventory/fulfilment location will initially receive the orders from this Trade Me integration.
   6. Under Inventory Sync Locations, you control which Linnworks Inventory locations are used to calculate the Available Stock values for your Trade Me listings.

If you have only the Default location, this can be ignored, with Default left enabled.

If you have multiple Inventory Locations, you can switch Off locations (Slide switch to the left) that you don’t want to be included in the stock numbers on the listings.

Ensure you click Save when you have finished to update Linnworks. You should also click Save at the bottom of the configuration window to apply any changes.

Mapping:

Mapping

Linnworks.net uses the Mapping Tool to ensure that it knows which SKUs in its inventory are connected to which listings on Trade Me. As such, you should ensure that all of your listings are mapped correctly, or stock levels and prices will not update correctly, and orders may not be picked accurately.

1. In Linnworks.net, select Settings.
2. Select Channel Integration.
3. Locate the Trade Me entry, and click on the Mapping button (see above).

This screen is divided into 2 sections.

On the left are the listings Linnworks is aware of on your Trade Me channel. If this is not correct, or a change is missing, you should see the Download Listings button in the Listings section of the Channel Configuration. On the right is a Linnworks Inventory Search Tool. Each has its own Search box.

In the bottom left hand corner of the window is a status section. It shows the Total Number of Listings on the channel, and then beside it the Unlinked and Linked numbers. Linked listings are connected to a Linnworks Inventory item to allow updates and recognition, Unlinked are not. Ideally there should be no Unlinked listings.

Please Note: SKUs with “BuyNowOnly” at the end are one time only listings so stock would not been updated for those SKUs. Only the price will be updated for BuyNowOnly SKUs. For all other SKUs without BuyNowOnly stock and price both will be updated.

Linking Items Automatically

If the SKUs in your inventory match the SKUs used on the listings, you can ask Linnworks to link them all for you.

1. Click the Settings button in the top left hand corner (with a gear on it).
2. Select Link All By.
3. Select SKU.
4. Linnworks will map all those listings that have a SKU that matches a SKU in the Linnworks Inventory.
5. Check the Linked and Unlinked values once this is complete.

Linking Items Manually

If the SKUs in your inventory do not match the SKUs used on the listings, you can make the link manually.

1. Use the left hand list and Search to find the listing to be linked.
2. Click on it to highlight and select it.
3. In the right hand list, use the Search box to find the correct Linnworks Inventory item to link it to.
4. Click on the Link button beside it with the listing highlighted.
5. Repeat for other listings to be linked manually.

Creating Linnworks Inventory items and Mapping

If there are no SKUs in your inventory match to the SKUs on the listings, you can ask Linnworks to create basic Inventory items for you, and link them.

1. Use the left hand list and Search to find the listing to be linked.
2. Click on the Create button.
3. A new item will be created in the Linnworks inventory using the name, price and stock level, as well as the SKU from the listing. This will be linked to the SKU.
4. This can be updated with other information later in the Inventory.
5. Repeat this for other Listings that have no Linnworks inventory equivalent.

Price Change Functionality

Price Change only works for listings that are correctly linked to a Linnworks Inventory item in the Mapping Tool.

1. Open Linnworks.net.
2. Select Inventory.
3. Select My Inventory.
4. Use Search to locate the Inventory item that requires a Price Change on Trade Me
5. Click on the SKU to edit the item.
6. Click on the Listing Descriptions tab.
7. Under the Product Pricing by Channel section, click on Add New.
8. Enter the Source as Trade Me.
9. Enter the SubSource as the name of the Trade Me channel.
10. Enter the Price.
11. Click on + Add to complete.
12. If there is already an entry present for the correct Source and SubSource, double click the Price to edit it, and then click Enter.
13. Close the SKU window when you have finished.

Payment Mapping: Payment Mapping

The next step is to map your Trade Me Shipping services to Postal Services in Linnworks, so orders don’t need to have their Postal Service set manually. Initially, all are mapped to Default.

1. 1. In Linnworks.net, select Settings.
   2. Select Channel Integration.
   3. Locate the Trade Me entry, and click the Payment Method button on the right (see above).
   4. This opens the Edit Payment Methods window; the list will initially be blank.
   5. When mapped, Linnworks will ensure the orders it downloads from Trade Me reflect correctly which payment methods/providers have been used on the site.
   6. Click Save at the bottom of the channel integration window to apply any changes.

Map Trade Me Payment Methods

1. Select the Channel Payment Method value, and select one of the Payment Methods from Trade Me that show in the dropdown list.
2. Then click on the Linnworks Payment Method dropdown. Select the appropriate Linnworks Payment Method that should be used in Linnworks orders when they are downloaded including the above payment method.
3. Click Add to save the mapping, and return to the list.
4. Repeat this for all of the Trade Me payment methods that you wish to use.
5. Click Save at the bottom of the channel configuration window to apply any changes.

Shipping Mapping: Shipping Mapping

The next step is to map your Trade Me Shipping services to Postal Services in Linnworks, so orders don’t need to have their Postal Service set manually. Initially, all are mapped to Default.

1. In Linnworks.net, select Settings.
2. Select Channel Integration.
3. Locate the Trade Me entry, and click the Shipping Mapping button on the right (see above).
4. In the Edit Shipping Allocation window, you should see an empty list.
5. To add a new entry for one of your Trade Me shipping services, click on Create New.

Create New Shipping Service Mapping

1. Channel Service Name: enter the name of the Shipping Service in Trade Me.
2. Channel Service Tag: enter the Tag value used for the service in Trade Me.
3. In the Linnworks Postal Service dropdown, select the name of the Linnworks Postal Service that should be used for orders imported from Trade Me with the Shipping Service to dispatch them correctly.
4. The Add button will save the mapping, and display it in the Edit Shipping Allocation screen.
5. Repeat this process for all the other Trade Me Shipping methods you are using.
6. Click Save at the bottom of the channel integration window to apply any changes.

Disclaimer:

Please note that the Trade Me Channel Integration for Linnworks is not designed to be used alongside other third party Trade Me apps. As such, please be aware that using other third party Trade Me integrations may cause issues and impede functionality.

The order download functionality requires that the SKU field for the Trade Me Listing be populated and assigned/defined. If this is not so, then the order may not be downloaded as it will be incomplete. Other integrations may use different fields that do not populate the SKU field, and we cannot accept responsibility for errors or problems arising from the SKU field not being populated for your listed and active items when downloading Trade Me orders.