Odoo Community Association

Shopify Connector

Beta License: AGPL-3 OCA/connector-shopify Translate me on Weblate Try me on Runboat

The core Shopify connector links any number of Shopify stores to Odoo 19 Community through company-scoped binding records. It synchronizes products, inventory, customers, orders, returns, refunds, and fulfillment through the GraphQL Admin API.

Signed webhooks provide the fast path, OCA queue_job provides durable execution, and scheduled reconciliation repairs missed or delayed events. Onboarding, health checks, a sync dashboard, error recovery, and configurable retention support day-to-day operation.

Table of contents

Configuration

  1. Add OCA queue_job and this repository to the Odoo addons path, then install Shopify Connector.
  2. Grant operators the Shopify Manager group.
  3. Open Shopify > Configuration > Instances and start onboarding.
  4. Enter the custom-app domain, Admin API token, and webhook signing secret.
  5. Correct any missing scopes, map Shopify locations, review generated tax mappings, choose synchronization policies, and install webhooks.
  6. Review payment-gateway and carrier mappings before enabling unattended order and fulfillment processing.

Configure queue_job worker capacities in odoo.conf; the repository README contains a safe starting allocation for import, export, and webhook channels.

Usage

Use Shopify > Dashboard to monitor binding states, queue backlog, recent errors, webhook health, drift schedules, and operational table sizes.

Normal changes flow through webhooks and idempotent jobs. Use the entity import or reconcile actions for manual catch-up. For failures, correct the underlying configuration or data, select error bindings, and choose Retry Failed Shopify Bindings. Resetting to pending clears the state without scheduling work.

Run Check Webhooks after changing domains or credentials and repair any missing or misrouted subscriptions. Never edit Shopify IDs or raw payloads.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Sawir Studio

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/connector-shopify project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.