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 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:

Additional Features for the eBay Integration

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

Feature

Description

Import Click N Collect Orders

By default, ShipStation does not import Click N Collect orders, but you can enable this feature in ShipStation.

To enable Click N Collect order import into ShipStation, go to Settings > Selling Channels > eBay > Store Settings > Edit eBay Settings. Check the box Import Click N Collect Orders.

eBay_storeSettings_clicknship-MRK.png

Supports custom field mapping

You can map certain additional eBay fields for your orders into ShipStation's Custom Fields.

  • eBay Legacy Order ID (this imports the sales record number)

  • eBay Order Item ID (this imports the eBay item ID number)

  • eBay Listing Marketplace

  • eBay Purchase Marketplace

To map any of these fields to a Custom Field in ShipStation, go to Settings > Selling Channels > eBay > Store Settings > Edit eBay Settings.

eBay edit store settings popup with custom fields highlighted

Status Mapping for On Hold

You can map orders from the pending_cancellation status to On Hold status in ShipStation by enabling a store setting in ShipStation.

To enable the store setting, go to Settings > Selling Channels > eBay > Store Settings > Edit eBay Settings. Check the box Import eBay "Pending Cancellation" orders into "On Hold".

ebay_editsettings_onhold-cancelled_MRK.png

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.

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

  • Any email communications sent from ShipStation to your customers must be in compliance with eBay's member-to-member policy. This means the emails cannot contain contact information like email addresses, phone numbers, or website URLs. Additionally, if using ShipStation's Branded Tracking Page, you cannot include non-eBay store URLs or social media links. eBay will begin blocking communications - including emails from ShipStation - that violate their member-to-member policy on June 7th, 2021.

    For guidance on how to best configure your shipment and delivery email templates to ensure they comply with eBay's policy, review our FAQ article about creating an eBay compliant email template and Branded Tracking page.

  • 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.

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 before you can update your eBay orders in ShipStation again.

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

Error: Comment Too Long.

This error occurs on ShipNotify if your Automatic Customer Feedback message is over 80 characters.

Solution : 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 Connect.

Cannot import orders after reconfiguring eBay within ShipStation.

If you have already tried reconfiguring the selling channel within ShipStation and you still cannot import orders, you can revoke an eBay token from the eBay side to force a reconfigure within ShipStation.

  1. Sign in to My eBay.

  2. Go to My Account > Sign in and Security > Third-Party App Access.

  3. Select Show under Third-party authorizations.

  4. Check the Revoke this authorization box and click Apply.

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

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