Appearance
Order Export
Send your Shopware orders to the systems that fulfil and account for them — an ERP, a warehouse, an accounting tool or any HTTP API — in exactly the format that system expects, with retries, protection for systems that are down, and confirmation that each order arrived.
Install · Set up targets · Write a mapping · Export orders · Troubleshoot · Developer docs
| Version | 0.9.0-beta.1 · Beta |
|---|---|
| Shopware | 6.6, 6.7 |
| PHP | 8.2+ |
| Plugin name | KmhOrderExportSW |
| Composer package | kommandhub/order-export-sw |
| Licence | Proprietary |
| Get it | ZIP upload, or Composer from the Git repository |
What does it do?
You describe the document another system expects as a mapping, test it against a real order, and publish it. You configure the receiving system once as an export target with its URL and credentials. Orders are then exported automatically from Flow Builder (for example when an order is placed or paid) or on demand from the order page. Each export is tracked on the order, including whether the other system acknowledged it.
Who it is for: merchants who need orders in an ERP, WMS, accounting or fulfilment system, and the agencies and integrators who connect them.
How it fits into Shopware: it adds three screens under Settings → Extensions, an Order export card on the order page, and an Export order Flow Builder action. Background exports run on Shopware's message queue; acknowledgement timeouts run as a scheduled task.
Key features
- Export targets — endpoint, HTTP method (
POST/PUT/PATCH), timeout, TLS check, authentication. - Encrypted credentials — API key, Basic, Bearer or OAuth2 client credentials; secrets never leave the database.
- Testable, versioned mappings — JSON definitions with paths, expressions, filters and functions; render against a real order; publish immutable versions.
- JSON or XML output.
- Automatic or manual — Flow Builder action or the order page.
- Immediate or background per target, with automatic retries for temporary failures.
- Acknowledgements — none, read from the response, or an asynchronous signed callback with timeout.
- No duplicates — unchanged orders are not sent again.
- Circuit breaker — pauses calls to a target that keeps failing.
Requirements
| Shopware | 6.6 or 6.7 |
| PHP | 8.2+ with the sodium extension (bundled by default) |
| Receiving system | An HTTP(S) endpoint that accepts JSON or XML, and its credentials |
| Environment | A stable ORDER_EXPORT_ENCRYPTION_KEY (or APP_SECRET) |
| Background targets | A running message-queue worker |
| Asynchronous acknowledgements | Scheduled tasks running, and the receiving system able to call back |
Quick start
- Set
ORDER_EXPORT_ENCRYPTION_KEY, install and activate — Installation. - Create a credential and an export target — Credentials & targets.
- Write a mapping, Test mapping against an order, Publish — Mappings.
- On any order, Order export card → choose the target → Export.
- Add Export order to the Order placed flow — Exporting orders.
Important limitations
- One transport ships: HTTP(S). Other protocols need a developer extension.
- A target's Sales channels field is not enforced in 0.9.0-beta.1 — scope exports with a flow condition.
tax_rate()returns 0 for a list of taxes; use the documented workaround.- The receiving system must recompute a payload hash for asynchronous acknowledgements.
- Uninstalling does not remove the plugin's tables or data.
All known issues: Troubleshooting → Known issues.
Documentation
For shop owners and administrators
- Installation — requirements, encryption key, ZIP or Composer, activation, background processing, verification, update, uninstall
- Credentials & targets · Mappings · Exporting orders
- Troubleshooting · FAQ
For integrators
- Mapping language reference — every node type, function and available order field
- Acknowledgement callback — the contract your ERP implements
For developers
- Architecture & background processing — pipeline, state machine, data model, queue, retries, circuit breaker, scheduled task, environment, testing
- Extension points — events, tagged interfaces, custom functions
- HTTP endpoints
- Changelog
Shopware resources
- Flow Builder · Rule Builder · Orders · Users & permissions
- Developers: Message queue · Scheduled tasks · Admin API · Events