Tophatter is the world's fastest, most entertaining marketplace, with live online auctions every day, now integrated with linnworks allows you to manage orders and inventory from linnworks.

Orders Management:
Order download to linnworks
Order process and send dispatch notification on Tophatter.com

Inventory Management:
Stock mapping on channel integration Mapping screen
Stock update from linnworks to Tophatter.com

Step 1: Integrate the Channel into Linnworks.net

To use Top Hatter channel, you must first install it from within Linnworks.net.

1. Login to 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 TopHatter on the list, and click on Integrate.

6. After reading the warning, please click on Accept to move onto the next step of the integration. You can click on the link at the bottom to review the TopHatter Channel Terms and Conditions first, if you TopHatter to.

7. Enter your Tophatter account name to start the actual integration. And then click on next button for the next step.

8. After reading the Disclaimer, please tick ‘I agree to the terms and conditions’ and Next to continue integrating TopHatter.

9. TopHatter Integration Guide:

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

<9.1> API KEY:

9.1.1 Open this link: https://tophatter.com/seller/api_keys

9.1.2 If you are not already logged in then will be asked for login. Enter your login credentials of your admin Account.

9.1.3 Click on Sign In.

<9.2> Please copy and paste these into the TopHatter integration API Settings.

API Key - you can find from your top hatter account

Default Currency – Your country currency

10. To complete the integration, please click on Finish. Your TopHatter integration should now show in Linnworks.Net -> Channel Integrations.

Step 2: Edit Channel Details

Account Status

1. In Linnworks .Net, select Settings.
2. Select Channel Integration.
3. Locate the TopHatter entry, and look to the right. Click on the Configuration button.
4. To Enable or Disable the Account, locate the Account section.
5. If the Enabled option is not 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 TopHatter 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. In Linnworks .Net, select Settings.
2. Select Channel Integration.
3. Locate the TopHatter entry, and look to the right. 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 opncart 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.
a. 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.
7. Max Listed allows you to filter the highest quantity that Linnworks can/will send to the listings on this Tophatter 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.
8. Stock Percentage acts in a similar fashion, but only updates the listings with the specified percentage of your actual Available Stock level.
9. 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.
10. 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 Tophatter entry, and look to the right. Click on the Configuration button.
4. In the Listings section, the information reflects the information Linnworks currently has about your listed items on the Tophatter 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 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 TopHatter channel integration. Linnworks downloads orders from TopHatter with the status shipping in Progress.

1. In Linnworks .Net, select Settings.
2. Select Channel Integration.
3. Locate the TopHatter entry, and look to the right. Click on the Configuration button.
4. In the Order section, there are 2 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 TopHatter.
6. The Order Sync Date reflects the date and time of the last successful order download and update for the current TopHatter 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 Tophatter account to connect, and are covered in Step 1. Click Save at the bottom of this window to apply any changes.

Step 3: Location Mapping

1. In Linnworks .Net, select Settings.
2. Select Channel Integration.
3. Locate the opncart entry, and look to the right. Click on the Configuration button.
4. Locate the Location Mapping button, and click on it.
5. This opens the Location Mapping window.
6. The first option is the Order Download location. This is initially Default, but can be changed. Click on the dropdown list and select which inventory/fulfillment location will initially receive the orders from this TopHatter integration.
7. Under Inventory Sync Locations, you control which Linnworks Inventory locations are used to calculate the Available Stock values for your TopHatter listings.
8. If you have only the Default location, this can be ignored, with Default left enabled.
9. 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.

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

Step 4: Mapping

Linnworks.net uses the Mapping Tool to ensure that it knows which SKUs in its inventory are connected to which listings on TopHatter. 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 TopHatter entry, and look to the right. Click on the Mapping button (see above).

This screen is divided into 2 sections.

On the left is the listing Linnworks is aware of on your TopHatter 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.

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 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 which 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 them

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 Tophatter.
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 TopHatter.
9. Enter the Sub Source as the account name of the TopHatter channel.
10. Enter the Price.
11. Click on + add to complete.
12. If there is already an entry present for the correct Source and Sub Source, double click the Price to edit it, and then hit Enter.
13. Close the SKU window when you have finished.

Step 5: Shipping Mapping

The next step is to map your TopHatter 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 TopHatter entry, and look to the right. Locate the Shipping Mapping button (see above), and click on it.
4) In the Edit Shipping Allocation window, you should have an empty list.
5) To add a new entry for one of TopHatter shipping services, click on Create New.

