1. ShipStation
  2. Integrations Help
  3. Stores S

Shopware

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.

  • 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 to Shopware supports for the following standard features:

Common ShipStation Features

Feature

Supported?

Custom Statuses
Green checkmark

Customer Emails
Green checkmark

Customer Phone Numbers
Green checkmark

Requested Service
Green checkmark

Payment Method
Green checkmark

Discounts
Red X mark

Identifies Gift Orders
Red X mark

Internal Notes
Green checkmark

Notes from Buyer
Green checkmark

Order Weight
Green checkmark

Item Weight
Green checkmark

Item Images
Red X mark

Item Options
Red X mark

Item Warehouse Location
Red X mark

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

Tracking Number
Green checkmark

Carrier
Green checkmark

Service
Red X mark

Carrier Fee
Red X mark

Note to Buyer
Red X mark

Item Information
Green checkmark

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

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

Here are some things you should keep 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 Classic.

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?