Tophatter linnworks integration user manual

Tophatter offers customers an entertaining shopping experience with the chance to win items at incredible prices

Sell on Tophatter alongside your other sales channels within Linnworks with our Tophatter connector.

Order Management: Download Tophatter orders to Linnworks, process orders and automatically send dispatch notifications to Tophatter.

Inventory Management: Map your inventory on Tophatter using the Mapping screen and push stock updates automatically from Linnworks to Tophatter.

Step 1: Integrate the Channel into Linnworks.net

The Tophatter connector is an application for Linnworks, developed and supported by eBusiness Guru.

1. Login to Linnworks.net

2. Click Settings in the left-hand menu bar.

User Guide Top Hatter

3. Click Channel Integration.

4. Click Add New to return a list of available Channel Integrations.

User Guide Top Hatter

5. Locate Tophatter on the list, and click Integrate.

User Guide Top Hatter

6. Read the warning; we recommend reviewing the Terms & Conditions. Click Accept to move onto the next step of the integration.

7. Enter your Tophatter account name to start the actual integration, then click Next for the next step.

User Guide Top Hatter

8. After reading the Disclaimer, tick I agree to the terms and conditions and click Next to continue integrating Tophatter.

User Guide Top Hatter

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

User Guide Top Hatter

9.1.2 If you are not already logged in, you will be asked to log in. Enter the login credentials for your admin account.

User Guide Top Hatter

9.1.3 Click Sign In.

9.2 Copy and paste the details into the Tophatter integration API Settings.

API Key – Can be found in your Tophatter account

Default Currency – Your country currency

10. To complete the integration, click Finish. Your Tophatter integration should now show in Linnworks.net under Channel Integrations.

User Guide Top Hatter

Step 2: Edit Channel Details

Account Status

1. In Linnworks.net, select Settings.

2. Select Channel Integration.

3. Locate the Tophatter entry, and click Configuration.

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 click Configuration.

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 an Out of Stock update 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 click Configuration.

4. In the Listings section, the information reflects the data Linnworks currently has about your listed items on the Tophatter marketplace.

5. If there is a tick next to 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 click on Configuration.

4. In the Order section, there are two options.

4a. 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.

4b. The Order Sync Date reflects the date and time of the last successful order download and update for the 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.

Remember to click Save to apply any changes.

User Guide Top Hatter

Step 3: Location Mapping

User Guide Top Hatter

1. In Linnworks.net, select Settings.

2. Select Channel Integration.

3. Locate the Tophatter entry, and click Configuration.

4. Locate and click the Location Mapping button.

5. The Order Download Location initially be set to Default, but can be changed. Click the drop-down list to select which inventory/fulfillment location will receive the orders from this Tophatter integration.

6. Under Inventory Sync Locations, you control which Linnworks Inventory locations are used to calculate the Available Stock values for your Tophatter listings.

7. If you only have the Default location, leave Default enabled.

8. 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.

User Guide Top Hatter Product Listing

Click Save 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 click the Mapping button (see above).

This screen is divided into two sections.

On the left are the listings 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 beside it, Linked and Unlinked 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 Settings button in the top left hand corner (with a gear/cog on it).
2. Select Link All By.
3. Select SKU.
4. Linnworks will map all the 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 create 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 Create.
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, then press Enter.
13. Close the SKU window when you have finished.

Step 5: Shipping Mapping

User Guide Top Hatter

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 click the Shipping Mapping button (see above).

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 Create New.

User Guide Top Hatter

 

Create New Shipping Service Mapping

User Guide Top Hatter

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. Click the Add button to 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.

6. Click Save at the bottom of the channel integration window to apply any changes.

Step 6: Tophatter Product Listing

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

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 a Tophatter 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 Tophatter listing option to proceed.

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

User Guide Top Hatter

Before starting a product listing, we need to add configurators, as you would when listing to Amazon, eBay, etc in Linnworks. To start, click Configurators.

User Guide Top Hatter Product Listing

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

These are displayed with the following columns:

Name: Displays the name of the configurator.
Templates: Displays the count of product listings created using this configurator. Clicking on it displays all of the products listed.
Site: Displays selected site name for this configurator.
Category: Displays the 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 Add New.

2.1.3 Clicking on the Add New button opens a screen:

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

After completing and checking the fields click Save.

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

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

We start by adding a category to the newly created configurator. You can 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. Click Save when you have finished making changes.

User Guide Top Hatter Product Listing

User Guide Top Hatter Product Listing

User Guide Top Hatter Product Listing

User Guide Top Hatter Product Listing

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

User Guide Top Hatter Product Listing

User Guide Top Hatter Product Listing

• 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 User Guide Top Hatter Product Listing 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.

User Guide Top Hatter Product Listing 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.

User Guide Top Hatter Product Listing

 

Single Listings

Clicking on the Create Single Listing option is only possible for visible SKUs, and they must have an Extended Property as below:

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

 

Compulsory fields for Listings on Tophatter

SKU: Your Linnworks SKU will be used as the Tophatter 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 Tophatter requirements. 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 or edit the listing description, click the button in that column. Click Save.

User Guide Top Hatter Product Listing

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.

User Guide Top Hatter Product Listing

Tags:

User Guide Top Hatter Product Listing

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 Tophatter.

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 customers will find your products. There is a maximum of 10 tags allowed per product, if you add more than 10, additional tags will be ignored.

User Guide Top Hatter Product Listing

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

Once all tags are added, click on Save. 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, click on Create. This will send the listing for creation on Tophatter.

If the listing is successfully created on Tophatter, 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 the product 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 Tophatter 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.

 

Variation Listings

For variation item listing, as with single items listings, users must 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.

User Guide Top Hatter Product Listing

Before starting a Variation product listing, 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.

User Guide Top Hatter Product Listing

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

• Name: This drop-down contains all the options available for variation options on Tophatter.
• Extended Property: This drop-down 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 Save, and the configurator screen will be updated with the count of 1 instead of 0.

User Guide Top Hatter Product Listing

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

e.g., RKZ23579 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 two products in the variation group have the same combination of the two values.

User Guide Top Hatter Product Listing

For variation listings:

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

1.1 SKU
Title
Description
Tags
Configurator
Variation
Image

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

SKU: Your Linnworks SKU will be used as the Tophatter 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 Tophatter. 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 or editing the listing description, 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 Tophatter.

Tags should be comma separated, but do NOT use commas within individual tags. The more tags added, and the more accurate your tags, the better the chances our users will find your products. However, there is a maximum of 10 tags allowed per product; where more than 10 are added, 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 Save. 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 the value of the parent product plus this price. This value is set in 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, click Create 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. The checkbox being ticked means this product is visible on the channel.

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

 

Edit Listing

If you want to update the title, price, description, category, imagesor tags on Tophatter 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 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.

Let's get in touch

Give us a call or fill in the form below and we will contact you. We endeavor to answer all inquiries within 24 hours.