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.

📘

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.

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.

📘

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.

---

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.

Faire Integration Audit Log

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.