Faire Integration
Zoey can import Orders from Faire!
Overview
The Zoey Faire Integration connects to your Faire account to import orders placed by your customers in Faire!
Faire orders can be imported manually or automatically up to 10x per hour. The products on an order are matched and can be immediately marked paid or shipped!
Connecting Zoey and Faire
Click the puzzle-piece icon to get to the Integrations list and open the Zoey Faire Integration settings by clicking Manage Connection.

Click Connect to sign into your Faire account and connect it to Zoey.
Faire Integration Settings
Set Enabled to Yes and begin configuring the Zoey Faire Integration settings.
Automatically Importing Orders from Faire
Set Enable Automated Order Import to Yes.
Then configure the Import Schedule to set how frequently the integration attempts to sync new orders.

The Date Limit will determine which orders the integration attempts to import.
Manually Importing Orders from Faire
Clicking the Import Orders button opens a pull-out menu that lets you determine which Faire Orders get synced into Zoey.

Here you can manually import orders from Faire which have been placed after the date and time set in the Date Limit.
Import Specific Orders by ID
Importing specific orders from Faire requires the internal ID like bo_bxdmjbwxid
.
The internal ID is very similar to the ID displayed on your Faire order. But with the difference being bo_
is prefixed and the internal ID is all lower-case.

Copy the internal ID from the URL bar of the order, shown above.
Each order can only get imported once! The Date Limit gets updated each time the import runs.
If you try to manually import a Faire order which was already brought in, an error will be presented.
Faire Order Import Configuration
When an order is synced from Faire, the item details are retrieved, and the Zoey order is created with the matched items. The default payment and shipping method is set on the order. The order is placed in Zoey for the default account.
The created date of the order in Zoey will be the same as it was in Faire.
Exclude Orders with State
Select the Faire Order States (statuses) that shouldn't be imported into Zoey.
This setting lets you prevent orders from being created in Zoey unless the Faire order is in the right stage.

Combine this setting with "Import As Shipped/Paid" so that the Zoey order reflects the intended details!
Matching Zoey Product to Faire Product
A product attribute in each system must be chosen in order to match products between them. By default, the Zoey SKU would be matched against the Faire Product ID.
- Zoey Product Lookup Attribute - set the Zoey attribute code to use in matching to Faire products.
- Faire Product Lookup Field - set the Faire attribute code to match against Zoey products.

In this example, a custom product attribute was created in Faire that exactly matches the SKU of each product in Zoey.
We recommend creating a custom attribute in Zoey and Faire.
Matching SKU or Name can be inconsistent and cause errors during import.
Create a custom attribute in both systems and set it on products in bulk so that they are matched exactly.
Account ID for Faire Orders
Orders imported from Faire will all be placed under the same default Zoey account. Pick that default account and copy its Zoey ID from the overview.
Paste that ID into the Account ID field, and you're all set.

Default Payment and Shipping Method
Orders imported from Faire will be created with the set default shipping and payment methods

Importing Order as Paid or Shipped
Orders created by the Faire integration will be immediately invoiced and marked paid if Import As Paid is set to Yes.
If Import As Shipped is set to Yes, a shipment will be created for all of the items automatically as well.

Inventory Sync
Zoey can send Product Inventory updates to Faire through the Faire Inventory Sync.

How to Sync Product Inventory to Faire
-
Set the Zoey Product Lookup Attribute.
This is the Zoey attribute which will be matched against the Faire field. If your SKUs match between systems, then you can usesku
. If they do not match you will have to create a new product attribute in Zoey to store the Faire Product Variant ID. Set that attribute's code in this field. -
Choose the Faire Product Variant Lookup Field.
This can be SKU or the Variant ID -
Press the Map Products button.
Every product in your Faire store will try to find its match in Zoey based on the lookups. This matching is saved in Zoey. -
Click Export Product Mapping to download a CSV file with all of your Faire products, and their matched Zoey products.
The CSV also contains the inventory numbers from each system. It will show you which products have been matched between Zoey and Faire! -
Click Push Inventory to update each Faire Product with the inventory levels from Zoey!
The product mapping spreadsheet can be exported again to show the updated inventory levels.
Faire Product Variant ID
In Faire there is a Product ID which begins with p_
.
There is also a Variant ID which begins with po_
.
Inventory levels in Faire must be updated using the SKU, or the Variant ID. The Product ID can only be used to match products for the Order Import. And the Variant ID can only be used for matching products to update inventory.
This is based on the functions available in the Faire API.
For this reason we greatly recommend adding a SKU to every Faire Product which exactly matches your SKU in Zoey.
Configuring the integration that way will be more simple and consistent.
Faire Integration Audit Log
Troubleshooting Faire Order Import
The Order Import Failures grid will list orders which failed to be imported and the error reported.

Click on each Faire Order to see details about why it failed to be imported.
Check the error logged in to each Faire Order ID by clicking on it. Attempt to resolve the specified issue in Faire or Zoey.
Check the box and open Bulk Actions to attempt to Retry Import after correcting the issue.
Imported Faire Orders
The Imported Orders list will display orders successfully created by the Faire integration.

Create a tab on your Orders list with the filter
Created By Source = Faire
.
Faire to Zoey Order Import Logs
The Audit log will record the import jobs and whether there were any errors. This view will combine the errors across the orders being imported. The Order Import Failures section will be more helpful in determining why a specific order failed to sync.

Zoey to Faire Inventory Export Logs
The Audit Log also records Inventory Update exports to Faire. Open the log to see the Faire products that had their inventory qty updated.

Updated 2 days ago