Wish User Manual

Import and manage orders, inventory, product listings & price updates with the Wish channel integration for Linnworks. Wish is the #1 mobile eCommerce platform in Europe and North America.

The Wish marketplace has over 200 million shoppers from 70 countries across the world. Wish is growing at a phenomenal rate, gaining an average of 250,000 new shoppers and a whopping sales of 1.5 million products daily.

Almost all Wish purchases are placed on a mobile device; the Wish marketplace is fully optimised for the perfect mobile shopping experience.

Wish provides a recommendation-based shopping experience. It takes social cues like customer age, gender, and purchase history into account, to proactively recommend products to customers. This results in a targeted feed of products, similar to Pinterest or Instagram, so customers only see products that they are likely to be interested in.

When a seller joins Wish, their products are categorised, and feature on the Wish app as well as (where appropriate) their sister sites Cute, Geek, Home, and Mama.

EU sellers can take advantage of promotional programs such as Wish Express to boost their sales and profits, as well as Product Boost which is open to all sellers. With no listing, monthly, or promotional fees, Wish sellers can enjoy a risk-free merchant experience, only payinga small commission on sales.

Sellers can sign up for a Wish merchant account by clicking here.

The eBusiness Guru Linnworks integration for Wish supports order downloads and confirmation of shipping. It also supports available Stock Level control, Price Updates and Product Listing.

£24.99 + VAT per month

Step 1: Integrate the Channel into Linnworks.net:

To use Wish, you must first install it from within Linnworks.net

1. 1. Login to Linnworks.net
   2. Select Settings in the left-hand menu bar.

1. 1. Select the Channel Integration option.
   2. Select Add New to return a list of available Channel Integrations

1. 1. Locate Wish on the list, and click Integrate.

1. 1. 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 Wish Connector’s Terms and Conditions first.

1. 1. Enter your Wish account name to start the actual integration.

1. 1. After reading the Disclaimer, tick ‘I agree to the terms and conditions’ and click Next to continue integrating Wish.

1. To integrate your Wish account, you will need the following information:A) Get Client ID / Client Secret :If you do not have the Wish Private app you need to create this.1. To create your Private app, open this link : https://merchant.wish.com. After you log in, navigate to the Settings page, located in the Account menu (on the right of the navigation bar).

   

   2. Select API Settings from the left hand panel. The Create a Private App form will displayed, as below :

   

   3. Enter the app name : Linnworks Integration In ‘Redirect URL you must enter https://ebusinessguru.it/Wish/gettoken. Click the Create App button.

   4. The confirmation page will open for Private app. Click Confirm.

   

   5. After you Click to create your app, the following form with Client Id and Client Secret should be displayed.

   

    

   B) Get Authentication Token / Refresh Token :

   1. Open this link. You should now see the following form to enter your Wish Client ID and Client Secret.

   

   2. Enter your Wish client ID and Secret, then click Submit. When the below page opens, Click Log In.

   

   3. Enter your login credentials of your Seller / Merchant Account.

   

   4. Click Log In.

   5. The next page asks you to confirm the permissions you’re giving the integration on your Wish account. Click Confirm.

   

   4. Confirm the access you are giving the integration again. Click Confirm.

   

   5. The next page provides the Access and Refresh tokens for the integration.

   

   6. Copy and paste these into the Wish integration in API settings page.

    

   C) Default Country:

   This is the region or country for the Wish channel you are integrating, eg. UK, Italy, Brazil. By default India is selected.

    

   D) Click Next to continue

   

Step 2: Edit Channel Details:

Account Status

1) In Linnworks.net, select Settings.

2) Select Channel Integration.

3) Locate the Wish entry, and click on the Configuration button (on the right).

4) To Enable or Disable the Account, locate the Account section.

5) If the Enabled option is unticked, 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 Wish 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 Wish entry, and click on the Configuration button (on the right).

