Scout topShelf

How to add a Scout topShelf account to ShipStation, what features are available, and other need-to-know details.

Scout topShelf is a cloud-based warehouse management system. Access topShelf from any internet-enabled device, automate, track, and manage inventory for multiple warehouses in real-time, ensure order accuracy, ship bundled products, and more.

topShelf offers two ways to integrate with ShipStation:

Shipping Integration

This is the original topShelf/ShipStation integration, where topShelf is set up as a Store in ShipStation. Orders import from the original selling channel into topShelf, then ShipStation imports those orders from topShelf. When you ship an order, ShipStation updates topShelf with shipment information and topShelf then updates the order.

Here are the main features of the Shipping integration:

  • Orders originate in topShelf and are only sent to ShipStation once the order has been picked in topShelf.

  • Tracking information is sent back to topShelf once the order has shipped within ShipStation.

Topshelf Shipping flow graph.

For more information on how the Shipping integration works, please check out this topShelf video.

Pick Pack Integration

This is a more recent integration that was developed by Scout. In this integration, you do not create a Store for topShelf in ShipStation. Instead, you connect your selling channels to ShipStation so ShipStation will import the orders from the selling channel directly. When you ship an order, ShipStation updates the sales channel directly.

topShelf is connected to ShipStation using our Open API, which allows them to pull order information from ShipStation. This lets them track the stock levels and ship from locations for your orders as you manage them through ShipStation.

Here are the main features of this Pick Pack integration:

  • Orders originate in ShipStation and are then populated into topShelf.

  • topShelf will update the Custom Field #3 field in ShipStation to indicate the Pick/Pack status of the order.

  • Multi Warehouse compatibility. If an order in ShipStation is set to be fulfilled from a specific Warehouse location, that information passes into topShelf.

Topshelf Pick Pack workflow graph.

For more information on how the Pick Pack integration works, please check out this topShelf video.

Scout topShelf Requirements

Connection Requirements:

  • An active Enterprise or Unleashed topShelf subscription plan. Learn about Scout topShelf pricing here.

    • Enterprise can only connect to ShipStation using the Pick Pack Method.

    • Unleashed can connect to ShipStation using either the Pick Pack Method or Shipping Method.

  • Your topShelf Username and Password.

Order Import Requirements:

  • Include a Ship To address.

  • Order address must include State and Zip code.

  • Be picked in topShelf.

Connect a topShelf account to ShipStation

To connect your topShelf account to ShipStation:

Note

The steps below cover how to connect topShelf to ShipStation using their Shipping integration method. If you're using the Pick Pack integration method, check out this video from topShelf instead.

  1. Select the Scout topShelf tile.

    TopShelf logo
  2. Enter your topShelf UserName and Password.

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 Scout topShelf Integration

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

Note

These features are available if you're using the Shipping integration method for topShelf. If you're using the Pick Pack integration method, see this video from topShelf instead.

Common ShipStation Features

Default Status Mappings

Status

topShelf Status

Awaiting Payment

Not Supported

Awaiting Shipment

Picked

Shipped

Not Supported

Cancelled

Not Supported

On Hold

Not Supported

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

Green checkmark. Supported feature. Yes.

Carrier Fee

Green checkmark. Supported feature. Yes.

Note to Buyer

Red X mark. Unsupported feature. No.

Item Information

Red X mark. Unsupported feature. No.

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

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