ShipStation

To use the ShipStation app:

1. You'll need to have a ShipStation account; you can create one here
2. You'll need to configure a weight for each product
3. You'll need to configure the ShipStation app

To connect your ShipStation account to the app, you will need to add your ShipStation API keys in the app configuration page. To do this:

1. Log in to your ShipStation account and select the settings icon
   
2. Navigate to Account > API settings
   
3. At the bottom of the API settings page, your ShipStation API keys are displayed
   
4. Copy these keys (one at a time) to your computer's clipboard
5. In ShopWired, navigate to Apps > Manage > ShipStation
6. Paste the keys into the corresponding ShipStation API key and ShipStation API secret fields in the Settings section
   
7. Select save changes

Once saved, the app will verify the credentials entered. If correct, the page will reload with a range of settings for you to configure.

Use this setting to select which ShipStation store you want ShopWired orders to export to.

Enable this setting to automatically update the ShopWired order's status to the mapped status (as described below) when the order status on ShipStation changes to Shipped.

Enable this setting to send your customer an order status change email when the app updates the order's status (as described above).

Enable this setting to automatically populate the Ship By Date field in ShipStation when orders are exported from ShopWired. The app calculates the Ship By Date by taking the requested delivery date and subtracting the number of days specified in the Number of days to remove from the Delivery Date field.

In the Number of days to remove from the Delivery Date field, enter the number of days you want to subtract. For example, to ship orders two days before the requested delivery date, enter 2.

Use this setting to decide how international orders that cannot be delivered should be handled. You can choose either 'Treat as abandoned' or 'Return to sender'. All international orders will be sent to ShipStation with the option you select here.

In this setting, enter the postcode your business ships orders from. This is used to determine whether an order should be sent to ShipStation as international. If you're shipping between Northern Ireland and Great Britain, using this setting ensures the correct customs information is included when required.

Use the Order Status Mapping section to determine which order status should be applied in ShipStation when an order is created or updated through the app.

The app will either create a new order or update an existing order when the status of the order on ShopWired matches a status that has been mapped in the app.

ShipStation has 5 default order statuses:

• Awaiting payment
• On hold
• Awaiting shipment
• Shipped
• Cancelled

Use this section to configure the corresponding ShopWired order status for each ShipStation order status.

When mapping order status:

• You don't need to map every ShopWired status to a ShipStation status
• Changing an order in ShopWired to an unmapped status will not update the order on ShipStation
• More than one ShopWired order status can match the same ShipStation status

ShopWired's recommended configuration is:

Each delivery rate configured in your ShopWired account is displayed in the Shipping rate mapping section and grouped according to delivery zone.

To export orders to ShipStation with shipping services pre-selected, map your ShopWired delivery rates to corresponding ShipStation shipping services.

Where a shipping rate hasn't been matched with a ShipStation rate, the order will still export to ShipStation but without a shipping service. You will then need to set the shipping service within ShipStation.

Orders exported into ShipStation will appear in the orders section of your ShipStation account.

Each order is listed separately, and you can view orders with a particular status by selecting one of the status from the left menu in ShipStation:

• Updates to customer details or changes to the products ordered for an order in ShopWired are sent to the order in ShipStation
• Order comments will be exported with the order to ShipStation and will appear in the Notes from buyer section
• When a gift card is purchased, the order will be sent to ShipStation, and the message entered by the buyer to be included with the gift card will be sent as the gift note
• Once an order is marked as shipped or cancelled in ShipStation (whether manually or via an update from the app) any further status changes made in ShopWired will not be sent to ShipStation. This is due to a limitation in ShipStation's API, which does not allow status updates to orders that have already been marked as shipped or cancelled

When shipping orders internationally, the app can send the following customs information to ShipStation:

• An HS Tariff Code
• An origin country

This information can be added to products when creating or editing them in the admin system or when using the product import/export system.

To send customs information to ShipStation select the send customs information option in the Settings section. When selecting this option it is strongly recommended to disable automatic customs declarations in your ShipStation account (having both options selected may lead to duplicated customs information being present on orders within ShipStation).

For the HS Tariff Code to populate within the customs information for exported orders, you must configure a setting within your ShipStation account. Navigate to Settings > Shipping > International settings and select the Leave blank (enter manually) option for the Customs declaration setting.

When an order fails to export to ShipStation, it will be displayed in the export errors section. Orders can fail to export for a number of different reasons.

If an order fails to export, you may be able to resolve the issue either by updating the order or adjusting the app settings. You can then select retry auto-export to try exporting the order again.