Wayfair: (drop shipment) marketplace guide

About this guide

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

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

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 become familiar with its dropship business model.

Associated costs

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

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

Marketplace features

¹ Only stock updates are supported. Price updates are not supported; Wayfair sets its own prices.

² Wayfair does not support an automated content connection; you need to manually submit a content file on the Wayfair platform to create products. There are no advanced order actions either, such as returns or cancelations. These have to be handled manually or via 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 channel on ChannelEngine follows the same flow, though not every channel 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. Fill in the Stock settings.
7. Finish the Activation.
8. Check the Listed products overview.

Marketplace-specific requirements and exceptions

Setup

On Wayfair

1. Log in to the Wayfair platform 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

Set up a sandbox 

1. Go to the Setup step of your Wayfair channel and in  Connection, enter Client ID and Client secret associated with your sandbox.
2. Ask your contact person at ChannelEngine or a member of the Support team to enable your sandbox settings in your Wayfair plugin.

Plugin specific settings

• Send using Wayfair's carrier account - automatically fill Wayfair's recommended carrier as your shipment method when creating your shipment. 
• Enable shipping labels - indicate if you want to import shipping labels from Wayfair to download directly from ChannelEngine. Please note that any associated fees or costs are determined by Wayfair — for pricing inquiries, contact Wayfair support.
• The default stock location - the ID of your default stock location. 
• Enable to use multiwarehouse support - use Wayfair's warehouse management feature. 
  • If Yes, then The default stock location field does not appear.

Invoice settings

You must include an invoice with your shipments. To configure your invoice settings:

1. Go to Settings, Invoice settings from the sidebar menu. 
2. Configure the invoice fields according to Wayfair's invoice requirements.

Move to production

1. Once the testing is done, replace the sandbox credentials with your production credentials on ChannelEngine.
2. Ask your contact person at ChannelEngine or a member of the Support team to enable your production settings in your Wayfair plugin.
3. On Wayfair, go to the Integration status page on Wayfair and access your production application.
4. Click View/Update by the Purchase order API and switch the Live in production setting from No to Yes.
5. Repeat that process for the two other APIs: Ship notice and Shipping.

Categorization

There is no categorization on Wayfair.

Mappings

Content

There are no content mappings on Wayfair. 

Offer

Required

• Price before  (re)price rules - the selling price of the item. 
• Stock at 1 -  the stock level at the given stock location. 

Carrier

If you prefer to specify which carrier to use in your shipments, you must do carrier mapping because Wayfair only accepts its specific carrier codes in its shipments. If you do carrier mapping, make sure that Send using Wayfair's carrier account is not enabled in Setup, Plugin specific settings. If you use your own shipment account, map your shipping method to [SSOA] Supplier Own Account.

Listed products

Wayfair does not provide feedback on the Listed products page.

Additional information

Order extra data items

When an order is imported to ChannelEngine, ChannelEngine also retrieves 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

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

Shipments

You must include an invoice in all shipments.

Wayfair requires you to use a specific set of carriers. View the list of Wayfair's supported carriers at Mappings, Carrier mappings:

1. For an overview of Wayfair's carrier codes, go to Mappings, Carrier mappings. 
2. Add a shipping method with + Add.
3. Open the dropdown list in the Channel field. 
4. Each of Wayfair's supported carriers appears as [carrier code] Name of carrier. The code enclosed in square brackets [ ] is the carrier code. E.g.: the code for [STRM] Streamline / UK is STRM. 
5. If you use your own shipment account, use SSOA.

To retrieve Wayfair's shipping labels, follow the guidelines in Merchant API: shipping labels (last-mile delivery).

FAQs

Why do all orders have the order date time 00:00?
All Wayfair orders on 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 has issues with exporting orders via its API connection.
• When ChannelEngine has 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 logistics has a cut-off time around that moment, this will pose issues for the orders affected.