Shopware Connector | Shopware 6 Odoo Integration

Overview

The connector keeps Odoo and Shopware in sync over the official Shopware 6 Admin API. It covers:

• Products — import Shopware products (with variants, options and images) into Odoo product templates (optionally with stock, images and tax class), and export Odoo product changes back to the store.

• Customers — import Shopware customers (and their billing/shipping addresses) into Odoo contacts.

• Orders — import Shopware orders into Odoo sale orders, mapping each order's Shopware state-machine state to a sale-order action (keep draft, confirm, cancel, or ignore).

• Refunds — optionally discover Shopware order credit notes (order_slip) and create matching draft customer credit notes in Odoo.

Direction of sync: Odoo ↔ Shopware (import is the primary flow; product export and webhook-driven updates are supported).

Every remote call goes through a queue: nothing is written to Odoo until a job runs, jobs retry with back-off on transient failures, and a circuit breaker pauses an instance that keeps failing.

Requirements

• Odoo: 18.0, Community or Enterprise.

• Shopware: a Shopware 6 store exposing the Admin API (OAuth2 client-credentials). Shopware must be reachable from the Odoo server.

• Python: no extra libraries beyond a standard Odoo 18 install.

• Odoo access: any internal user can use the connector screens. Shopware credentials are stored in system-only fields, so only the Settings / Administration user can read or change the Access Key ID and Secret Access Key.

• Network: outbound HTTPS from Odoo to your store. By default the connector refuses internal/loopback/private hosts as an SSRF safeguard (see Safety features).

Installation

1. Copy bambooforge_shopware_connector into your Odoo addons path.

2. Restart the Odoo service.

3. Open Apps, click Update Apps List, search for Shopware, and press Activate / Install. Dependencies (Sales, Contacts, Invoicing) install automatically.

No Shopware store is required to evaluate the connector: a mock Shopware Admin API ships inside the module, so you can install, explore and run the full import flow against sample data before pointing it at a real store. Point an instance's Base URL at <your-odoo-domain>/shopware/mock_api (auth type Integration, any access key and secret) to exercise the full flow without a live store.

Step 1 — Create an Admin API integration in Shopware

The connector authenticates as a Shopware Integration (OAuth2 client-credentials). In your Shopware 6 administration:

1. Go to Settings ▸ System ▸ Integrations.

2. Click Add integration.

3. Give it a Name such as Odoo, and grant it the access it needs (administrator access, or read/write on Products, Customers and Orders).

4. Save. Shopware shows the Access key ID and the Secret access key once.

5. Copy both values now — the secret is shown only at creation time.

Optional, for real-time updates, you will also configure a webhook later (see Automation).

Step 2 — Create the connection in Odoo

Open Shopware Connector ▸ Configuration ▸ Instances and create a record.

Key fields:

Then click Test Connection. A green Connected state means the credentials and URL are correct, and the default order-state mapping is seeded automatically on first successful connect. If it fails, the exact error is shown on the form and recorded in Logs (see Troubleshooting).

Tip: use Quick Setup (button on the instance) to pick a solution pack (catalog only, B2C full sync, …), seed default field mappings and order-state rules, and apply a recommended schedule in one step.

Step 3 — First sync (dry-run, then live)

New instances start with Dry-run ON. In dry-run, import and delete jobs simulate writes: instead of changing data they produce Validation Results you can review under Shopware Connector ▸ Operations ▸ Validation Results. This lets you confirm what would happen before anything is written.

To run a first import:

1. On the instance, click Import Products (and/or Import Customers, Import Orders). This enqueues jobs; it does not block the UI.

2. Jobs are processed by the Shopware Queue Processor scheduled action (every minute), or immediately if you run it manually from Operations ▸ Queue Jobs.

3. Review Validation Results while still in dry-run.

4. When satisfied, open the instance, turn Dry-run OFF, and run the imports again to write the records for real.

Imported records land in the standard Odoo apps: Sales ▸ Products, Contacts, and Sales ▸ Orders. Each carries its Shopware reference so re-imports update the same record instead of duplicating it.

Order status mapping

Shopware drives each order through a state machine; an order carries a stateMachineState whose technicalName (e.g. open, in_progress, completed, cancelled) identifies its current state. Under Configuration ▸ Order State Mappings each instance gets a default table that decides what happens to the Odoo sale order when an order reaches a given state:

Change any row to Ignore (do nothing), Keep draft, Confirm sale order or Cancel sale order. Unknown/custom states default to Ignore, so a state you have not mapped never triggers a destructive transition. Add a row for any custom state your store introduces (use the exact technicalName).

Field mapping & customization

• Field Mappings (Configuration) map Shopware fields to Odoo fields per model. Use Generate suggested mappings on the instance to seed the business-critical ones, then adjust. The mapping board flags fields that need attention.