4) In the Inventory section, the first entry is Update Inventory. If this is disabled, then Linnworks will not tell the listings on the Wish 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 Wish 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 Wish 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 Wish 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.

<br

Order Settings

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

1. In Linnworks.net, select Settings.

2. Select Channel Integration.

3. Locate the Wish 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 Wish.

6. The Order Sync Date reflects the date and time of the last successful order download and update for the current Wish 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 Wish 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 Wish entry, and click on the Configuration button (on the right).

4) Click the Location Mapping button.

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 drop-down list and select which inventory/fulfillment location will initially receive the orders from this Wish integration.

7) Under Inventory Sync Locations, you can control which Linnworks Inventory locations are used to calculate the Available Stock values for your Wish listings.

8) If you only have a Default location, this can be ignored, with Default left enabled.

9) If you have multiple Inventory Locations, you can switch off locations that you don’t want to be included in the stock numbers on the listings by sliding the switch to the left.

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.

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 Wish. 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 Wish entry, and click on the Mapping button (see above).

This screen is divided into two sections.

On the left are the listings Linnworks is aware of on your Wish 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 Settings button in the top left hand corner (with a cog/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 the listing 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 matching 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 in the Inventory.

5) You can 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 Wish.

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

9) Enter the SubSource as the name of the Wish 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.

Step 5: Payment Mapping :

1. In Linnworks.net, select Settings.

2. Select Channel Integration.

3. Locate the Wish entry, and click the Payment Method button (as above, located on the right).

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 Wish 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 Wish Payment Methods

1. Select the Channel Payment Method value, and select one of the Payment Methods from Wish that show in the drop-down list.

2. Click the Linnworks Payment Method drop-down. Select the appropriate Linnworks Payment Method that should be used in Linnworks orders when they are downloaded including the above payment method.

3. Press Add to save the mapping, and return to the list.

4. Repeat this for all of the Wish payment methods that you wish to use.

5. Click Save at the bottom of the channel configuration window to apply any changes.

Step 6: Shipping Mapping:

The next step is to map your Wish 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 Wish entry, and click the Shipping Mapping button (see above, found on the right).

4. In the Edit Shipping Allocation window, you should see an empty list.

5. To add a new entry for one of your Wish shipping services, click on Create New.

 

Create New Shipping Service Mapping

1. For Channel Service Name, enter the name of the Shipping Service in Wish.

2. In Channel Service Tag, enter the Tag Value used for the service in Wish.

3. In the Linnworks Postal Service drop-down menu, select the name of the Linnworks Postal Service that should be used for orders imported from Wish 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 Wish 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 7: Product Listing:

Requirements:

Wish channel must be integrated in Linnworks.net

While integrating Wish, the Channel Name (Subsource) used must be defined in product’s extended property as below:

Property Name: Test7777 (Name of the sub source)

Property Value: true

Property Type: Attributes

 

Product must have at least one image inserted in Linnworks.

Stock must be greater than 0.

Price must be greater than 0.

 

Using Wish Product Listing:

1. Once the Wish channel is integrated in Linnworks, on the left side of menu screen, the Apps button will appear, and when clicked, the apps list are displayed. Click the Wish Listing option.

 

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

 

2.1 Before starting product listing, add Configurations. For that, click the Configuration button.

 

2.1.2 Once clicked, main screen displays the created configurator.

Main screen display with following column:

Name: This displays the configurator name that is already created.

Templates: This displays the count of products and how many products are created. Clicking it displays the entire product list.

Site: This displays the selected site name.

Specification: Displays the count of specifications added. Used for single product listing, not mandatory.

Variations: Displays the count of variations added. This is use for variations product listing. This field must be configured.

Show: Choose to display the listing screen or not.

If Show Checkbox is not ticked, that configurator is not display on the product listing page.

For add a new configuration click on Add New button.

 

2.1.3 Clicking on the Add New button option opens a screen with these details:

Name: Enter the configurator name.

