Connecting Shopware 6

With the Shopware connection, Stockhub fetches the orders from your Shopware 6 webshop. Stockhub sends the stock and the track & trace back to Shopware. In this article you first create an integration in Shopware and then the connection in Stockhub.

What you need

• Access to the Shopware administration with an account that is allowed to create integrations.
• The address of your webshop, for example https://www.yourwebshop.com.

Creating an integration in Shopware

1. Log in to the Shopware administration.
2. Go to Settings > System > Integrations.
3. Click Create integration.
4. Enter a recognisable name, for example Stockhub.
5. Give the integration the rights of an administrator (Administrator). If you do not want that, choose a role that can view and edit products and orders.
6. Copy the Access key ID and the Secret access key. Shopware shows the Secret access key only once.
7. Save the integration.

More information is in the Shopware documentation: https://docs.shopware.com/en/shopware-6-en/settings/system/integrationen

Creating the connection in Stockhub

1. In the menu, go to Integrations > Sales channels.
2. On the Sales channels tab, click New sales channel. The Add sales channel window opens.
3. Choose Shopware.
4. Fill in the fields:
   • Description: a recognisable name for the connection, for example the name of your webshop.
   • Shipping name: the name on the shipping label. If you leave it empty, Stockhub uses your company name.
   • URL: the address of your Shopware webshop with https://, for example https://www.yourwebshop.com. Do not add /api; Stockhub adds that itself.
   • Client ID: the Access key ID from Shopware.
   • Client Secret: the Secret access key from Shopware.

5. Click Test connection. If you see Connected, Stockhub can reach your webshop. If you see Connection failed, check the URL and the keys.
6. Click Next.
7. Choose which data Stockhub exchanges. Set each setting to Active or Inactive:
   • Import orders: fetch orders from Shopware.
   • Update existing product info and Import new products: you only see these if the fulfilment company has turned them on.
   • Update stock to channel: send the stock from Stockhub to Shopware.
   • Sync a virtual stock amount: Stockhub adds this amount to the stock it sends to Shopware.
   • Send track & trace email: you only see this if the fulfilment company has turned it on.
8. Click Save.

You then see the message Pending sales channel approval. The channel stays in draft status until the fulfilment company activates it. Only then do the synchronisations start.

How the Shopware connection works

• Stockhub fetches orders whose payment has the status Paid or Authorized, or that are paid by invoice. Stockhub skips orders that have already been shipped completely.
• Stockhub recognises products by the product number, or otherwise by the EAN.
• If Process orders (with tracking) is on, Stockhub adds the track & trace to the delivery and sets the delivery to Shipped.

On the Details tab you can later change the Webshop URL, the Client ID and the Client Secret, for example if you have created a new key in Shopware.

See also Verkoopkanalen beheren for all settings, the orders of the channel and deleting a channel.