Zoey

How to add a Zoey store to ShipStation, what features are available, and other need-to-know details.

Zoey's ecommerce platform provides tools for B2B and wholesale business, from website design and shopping carts to marketing analytics. ShipStaton helps you to process and manage orders and shipments from Zoey's customer grouping, access restrictions, abandoned cart capabilities, and international selling.

Zoey Requirements

Connection Requirements:

  • An active account with Zoey.

  • Your API username and password (generated in your Zoey account).

  • Your Zoey store secure URL.

Order Import Requirements:

  • Include a Ship To address.

Connect a Zoey Store to ShipStation

Follow the steps below to connect your Zoey store to ShipStation:

  1. Login to your Zoey account here.

  2. Click Apps on the left, then click Manage next to ShipStation.

  3. Click Create The Connect To ShipStation API Credentials, then copy the API Username and API Password which are generated.

  4. Go back to Apps, then click Manage for the ShipStation General Settings.

  5. Scroll down and expand the General Settings, then adjust the settings as desired. The table below describes each option:

    Setting Name

    Description

    Values

    Price Export Type

    Controls whether ShipStation will receive the price and cost based on what the currency your customer saw at checkout, or the price and cost based on your account currency.

    Store Price: Storefront-specific currency (the price your customer sees at checkout.)

    Base Price: Default account currency (price before conversion to customer currency.)

    Import Discounts

    Controls whether coupons and discounts are sent from Zoey to ShipStation.

    Yes

    No

    Export custom attributes as custom options

    Controls which Custom Attributes will be sent to ShipStation as Item Options. One of these can also be mapped as Warehouse Location when you're connecting the store in ShipStation.

    Varies: List of Custom Attributes created in your Zoey account

    Import Child Products

    Controls how ShipStation will receive bundled products.

    Yes: Both the main bundle SKU and the individual bundle component SKUs will be received.

    No: Only the main bundle SKU will be received.

  6. Click Save Config.

  7. Select the Zoey tile.

    Zoey logo.
  8. Enter the API Username, API Password, and Secure URL, and map any custom statuses if needed.

  9. Set the optional Warehouse Location Attribute, Invoice after shipping option, and Enable Partial Shipping settings as desired.

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

ShipStation's integration with Zoey supports these standard features:

Common ShipStation Features

Default Status Mappings

Status

Zoey Status

Awaiting Payment

Pending, Pending Payment

Awaiting Shipment

Payment Received, Invoiced, Processing

Shipped

Complete

Cancelled

Cancelled, Canceled, Refunded

On Hold

On Hold, Holded

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

Green checkmark. Supported feature. Yes.

Item Information

Green checkmark. Supported feature. Yes.

Zoey Additional Features

ShipStation's integration with Zoey allows these additional features:

Feature

Description

Configurable Time Zone

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

Invoice on Shipping

When configuring your Zoey 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 Zoey.

Partial Shipping

When configuring your Zoey store connection, you can choose to enable Partial Shipping. If Partial Shipping is enabled, the shipment notification ShipStation will send to Zoey will include specific product information so that only the products in the shipment will be updated as Shipped on Zoey.

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

Here are some things you should keep in mind about ShipStation's integration with Zoey:

  • If selling in multiple currencies, ShipStation will import the price and totals as numbers and will not convert currency values. The currency symbol which will be displayed in ShipStation is based on your account's home country code.

  • If using ShipStation Classic, Zoey orders which are split must retain the original order number. If the order number is changed, such as by adding a suffix, ShipStation will not be able to update Magento with the shipment information

Zoey Troubleshooting Tips

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

Why is the Order Date in ShipStation different than the Order Date in Zoey?

This usually occurs because the Zoey 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 that the store is using the same timezone as the server your Zoey 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 Zoey 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 that the store is using the same timezone as the server your Zoey store is hosted on.

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