Site: This drop-down field contains the entire Wish channel account name (Subsource) from Linnworks.

 

After completing the required details, click the Save button.

 

2.1.4 For single product listing, newly created configurator is added to the main screen (as displayed below).

For a single product listing, it is not necessary to add a specification

 

After creating a configurator, open the Inventory screen.

 

Header menu displays with following column:

Select Site: This drop-down field contains the entire Wish channel account name (Subsource) from Linnworks. When you select the site product list, the integration displays the site you selected.

Search: Allows you to filter your products as you require. Filter by SKU, Title and barcode.

Main screen displays with following column:

Before the SKU column, if you see a blank value, it means the product is single, there is no child product.

If you sees symbol it means this product is variation product, there is a child product. By clicking on that symbol you can see the child product list.

SKU: This field displays the product name.

Title: This field displays the product title.

Barcode: This field displays the product barcode value.

Retail Price: This field displays the retail price of the product.

Level: This field displays the level of the product of Linnworks.

Open Orders: This field displays the count of open orders in Linnworks in which the product is associated.

Available: This field displays the number of products available in Linnworks.

Create Listing: Allows the operation of single and variation Listings.

This symbol indicates that this product is not created in the Wish channel. Product Listing is not completed. Use this product for Listing.

 

On clicking this field, three options are displayed

1. Edit Listing

2. Create Single Listing

3. Create Variation Listing

If product is single, you can select Create Single Listing. When you click on the Create Single Listing option, the configurator list will be displayed.

Select you preferred option. After clicking on the configurator it will redirect to the single listing page.

 

On clicking this field, three options are displayed

1. Edit Listing

2. Create Single Listing

3. Create Variation Listing

 

If product is variation, then you can select Create Variation Listing only; other options will be disabled. When you click on the Create Variation Listing option, the configurator list is displayed. Select an option. After clicking on the configurator, it will redirect to the Variation Listing page.

This symbol indicates that, this product has been created in the Wish channel. Product Listing is done. You can use this product in the Wish channel.

On clicking this field, three options are displayed

1. Edit Listing

2. Create Single Listing

3. Create Variation Listing

You can select Edit Listing option only, other options will be disabled.

Create Listing operation is disabled.

 

Single Listing:

2.1.5 When clicking on Create Single Listing, the configurator screen is opened with SKUs that have the extended property as below:

Name: Subsource (In this example Test7777)

Value: true

 

1. If you want to list the Linnworks SKU on Wish store, ensure to follow the points below:

There are compulsory fields to create listing on Wish as below:

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: By default, the Linnworks SKU will be used for Wish Listing SKU.

Title: By default, the Linnworks title will be displayed in the Title Text box. Changes can be made according to requirements on Wish. When the listings are done through this integration, next time whatever title has been sent to Wish, the same title will appear from Linnworks on this screen.

Note for Title: Using this template to build your product names will help consumers identifying them: 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.

Description: For adding / editing description, please click on button.

Complete the description and click Save.

 

For the first time, the Description text box will be empty, to allow the user to describe their product on Wish. When the description is saved, on this screen and listing is done through this app, next time whatever description has been sent to Wish, that description will appear from Linnworks on this screen. After saving the description, that button value will be change from Empty to Filled.

Retail Price:

By default, the Linnworks Retail Price will be displayed on this screen. To update the retail price, edit it here.

 

Tags:

 

Please Note: Tags are non-hierarchical keyword or terms assigned to each product in your feed. This kind of metadata helps describe an item and allows it to be categorized and found again by browsing or searching on Wish. Tags should be comma separated, but do NOT use commas in 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, if you add more than 10 we ignore the extra tags.

 

Popup screen with 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 Save. This will save all tags in item’s extended properties. Same details will be sent to Wish when you click Create Listing. After you click Save, the tags for that button value will be changed from Empty to Filled.

Next time you edit these tags, the same tags saved when you created your listing will be displayed here.

