Shopware

What it brings

Customers with an account and guest buyers (taken from their orders), as contacts.
Orders of the last 12 months and products with price and stock, read through the Shopware Admin API.
New orders and their status changes, accounts and confirmed newsletter subscriptions, through the app’s webhooks.
Carts as they happen, with the email typed at checkout, through the app’s storefront script.

Requirements

What	Why
Shopware 6.7, on your own server	The app is tested on self-hosted Shopware 6.7. Shopware’s cloud installs apps from the Shopware Store, where the Azimea app is not listed yet.
An admin account that can upload and activate extensions	To install the app.
The site on HTTPS	Keys are never sent unencrypted.
The link code used within 30 days	After that it expires; reinstalling the app gives a new one.

How it works

It is an app, not a plugin: no PHP code of Azimea runs in your shop. On install you see the permissions it asks for: read access to customers, orders and products, plus its own settings.
Reading: when the app is installed, Shopware registers your shop with Azimea and gives it read-only Admin API keys. Azimea reads customers, orders and products with them.
Sending: new orders, status changes, accounts and confirmed newsletter subscriptions reach Azimea through the app’s webhooks; carts and the email typed at checkout through its storefront script, which is never cached and hashes the cart’s identifier in the browser before it leaves.
Consent comes from Shopware’s own newsletter, once confirmed. An email typed at checkout never counts as consent.
Shopware orders do not say which cart they came from, so Azimea closes the cart of the same email address when it orders within 7 days.

Install and connect

Download the app: azimea-shopware.zip.
In the Shopware admin, go to Extensions › My extensions › Upload extension, upload the zip, then install and activate the app.
Open Extensions › My extensions › Azimea › Configure and copy the Link code; it looks like AZM-XXXX-XXXX-XXXX.
In Azimea, open Integrations › Shopware › Connect your store, paste the link code with your shop’s address and press Check and connect.
That is all: Azimea writes the store key into the app itself and clears the code. Put a product in the cart on your shop and it appears in Azimea.

There are no plugin keys to copy for Shopware: the app receives them from Azimea.

Statuses

The store and plugin statuses are explained in the overview; order statuses in carts and orders. Deactivating the app in Shopware puts the store in Error; activating it again brings it back.

Troubleshooting

Symptom	Likely cause	Fix
`stores.shopware_link_code_invalid`	The code does not match a Shopware shop at this address, or it expired.	Copy it again from the app’s settings; reinstall the app for a new one.
`stores.shopware_not_confirmed`	The shop has not finished installing the app.	Install the app again in Shopware.
`stores.shopware_app_deactivated`	The app is deactivated.	Activate it in Extensions › My extensions.
`stores.shopware_keys_rejected`	Shopware no longer accepts the app’s keys.	Reinstall the app, then check the connection.
`stores.shopware_permission_missing`	The app is not allowed to read one of the resources (named in the message).	Update the app in Shopware and accept its permissions.
`stores.shopware_api_not_found`	The Admin API did not answer at this address.	Use your shop’s own address.

All codes: error codes.

Disconnect

Removing the app in Shopware disconnects the shop at once; nothing else is needed. You can also press Disconnect next to the store in Azimea. Contacts and orders brought in so far stay in your account.