Shopware

How to add a Shopware store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

Shopware is an open-source platform for ecommerce selling that lets you create and customize an online store.

ShipStation integrates with Shopware through a downloadable plugin that allows us to import your Shopware order information and update Shopware when an order has been shipped.

Shopware Requirements

Connection Requirements:

  • An active account with Shopware.

  • Connect to ShipStation as a Custom Store.

    • URL: http://shopware.[ShopwareID].com/api/shipstation

    • Username: Shopware Username

    • Password: Shopware Username API Key

  • Must install and configure the ShipStation plugin for Shopware.

  • Supported versions: 5.2.0 – 5.2.27 | 5.3.0 – 5.3.7 | 5.4.0 – 5.4.6 | 5.5.0 – 5.5.7

Order Import Requirements:

  • Include a Ship To address.

Connect a Shopware store to ShipStation

To connect your Shopware store to ShipStation:

  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.

  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.

    Shopware ShipStation Configuration.
  6. Click Save then exit the Plugin Manager window.

  7. Click Configuration, then User administration.

  8. Click Add user.

    Note

    It's recommended you create a new user in order to better track the actions taken by ShipStation in the Shopware logs. If you do not want to create a new user, you can edit an existing user instead.

  9. Create a new Shopware user that will be used just for ShipStation. Make sure API access is Enabled for the user. Copy the Username and API Key.

  10. Click Save then exit the User administration window.

  11. Select the Custom Store tile.

    Custom Store tile.
  12. Fill out the Custom Store connection details as follows:

    • URL to Custom XML Page: http://shopware.[Your Shopware ID].com/api/shipstation

    • Username: Username for the Shopware user.

    • Password: API Key for the Shopware user

  13. 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

  14. After you've completed the above steps, your store will be connected to ShipStation. You'll be taken to the store's Settings page. Set the Store Timezone setting to (GMT+00:00) GMT Standard Time (Greenwich Mean Time: London).

  15. Fill out any other store details as desired, then click Save Changes.

Available Features for Shopware Integration

ShipStation's integration with Shopware supports the following standard features:

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer email address and can send customer shipment notification and delivery emails.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order.

ShipStation will import item options (such as color or size) for each line item in the order.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Additional Details about the Shopware Integration

  • For the shipping address lines, ShipStation can only import the Street and Additional Address Line 1. Additional Address Line 2 is not supported.

Shopware Troubleshooting Tips

Here are some common issues experienced by users, potential causes, and available troubleshooting tips.

Issue

How to troubleshoot or resolve

Orders are importing into ShipStation, but they are not in status which I was expecting.

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.

  1. 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.

  2. 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.

  3. 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.

Why are my order weights incorrect in ShipStation?

When getting order and product information from the Shopware database, the ShipStation plugin is not able to determine the weight unit which is associated to the weight value - it just sees a number, but no information on what weight unit that number is meant to represent.

In order for ShipStation to understand the weight unit which is associated to the value, you must define the weight unit setting in the Configuration settings of the ShipStation plugin. If weight unit is not defined, ShipStation will assume the value is meant to be interpreted as ounces.

If you need to adjust the weight unit the plugin will use for Shopware products, log in to your Shopware backend and click Configuration, then Basic Settings. Expand the Additional settings folder and choose ShipStation integration. Define the weight unit and Save the changes.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer email address and can send customer shipment notification and delivery emails.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order.

ShipStation will import item options (such as color or size) for each line item in the order.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information