Wayfair

Wayfair is a popular furniture and home goods marketplace in the US and UK. Wayfair integrates directly with ShipStation to automatically import your orders so you can start shipping quickly. ShipStation will automatically notify your Wayfair account with each order's shipment details as soon as you create each label.

If you haven't already, sign up to become a Wayfair partner!

Wayfair Requirements

Connection Requirements:

  • An active account with Wayfair.

  • Wayfair Client ID and Client Secret.

    To get these, you'll create a New Application for ShipStation within Wayfair to generate a fresh Client ID and Client Secret.

    Caution

    Client Secret IDs are inaccessible once the pop-up closes.

    Do not close the Client Secret pop-up until you have taken a screenshot or copied the Client ID and Secret to a separate document where you can refer to them later.

  • Wayfair Sandbox application to test API endpoints

  • Submit a request to Wayfair for a Production application after you've completed testing in the Sandbox application.

Order Import Requirements:

  • Must include a Ship To address.

  • All orders must be in accept status before they can import into ShipStation.

Connect a Wayfair Store to ShipStation

To complete the connection, you'll need two browser windows open: one for ShipStation and one for Wayfair.

To connect your Wayfair store to ShipStation:

  1. Select Wayfair.

    Wayfair logo tile. Button that reads, Connect

    This will open the connection pop-up in ShipStation. To proceed further, you will need information from your Wayfair account.

  2. Open a new browser tab, then log in to your Wayfair account portal with your Wayfair username and password.

  3. Visit the User Management page in Wayfair's Partner Home portal and grant your account the API Access Permission

    Note

    Only Account Administrators can grant this permission.

  4. Go to the Applications tab in the side menu then click + New Application. After you click this button you’ll see a Create Application pop-up.

    Wayfair_Applications_New_Application_MRK.png
  5. Enter a Name and Description for the new application into the Create Application pop-up. These can be anything, but calling it ShipStation will help to identify its purpose and use.

  6. Toggle the selection from Sandbox over to Production, then click Save. This will open the Client Secret pop-up.

    Wayfair_Create_Application_PU_MRK.png
  7. Copy your Client ID and Client Secret from the Client Secret pop-up in Wayfair.

    Client Secret IDs are inaccessible once the pop-up closes.

    Do not close the pop-up until you have taken a screenshot or copied the Client ID and Secret to a separate document where you can refer to them later.

    Wayfair_ClientSecret_PU_MRK.png
  8. Return to your open browser tab with the open connection pop-up in ShipStation.

  9. Copy and paste your Wayfair Client Id and Client Secret into the corresponding fields in the ShipStation pop-up. Then click Connect.

    Wayfair connection screen, shows fields for Client secret and Client ID
  10. Submit an API setup ticket with Wayfair by selecting Inventory & EDI >Set Up an Inventory Feed or EDI Connection with Wayfair from the drop-down menus, then select the API Integration option and enter the comments: "We will be setting up via ShipStation."

    Afterward, the Wayfair associate assigned to your ticket should grant the PO and ASN scopes without any testing required since the setup is via ShipStation, setting the integration live.

After you've completed the connection steps, the store's Settings page will open. You can adjust your store-specific settings like branding and customer notifications, if you wish. Or click Save to close.

Available Features for Wayfair

The ShipStation integration with Wayfair supports the following standard features:

Order Status Mapping

ShipStation Status

Wayfair Status

Awaiting Payment

N/A

Awaiting Shipment

accept

Shipped

shipment

Cancelled

N/A

On Hold

N/A

Data Sent with Shipment Notification

This table indicates which data ShipStation sends to Wayfair with the marketplace shipment notification:

Field

Sent to Marketplace?

Status Update

Green checkmark. Supported feature. Yes.

Tracking Number

Green checkmark. Supported feature. Yes.

Carrier

Green checkmark. Supported feature. Yes.

Service

Green checkmark. Supported feature. Yes.

Carrier Fee

Green checkmark. Supported feature. Yes.

Note to Buyer

Red X mark. Unsupported feature. No.

Item Information

