Magento

Magento provides a fully customizable shopping cart for ecommerce sellers, ranging from small businesses to enterprise retailers. ShipStation automatically syncs and updates your Magento orders, helps you sell on multiple stores, and supports Magento's invoice-after-shipping feature.

Schedule a free demo with Magento to learn more about what they have to offer.

Magento Requirements

Connection Requirements:

  • An active store using Magento 2.4.5 or higher.

    Magento platform versions later than what ShipStation officially supports may work without issue. However, ShipStation cannot support issues that occur when using an unsupported version. When Magento releases an update to their platform, ShipStation will validate our plug-in against it. Once validated, we will then support using our plug-in with that version of the Magento platform. Until then, if you upgrade your Magento account, you do so at your own risk. If you experience issues with an unsupported Magento version and the ShipStation plug-in, you must downgrade your Magento version.

  • The ShipStation API Key generated by the Auctane-ShipStation plug-in file.

  • Installation of the ShipStation-Magento plug-in file on your store web server.

    The plug-in is available to download from the ShipStation connection pop-up and on the Magento Marketplace.

Scope of Support

Installing the plug-in file to your web server is beyond ShipStation's scope of support. We recommend you contact your store developer or Magento Solutions Partner if you need assistance with plug-in installation, as the process can differ based on the unique Apache server configuration.

Order Import Requirements:

  • Include a Ship To address.

  • Include at least one physical product.

Connect a Magento store to ShipStation

Connecting a Magento store to ShipStation first requires setup within your Magento account. Once you have completed the steps in your Magento account, you can then follow the steps to connect the store to ShipStation.

Magento 2.4.x Plug-in Setup

Before you can connect your Magento 2.4.5 or higher site to ShipStation, you will need to:

  • Install and enable the Auctane extension file.

  • Generate and copy your API Key. The API Key will be used later when adding your Magento store to ShipStation.

Web Setup Wizard Removed

Starting with Magento 2.4.0, there is no longer a Web Setup Wizard. You must use the command line to enable modules and extensions.

Install the ShipStation Extension

  1. Download the Auctane-ShipStation module for Magento 2.x and extract the contacts to your Magento Folder.

  2. Log in to the Magento Admin site as your Administration User.

  3. Click System on the left, then Cache Management under Tools.

    Magneto v2 System Menu with Cache Management option highlighted.
  4. Select Flush Magento Cache.

    Magento v2 Admin with Flush Magento Cache selected.
  5. Enable the Auctane ShipStation module using the Magento command line. Follow the detailed steps in Magento's Enable or Disable Modules article found here.

Generate and Copy the API Key

  1. In your Magento Admin site, go to Stores > Configuration > ShipStation > General Settings . Then, click Generate and save api key.

    magento_2_3_generalsetting_api_MRK.png
  2. Select and copy the generated ShipStation API Key.

  3. Log in to ShipStation.

Connect to ShipStation

