Wayfair
The Wayfair plugin allows you to sell your variations on the Wayfair marketplace via PlentyONE. The plugin provides multiple integrations with Wayfair’s interfaces, including - but not limited to - the following operations:
-
Automatic retrieval of Wayfair orders, with conversion to PlentyONE orders
-
Automatic sending of PlentyONE inventory information to Wayfair to keep item availability accurate
-
Automatic transfer of Wayfair-generated shipping documents to PlentyONE
-
Sending order status changes from PlentyONE to Wayfair, to keep Wayfair customers and Wayfair Customer Support up to date.
1. Registering on Wayfair
Wayfair is a closed marketplace. Therefore, you need to register as a Wayfair supplier before using the Wayfair plugin. If you are not currently selling on Wayfair, head to the Wayfair website and register as a partner to get started.
2. Preparations
Using the Wayfair plugin requires Wayfair API credentials that have been granted the appropriate rights.
Prior to installation, use these instructions to contact Wayfair and obtain proper API credentials.
2.1. Retrieving API credentials
In order for the Wayfair plugin to connect to Wayfair’s systems, you need to provide your unique API credentials.
To receive the API credentials for you organization, follow these steps:
2.1.1. Sending an email to Wayfair
Send an email to your Wayfair account manager to request assistance and add johara1@wayfair.com to the CC field.
The email must contain the following information:
Subject |
Access to PlentyONE plugin / (name of your company) (Wayfair Supplier ID) |
Content |
|
You will promptly receive a response containing the following details:
-
Confirmation of your API access being set up
-
Supplier ID(s) for your warehouses
2.1.2. Generating application credentials
Generating application credentials:
-
Enter your Wayfair Partner Home credentials.
→ You will be redirected to the Application Management page for Wayfair. -
Click the New Application button at the bottom of the Application Management page.
→ The New Application form is displayed. -
Enter a useful name for the application, for example
[Name of your company] PlentyONE plugin. -
Enter a useful description for the application, for example
PlentyONE plugin application for [Name of your company] go-live in autumn 2023. -
Use the toggle at the bottom of the dialogue box to set it to Production, unless otherwise instructed by Wayfair.
-
Click Save in the dialogue box to display the application’s credentials.
→ The Client ID and Client Secret are displayed. -
Copy the Client ID and Client Secret. These credentials are required to authorise the Wayfair plugin for use with Wayfair systems.
Important: The Client Secret cannot be retrieved after this point and a new one must be generated if the original is lost. -
Close the dialogue box with the credentials to protect the information.
3. Installing the Wayfair plugin
Now, install the Wayfair plugin in your PlentyONE system.
3.1. Requirements
The following requirements must be met to install the plugin:
-
You have a PlentyONE system.
-
You have administrator rights for the PlentyONE system in which the Wayfair plugin is to be installed.
-
You have generated the Wayfair API credentials as described above and have them to hand.
3.2. Installing the plugin
In order to set up Wayfair in PlentyONE, you have to install the Wayfair plugin in your PlentyONE system.
Adding plugin to the system:
-
Go to Plugins » plentyMarketplace.
→ The marketplace opens in a new tab. -
Navigate to the plugin Wayfair.
Tip: Either use the search function or open the category Plugins » Sales » Marketplaces. -
Open the detail view of the plugin.
-
In the column to the right, click Go to checkout.
→ The Checkout window opens. -
Read and accept the General Terms and Conditions.
-
Click Order now.
→ Wait a few minutes before installing the plugin.
Installing plugins:
-
Go to Plugins » Plugin set overview.
-
Click on the plugin set in which you want to install the plugin.
→ The plugin set opens. -
Click add Add plugin.
-
Select Wayfair from the plugin list.
-
Click Install.
→ The plugin is installed.
→ The plugin set is shown. -
Switch the plugin to active (toggle_on).
-
Save (save) the plugin set.
Tip: Problems saving the plugin set? Click Open details to show additional information.
3.3. Authorizing the Wayfair plugin to access Wayfair interfaces
After installing and deploying the plugin in your PlentyONE plugin set, the plugin must be configured to use the correct login credentials when connecting to the Wayfair interfaces.
Important: The authorisation process must be carried out for each plugin set that contains the Wayfair plugin.
Authorising the Wayfair plugin to access Wayfair interfaces:
-
Go to Plugins » Plugin set overview.
-
Search for the plugin set that is linked to the client with which Wayfair is used.
-
Click on the desired plugin set.
-
Click on the row with the Wayfair plugin to open the settings for the plugin.
→ The Global Settings for the plugin are shown. -
In the Supplier Settings section, enter the Client ID and Client Secret values that correspond with your Wayfair API credentials.
-
Change the Mode setting to Live.
-
Click the Save button in the toolbar above the settings.
-
Repeat these steps for each plugin set in which you use the Wayfair plugin.
4. Setting up the sales channel in PlentyONE
Installed the Wayfair plugin? Great. Now, set up the market in PlentyONE.
4.1. Activating the order referrer
Go to Setup » Orders » Order referrer to activate the order referrer. This ensures that orders are assigned to the correct sales channel.
An order referrer tags an order with the sales channel on which the order was generated. Sales channels can be e.g. your online shop or markets on which you sell your items. Each sales channel has an individual order referrer. Some order referrers are available by default in your PlentyONE system. Further order referrers are added e.g. if you install a new plugin. For further information about the order referrer, see the page Order referrer of the PlentyONE manual.
Activating the order referrer for Wayfair:
-
Go to Setup » Orders » Order referrer.
-
Click Search (search).
-
In the list, navigate to the option Wayfair.
-
On the right of the referrer’s line, click Edit (edit).
→ The window Edit referrer opens. -
Activate the option Visible in selection (toggle_on).
-
Click SAVE (save).
→ The referrer is active.
4.2. Configuring the plugin
Have you installed and deployed the plugin and activated the order referrer Wayfair? Great. Then you can now configure the plugin.
-
Go to Setup » Markets » Wayfair » Home.
→ The Wayfair settings are shown.+ Tip: There are no settings in the tab Wayfair. -
Carry out the settings. Pax attention to the explanations given in Table 1.
-
Click Save.
Important: The settings for each tab are not automatically saved when changes are made. Therefore, make sure to click Save before switching to another tab.
| Setting | Explanation | ||||||
|---|---|---|---|---|---|---|---|
Tab: Stock |
|||||||
Map warehouses |
In this tab, you map the warehouses you use in PlentyONE to the Wayfair supplier IDs you received from Wayfair. The mappings determine from which warehouses inventory is reported to Wayfair and from which warehouses Wayfair orders received in PlentyONE are fulfilled.
Removing a warehouse mapping
|
||||||
Tab Settings |
|||||||
Stock Buffer |
The Stock Buffer setting is a non-negative integer that sets a reserved amount of stock for each variation for each Wayfair supplier ID. The buffer amount is deducted after all other stock calculations have been performed, including aggregating the stocks for multiple PlentyONE warehouses that have been assigned the same Wayfair supplier ID. To disable the Stock Buffer, leave this setting empty, or set it to 0. |
||||||
Default Order Status |
The Default Order Status setting determines which status a new PlentyONE order should have after being created by the Wayfair plugin. Note: The order creation does not qualify as an order status change. If you set the default order status to a value higher than the status values for configured PlentyONE events, some events may fail. |
||||||
Item Mapping Method |
The Item Mapping Method setting determines the behaviour for mapping PlentyONE variations to Wayfair products. It is used when the inventory listings are sent to Wayfair, and also to select the requested products in a Wayfair purchase order.
|
||||||
Import orders since |
The optional Import orders since setting determines a date on which new Wayfair purchase orders are considered eligible for being imported into the PlentyONE system. This setting can improve performance by preventing the Wayfair plugin from requesting orders created before the specified date. It can also be used to prevent the PlentyONE system from accepting orders prior to the desired go-live date. |
||||||
Tab Inventory |
|||||||
Tab Inventory |
The Inventory tab does not contain any configurable settings. The tab is used to check the synchronisation status of the PlentyONE inventory with Wayfair. The page’s data refreshes on a regular basis, as denoted by the timestamp toward the bottom. The top of the Inventory page always displays an icon and a message describing the overall health of the inventory synchronisation process. Information about the symbols on the Inventory tab
Important: Errors are expected if the Wayfair plugin was recently installed and the setup process has not been completed yet. Finish setting up the plugin prior to using the Inventory page again. |
||||||
Tab Ship Confirmation (ASN) |
|||||||
Tab Ship Confirmation (ASN) |
The Ship Confirmation (ASN) page is used for configuring the shipment interactions between PlentyONE, the Wayfair plugin and Wayfair. The information provided here defines the behaviour for the Send Ship Confirmation (ASN) to Wayfair process for orders. The radio button at the top of the page contains the options described below. Wayfair provides suppliers with instructions on selecting the correct value.
|
||||||
4.3. Setting up shipping
Now, set up shipping.
4.3.1. Creating a shipping service provider
Follow these steps to create a Wayfair shipping service provider.
Creating a shipping service provider:
-
Go to Setup » Orders » Shipping » Settings.
-
Click on the Shipping service provider tab.
-
Click + New.
→ A new line is displayed. -
Enter a Name for the shipping service provider.
Tip: We recommend the name WayfairShipping. -
In the Shipping service provider drop-down list, select the option WayfairShipping. All other fields in the row may be left blank.
Tip: The WayfairShipping option is not available? This option is provided by the Wayfair plugin. Ensure that you have installed and deployed the plugin correctly. -
Click Save.
4.3.2. Creating a shipping profile
Each order has a shipping profile that is used to ship items from an order. Follow these steps to create a shipping profile for Wayfair.
Creating a shipping profile:
-
Go to Setup » Orders » Shipping » Settings.
-
Click on the Shipping profiles tab.
-
If a Wayfair row already exists, click on it.
Or: Click New.
→ The settings of the shipping profile are shown. -
Select your Wayfair shipping service provider from the drop-down list.
Tip: If you have created the shipping provider as recommended, it will be called WayfairShipping. -
Enter a Name.
Tip: We recommend the name WayfairShipping. -
Select the language from the drop-down list to the right of the Name field.
-
In the Flag drop-down list, select the icon that will represent Wayfair orders (6 and 126 are good options, as they reflect the Wayfair colour scheme).
-
Optional: Change the priority in the Priority drop-down list.
Recommendation: Keep the highest priority as the default priority. -
In the Clients (stores) field, select all clients that may be set up for Wayfair.
-
In the Order referrer list, activate all Wayfair entries.
-
Click Save at the top of the page.
4.3.3. Automatically sending shipping confirmations
You can automatically send shipping confirmations to Wayfair when the outgoing items have been booked by using one of the following options:
-
Option 1: PlentyONE Flow (recommended)
-
Option 2: Event procedure (old method)
4.3.3.1. Option 1: PlentyONE Flow (recommended)
Create an event-based flow to automatically send shipping confirmations to market} when the outgoing items have been booked.
With PlentyONE Flow (short: "Flow"), you can automate workflows for your business processes. Flow provides you with two functions in the Automation menu:
-
In Flow Studio, you create and configure automated workflows. Depending on the trigger type, there are three types of flows: event-based, time-based or manual.
-
In the Flow Tracker, you can monitor running or completed workflows.
The central element in both functions is the Canvas – a graphical interface on which the workflows are visualised with Actions and Controls. In Flow Studio the canvas can be edited, in Flow Tracker it is only used for visualisation and is therefore read-only.
-
Is this your first time working with PlentyONE Flow? Then read up on the basic concept of Flow first.
-
Go to Automation » Flow Studio.
-
Click Create flow (add).
→ A stepper opens and guides you through the following three steps.-
General
-
Enter a unique name and, if necessary, a description for the new flow.
-
Click Next.
-
-
Trigger
-
Select Event-based as the trigger.
-
Click Next.
-
-
Settings
-
If desired, select a UI from the optional drop-down list Flow available in.
→ The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
Note: UIs currently selectable: Order UI. -
From the drop-down list Trigger selection, select the event according to Table 2.
Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow. -
Save () the settings.
→ The flow is created.
→ The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.
-
-
-
Configure the new flow according to Table 2.
-
Save () the settings.
Note: The selected statuses, controls and filters in Table 2 only serve as an example. Select the statuses, controls and filters for the flow which best suit your workflow.
| Setting | Option | Selection | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Trigger selection |
Select a trigger, for example:
|
Select an order status, for example:
|
|||||||||
Control element |
Branch |
|
|||||||||
Actions |
Plugin (Legacy) > SendWayfairASN |
Send Ship Confirmation (ASN) to Wayfair |
4.3.3.2. Option 2: Event procedure (old method)
Set up an event procedure to automatically send shipping confirmations to Wayfair when the outgoing items have been booked.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 3.
-
Save () the settings.
-
Carry out the additional settings according to Table 3.
-
Select the setting Active ().
-
Save () the settings.
| Setting | Option | Selection |
|---|---|---|
Event |
Order change > Status change |
Select a status, for example:
|
Filter 1 |
Order > Order type |
Order |
Filter 2 |
Order > Referrer |
Wayfair |
Procedure |
Plugins > Send Ship Confirmation (ASN) to Wayfair |
4.3.4. [Optional] Automatically setting the shipping profile
You can automatically set the shipping profile for Wayfair orders by using one of the following options:
-
Option 1: PlentyONE Flow (recommended)
-
Option 2: Event procedure (old method)
4.3.4.1. Option 1: PlentyONE Flow (recommended)
Create an event-based flow to automatically set the shipping profile for Wayfair orders.
With PlentyONE Flow (short: "Flow"), you can automate workflows for your business processes. Flow provides you with two functions in the Automation menu:
-
In Flow Studio, you create and configure automated workflows. Depending on the trigger type, there are three types of flows: event-based, time-based or manual.
-
In the Flow Tracker, you can monitor running or completed workflows.
The central element in both functions is the Canvas – a graphical interface on which the workflows are visualised with Actions and Controls. In Flow Studio the canvas can be edited, in Flow Tracker it is only used for visualisation and is therefore read-only.
-
Is this your first time working with PlentyONE Flow? Then read up on the basic concept of Flow first.
-
Go to Automation » Flow Studio.
-
Click Create flow (add).
→ A stepper opens and guides you through the following three steps.-
General
-
Enter a unique name and, if necessary, a description for the new flow.
-
Click Next.
-
-
Trigger
-
Select Event-based as the trigger.
-
Click Next.
-
-
Settings
-
If desired, select a UI from the optional drop-down list Flow available in.
→ The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
Note: UIs currently selectable: Order UI. -
From the drop-down list Trigger selection, select the event according to Table 4.
Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow. -
Save () the settings.
→ The flow is created.
→ The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.
-
-
-
Configure the new flow according to Table 4.
-
Save () the settings.
Note: The statuses, controls and filters for the flow which best suit your workflow.
| Setting | Option | Selection | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Trigger selection |
Select a trigger, for example:
|
For Order types, select the type Sales order. |
|||||||||
Control element |
Branch |
|
|||||||||
Actions |
Order |
Change shipping profile |
4.3.4.2. Option 2: Event procedure (old method)
Set up an event procedure to automatically set the shipping profile for Wayfair orders.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 5.
-
Save () the settings.
-
Carry out the additional settings according to Table 5.
-
Select the setting Active ().
-
Save () the settings.
| Setting | Option | Selection |
|---|---|---|
Event |
New order |
|
Filter 1 |
Order > Order type |
Order |
Filter 2 |
Order > Referrer |
Wayfair |
Procedure |
Order > Change shipping profile |
Select shipping profile for Wayfair |
5. Preparing variations
Now, prepare your variations.
5.1. Setting the variation availability
You need to activate the variations that you want to sell on Wayfair. This is done in the Availability and visibility section of a variation within the Item » Items » [Open item] » [Open variation] menu.
Making a variation available for Wayfair:
-
Go to Item » Items » [Open item] » [Open variation].
Tip: To sell all variations of an item on Wayfair, carry out the settings for the item’s main variation. If the inheritance function is active for the variations, then this activates the availability of all variations of the item. -
In the Availability and visibility section, activate the option Active.
-
In the Sales channels section, click Add sales channels (add).
→ The window Add sales channels opens. -
In the drop-down list Sales channels, select the option Wayfair.
-
Click Apply.
→ The sales channel is added. -
Save () the settings.
→ The variation is available for Wayfair.
Use the variation group function to edit multiple variations at once. You select the variations that you want to edit.
Making several variations available for Wayfair using the variation group function:
-
Go to Item » Items.
-
Select () the variations to be edited.
-
In the toolbar, click on layers » layers Variation group function.
→ The Variation group function window opens. -
Select the action Sales channels from the drop-down list Actions.
→ The action is added to the lower part of the window. -
In the drop-down list Sales channels, select the option Wayfair.
-
Select the action Active from the drop-down list Actions.
→ The action is added to the lower part of the window. -
Activate the option Active.
-
Navigate to the area Availability.
-
Click Execute to apply the settings.
Batch processing allows you to edit several variations at once. You use filters to limit which variations are edited.
Making several variations available for Wayfair using batch processing:
-
Go to Item » Batch processing.
-
Click on the tab Variations in the upper left corner.
-
Use the filters on the left to specify which variations should be processed.
-
Navigate to the area Market availability.
-
Activate the checkbox to the left of the option Wayfair.
-
Activate the checkbox to the right of the option Wayfair.
-
Navigate to the area Availability.
-
Activate the checkbox to the left of the option Active.
-
Activate the checkbox to the right of the option Active.
-
Click on Apply to apply the settings to the variations.
6. First inventory synchronisation
Once you have set up the sales channel, your variations will be automatically exported to Wayfair. Proceed as follows to verify that the first inventory synchronisation has taken place:
-
Go to Setup » Markets » Wayfair » Home.
→ The Wayfair settings are shown. -
Click Inventory.
-
Wait a minute while the system updates inventory information.
-
Review the information displayed on the page.
-
If problems are reported for the complete inventory synchronisation:
Try to resolve these problems by reading the information for the Inventory page, checking the PlentyONE logs and referring to the chapter Troubleshooting: Common issues.
-
A calendar icon will be displayed if the Wayfair plugin has not yet attempted to synchronise stock.
-
This happens right after the plugin is installed.
-
This may happen if the plugin was recently updated.
-
The page changes within 15 to 30 minutes once the synchronisation is initiated.
-
-
A *cloud with a checkmark* will appear if the Wayfair plugin is regularly synchronising inventory without detecting any issues.
-
A crossed-out cloud will appear if the Wayfair plugin detects irregularities in inventory synchronisation.
-
An arrow pointing upwards to a cloud indicates that an event is currently taking place. This event will be described once it has been completed.
Important: Errors are expected if the Wayfair plugin was recently installed and the setup process has not been completed yet. Finish setting up the plugin prior to using the Inventory page again.
Tip: In the chapter Troubleshooting: Common issues, you will find suggestions for resolving issues with inventory synchronisation.
7. Troubleshooting: Common issues
Before contacting Wayfair, use the following table to diagnose issues within the Wayfair plugin yourself.
| Problem | Possible reasons |
|---|---|
General lack of data coming from Wayfair or going to Wayfair |
|
An item is missing from inventory sent to Wayfair |
|
The inventory amount sent to Wayfair for an item is less than the expected value |
|
No orders coming from Wayfair |
|
Orders coming from Wayfair are not properly getting associated with items in PlentyONE |
|
Warehouses are missing or incorrect for orders coming from Wayfair |
|
The button for downloading shipping labels is not displayed in the Overview of an order in the PlentyONE Shipping centre. |
|
Inventory updates are not sent to Wayfair |
|