1. ShipStation Help Canada
  2. Integrations Help Guide
  3. Stores S

Shopware

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

This article contains:

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.

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

Follow the steps below 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 which 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. Open a new tab or browser window and log in to your ShipStation account.

  12. Go to Account Settings (the wrench icon in the upper right).

    V3 Closeup of Toolbar. Red box highlights the wrench icon for Settings.

  13. Select Selling Channels from the left-hand sidebar, then choose Store Setup.

    Left-hand sidebar. Under Selling Channels, red box highlights Store Setup

  14. Click + Connect a Store or Marketplace.

    Closeup of Store Setup. Red arrow points to Connect a Store or Marketplace button.

  15. Select the Custom Store tile.

    Custom Store tile.

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

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

  18. Click Test Connection, then Connect if the test is successful.

  19. 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).

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

Available Features

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

Key: Green checkmark. Supported feature. Yes. = Supported; Red X mark. Unsupported feature. No. = Not Supported; Grey dash icon. Not applicable. = Does Not Apply

Common ShipStation Features

Feature

Supported?

Custom Statuses
Green checkmark. Supported feature. Yes.

Customer Emails
Green checkmark. Supported feature. Yes.

Customer Phone Numbers
Green checkmark. Supported feature. Yes.

Requested Service
Green checkmark. Supported feature. Yes.

Payment Method
Green checkmark. Supported feature. Yes.

Discounts
Red X mark. Unsupported feature. No.

Identifies Gift Orders
Red X mark. Unsupported feature. No.

Internal Notes
Green checkmark. Supported feature. Yes.

Notes from Buyer
Green checkmark. Supported feature. Yes.

Order Weight
Green checkmark. Supported feature. Yes.

Item Weight
Green checkmark. Supported feature. Yes.

Item Images
Red X mark. Unsupported feature. No.

Item Options
Red X mark. Unsupported feature. No.

Item Warehouse Location
Red X mark. Unsupported feature. No.

Status Mappings

Status

Shopware Status

Awaiting Payment

notpaid

Awaiting Shipment

paid

Shipped

shipped

Cancelled

cancelled

On Hold

on-hold

Sent with Shipment Update

Field

Supported?

Status Update
Green checkmark. Supported feature. Yes.

Tracking Number
Green checkmark. Supported feature. Yes.

Carrier
Green checkmark. Supported feature. Yes.

Service
Red X mark. Unsupported feature. No.

Carrier Fee
Red X mark. Unsupported feature. No.

Note to Buyer
Red X mark. Unsupported feature. No.

Item Information
Green checkmark. Supported feature. Yes.

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.

ShipStation will update the order on the selling channel to the Shipped, Fulfilled, or Completed status after a shipment or fulfillment is created.

The shipment update ShipStation sends to the selling channel will include the shipment tracking number.

The shipment update ShipStation sends to the selling channel will include the carrier used for the shipment.

The shipment update ShipStation sends to the selling channel will include the shipping service used for the shipment.

The shipment update ShipStation sends to the selling channel will include the carrier's cost for the shipping label.

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

The shipment update ShipStation sends to the selling channel will include details about the specific line items in the shipment, which allows for partial shipment updates.

Integration Notes

Keep this in mind about ShipStation's integration with Shopware:

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

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.

ShipStation will update the order on the selling channel to the Shipped, Fulfilled, or Completed status after a shipment or fulfillment is created.

The shipment update ShipStation sends to the selling channel will include the shipment tracking number.

The shipment update ShipStation sends to the selling channel will include the carrier used for the shipment.

The shipment update ShipStation sends to the selling channel will include the shipping service used for the shipment.

The shipment update ShipStation sends to the selling channel will include the carrier's cost for the shipping label.

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

The shipment update ShipStation sends to the selling channel will include details about the specific line items in the shipment, which allows for partial shipment updates.

Related articles

Didn’t Find What You Were Looking For?