Wayfair: marketplace guide

About this guide

This is a ChannelEngine guide on the Boston-based marketplace Wayfair. Here you can find information on how to request a Wayfair account, how to configure this marketplace on ChannelEngine, what the specific requirements are, and more.

Table of contents

Commercial information

How to request an account

Associated costs

Marketplace features

Settings and configuration

Marketplace-specific requirements and exceptions

• Setup
• Mappings
• Listed products
• Activation

Additional information

Commercial information

Founded	August 2002
Founder	Niraj Shah and Steve Conine
Headquarters	Boston, Massachusetts, United States
Area served (orders)	Canada, Germany, United Kingdom, United States
Revenue	USD 14.145 billion (2020)
Number of active customers	31.19 million (2020)
Website	Wayfair
Setup cost	none
Commission	none
Other costs	none
Payment	Wayfair pays their partners the wholesale cost of their items, and sets their own retail prices
Product categories	furniture, decoration, housewares, garden, and other home goods
Input language	English
Input currency	depends on the country
Content creation	no
Profile on ChannelEngine	Wayfair

How to request an account

To request a Wayfair supplier account, go to Partner with Wayfair and enter all the required information. Note that Wayfair relies on dropship suppliers. If you plan to sell on Wayfair, you must look into their dropship business model – Wayfair does not offer their own logistic fulfillment service, unlike Amazon and bol.

Associated costs

When it comes to costs and payments, Wayfair is not like most other marketplaces. Instead of using a commission system, Wayfair pays their partners upfront for their products, setting their own retail prices on their website.

For more information on Wayfair's business model check out the Sell with Wayfair website.

Marketplace features

Supported	Not supported
Product offers1	Product content2
Orders	Pricing
Shipments	Cancelations
Carrier mapping (if enabled)	Returns
Multiple stock locations	Categorization
	Repricing
	Sales channels3

¹ Only stock updates are supported.

² Wayfair does not support any automated content connection, so you need to manually submit a content file within the Wayfair back-end to create products. There are no advanced order actions either, such as returns or cancelations. These have to be handled either manually or through Wayfair's customer service.

³ A marketplace that supports sales channels allows merchants to list and sell products across multiple markets (e.g.: countries, regions, and states), all from the same connection.

Settings and configuration

Setting up each marketplace on ChannelEngine follows the same flow, though not every marketplace includes the steps listed below.

1. Go through the Setup.
2. Create a Product selection.
3. Complete the Categorization.
4. Set up the Mappings: content, offers, and carriers.
5. Configure the Pricing: rules and currency conversion.
6. Finish the Activation.
7. Check the Listed products overview.

Marketplace-specific requirements and exceptions

Setup

On Wayfair

1. Log into the Wayfair back-end and go to User management.
2. Click the pencil icon to edit your active account.
3. Under the Access permissions section, select the API box and click Save.
4. Go to the Application management page and click the Edit button.
5. If you already have an application set up, copy the Client ID and Client secret of the existing sandbox to test the connection between ChannelEngine and Wayfair. Skip step #6.
6. If you do not have an application set up, click + New application to create testing and production applications. Copy each application's Client ID and Client secret.

On ChannelEngine

1. Go to the Setup page of your Wayfair channel and enter Client ID and Client secret associated with your sandbox under the Connection section.
2. Ask your contact person at ChannelEngine or a member of the Support team to enable the Use sandbox setting, so you can test the connection with Wayfair.
3. Once the testing is done, replace the sandbox credentials with your production credentials on ChannelEngine.
4. Ask your contact person at ChannelEngine or a member of the Support team to disable the Use sandbox setting.

On Wayfair

1. Go to the Integration status page on Wayfair and access your production application.
2. Click View/Update by the Purchase order API and switch the Live in production setting from No to Yes.
3. Repeat that process for the two other APIs: Ship notice and Shipping.

The following information must be added to ChannelEngine on the Setup page:

• Supplier ID 1-10 - the ID of each Wayfair warehouse you are going to use. See the Mappings section of this guide.
• Send using Wayfair's carrier account - enable this option to use Wayfair's selected carrier. If you have your own logistical partner, leave this option disabled and use the carrier mapping.

Mappings

There are no content mappings on Wayfair.

Offer

All products (required)

• Stock at 1 - the product's stock at the warehouse identified by Supplier ID 1 on the Setup page.

All products (optional)

• Stock at 2 - the product's stock at the warehouse identified by Supplier ID 2 on the Setup page.
• Stock at 3 - the product's stock at the warehouse identified by Supplier ID 3 on the Setup page.

Carrier

To use your own carriers to ship Wayfair orders, you need to set up carrier mapping. Make sure that Send using Wayfair's carrier account is not enabled. This is mandatory, as Wayfair only accepts their specific carrier codes. For an overview of Wayfair's carrier codes, check out the list below:

Carrier name	Carrier code on ChannelEngine
BJS Distribution	BJSH
DHL Freight Deutschland	DFDE
DHL Freight Network	DFFN
DHL Home Delivery GmbH	DHWG
DHL Paket Deutschland	DHDE
DHL Paket UK	DHUK
DHL Parcel UK	UKML
DPD	DPDD
DPD Deutschland	DPDE
DX Freight - 1 Man	NIDW
GEL Express Logistik GmbH	GEL1
GLS - UK	GLUK
GLS - DE	GLDE
Hermes Einrichtungs Service	HRMS
Hermes World	HRSP
IDS Logistik GmbH	IDS
Jan Krediet	JANK
LGT Logistics A/S	LGTL
Network 4 - 2 man	NWUK
Panther	PROM
Rhenus Home Delivery	RSHD
Rhenus Poland [FN]	RHPLFN
SEUR	SEUR
Supplier shipping in own trucks	SSOA
SUUS Logistics SA	SUUS
UPS - DE	UPDE
UPS - UK	UPUK
XDP	XDPE

If your carrier is not listed above, such as PostNL or bpost, you can use SSOA as the carrier method.

Listed products

Wayfair does not provide feedback on the Listed products page.

Activation

Next to the mandatory settings displayed in the Activation overview, Wayfair also requires you to fill out your invoice settings. To ship items at Wayfair, an invoice must be included in the export.

Additional information

Order extra data items

When an order is imported to ChannelEngine, ChannelEngine also fetches extra data items related to the order itself – or to order lines. This extra data is specific to this marketplace. An explanation of each can be found below: 

Order extra data

Key	Conditional	Description
shipping_method	Yes	The carrier code related to the shipment method selected to fulfill the channel order.
ship_speed	Yes	The transit time taken from the shipping information of the channel order.
estimated_ship_date	Yes	The estimated shipping date of the channel order.
warehouse_id	Yes	The supplier id for the channel order.

* Conditional fields are only displayed if the marketplaces provides a value. 

FAQs

Why do all orders have the order date time 00:00?

All Wayfair all orders in ChannelEngine have a 00:00 timestamp.This is because Wayfair does not supply a specific order time for new orders. As the time is left empty, this is automatically displayed as 00:00. Unfortunately, there is no way for us to get the true order and therefore Wayfair orders will always show the time as 00:00 (until Wayfair changes something on their end). ChannelEngine does not change the DateTime when creating orders as this could cause errors related to the following scenarios:

• When Wayfair is having issues with exporting orders via their API connection.
• When ChannelEngine is having issues with importing orders from Wayfair.
• When an order is placed around 23:59/00:00. In that case, the order date could be day one, but ChannelEngine's created date is on day two. If your logistic has a cut-off time around that moment, this will pose issues for the orders affected.