1. Create New Shipping Service Mapping

1. For Channel Service Name, Enter the name of the Shipping Service in TopHatter.
2. In Channel Service Tag, enter the Tag value used for the service in TopHatter.
3. In the Linnworks Postal Service dropdown, select the name of the Linnworks Postal Service that should be used for orders imported from TopHatter 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 for all the other TopHatter Shipping methods you are using. This ensures your Linnworks order processing will run smoothly, and with minimal distractions.
6. Click Save at the bottom of the channel integration window to apply any changes.

Step 6: Tophatter Product Listing

Requirements:

Your TopHatter channel must be integrated in Linnworks.net

The Channel Name (Sub Source) used while integrating Fyndiq must be defined as an Extended Property of all items you wish to list using the integration. An example of this is shown below:

o Property Name: Fyndiq_31082017 (Name of the Sub Source)
o Property Value: true
o Property Type: Attribute

Each product must have at least one image in its Linnworks Inventory entry. This can include linking to a remote image using Extended Properties (https://help.linnworks.com/support/solutions/articles/7000010167-using-extended-properties-to-work-with-images-already-hosted-online).

The Stock Level must be greater than 0.

The Default or specific Price must be greater than 0.

Steps for using the TopHatter Product listing tool:

1. Once aFyndiq channel is integrated in Linnworks, you can open the Apps button to show the currently installed Apps list as well as the Application Store entry. You can select the Fyndiq listing option to proceed.

2. Once opened, the main screen will be displayed as below:

2.1 Before starting a product listing, we need to add configurators, as you would when listing to Amazon, eBay, etc in Linnworks. To start, pleaseclick on the configurators button.

2.1.2 You’ll be shown a list of all currently available configurators, now.

These are displayed with the following columns:

• Name: This displaysthe name of the configurator.
• Templates: This displays the count of product listings created using this configurator. Clicking on it displays all of the products listed.
• Site: This displays selected site name for this configurator.
• Category: This displaysthe selected listing category for individual products listed through the configurator. From here we can also change this category.
• Specification: This button shows the number of specifics used by this configurator for listings. This is for single product listings. • Variations: This button display the count of variation listings added to the channel using this configurator. This is used for variation product listings only.
• Show: This checkbox lets you decide of this configurator will display in the listing screen or not.
If the checkbox is not ticked, the configurator will not be displayed on the product listing page.

To add a new configuration, click on the Add New button.

2.1.3 Clicking on the Add Newbutton opens a screen:

• Name: Enter/edit the Configurator name.
• Site: This dropdown field contains the Fyndiq channel account name or names (SubSource) from your Linnworks account.

After completing and checking the fields click on the Save button.

1.1.2 For a single product listing, a newly created Configurator is added to the main screen, as below.

It’s not compulsory to add a specification for a single product listing, but allows you to replicate the feat for other products much more easily moving forwards.

We start by adding a category to the newly created configurator. You can in fact select and add multiple categories, by clicking the gear button, shown below.

Tick the boxes for the categories you want this configurator to list products in. Select Save when finished

After creating a configurator, you should move to the listing inventory screen.

• Before the SKU column, if you see a blank value, it means this product has no variation children. If you see a symbol, this means the product is a Variation product, with children. By clicking on the symbol you can see the children as a list.
• SKU: This field displays the product’s unique identifier.
• Title: This field displays the product’s title.
• Barcode: This field displays the product’s barcode (UPC/EAN).
• Retail Price: This field displays retail price you have set for the product.
• Level: This field displays the physical stock level for the product in Linnworks.
• In Open Orders: This field displays a count of the number of this product sold from the contents of the Linnworks Open Orders screen. Only linked/mapped products are counted.
• Available: This field displays the stock available to sell in the Linnworks inventory (Shelf stock level less the items in Open Orders and paid for).
• Create Listing: This shows if the product has already been listed.

This symbol indicates that this product has not been created/listed on the Fyndiq channel. You can therefore list it using the Listing Tool.

On left clicking this field, you are offered three options:

1. Edit Listing
2. Create Single Listing
3. Create Variation Listing
If it is a single product, then you can select the Create Single Listing option only. The other option(s) will be disabled. Clicking on the Create Single Listing option displays another list, containing the available configurators.

You can select one by clicking on it. You will then proceed to the single item listing page.

If it is a variation product, then you can select the Create Variation Listing option only. The other option(s) will be disabled. Clicking on the Create Variation Listing option displays another list, containing the available configurators.

You can select one by clicking on it. You will then proceed to the variation listing page.

This symbol (or similar) indicates that this product is already listed on the Fyndiq channel. You can use the Edit Listing option only. You cannot list if an item has already been listed.

<2.1>Single Listing:

2.1.5 Clicking on the Create single listing option is only possible for visible SKUs, and they must have anExtended Property as below:

Name: Subsource (In this example oc_ind02)
Value: true

To list a SKU/Item on a Fyndiq store, you must bear in mind the following points:

The compulsory fields to create a listing on Fyndiq are:

1.1 SKU
1.2 Title
1.3 Description
1.4 Retail Price (Price cannot be 0 or negative)
1.5 Tags
1.6 Configurator
1.7 Image

SKU: Your Linnworks SKU will be used as the Fyndiq Listing SKU.

Title: Initially, the Linnworks item title will be displayed in the Title Text box. You can make changes in this title according to your needs for the listing on Fyndiq. Once the listing is completed here, the same Title will be recorded to use for future changes unless you edit it again.

Note: Please bear in mind the following template to build your product names:

Main brand + Sub-brand, family or product name + Up to 3 key attributes + Generic product type.

Product Names must be clear and concise, and should also be descriptive of the product being sold. This template will help consumers identifying your product.

Image: For adding / editing Image, please click on the Image button.

• Click on the + button to add a new image.
• To set an image as the default, tick the checkbox on it.
• To remove an image, click on the Recycle Bin button.

Description: To add/edit the listing description, please click the button in that column. Click Save when finished.

The first time you list a product, the Description will be empty. Once the Description is entered and saved on this screen, and the listing is completed, the same description will be shown on re-entering this screen. After Saving, the description button will change from Empty to Filled.

Retail Price:

By Default, the Linnworks Retail Price will be displayed on this screen.

Tags:

Please Note: Tags are Non-hierarchical keywords or terms assigned to each product in your feed. This metadata helps describe an item, and allows it to be categorised and found again by browsing or searching on Fyndiq.com.

Tags should be comma separated, but do NOT use commas within individual tags. The more tags you add, and the more accurate your tags, the better the chances our users will find your products. There is a maximum of 10 tags allowed per product, more than 10 means that the extra tags will be ignored.

A popup screen with a text box for adding tags will be opened. User can add maximum 10 tags with comma separated values.

Once all tags are added, click on theSave button. This will save all of the tags in the item’s Extended Properties. After saving, the button label will be changed from Empty to Filled.

Configurator:

The configurator name cannot be changed. It was set earlier in the process.

Create Listing:

If the listing status column is Yellow, with the text “Not Listed”, then you have not listed the item.

Once the title, price, description and tags have been added/updated, please click on the “Create” button. This will send the listing for creation on Fyndiq.

If the listing is successfully created on Fyndiq,the status will be changed to“Listed”,and the colour will change to Green. The button label will also be changed to “Update” and the check box is ticked, to show that this product is enabled on the channel.

Once theproduct is created, the URL column enables, so that you can access the listing from this screen. Clicking on the chain button in this field opens the Fyndiq site with the product listing.

The Configurator screen is now updated, as shown below. Now that the configurator has been used to list an item, the count is updated to reflect this change.

Clicking on the Template value opens a new window with the following details:

• SKU: Product SKU used when creating the listing on Fyndiq using this configurator.
• Name: Product title.
• Listed On: This field displays the date onwhich the product was created.

<2.2>Variation Listing:

For Variation item listing, as with single items listings, the user needs to add the following Extended Property to the Variation parent.

Name: Subsource (In this example Fyndiq_31082017)
Value: true

Only variation parents with this Extended Property containing the correct Sub Source will be displayed for listing.

You should also add an extra Extended Property for the price, this has the same name, but with ‘_price’ at the end, and contains the price you wish to charge.

2.1.1 Before starting a Variation product listing, we need to ensure there is a Variation-ready Configurator for it. We use the same Configurator screen as we do for single product listings.

The main difference here is that we need to add variations into the configurator.

After clicking on the Variations field, a window will pop up containing the following details:

• Name: This dropdown contains all the options available for variation options on Fyndiq.
• Extended Property: This dropdown contains the list of available Extended Properties from Linnworks.
• Default Value: You can add a value here that will be used if the parent/child being listed doesn’t have the correct Extended Property for the Variation.

Click on the save button, and the configurator screen will be updated with the count of 1 instead of 0.

Using the configurator above, we can now almost perform a Variation Listing. We only have to do one more thing.

We have to ensure the specified Extended Property is added to all of the child products for this variation in Linnworks.

egRKZ23579 is a parent product, and has four child products. We therefore have to add the Extended Property Colour to all four children in Linnworks with different colours. If you specify more than one Variation field, you CAN have repeats, but only if no 2 products in the variation group have the same combination of the 2 values.

We can now start variation product listing.

1. For variation listings:

The following are compulsory fields to list on TopHatter with this tool:

1.1 SKU
1.2 Title
1.3 Description
1.4 Tags
1.5 Configurator
1.6 Variation
1.7 Image

SKU, Title, Description, Tags and Images are added as described for single listings.

SKU: Your Linnworks SKU will be used as the Fyndiq Listing SKU.

Title: Initially, the Linnworks item title will be displayed in the Title Text box. You can make changes in this title according to your needs for the listing on Fyndiq. Once the listing is completed here, the same Title will be recorded to use for future changes unless you edit it again.

Note: Please bear in mind the following template to build your product names:

Main brand + Sub-brand, family or product name + Up to 3 key attributes + Generic product type.

Product Names must be clear and concise, and should also be descriptive of the product being sold. This template will help consumers identifying your product.

Description: For adding / editing the listing description, please click on the button in that column. Click Save when finished.

The first time you list a product, the Description will be empty. Once the Description is entered and saved on this screen, and the listing is completed, the same description will be shown on re-entering this screen. After Saving, the description button will change from Empty to Filled.

Retail Price:

By Default, the Linnworks Retail Price will be displayed on this screen.

Tags:

Please Note: Tags are Non-hierarchical keywords or terms assigned to each product in your feed. This metadata helps describe an item, and allows it to be categorised and found again by browsing or searching on Fyndiq.com.

Tags should be comma separated, but do NOT use commas within individual tags. The more tags you add, and the more accurate your tags, the better the chances our users will find your products. There is a maximum of 10 tags allowed per product, more than 10 means that the extra tags will be ignored.

A popup screen with a text box for adding tags will be opened. The user can add a maximum of 10 tags with comma separated values.

Once all tags are added, click on theSave button. This will save all of the tags in the item’s Extended Properties. After saving, the button label will be changed from Empty to Filled

Variations:

By clicking on the Variation button, you will see a list of the Child products for the variation, with the below details.

• SKU: Child product SKU.
• Title: Child product Title.
• Specific Name: If the Colour is specified in the configurator, for example, that will be the title. The child product’s Extended Property value is then display here.
• Quantity: This displays the stock level of the child product in Linnworks’ inventory.
• Subtract Stock: This field derives it’s value from an associated Extended Property. It defaults to Yes if there is no Extended Property. Yes means that the stock level displayed on TopHatter can be reduced or changed by Linnworks.
• Price: This field displays the price of the child product. A +control displays thevalueof the parent product plus this price. This value is set in an Extended Property. If no Extended Property is specified for the Child, then just the default value is shown by the +.
• Points: Points are bullet points to describe the product. They are drawn from an Extended Property.
• Weight: This is drawn from the Inventory item in Linnworks. If you see a +, you will be able to view the weights of the Child items in a Variation group.

Once all of the details are entered, please click on the “Create” button to create the listing.

As with single listings, once the listing is created the status will changed to “Listed”, and the button label will become“Update”. Thecheckbox being checked means this product is visible on the channel.

Oncethe listing is created, the URL column button is enabled. Clicking it opens the Fyndiq page, and displays the listing you created.

<2.3> Edit Listing:

If you want to update the title, price, description, category, imagesor tags on Fyndiq for a listing you have already created, there is the Edit Listing option in the main inventory screen. Regardless of whether it is a single or variation listing, you’ll be directed to the correct options. You can then apply the new details to that product by clicking on the Update button.

The far right-hand column controls the visibility of the listing. If ticked, the listing is visible on the topHatter marketplace. If unticked, it will not be shown to customers.

This document can be accessed by clicking on the Documentation button, and this opens a new tab:

This will be redirected to our documentation URL.

Get your free quote

Call 0208 090 4547

Hear From Our Clients

Best website/e-commerce vendor I've worked with in my 10 years of being an IT PM! We hired eBusiness Guru to create our e-commerce website for our premium brand. This was no easy task as it was not your traditional e-commerce site. They delivered on-time, on-budget, and all with a successful release to the public and established partnership with us. We enjoyed working with the whole team. I would highly recommend them for any website need.
Bastien Peyronnel

Certifications