This article describes how to connect your Shopware account with ShipStation.
Install & configure the ShipStation-Shopware plugin
1. Log in to your Shopware backend as an admin user.
2. Click Configuration, then Plugin Manager.
3. Search for the "ShipStation" plugin, then Install the plugin.
4. After the plugin has installed, open the plugin and go to the Configuration tab.
- Alternatively, from the main Shopware backend screen, click Configuration, then Basic Settings. Expand the Additional settings folder and choose ShipStation integration.
5. Define your Shopware paid, shipped, cancelled, and on-hold statuses, as well as the weight unit which is used for the product weight values within Shopware.
6. Click Save.
Create a new Shopware user (Recommended)
1. In the Shopware backend, click Configuration, then User administration.
2. Click Add user.
3. Create a new Shopware user which will be used just for ShipStation. Make sure API access is Enabled for the user.
- The new user does not need to be an admin user, nor does it require access to any specific permissions or roles, other than API access.
- Copy the Username and API Key - you'll need those to connect with ShipStation.
4. Click Save.
NOTE: This step is optional, but recommended in order to better track the actions taken by ShipStation in your Shopware backend logs. If you choose to skip this step, you'll need to gather the Username and API Key for an existing user so you can connect Shopware with ShipStation.
Connect the Shopware Account to ShipStation
1. In a new tab or browser window, log in to your ShipStation account.
2. Go to your Account Settings (the wrench icon in the upper right).
3. Select Selling Channels and then Store Setup from the left-hand sidebar.
4. On the new page, click +Connect a Store or Marketplace.
5. Select the Custom Store tile.
6. Fill out the Custom Store connection details with the following information:
- URL to Custom XML Page:
http://shopware.[Your Shopware ID].com/api/shipstation
- Username: Username for the new Shopware user.
- Password: API Key for the new Shopware user.
7. Fill out the Custom Store statuses as follows:
- Unpaid Status: notpaid
- Paid Status: paid
- Shipped Status: shipped
- Cancelled Status: cancelled
- On-Hold Status: on-hold
8. Click Test Connection, then Connect if the test was successful. A new ShipStation store will be created.
9. Set the Store Timezone setting to (GMT+00:00) GMT Standard Time (Greenwich Mean Time: London).
10. Fill out any other store details as desired, then click Save Changes.
Shopware Statuses & ShipStation
Shopware uses two statuses for orders - Payment Status and Order Status. ShipStation, on the other hand, only has a single Status field. To translate the status of the order to Shipstation, the plugin will look at both the Payment and Order status of the order in Shopware and simplify the status, based on the status definitions found in the plugin's configuration settings.
- First, the plugin will check to see if the Order Status is defined as a shipped, cancelled or on-hold status. If so, the order data will use that status.
- If not, the plugin will look at the Payment Status and check to see if it is defined as a paid status. If so, the order data will use the paid status.
- If neither the Order Status or Payment Status is defined, the order data will use the notpaid status.
If you need to adjust the definitions for your Shopware statuses, log in to your Shopware backend and click Configuration, then Basic Settings. Expand the Additional settings folder and choose ShipStation integration. Define the statuses as needed and Save the changes.