• Schema Fields lists the discovered Shopware fields per resource. Run Schema Introspection on the instance to refresh it from your live store.

• Stock / images / tax are opt-in toggles on the instance: Sync stock, Sync images (and max images), Upload images on export, Sync taxes (and auto-match taxes on import). They are off by default; turn on only what you need. Tax auto-match never auto-creates taxes — it only links to an existing Odoo sale tax by name.

• Refunds: Sync refunds discovers Shopware order_slip credit notes during order import and creates draft Odoo credit notes; Auto-post refund (off by default) posts them automatically so accountants can review first.

Automation (scheduled actions & webhooks)

The module ships these scheduled actions (Settings ▸ Technical ▸ Scheduled Actions):

Turn on Auto import / Auto reconcile per model on the instance to let the scheduled actions keep things in sync hands-free.

Real-time webhooks (optional): point a Shopware webhook subscriber at the connector's delivery URL so order, product and customer changes are pushed to Odoo as they happen:

• Delivery URL: https://<your-odoo-domain>/shopware/webhook

• Signature: each delivery must carry an X-Shopware-Signature header — the HMAC-SHA256 of the raw request body keyed with the instance Webhook Secret (admin-only field on the instance). The signed body must include an emitted_at timestamp for replay protection.

Odoo verifies the HMAC-SHA256 signature on each delivery, rejects stale or duplicate deliveries, and enqueues a safe import. Without webhooks the scheduled reconciliation still keeps data current.

Safety features

• Dry-run mode — simulate writes and review Validation Results before going live.

• Business validation profiles — Minimal / Standard / Strict gate risky writes.

• Resilient queue — every remote action is a job with retry and configurable fixed/exponential back-off, plus a dead-letter state for jobs that keep failing.

• Circuit breaker — after repeated failures an instance auto-pauses (Tripped); the Auto Recover action reopens it once the store responds again, or click Resume.

• Rollback snapshots — when enabled, imports capture a snapshot so you can undo a batch from Operations ▸ Rollback Snapshots.

• SSRF guard — the connector refuses internal/loopback/private hosts unless Allow internal host is explicitly enabled.

• Signed webhooks — public webhook route fails closed: a delivery is accepted only with a matching HMAC-SHA256 signature and a fresh, non-replayed emitted_at.

Troubleshooting

For anything else, Operations ▸ Logs records every API call, payload and error with a timestamp.

Frequently asked questions

Which versions are supported? Odoo 18.0 on the Odoo side. On the store side the connector targets the Shopware 6 Admin API (OAuth2 client-credentials). Validate your exact build with the bundled mock first.

Do I need Shopware installed to evaluate it? No. A mock Shopware Admin API ships inside, so you can install, explore and demo the full import flow before connecting a real store — point the Base URL at <your-odoo-domain>/shopware/mock_api.

How does authentication work? Create a Shopware Integration under Settings ▸ System ▸ Integrations to get an Access Key ID and Secret Access Key. The connector exchanges them for a short-lived bearer token via OAuth2 client-credentials and refreshes it automatically.

How does real-time sync work? Point a Shopware webhook subscriber at /shopware/webhook and sign each delivery with the shared Webhook Secret (HMAC-SHA256 over the raw body, with an emitted_at timestamp). Odoo verifies the signature, rejects replays, and enqueues a safe import. Without it, scheduled reconciliation keeps things in sync.

Is it safe to run against production data? Dry-run is ON by default, validation blocks risky writes, and rollback snapshots let you undo. You decide when to go live.

What support and refund policy do I get? Every request is answered within 24 hours, setup help included. If you report a bug within 2 months of purchase and it is not resolved within 15 days, you are entitled to a full money-back refund.

Data, privacy & limits

• The connector reads products, customers, orders and order credit notes from your store and writes the corresponding Odoo records. Credentials are stored in admin-only fields.

• In scope today: product/customer/order import, product export, order-state mapping, refund (order_slip) discovery, scheduled sync, signed webhooks.

• Out of scope / best-effort: tax auto-matching (off by default, name-based, never auto-creates taxes); multi-warehouse stock routing; subscription/booking order types.

Support & updates

• Support: support@bambooforge.dev — answered within 24 hours, setup help included.

• Refund: report a bug within 2 months of purchase; if unresolved within 15 days, full refund.

• Full source is included. Updates track the supported Odoo 18 / Shopware 6 Admin API line.

Upgrading & version compatibility

This build targets Odoo 18.0. Each Odoo major series (17.0, 18.0, 19.0) has its own dedicated build of this module — always install the build that matches your Odoo version. Mixing a build with a different Odoo series is not supported.

Uninstallation

You can remove this module at any time from Apps → (this module) → Uninstall, or from the command line. Uninstalling is clean and reversible by reinstalling — but note what is and is not deleted.

Changelog