Wayfair - Validate Application

Wayfair requires that the supplier take the following steps to validate PackageBee as a production application for the account.

Follow these steps to validate PackageBee for the supplier's Wayfair account.

Integration Requirements

All Wayfair integrations must comply with Wayfair-specific API requirements. Please review these before beginning the Validation steps below.

Warehouse Source Address must be set by PackageBee support

Wayfair requires a SourceAddress (the address of the warehouse location) is specified in shipment notifications. This address is configured per Merchant, and can only be configured by a PackageBee support representative.

Before testing sales order flow, make sure to provide PackageBee support with the name of your warehouse in PackageBee, and the following warehouse values:

  • Warehouse Name
  • Street Address Line 1
  • City
  • State
  • Postal Code
  • Country

Billing and shipping names cannot be altered

Wayfair requires that the first and last names on shipment notifications match exactly to the names on the original order. Therefore, you cannot use rules in PackageBee to transform billing or shipping names in any way.

Validation Phase 1: Order Management Testing

Grant your account access to Wayfair’s API tools

  1. Go to User Management at https://partners.wayfair.com/users.
  2. In the box for your account, click the Edit ( ) icon.


  1. Under Access Permissions, make sure the "API" box is checked.


  1. Click Save.


Testing with Sandbox Application

  1. Go to Application Management at: https://partners.wayfair.com/developer/applications
  2. If you already created applications during an earlier integration, you can use your existing Sandbox application for testing. Provide PackageBee with the Client ID and Client Secret.




If you do not have applications from an earlier integration, create one (1) Sandbox Application for testing and one (1) Production Application for live operations using “+ New Application.” Provide PackageBee with the Client ID and Client Secret for both applications.





  1. Input Sandbox Client ID and Client Secret into PackageBee software settings and complete testing.

Go Live with Production Application

  1. When PackageBee informs you that testing is complete, go to Wayfair's Integration Status Page: https://partners.wayfair.com/d/supplier-integration-status
  2. Grant your Production Application permission to go live for all APIs with a “Ready for Production” status by clicking “View/Update.”


  1. Find your Production Application and click “Yes” under “Live in Production


Order Management integration is now complete.

Valudation Phase 2: Inventory Testing

  1. Submit a ticket to Wayfair at: https://partners.wayfair.com/v/submit_ticket/index

Enter the following information in the ticket:

  • Submit a Ticket for:
    "Inventory & EDI"
  • Ticket Type:
    "Set Up an Inventory Feed or EDI Connection with Wayfair"
  • Tech Contact Name:
    "Third Party Onboarding Representative"
  • Tech Contact Email:
    "Third Party Onboarding Representative"
  • What Would You Like To Set Up? (check all that apply):
    "API Integration"
  • Any Additional Comments?:
    Order Management"


  1. In PackageBee, initiate a FULL inventory update to Wayfair to synchronize all of your inventory to Wayfair. This fulfills the Wayfair requirement that at least one "True Up" inventory update must be performed and validated. 
  2. When inventory testing in PackageBee is complete, go to your Ticket Inbox at: https://partners.wayfair.com/app/tickets#supplier_tickets

Your ticket is “Business Related Tickets” in the “Inventory & EDI” section. Update your ticket with “Inventory testing is complete.”


  1. Wayfair will update your ticket once permission to go live with API Inventory has been granted. You can then switch your inventory live.

Inventory integration is now complete.

Next [Required]: Configure Daily Full Inventory Sync

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request



Please sign in to leave a comment.