After you've set up the Auctane module in your Magento site and created the admin user, you're ready to connect the Magento store to ShipStation.

  1. Log into your ShipStation account.

  2. Select Magento.

    Magento logo on square tile button that reads, "Connect"
  3. Paste the ShipStation API Key that you generated and copied in the previous steps into the API Key field.

    Paste the Magento API Key into the API Key field in ShipStation.
  4. Switch back to your Magento admin console and go to General > Web. Then, copy the Base Link URL

    The Magento admin console is open to General > Web and the Base Link URL is selected.
  5. Paste the Base Link URL that you just copied into the Store URL field in ShipStation. Use HTTPS if possible (for example: https://www.mystore.com).

    Enter the Magento Base Link URL into the Store URL field in ShipStation.

    Multiple Magento Stores

    If you manage multiple stores in Magento and want the ShipStation store connection to be store-specific, you must modify your Store URL using the Store View Code.

    Skip to the Connect Multiple Stores section below for detailed instructions.

  6. Adjust your custom status mappings, if needed.

    ShipStation will automatically fill in the most common Magento status mappings, but if you use any custom status mappings, update them in the provided status fields.

    Magento connection screen, shows the various status fields
  7. Choose options in the connection window for Warehouse Location Attribute, Invoice after shipping, Product Weight Units, and Enable Partial Shipping.

    Magento v2 connections screen, shows the warehouse location attributes, Invoice after shipping, and product weight units fields
    • The Warehouse Location Attribute field requires you to have configured this as a custom attribute in Magento.

      If you add this as a custom attribute at a later time, you will need to reconfigure your store connection in ShipStation before the attribute will import correctly.

  8. Click Test Connection to verify that your connection is ready to go, then click Connect to make this store active in ShipStation.

    SET_STORE_Magento_BTN_Test_Connect_MRK.png

After you've completed the connection steps, the store's Settings page will open. You can adjust your store-specific settings like branding and customer notifications, if you wish. Or click Save to close.

Connect Multiple Stores From One Account

If you manage multiple Magento stores within a single Magento account and want your connection to be store specific, you can do so by using a special Store URL format that includes your Magento Store View Code parameter.

This will limit order requests to the orders contained in the specified store. You can also connect each store within your Magento account so each store's orders will import into the corresponding store in ShipStation.

First, locate your Store View Code in your Magento Admin panel:

  1. Go to System > Manage Stores.

  2. Click the store link in the Store View Name column.

  3. Copy the code from the Code field.

Next, you'll follow connection steps 1-7 from the Connect to ShipStation section above. When you reach Step 8, follow the instructions to locate your Store URL but use the instructions below to modify the URL format.

  1. Enter the Store URL into the Store URL field using one of the formats listed below, where [store view code] is the code you copied from your Magento Admin panel.

    The structure of the URL will depend on whether your site allows direct access to PHP files.

    • https://[websitedomain.com]/[store view code]/api/auctane/index/store/[store view code]

    • https://[websitedomain.com]/[store view code]/api/auctane

    The Magento setting to Add Store Codes to Urls must be set to Yes. Review Magento's Set Up Multiple Websites article for more information on where to locate this setting.

  2. Click Test Connection to see if the steps you followed worked correctly.

  3. Complete steps 10-12, as listed in the Connect to ShipStation section above.

  4. Repeat the same process to connect any additional Magento stores in your ShipStation account.

Available Features for Magento

The ShipStation integration with Magento supports the following standard features:

Order Status Mapping

ShipStation Status

Magento Status

Awaiting Payment

Pending

Pending Payment

Awaiting Shipment

Payment Received

Invoiced

Processing

Shipped

Complete

Cancelled

Cancelled

Canceled

Closed

On Hold

On Hold

Holded

Data Sent with Shipment Notification

This table indicates which data ShipStation sends to Magento with the marketplace shipment notification:

Field

Sent to Marketplace?

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.

Status UpdateTracking NumberCarrierServiceCarrier Fee

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

Item Information

Additional Features for Magento

The ShipStation integration with Magento allows for the following additional features:

Feature

Description

Invoice on Shipping

When configuring your Magento store connection, you can choose whether your store invoices when the order is placed or when the order is shipped.

If your store invoiced upon shipment, ShipStation will include an action to invoice the order when we send the shipment update to Magento.

Partial Shipping

When configuring your Magento store connection, you can choose to Enable Partial Shipping.

Magento v2 connections screen, shows the warehouse location attributes, Invoice after shipping, and product weight units fields

If Partial Shipping is enabled, the shipment notification ShipStation sends to Magento will include specific product information so that only the products included in the shipment will be updated as Shipped in Magento.

🇺🇸 Send ShipStation Rates to Magento Checkout

For US-based ShipStation accounts: The ShipStation Checkout Rates option allows you to send the rates you get in ShipStation to your store checkout for your customers to select.

Use the latest version of the ShipStation plug-in to Send Rates to Store Checkout. For details on how to enable Checkout Rates for Magento, review the Enable Checkout Rates Option for Magento section of our Connect Checkout Rates to Your Store article. Visit Magento's ShipStation page to get the most recently updated plug-in in their marketplace.

The plugin 2.4.1 supports sending Estimated Shipping times and Descriptions ShipStation to Magento's checkout screen.

We currently do not support Checkout Rates with multi-storefront Magento Stores.

Support-Enabled Magento Features

In addition to the features listed above, the following settings can be enabled for your Magento store by the ShipStation User Success team.

Feature

Description

Custom Fields

Up to three Custom Fields can be mapped for a Magento store. Available custom fields are as follows:

  • Coupon Code

  • Delivery Date

  • Discount Amount

  • Dispatch Date

  • Order Status

  • PO Number

  • Requested Warehouse

Suppress Internal Notes

If enabled, this setting will prevent ShipStation from importing Internal Notes from your Magento store.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

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. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

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

Item Information

Magento Integration Notes

  • With the ShipStation 2.2.3 plug-in or later, a single Magento instance can support exporting orders to ShipStation in different currencies.

  • If using ShipStation Legacy, Magento orders that have been split must retain their original order number. If the order number is changed, such as by adding a suffix, ShipStation cannot successfully update Magento with the shipment information.

Magento Troubleshooting Tips

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

Issue

How to troubleshoot or resolve

Magento Pickup Orders Require Tracking Number

When a customer picks up an order and you want to mark it as shipped, Magento will not update the order as shipped without a Tracking number.

What to do: Add a dummy tracking number such as 0 or the Order Number.

Error: We received an error testing the Magento store: Invalid data returned from API

What it means: This may be caused by entering an incorrect username when connecting the store to ShipStation.

What to do: Reconfigure your store connection in ShipStation and be sure to enter the username created for the ShipStation user in Magento.

Error: Order does not exist.

What to do: Reconfigure your Magento store connection in ShipStation. Check that you are using the correct secure or unsecure connection option.

The ShipStation shipment notifications are not successfully updating your orders in Magento.

What to do: Ensure you have updated to the most recent ShipStation plug-in.

Once the plug-in has been updated, resend your marketplace notifications from ShipStation.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

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. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

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

Item Information