Metadata-Version: 2.1
Name: odoo-addon-shopify_connector
Version: 19.0.1.0.0.5
Requires-Dist: odoo-addon-queue_job==19.0.*
Requires-Dist: odoo==19.0.*
Requires-Dist: requests
Summary: GraphQL-first Shopify commerce synchronization
Home-page: https://github.com/OCA/connector-shopify
License: AGPL-3
Author: Sawir Studio, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=================
Shopify Connector
=================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:74c4b1ba1328614586eb0b675cd1a27792474474d48a35056232c7190dd43dfc
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fconnector--shopify-lightgray.png?logo=github
    :target: https://github.com/OCA/connector-shopify/tree/19.0/shopify_connector
    :alt: OCA/connector-shopify
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/connector-shopify-19-0/connector-shopify-19-0-shopify_connector
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/connector-shopify&target_branch=19.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

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**

.. contents::
   :local:

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 <https://github.com/OCA/connector-shopify/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 <https://github.com/OCA/connector-shopify/issues/new?body=module:%20shopify_connector%0Aversion:%2019.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

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

Credits
=======

Authors
-------

* Sawir Studio

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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 <https://github.com/OCA/connector-shopify/tree/19.0/shopify_connector>`_ project on GitHub.

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