Skip to main content

Faire Store Management

The ECOSIRE Faire Store Management module integrates your Faire brand account with Odoo ERP. Faire is the world's leading online wholesale marketplace connecting independent brands with over 700,000 independent retailers globally. This module uses the Faire Partner API to synchronize your wholesale product catalog, retailer orders, and inventory between Faire and Odoo, making it seamless to manage your B2B wholesale business.

Compatibility: Odoo 17 / 18 / 19 Price: $349 (one-time) License: Up to 3 domain activations

Key Features​

  • Faire Partner API integration with OAuth2 access token authentication
  • Wholesale product catalog synchronization
  • Retailer order import and fulfillment management
  • Real-time inventory synchronization
  • Net 60 payment terms tracking
  • Retailer information and relationship management
  • Returns and credit request processing
  • Open-to-buy (OTB) and reorder management
  • Multi-company record rules for isolated data management

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A Faire brand account with Partner API access
  • Faire access token from the Partner API portal

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-faire-*.zip -d /opt/odoo/addons/
  3. Restart the Odoo service: 
    sudo systemctl restart odoo
  4. Navigate to Apps, click Update Apps List
  5. Search for "ECOSIRE Faire Store Management" and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain Faire API Credentials​

  1. Log in to your Faire brand account at https://www.faire.com/brand-portal
  2. Navigate to Settings then Integrations then API
  3. Click Generate Access Token to create a Partner API token
  4. Copy and save the access token securely -- it grants full access to your brand account

Step 2: Connect in Odoo​

  1. Navigate to Faire Store Management > Configuration
  2. Create a new configuration and enter:
    • Access Token (access_token) -- your Faire Partner API OAuth2 access token
  3. Click Test Connection to verify API access
  4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings​

Product Sync​

  • Choose sync direction: Faire to Odoo, Odoo to Faire, or bidirectional
  • Set sync interval: scheduled (every 15 or 60 minutes)
  • Configure wholesale price tiers and minimum order quantities
  • Map product variants and option sets

Inventory Sync​

  • Map Odoo warehouses to Faire inventory settings
  • Set buffer stock quantities per SKU
  • Enable real-time stock updates to keep Faire listings accurate

Order Sync​

  • Enable automatic order import for all Faire retailer orders
  • Map Faire payment methods (Net 60, credit card) to Odoo payment journals
  • Configure fulfillment sync to push tracking numbers and shipping confirmations

Initial Sync​

  1. Go to Faire Store Management > Operations > Initial Import
  2. Select data types to import (Products, Customers/Retailers, Orders)
  3. Set date range for historical orders
  4. Click Start Import and monitor progress in the sync log

API Details​

FieldValue
Auth methodBearer token (OAuth2 access token)
Base endpointhttps://www.faire.com/api/v2
Products endpoint/products
Orders endpoint/orders
Retailers endpoint/retailers
Inventory endpoint/product-tiles/{productTileId}/inventory
Key config fieldsaccess_token

Dashboard​

The built-in OWL 2 dashboard provides real-time visibility into your integration:

  • 6 KPI cards -- Revenue, Orders, Customers, Products, Avg Order Value, and Sync Health -- each with period-over-period delta indicators
  • Sales Trend chart (Chart.js line chart) with interactive date filtering
  • Order Status breakdown (doughnut chart) showing distribution across statuses
  • Period filters -- Today, 7 days, 30 days, 90 days, Year, or Custom date range
  • Activity feed showing recent sync log entries with type indicators
  • Quick action buttons for Products, Orders, Customers, Queue, Logs, and Settings
  • Status footer with Queue Jobs, Errors, Out of Stock, and Sync Rate
  • Auto-refresh every 60 seconds with dark mode support

Troubleshooting​

IssueSolution
Connection failedVerify access token; regenerate in Faire brand portal if needed
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Products not syncingReview product status in Faire brand portal (active/inactive/draft)
Orders not importingVerify order status filters and date range settings
401 UnauthorizedRegenerate access token in Faire brand portal API settings
Inventory not updatingConfirm SKU identifiers match between Odoo and Faire
Net 60 orders not reconcilingMap Faire Net 60 terms to the correct Odoo payment journal
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on