1. Knowledge Base
  2. Information for vendors

How to sign up for Wayfair Integration Package

HomeRoots/Wayfair Integration: Getting Started
 Within your HomeRoots portal– toggle to “Integrations” under “SUBSCRIPTIONS” on the left-hand panel.

Click Start Free Trial- enter credentials and submit.

Once signed up you will receive additional Wayfair options on your side panel of your HomeRoots profile under “EXPORT”.

The first step whether you'd like to import, export or both - is to collect your encrypted key from your Wayfair partner portal.

To do this, you will need to click on “Wayfair Settings” under “EXPORT”.

Below are the full directions to gather your Encrypted Key from your Wayfair Partner Portal :

These directions can also be found in red under "click here" in your HomeRoots portal under Wayfair Settings. 

[Supplier] Supplier Authorizes HomeRoots Application

Our UI for Supplier management of HomeRoots apps will be released shortly.

This UI can be found on the Supplier Integration Status page on the existing Partner Home developer portal. Here, suppliers can view a list of our approved HomeRoots applications and authorize the HomeRoots(s) that they work with.

Steps:

  1. Go to the Supplier Integration Status page
  2. Select “HomeRoots Applications” tab
  3. Hit “Manage” on the Catalog API row
  4. Select your HomeRoots from the list
  5. Grant the needed permissions (see overview of permissions below)
    1. Note: Only the permissions that correspond to capabilities that a given HomeRoots has adopted will be viewable + grantable.
    2. Overview of permissions:
      1. read-product-classes
        1. Gets the product classes that suppliers can list items for sale
      2. read-product-catalog
        1. Export the supplier product catalog
      3. write-product-generic-description
        1. Update the generic descriptions for products
      4. read-product-generic-description-update-status
        1. Checks the status of generic description updates
      5. read-product-generic-descriptions-by-part
        1. Get the existing generic descriptions given a supplier part number
      6. read-media-metadata-tags
        1. Get the metadata tags associated with media
      7. read-media-uploaded
        1. Get the list of media that was uploaded for a product
      8. read-media-uploaded-status
        1. Get the uploaded status for a given media request
      9. write-media-upload-from-url
        1. Uploads new media and associates it with a product
      10. read-product-create-submit-status
        1. Check the status of a new product request
      11. read-product-create-questions
        1. Get the questions required by a product class for listing new items for sale
      12. write-product-create-submit
        1. Submit a new product to be listed on site
      13. read-supplier-brand-associations
        1. Get the supplier brands that are authorized for the supplier to sell

Go to the Supplier Integration Status page

Select “HomeRoots Applications” tab

Hit “Manage” on the Catalog API row

 

Select your HomeRoots from the list

Grant permissions

Supplier Configuring “Encrypted Key” in HomeRoots System

  1. On the HomeRoots application page, the supplier can copy their encrypted key by pressing the “Copy Encrypted Key” button.
    1. This encrypted key is just an encrypted supplier ID + name. This is more secure than suppliers inputting SuID into the HomeRoots’s system. The HomeRoots will have to decrypt this and then store the corresponding SuID (details below).
  2. They need to then input their encrypted key into their HomeRoots configuration

 

Enter your Encrypted Key into the coordinating section of your HomeRoots Portal. Then add your brand name.

Click “Save” and you will see your supplier ID generate and is no longer grayed out.

 


Once the encrypted key is successfully inputted and the supplier ID is generated, you will be able to access your Wayfair catalog through HomeRoots, as shown below.

 

Import 

 

Export