Wayfair

Wayfair is a popular furniture and home goods marketplace in the US and UK. Launching a solutions marketplace to help bolster its offerings to mid-level suppliers, Wayfair aims to connect fulfillment and inventory software partners that can help provide a better end-to-end solution. 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, which will generate a fresh ID and Secret.

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 the Wayfair tile. This will open the connection popup in ShipStation. To proceed further, you will need information from your Wayfair account.

    Wayfair logo tile. Button that reads, Connect
  2. Open a new browser tab, then log in to your Wayfair account portal with your Wayfair username and password.

  3. Go to the Applications tab in the side menu then click + New Application. After you click this button you’ll see a Create Application popup.

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

  5. Toggle the selection from Sandbox over to Production, then click Save. This will open the Client Secret popup.

    Wayfair_Create_Application_PU_MRK.png
  6. Copy your Client ID and Client Secret from the Client Secret popup in Wayfair.

    Client Secret IDs are inaccessible once the popup closes.

    Do not close the popup 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
  7. Return to your open browser tab with the open connection popup in ShipStation.

  8. Copy and paste your Wayfair Client Id and Client Secret into the corresponding fields in the popup. Then click Connect.

    Wayfair connection screen, shows fields for Client secret and Client ID

After you've completed the connection steps, your store will be connected to ShipStation. You'll be taken to the store's Settings page to adjust the store-specific settings like branding, notification preferences, and product handling.

Available Features for the Wayfair Integration

The ShipStation integration with Wayfair supports the following standard features:

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer's email address with the order and can send customer shipment confirmation and delivery emails, which are configured in your Store Settings.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

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

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

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.

ShipStation will import item options (such as color or size) for each line item in the order.

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

Additional Details About the Wayfair Integration

  • 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 Integration

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.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer's email address with the order and can send customer shipment confirmation and delivery emails, which are configured in your Store Settings.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

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

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

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.

ShipStation will import item options (such as color or size) for each line item in the order.

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