Miva Merchant

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

Miva provides ecommerce software and services to small and medium-sized businesses. They support product weights and images, include order notes and messages, and post shipping method, status, and tracking numbers.

Miva Merchant Requirements

Connection Requirements:

  • An active account with Miva Merchant (version 5.5 PR7 or higher.)

  • The ShipStation module for Miva Merchant must be downloaded and uploaded to Miva Merchant. The file can be found in the Miva Merchant connection window within ShipStation.

  • Username and Password

  • Module URL

  • Store Code (located under the Store Settings in the Dashboard.

    miva_quicklinks_store-settings_annotated.png

Scope of Support

Installing the module in Miva is beyond ShipStation's scope of support. We recommend you contact your store developer or Miva Support if you need assistance with the module installation process, as the process can differ based on the unique account configuration.

Order Import Requirements:

  • Include a Ship To address.

Connect a Miva Merchant store to ShipStation

To connect your Miva Merchant store to ShipStation:

Note

These instructions are for Miva Merchant 9. If you are using an older version of Miva Merchant, please contact support if you need assistance connecting your store.

  1. Download the ShipStation Miva Merchant module.

  2. Log in to your Miva Merchant admin site.

  3. Click Modules under Menu, or in the Quicklinks dashboard.

    miva_menu_modules_annotated.png
    Miva quicklinks with Modules icon highlighted.
  4. Click the + button at the top right-hand side of the screen.

    Miva modules menu module tabs with + button highlighted.
  5. Click the UPLOAD button and find the shipstation.mvc file saved on your computer, then click + Add.

    Miva add module menu with +Add and Upload buttons highlighted.
  6. Click Order Fulfillment under Menu or in the Quicklinks dashboard on the main page.

    Miva menu with Order Fulfillment option highlighted.
    Miva quicklinks with Order fulfillment highlighted.
  7. Click Add/Remove Modules, then Install the ShipStation Integration Script.

    Miva Order Fulfillment Settings menu with Add/Remove Modules and Install buttons highlighted.
  8. Click the new tab for ShipStation Settings. If you don't see that tab, refresh your browser.

  9. Set the ShipStation Settings as desired. Click Update when you're done.

    • Page Size: Default is 100, which is optimal for most Miva Merchant stores.

    • Product ID: Choose whether you want products to be identified based on SKU or Code. Use the Code option if you do not have SKUs assigned for your Miva Merchant products.

    • Warehouse Location: Choose if you want to send a Warehouse Location field to ShipStation, using either the SKU or Code.

    Miva Order Fulfillment Settings with ShipStation Settings highlighted.
  10. Select the Miva Merchant tile.

    Miva logo
  11. Enter your Miva Merchant admin Username and Password, the URL to Store modules folder, your Store Code, and choose your Miva Merchant version and Product Weight Unit.

    Tip

    The module URL can be in several different formats, depending on your Miva configuration. They will typically be in one of the following formats:

    • https://www.yoursite.com/mm5/5.00/modules/export/shipstation.mvc

    • https://www.yoursite.com/modules/export/shipstation.mvc

    • https://www.yoursite.com/Miva5/modules/export/shipstation.mvc

    • https://www.yoursite.com/Merchant5/modules/export/shipstation.mvc

    • https://www.yoursite.com/Merchant2/modules/export/shipstation.mvc

    • https://www.yoursite.com/5.00/modules/export/shipstation.mvc

    • https://www.yoursite.com/Miva5/5.00/modules/export/shipstation.mvc

    • https://www.yoursite.com/Merchant5/5.00/modules/export/shipstation.mvc

    • https://www.yoursite.com/Merchant2/5.00/modules/export/shipstation.mvc

    If you don't know your Miva Merchant Store Code, click Store Settings under Menu or in the Quicklinks dashboard on the main page. The Store Code will be listed under Identification.

After you've completed the connection steps, your store will be connected to ShipStation. You'll be taken to the store's Settings page to adjust the store-specific settings like branding, notification preferences, and product handling.

Available Features for Miva Merchant Integration

ShipStation's integration with Miva Merchant supports the following standard features:

Miva Merchant Additional Features

ShipStation's integration with Miva Merchant allows for the following additional features:

Feature

Description

Configurable Time Zone

By default, ShipStation assumes that the Miva Merchant store's server uses UTC as the timezone. If your Miva Merchant account uses a different server timezone, you can define it in the store's settings.

Configurable Custom Fields and Notes

You can configure a Miva Merchant order field value to be set to ShipStation as Custom Field 1, Custom Field 2, Custom Field 3, Notes from Buyer, or Internal Notes. Go to Order Fulfillment Settings > ShipStation Settings to set the values for these fields.

Custom StatusesCustomer EmailsCustomer Phone NumbersRequested ServicePayment MethodDiscountsIdentifies Gift OrdersInternal NotesNotes from BuyerOrder WeightItem WeightItem ImagesItem OptionsItem Warehouse LocationStatus UpdateTracking NumberCarrierServiceCarrier FeeNote to BuyerItem Information

Additional Details about the Miva Merchant Integration

  • To pull orders from Miva Merchant, your site must be secured with valid TLS/SSL certification.

  • Miva Merchant orders are only exposed automatically to ShipStation a single time. If you update the order in Miva Merchant after it's already imported into ShipStation, the updates will not be sent to ShipStation.

    • Manually force Miva Merchant to resend order information to ShipStation by going to Menu > Order Fulfillment > ShipStation Data, and unchecking any orders that you want to have resent. Any unchecked orders will be included the next time you Update the store in Shipstation.

      Miva Order Fulfillment Settings with arrow point to unchecked exported checkbox.
  • Miva Merchant version 9.10 introduced forced 2-Factor Authentication for Administrator Users, which interferes with ShipStation's ability to pull orders from the Miva Merchant store. If using Miva Merchant version 9.10 or higher you will need to disable 2-Factor Authentication for the Administrator user used to connect with ShipStation. Contact support@miva.com for details on how to disable 2-Factor Authentication.

Miva Merchant Troubleshooting Tips

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

Issue

How to troubleshoot or resolve

Why is the Order Date in ShipStation different than the Order Date in Miva Merchant?

This usually occurs because the Miva Merchant server is using a different timezone than the timezone set in the store's settings in ShipStation, which causes the Order Date to be thrown off when converting the timestamp based on time zone.

Update the store's settings so the store is using the same timezone as the server your Miva Merchant store is hosted on.

Why are certain orders placed late in the day not importing into ShipStation?

Similar to the issue above, this typically occurs because the Miva Merchant server is using a different timezone than the timezone set in the store's settings in ShipStation, which causes our import process to inadvertently skip ahead.

Update the store's settings so the store is using the same timezone as the server your Miva Merchant store is hosted on.

Custom StatusesCustomer EmailsCustomer Phone NumbersRequested ServicePayment MethodDiscountsIdentifies Gift OrdersInternal NotesNotes from BuyerOrder WeightItem WeightItem ImagesItem OptionsItem Warehouse LocationStatus UpdateTracking NumberCarrierServiceCarrier FeeNote to BuyerItem Information