eBay

How to add an eBay store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

Sell on eBay and access 170 million active users in nearly 200 countries. Benefits like branded tracking pages, product information imports, order detail imports, and the eBay Global Shipping Program will help you to grow your brand and reach new markets.

Follow this link to our article to learn about eBay Guarantee Delivery.

Updated to eBay's REST API

ShipStation has updated our integration with eBay to use their current REST API. This allows the use of the new eBay Order Number format.

However, this update has retired some legacy features such as Automatic Customer Feedback and Promotions of Related Items in Shipping Emails.

Follow the steps in the Migrate to the New eBay Integration section to ensure you are using the current eBay integration.

eBay Requirements

Connection Requirements:

  • An active seller account with eBay.

  • eBay username and password.

    The username field for eBay store connections has a limit of 50 characters. If a username exceeds 50 characters, you will receive an error.

Order Import Requirements:

  • Include a Ship To address.

  • Contain at least one item.

Connect an eBay store to ShipStation

To connect your eBay store to ShipStation:

Multiple eBay Stores

If you're connecting multiple eBay stores to ShipStation, we recommend you log out of any active eBay sessions before connecting the accounts.

  1. Select the eBay tile.

    eBay logo
  2. Click Connect.

    PU_eBay_Connection.png
  3. Log in to your eBay account to authorize the connection.

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 eBay Integration

ShipStation's integration with eBay supports the following standard features:

Common ShipStation Features

Sent with Shipment Update

Field

Supported?

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

Green checkmark. Supported feature. Yes.

Note to Buyer

Red X mark. Unsupported feature. No.

Item Information

Green checkmark. Supported feature. Yes.

Additional Features for the eBay Integration

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

Feature

Description

Imports orders that are part of the eBay Global Shipping Program

Orders that belong to the eBay Global Shipping Program will import into ShipStation alongside your other eBay orders.

Supports eBay Guarantee Delivery orders (Door-to-Door only)

ShipStation will import eBay Guarantee Delivery orders alongside your other eBay orders. ShipStation supports eBay Guarantee Delivery orders that use the Door-to-Door option.

Review our eBay Guarantee Delivery FAQ article for more details.

Supports eBay Order Number Identifier

ShipStation will import eBay's new Order Number format.

You must migrate to the new eBay integration to import the new order number format.

Support-enabled Features for the eBay Integration

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

Feature

Description

Custom Fields

Contact ShipStation Support to map the following eBay fields into ShipStation's three Custom Fields:

  • eBay External Transaction ID

  • eBay Item ID

  • eBay Order ID

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's Legacy Layout.

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.

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 Details about the eBay Integration

  • No Shipment or Delivery emails for eBay orders: eBay will send customer notification emails when ShipStation notifies eBay of the shipment.

    • We recommend that you handle shipment confirmation in eBay.

    • Branded tracking and Branded SMS will not be useable with eBay.

    • Returns or return portal communications should also be handled in eBay.

  • Item SKUs: To import Item SKUs from eBay into ShipStation, you'll need to add the Custom Label attribute to your listings and define the Custom Label for each. If you're not sure how to add the Custom Label to eBay listings, follow the steps below.

    Note

    This feature is only available if you're using eBay Selling Manager or Selling Manager Pro.

    1. Log in to your eBay account and navigate to Active Listings.

    2. Click the Customize link at the top right of the page.

    3. Check the Custom Label checkbox and it will be added to the list. You can change the order of how you want it to appear if you like. Click Apply.

      At this point, you should see a Custom Label column in your listings.

    4. Click [Add] to define the value for each listing.

  • Weight and Dimensions (dimensions will no longer import on the new eBay integration released on March 3rd, 2021).

    ShipStation will only receive item weight and dimensions if your store is using eBay's calculated shipping costs. If you're using flat-rate or free-shipping options, weight and dimensions will not be sent to ShipStation.

    Additionally, ShipStation can only import dimensions for single-item, single-quantity orders. If there's more than one product on an order, ShipStation will only import the weight.

  • Single shipment update only: ShipStation can only update an eBay order with shipment information once. If ShipStation tries to send eBay additional shipment updates, eBay will ignore them.

  • Automatic feedback unavailable in ShipStation: eBay no longer allows for feedback messages to be sent via ShipStation's store settings. You can still utilize eBay's Automatic Customer Feedback feature by setting it up directly in your eBay account.

eBay Troubleshooting Tips

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

Issue

How to troubleshoot or resolve

Error "Auth token has expired" when trying to update an eBay store's orders

As a security measure, the authentication token eBay creates for third-party integrations like ShipStation expire after a set time. This error means the authentication token we're using has expired and needs to be renewed.

To renew the token, reconfigure the eBay store's connection with ShipStation.

How can I identify my eBay Global Shipping Program orders?

All orders that are part of the eBay Global Shipping Program (GSP) use a standard address with an Address Line 1 that begins with "Reference #" to identify the orders. To make those orders stand out, or make them easier to filter, we recommend that you tag the orders with an automation rule.

  1. Create an order tag specifically for your GSP orders.

  2. Create an automation rule that looks for eBay orders with a Address Line 1 that begins with "Reference #" and applies the tag you created. Here's an example:

    Automation Rule Example for ebay

Error Comment Too Long occurs on ShipNotify if your Automatic Customer Feedback message is over 80 characters.

Update the Automatic Customer Feedback to be less than 80 characters, then retry the shipment update. This eBay Help article explains the Automatic Customer Feedback feature in eBay, but not the 80 character limit.

Error: The username that was provided during store setup was not the same username that was authenticated on eBay. Please return to the store setup page and try again.

This error message means your eBay username is too long. The username field for eBay store connections has a limit of 50 characters. If a username exceeds 50 characters, you will receive an error because the username will cut off at 50 characters.

Solution: You'll need to do two things: change the username in eBay to be fewer than 50 characters and then reconfigure the store in ShipStation with the new store name. 

After you change the username in eBay, go in ShipStation to Settings > Selling Channels > Store Setup. Click Modify next to eBay on the Store Setup page,  enter the new username, and click Connnect.

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's Legacy Layout.

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.

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