Skip to main content

Facebook & Meta Shop Store Management

The ECOSIRE Facebook & Meta Shop Store Management module integrates Meta Commerce (Facebook Shop + Instagram Shop) with Odoo through the official Meta Graph API. Push catalogs, sync inventory, pull Checkout-on-Meta orders, and operate your Meta storefronts from a single Odoo instance.

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

Key Features​

  • Meta Graph API integration (Catalog, Commerce, Pages, Instagram Shopping)
  • Multi-page / multi-business-asset support
  • Catalog (product feed) push: product_group + product_item objects
  • Variant handling via Meta's retailer_product_group_id
  • Inventory + price sync with regional offers
  • Checkout-on-Meta order import (US / supported regions)
  • Tag-products-in-posts workflow helper (Instagram Shopping)
  • Webhook subscriptions for catalog + order + checkout events with signature verification
  • OWL 2 real-time dashboard with KPIs and charts
  • License-mixin enforced — one key per Odoo SH or on-prem domain

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise)
  • An active ECOSIRE license key for this module
  • A Meta Business Suite account with Commerce Manager access
  • A Meta App (Standard access) with the following permissions:
    • catalog_management
    • business_management
    • pages_show_list, pages_read_engagement, pages_manage_metadata
    • instagram_basic, instagram_shopping_tag_products (for Instagram tagging)
    • commerce_account_read_orders, commerce_account_manage_orders (for Checkout-on-Meta)
  • A long-lived System User access token with the required scopes

Installation​

  1. Download the module ZIP delivered with your purchase.
  2. Extract facebook_store_management/ into your Odoo addons directory.
  3. Make sure ecosire_license_client/ is also on the addons path (ships in the same delivery).
  4. Restart Odoo and click Apps → Update Apps List.
  5. Search for ECOSIRE Facebook & Meta Shop Store Management and click Install.
  6. Paste your license key when prompted, then click Activate.

Configuration​

Step 1: Get Meta credentials​

  1. Open Meta for Developers → My Apps, create or select an app, and switch to Live mode.
  2. Add the Marketing API, Commerce Platform, and Instagram Graph API products.
  3. In Meta Business Suite → Business Settings → System Users, create a system user with the role Admin and assign it to the Business and the relevant Pages / Catalogs.
  4. Generate a long-lived system-user access token with the scopes listed in the Prerequisites.
  5. Note your Catalog ID, Page ID, Instagram Business Account ID, and Commerce Merchant ID (if Checkout-on-Meta is enabled).

Step 2: Create an instance in Odoo​

  1. Navigate to Facebook & Meta Shop → Configuration → Instances.
  2. Click Create and fill in:
    • Instance name (e.g. Meta Commerce — Main)
    • Graph API version (default v22.0, with auto-degrade fallback to v21.0 / v20.0 — bump as Meta versions roll forward)
    • App ID, App Secret, System User Access Token
    • Catalog ID, Page ID, Instagram Business Account ID, Commerce Merchant ID
    • Default warehouse, company, currency, fiscal position
  3. Click Test Connection to verify (/me/businesses round trip).
  4. Save and click Activate Instance.

Step 3: Sync configuration​

  • Catalog Push — choose product domain, variant strategy (retailer_product_group_id based), and image quality. Set cron cadence (recommended 60 min).
  • Inventory + Price Sync — fast lane (15 min) for stock + price deltas via availability and price fields.
  • Order Sync — only available for Checkout-on-Meta regions. Maps Meta order states to Odoo sale order stages with auto-acknowledge.
  • Webhooks — register the module's webhook endpoint with Meta on the configuration form. Subscribed topics: catalog, commerce_account, messaging_postbacks (optional).

Initial Sync​

  1. Open Facebook & Meta Shop → Operations → Push Catalog.
  2. Select the product domain and click Push Now — the connector creates product_group + product_item objects with batch sizes that respect Meta's /batch limits.
  3. Review catalog issues in Commerce Manager → Catalog → Diagnostics and fix any field-level errors flagged by Meta.
  4. If Checkout-on-Meta is enabled, click Import Historical Orders with the date range.

Dashboard​

The OWL 2 dashboard renders:

  • KPI cards: live products in catalog, pending review, rejected, orders this week, AOV
  • Catalog health: items with missing GTIN, missing brand, low-quality images
  • Order pipeline: pending acknowledge, picking, shipped, delivered
  • Sync queue with retry shortcuts and Meta error code summary

Troubleshooting​

IssueLikely cause + fix
License is not valid for Odoo versionConfirm the key you pasted matches your installed module version (Odoo 19).
OAuthException — Permissions errorToken missing one of the listed scopes. Regenerate a system-user token with the full scope set.
Catalog push: Invalid parameter — retailer_idretailer_id must be unique per product item. The connector derives it from product.product.default_code — fill that field on every Odoo variant.
Orders not importingCheckout-on-Meta is region-locked. Outside supported regions, only catalog + tagging is available.
Webhook signature mismatchThe connector verifies X-Hub-Signature-256 against your App Secret. Confirm the secret on the instance matches the one in Meta App Settings → Basic.

Support​