The HomeRoots Wayfair App for Suppliers

This outlines the new supplier flow for finding and authorizing HomeRoots applications in Wayfair’s Partner Home.

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:
   3. read-product-classes
   4. 1. Gets the product classes that suppliers can list items for sale
   5. read-product-catalog
   6. 1. Export the supplier product catalog
   7. write-product-generic-description
   8. 1. Update the generic descriptions for products
   9. read-product-generic-description-update-status
   10. 1. Checks the status of generic description updates
   11. read-product-generic-descriptions-by-part
   12. 1. Get the existing generic descriptions given a supplier part number
   13. read-media-metadata-tags
   14. 1. Get the metadata tags associated with media
   15. read-media-uploaded
   16. 1. Get the list of media that was uploaded for a product
   17. read-media-uploaded-status
   18. 1. Get the uploaded status for a given media request
   19. write-media-upload-from-url
   20. 1. Uploads new media and associates it with a product
       1. read-product-create-submit-status
          1. Check the status of a new product request
   21. read-product-create-questions
   22. 1. Get the questions required by a product class for listing new items for sale
   23. write-product-create-submit
   24. 1. Submit a new product to be listed on site
   25. read-supplier-brand-associations
   26. 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' putting SuID into 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