Red X mark. Unsupported feature. No.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Wayfair Integration Notes

  • You must manually process cancellation requests in Wayfair’s vendor portal. (Log in to Wayfair for access.) The line items for the order in ShipStation will never change, but your customer can request that you cancel an item.

  • Doublecheck that your order data is correct before importing as your Order data cannot change once the order imports into ShipStation. After the initial order import, ShipStation will not receive any subsequent updates.

Troubleshooting Tips for Wayfair

Here are some common issues experienced by users, potential causes, and available troubleshooting tips.

Issue

How to troubleshoot or resolve

Error: CODE: 7001 - The supplied value '{sourceAddress.country}' for sourceAddress.country should be a 2 or 3 character country code.

Error: CODE: 7002 - The supplied value '{destinationAddress.country}' for destinationAddress.country should be a 2 or 3 character country code.

Country fields have a limit of three characters and will truncate any letters beyond that limit. Replace the supplied value with an ISO Alpha-2 or Alpha-3 Numeric Country Code.

Inventory Errors

Fatal Errors

These errors mean your request was not processed. Please fix the issue causing the error and re-submit the request.

Issue

How to troubleshoot or resolve

Error: Your application has not been verified to upload inventory via this API. Please complete the steps in the testing section of this article.

For suppliers to submit Inventory in production they must be verified. This error means an unverified application tried to submit production inventory data via the API. Please complete the steps in the testing section of this Wayfair Inventory article. (Log in to Wayfair to access the article.)

Error: You do not have access to inventory for any suppliers.

The client does not have the specific permissions required to submit inventory for any suppliers.

Error: The "inventory" argument cannot be empty.

Wayfair received an inventory mutation request with no inventory data. Check for any missing information in the required fields. See Wayfair's Inventory API FAQ for more details. (Log in to Wayfair to access the article.)

Error: Required inputs are missing: {Field Names}

One or more required data fields are missing from the input object. {Field Names} is a list of the required input field(s) not found in the request. Check for any missing information in the required fields.

Validation Errors

These errors mean the valid inputs in the request were successfully processed. Please fix the invalid input and submit another request with the updated data.

Issue

How to troubleshoot or resolve

Error: CODE: 4001 - Quantity on hand cannot be less than -1. Supplier Part Number: {Part Number}

The on-hand inventory quantity for the specified part is invalid. Valid quantities are integers greater than or equal to -1. A value of -1 is only used for distributors whose lead time changes drastically between when the item is in stock and when it needs to be ordered from the manufacturer.

If both the distributor and manufacturer do not have an item in stock, the item should be considered out of stock. If you think this situation might apply to you, please contact your Wayfair Integration Manager.

Error: CODE: 4002 -Invalid supplier id given: {supp_id}. Supplier Part Number: {part_num}

An Invalid or incorrect Supplier ID provided with the part number was specified in the request.

Please ensure the part number exists for that supplier.

Error: CODE: 4003 - Invalid 'quantity_on_hand' or 'item_next_availability_date' for discontinued product for supplier id: {supp_id}. Supplier Part Number: {part_num}

An invalid input was provided for a product that has been discontinued by the supplier. This is to prevent any operations on products that aren't or won't be available in inventory.

Order Errors

General Errors

Issue

How to troubleshoot or resolve

Error: Your application has not been verified to accept purchase orders via this API. Please complete the steps in the testing section of this article (Log in to Wayfair to view the article).

An unverified application tried to accept a purchase order via the API. Please check that the steps and criteria in the testing section of this article have been completed and met. (Log in to Wayfair to view the article).

Accept Order Errors

Issue

How to troubleshoot or resolve

Error: Cannot accept a purchase order without any line items.

There was an order mutation API call for an accept purchase that had no line items.

Error: Ship speed provided does not match previously provided ship speeds

A supplier attempted to change the shipSpeed of a previously provided PO response.

Error: Purchase Order {PO Number} does not contain part {PO Part Number}

A supplier attempted to respond to a purchase order with a part that was not part of the order.

Registration Errors

Issue

How to troubleshoot or resolve

Error: Invalid pickup date provided

Invalid pickup date provided. PO: {PO Number}. If the request for pickup date has an invalid format or fails one of the region (EU) constraints, this error is encountered. See Wayfair documentation on API Errors.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information