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 catalog items, sync inventory availability, import Shop orders (where Meta checkout is enabled for your Page), push shipments, and import payouts from a single Odoo instance.

Compatibility: Odoo 17 / 18 / 19 Price: $499 (one-time) License: OPL-1 — no licence key or activation required

Key Features​

  • Meta Graph API v25 integration (Catalog, Commerce orders, payouts, Pages)
  • Multi-store: one instance per Page / catalog
  • Catalog push: one product item per Odoo variant (name, description, price, availability, SKU)
  • Product sets (usable as Dynamic Ads sources)
  • Inventory availability sync every 10 minutes
  • Shop order import (Facebook and Instagram channels, where Meta checkout is enabled) and shipment push
  • Webhooks for commerce orders and catalog items (plus Lead Ads on Odoo 19); X-Hub-Signature-256 verification in the Odoo 19 build
  • OWL 2 real-time dashboard with KPIs and charts

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise)
  • 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
    • 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 from the Odoo Apps Store (or your ecosire.com purchase).
  2. Extract facebook_store_management/ into your Odoo addons directory.
  3. Restart Odoo and click Apps → Update Apps List.
  4. Search for Facebook & Meta Shop Store Management and click Install. No licence key is needed.

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 Commerce Platform product (and Marketing API if you use Lead Ads).
  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 and App ID / App Secret.

Step 2: Create an instance in Odoo​

  1. Navigate to Facebook → Configuration → Instances.
  2. Click Create and fill in:
    • Instance name (e.g. Meta Commerce — Main)
    • App ID, App Secret, Access Token (system-user token)
    • Catalog ID, Page ID
    • Default warehouse, company, pricelist, salesperson
    • The connector calls Graph API v25.0 (fallback v24.0 declared); the version is set in code, not on the form
  3. Click Test Connection to verify (a GET /me round trip) and save.

Step 3: Sync configuration​

  • Products — the product sync runs every 30 minutes; each item is keyed by the variant's Internal Reference (retailer_id). The push does not send an image URL, so set images in Commerce Manager.
  • Inventory — availability (in stock / out of stock) is pushed every 10 minutes per mapped location.
  • Orders — imported every 15 minutes where Meta checkout is enabled; the optional auto-workflow confirms orders and creates invoices.
  • Webhooks — create a webhook record under Configuration → Webhooks to subscribe a Page or catalog field (for example page/commerce_order, catalog/product_item, and on Odoo 19 page/leadgen).

Initial Sync​

  1. Open Facebook → Operations → Run Operations.
  2. Choose the product export operation and run it — the connector creates or updates one catalog item per mapped product.
  3. Review catalog issues in Commerce Manager → Catalog → Diagnostics and fix any field-level errors flagged by Meta.
  4. If Meta checkout is enabled, run the order import from Run Operations with a From / To date range.

Dashboard​

The OWL dashboard (Chart.js + ApexCharts, refreshes every 60 seconds) renders:

  • KPI cards: total sales, products, orders, customers, pending orders, queue jobs and errors
  • Charts over a selectable date range
  • Sync queue and error counts linking to the Queue Jobs and Logs views

Troubleshooting​

IssueLikely cause + fix
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, inventory and product-set sync apply.
Webhook signature mismatchOn Odoo 19 the 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​

Last updated on