Configurator:

In this field the configurator name is set as you selected for the listing operation.

This drop-down is disabled; you can’t change the configurator value here.

 

Create Listing:

If listing is not done, status column colour will be Yellow and status will be Not Listed

Once the title, price, description and tags have been added and updated, click on Create. This will create the listing on Wish.

If listing is successfully created on Wish, the status will be changed to Listed and the colour will be changed to Green.

When the button is changed to update and the checkbox is checked, this product is enabled in the Wish channel.

 

Using the Configurator, products are created in the Wish channel. The Configurator screen should now look similar to the screen below. Note that the Templates field is updated with one because we created just one product in Wish.

 

When you click on the Template field, it opens with the following details:

SKU: Product SKU name display created for Wish using this configurator.

Name: Product title display.

Listed On: This field display the date of which date product is created.

 

2.2 Variation Listing:

For Variation item listings, as above, user needs to add

Name: Sub source (In this example Test7777)

Value: true

Linnworks parent product.

On Variation listing screen, only parent items with extended property as Subsource: true will be displayed.

Also add extended property for parent product price. It is mandatory to add a price in parent product; it should not be created in the Wish channel.

 

2.1.1 Before starting variation product listings we need to add configurator for it.

Follow the Configurator screen details as above in single product listing.

But for variation product listings we need to add variations in the added configurator.

 

After clicking on Variations screen will display with below details,

Name: This drop-down contains the list of options from the Wish channel. We have two options; colour and size. In this example, we use the colour option. You can do with size also and you can also use both options.

Extended Property: This drop-down contains the entire extended property list from Linnworks.

Default Value: In this option, users can add a default value for it.

Clicking on the Save button details will be saved. The configurator screen will be updated with the count.

 

Using this configurator, we can do the variation product Listing.

Next, set the extended property value for the entire child product in Linnworks.

The example here 001-v is a parent product and it has two child products so we have to add extended property [Colour] value in all two child value in Linnworks.

Child Products:

1. 001-v1

2. 001-v2

 

1. For Variation Listings:

There are compulsory fields to create listing on Wish as below:

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 same as described above for single listing.

Variations:

Click on Variation to display the entire Child products with the details below.

• SKU: Child product SKU name is displayed.

• Title: Child product title is displayed.

• Colour: Child product extended property value is displayed here. We have to add in the entire child products.

• Quantity: This field displays the stock of child products from Linnworks.

• Price: This field displays the price of child products from Linnworks.

 

When all fields are completed, click on Create to create the listing.

As with single listings, once the listing is created, status will be changed to Listed. When the button shows Update and checkbox is checked, it means the product is enabled in the Wish channel.

 

2.3 Edit Listing:

To update title, price, description, category, images and tags on Wish for the listings already created, click on the Edit Listing option on the main inventory screen. This will redirect accordingly, depending on if it’s a single or variation listing. You can update the details of that product by clicking on update button. This functionality is same for single product listings and variation product listings.

 

You can also enable or disable product on Wish by clicking on the last column checkbox.

If the checkbox is ticked, this product will be enabled on Wish with Enable status.

If the checkbox is clear, this product will be disabled on Wish with Disabled status.

Document can be accessed by clicking on Documentation as below:

 

This will be redirected to our documentation URL.

Step 8: FAQs: style>
.faq-section h2{
font-size: 12pt;
font-weight: bold;
color: #000;
margin-bottom: 8px;
}
.faq-section table thead th{
background: #cccccc;
padding: 4px 8px !important;
}
.faq-section table{
border-collapse:collapse;
margin-bottom: 30px;
}
.faq-section table tr th,
.faq-section table tr td{
padding: 6px 8px;
margin: 0px;
border: 1px solid #000;
width: 40%;
font-size: 13px;
line-height: 1.5em;
text-align: left;
}
.faq-section table tr th:last-child,
.faq-section table tr td:last-child{
width: 60%;
}