Migrate to New Miva Connect Integration

ShipStation's new integration with Miva Connect supports new order status mappings and importing more order details. The Miva Connect integration will replace our existing Miva integration.

To use the new integration, you will set your old Miva store to inactive and create a new store connection with Miva Connect. This guide will help you plan your migration process so you don't miss any orders or ship orders more than once.

Scope of Support

While ShipStation Support can assist you with deactivating your old Miva store and connecting your new store, we recommend contacting Miva Support with questions about Miva Connect or the migration.

Additionally, installing the Miva ShipStation configuration file and creating a new API token in Miva are beyond the ShipStation scope of support.

See Miva's ShipStation integration guide for more details.

Important Miva Integration Changes

Miva Connect supports the following features that were not supported by our previous Miva integration:

  • Miva orders not yet paid or not paid in full can now import into ShipStation's Awaiting Payment status.

  • Importing discounts, identifying gift orders, and importing gift messages are now supported.

  • For Miva merchants who sell kits (where one SKU contains multiple product SKUs that make up the kit), the singular kit SKU will import with the order into ShipStation. The product SKUs will be listed in the order's item details in ShipStation.

  • Miva Order Custom Fields can be mapped to ShipStation shipment options during the store connection process. These fields are used in Miva to collect things like order notes during checkout, and they can be mapped to the following custom fields in ShipStation:

    • Additional Handling/Special Instructions

    • Deliver by Date

    • Do Not Prepay Postage

    • Gift Message

    • Has Alcohol

    • Hold Until Date

    • Insured Value

    • Non-Machinable

    • Package Type

    • Premium Program Name

    • Ready To Ship Date

    • Requested Warehouse

    • Saturday Delivery

    • Ship By Date

    • Show Postage

    See our Miva Connect integration guide for steps to connect your Miva store to ShipStation.

Plan Your Migration

Before starting your migration, we recommend preparing your ShipStation account to avoid disrupting your normal flow:

  • Any open orders in your Miva store will import into the new Miva Connect store in ShipStation, once you have completed the migration.

    If any of these orders previously imported into your old store and you made changes to them in ShipStation, you will need to make those changes again. To avoid this scenario, we recommend migrating to the new store after you have closed all shipments for the day and shipment notifications have been sent.

  • The store settings in your new Miva Connect store will be set at their default settings. Take note of the store settings in your old store first, like Branding, Email and Packing Slip Templates, the Branded Returns Portal, etc., so you can update your new store connection to match.

  • If you are using ShipStation webhooks, please follow these instructions to update the webhooks to the correct new store. You may also need to unsubscribe from the webhooks and re-subscribe with the correct Store ID.

  • If you are using ShipStation’s Open API, please note you will need to update the Store ID in the calls you are making to the new store ID number post-migration.

Migration Instructions

To migrate to Miva Connect, you will first set your old Miva store connection to inactive in ShipStation.

  1. Click the ellipsis Actions menu next to your Miva store, then click Set Store to Inactive.


Next, create a new store connection for Miva Connect:

Post-Migration Checklist

Once your new Miva Connect store is connected to ShipStation, we recommend checking the following settings to help quickly resume normal operations.

Where is my old Miva store?

In Settings > Selling Channels > Store Setup, vheck the box below the list of connected stores to show inactive stores. All your inactive stores will display without a value in the Status column.

Store Setup page with a store's inactive status outlined to show no status icon and arrow pointing to Show Inactive Stores option