Skip to content

[ADD] om_connector_base, om_shopify: Shopify connector - #369

Merged
odoomates merged 1 commit into
20.0from
20.0-shopify
Nov 17, 2026
Merged

odoomates merged 1 commit into
20.0from
20.0-shopify

Conversation

@odoomates

@odoomates odoomates commented Nov 16, 2026 •

Copy link
Copy Markdown
Owner

What and why

Shopify Connector: Shopify stores connected to Odoo 20 through the Shopify Admin GraphQL API, on top of a new common engine for shop and marketplace connectors.

om_connector_base (Connector Base): the engine, reusable by the next connectors.

  • Job queue: every import, export and webhook is a job; row locking so that two workers never run the same job; a savepoint per job; retries after 2, 4, 8 minutes and more; deduplication by key; failed jobs tried again in one click and reported to their connection.
  • Mappings between external records and Odoo records.
  • Workflows for imported orders: confirm, invoice, register one or several payments, pay back credit notes.
  • Secrets stored encrypted (key from the om_connector_key option, else the database secret); HMAC webhook signatures; HTTP calls retried on rate limits and server errors.

om_shopify (Shopify Connector):

  • Connection: client ID and secret of a Dev Dashboard app, installation by link (OAuth, expiring tokens refreshed and rotated safely), or a custom app token; setup wizard.
  • Webhooks checked with the signature of Shopify, queued and answered at once; privacy (GDPR) webhooks.
  • Products: bulk import of the catalogue, changes daily and by webhook, matching by SKU or barcode, creation with variants and images; export with variants, prices, weight, image and publication; CSV/Excel mapping; metafields.
  • Prices from a pricelist with compare-at prices, and to Shopify price lists (markets, B2B).
  • Stock sent per location with limits per variant, or imported.
  • Customers; B2B companies, locations, payment terms and tax exemption.
  • Orders by webhook, every 15 minutes or by number: discounts, shipping, taxes of Shopify or of Odoo, tips, duties, gift cards, custom items, currency of the customer; workflows chosen by order rules (payment method, payment and fulfillment status, tag, channel); risky orders held; edits applied.
  • Fulfillment with tracking, cancellations both ways, refunds both ways with credit notes and returns.
  • Payouts (optional): bank statement lines, or a journal entry through a transit account matched with the payments and the bank transaction.

Written from scratch against the public Shopify Admin API documentation: it contains no code of any other Shopify connector or third-party module.

Released as beta: the store pages of both modules say so and ask for feedback, suggestions and issues. Store pages, icons and animated banners are in the store style (Bootstrap classes, no <style> block).

How to test

  1. Install om_shopify on a fresh database (installs om_connector_base), and run --test-tags /om_connector_base,/om_shopify (the tests use recorded Shopify answers, no network).
  2. With a Shopify development store: create an app in the Dev Dashboard with the scopes listed on the store, install it, then Shopify > Configuration > Connect a Store.
  3. For webhooks, set the Odoo Public URL of the store to a public https address (e.g. a tunnel) and click Sync Webhooks.

Versions

20.0 only for now.

Checklist

  • The pull request targets the right version branch (20.0, 19.0 or 18.0).
  • One commit, named [TAG] module: summary (50 characters at most).
  • The tests of the module pass, and new tests cover the change.
  • The module installs and upgrades on a fresh database without error or warning.
  • User-facing texts are translatable.
  • A data-model change has a migration script and a higher version in __manifest__.py (new modules).
  • I have read and follow the AI contribution policy.

@odoomates
odoomates marked this pull request as ready for review November 17, 2026 14:53
@odoomates

Copy link
Copy Markdown
Owner Author

/mergebot r+ skipci

@odoomates
odoomates merged commit d58bca1 into 20.0 Nov 17, 2026
3 of 4 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

Merging now, CI skipped by @odoomates. Then version bump (patch).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant