Faire Account Integration

Overview

Faire is an online wholesale marketplace connecting retailers with independent brands and artisans. It allows retailers to discover and purchase unique products from a variety of categories, including home decor, fashion, beauty, and more. Retailers can order online and get flexible payment terms and free returns.

Integrating Faire into your Sellercloud account allows you to seamlessly import orders, upload tracking information, and ensure your Faire store is always up-to-date with the latest inventory data. The integration works through API, transmitting information between the two services via plugins and Scheduled Tasks.

If necessary, you can open a ticket with Sellercloud Support to request additional customizations or other plugins for this integration. Any such modifications will be billable.

Prerequisites

Before you can integrate Faire with Sellercloud, you must complete the following requirements.

Faire Support

To integrate with Faire, you must obtain your unique API key:

1. Register Sellercloud as an application in the Faire Development Portal.
2. After completing the registration, you will receive a unique alphanumeric App ID, which must be emailed to [email protected] along with your request for an API key.

See Managing Integrations on Faire for more information.

Sellercloud Support

Open a ticket with Sellercloud Support and request that the following plugins be installed on your server:

• Faire API Order Import Plugin – Imports orders from Faire to Sellercloud.
• Faire API Order Tracking Export – Exports tracking information from Sellercloud to Faire.
• Faire API – Product Inventory Export Plugin – Exports inventory information from Sellercloud to Faire.

Custom Company Settings

Create the following Custom Company Settings on the company created for the integration:

• FaireAPIKey – Enter your API key to connect Sellercloud to Faire.

• (Optional) FaireAPIUseTestAPI – Set to True to enable the sandbox API or False for production. The default is False.
  
  Changing this setting requires updating the FaireAPIKey, as sandbox and production services require different keys.

• (Optional) SetFaireOrdersOnHold – Set Faire orders On Hold when importing them to Sellercloud. Enter True or False. The default is False.
• (Optional) FaireAPIShippingCostPaddingPercent – Add a percentage increase to the Shipping Cost when sending tracking to Faire. The setting defaults to 0. Enter a whole number.

Custom Product Columns

Create the following Custom Product Columns:

• FaireMerchantSKU – The product’s Faire SKU. By default, Sellercloud matches products using this column, and if this fails, it matches by Sellercloud SKU. Set the Data Type to String.
• FaireSafetyQty – Apply Safety Quantities to products on Faire. The default is 0. Set the Data Type to Integer. 
• (Optional) Faire_Enabled – Enable only specific products for Faire. Set to True for any products you want to send with the Inventory Export plugin. Set the Data Type to Boolean.

Order Import

The Faire API Order Import Plugin imports orders from Faire to Sellercloud.

Automate Order Import

To create a Scheduled Task that imports orders:

1. Navigate to Settings > Scheduled Tasks > Manage Scheduled Tasks.
2. Click the green + icon: Create New Scheduled Task.
3. Complete as follows:
   1. Click Task Type and select Import Orders.
   2. Set the Task Name.
   3. Select the Company.
   4. Select the Start Time.
4. Click Create, and the new Scheduled Task page will load on your screen.
5. Click the Edit button at the top right corner.
6. In the Details panel:
   1. Click Create Orders For Company and select the company designated for this integration.
   2. Click the Plugin menu and select Faire API Order Import Plugin.
7. In the Import Options panel, set Import From to None.
8. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
9. In the General panel, click the Enable toggle button.
10. Click Save.
    

Tracking Export

The Faire API Order Tracking Export plugin sends tracking from Sellercloud to Faire.

Before you proceed, create a Saved Search for orders filtered by:

• Company – The company you created for the integration
• Order Status – InProcess Or Completed
• Shipping Status – FullyShipped
• Payment Status – Charged
• Tracking Uploaded – No

Automate Tracking Export

To create a Scheduled Task that exports order tracking:

1. Navigate to Settings > Scheduled Tasks > Manage Scheduled Tasks.
2. Click the green + icon: Create New Scheduled Task.
3. Complete as follows:
   1. Click Task Type and select Export Orders.
   2. Set the Task Name.
   3. Select the Company.
   4. Select the Start Time.
4. Click Create, and the new Scheduled Task page will load on your screen.
5. Click the Edit button at the top right corner.
6. In the Details panel:
   1. Click the User ID menu and select your ID.
   2. Click the Saved Search menu and select the saved search you created earlier.
   3. Click the Export Via menu and select Faire API Order Tracking Export.
   4. Check This Is Tracking Export.
7. In the Export Options panel, set Export To to None.
8. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
9. In the General panel, click the Enable toggle button.
10. Click Save.
    

Inventory Export

The Faire API – Product Inventory Export Plugin sends your Sellercloud inventory quantities to Faire. 

By default, Sellercloud matches products using the Custom Product Column FaireMerchantSKU, and if this fails, it matches by Sellercloud SKU.

Optionally, you can enable only specific products for Faire by setting their Faire_Enabled Custom Product Column to True:

• For one product at a time: go to the Product Details Page > click Toolbox and select Custom Columns > click Edit, update the Faire_Enabled column, and Save.
• For multiple products in bulk: follow the steps to Bulk Update Products and use the Faire_Enabled column – set it to True for all products you want to enable.

Unlike core integrations, plugin integrations don’t require products to be in the company with the scheduled tasks. The export will include the products you select with your Saved Search.

Next, create a Saved Search for products filtered by Faire_Enabled – True. Optionally, you can add more filters to the search to narrow down the export further.

Automate Inventory Export

To create a Scheduled Task that exports inventory:

1. Navigate to Settings > Scheduled Tasks > Manage Scheduled Tasks.
2. Click the green + icon: Create New Scheduled Task.
3. Complete as follows:
   1. Click Task Type and select Export Products.
   2. Set the Task Name.
   3. Select the Company.
   4. Select the Start Time.
4. Click Create, and the new Scheduled Task page will load on your screen.
5. Click the Edit button at the top right corner.
6. In the Details panel:
   1. Click the User ID menu and select your ID.
   2. Click the Saved Search menu and select the saved search you created earlier.
   3. Click the Export Via menu and select Faire API Product Inventory Export Plugin.
7. In the Export Options panel, set Export To to None.
8. In the Frequency panel, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
9. In the General panel, click the Enable toggle button.
10. Click Save.