1. ShipStation Help
  2. Integrations Help Guide
  3. Stores T-Z

X-Cart

Avatar

ShipStation Content Team

Updated

X-Cart is a flexible, open-source platform that offers both hosted and self-hosted options, making it an ideal shopping cart for businesses of all sizes. Connect with X-cart with ShipStation and automatically import and sync order information, see all product details with pick lists and pack slips, and receive automatic shipping updates for those orders.

Schedule an X-Cart demo to learn more about the features they have to offer.

X-Cart Requirements

Connection Requirements:

  • An active X-Cart store using X-Cart version 4.4 or greater.

    • 4.4.x - 4.7.x

    • 5.1.0.x - 5.5.0.x

  • Your X-Cart admin username, password, and URL to X-Cart store.

  • The ShipStation X-Cart module must be installed and activated in the X-Cart store.

Scope of Support

Installing the module to your X-Cart webserver is beyond the scope of ShipStation support. We recommend you contact your store developer or X-Cart Support if you need assistance with the module installation process, as the process can differ based on the unique Apache server configuration.

Order Import Requirements:

  • Include a Ship To address.

Connect an X-Cart store to ShipStation

To connect your X-Cart store to ShipStation:

  1. Go to Account Settings.

    sssettings.png

  2. Select Selling Channels from the sidebar, then choose Store Setup.

    Settings page selections, with outline marking the Selling Channels Store Setup option.

  3. Click Connect a Store or Marketplace.

    Store Setup Settings, box highlights Connect a Store or Marketplace button.

  4. Select X-Cart.

    X Cart logo. Button that reads, Connect

  5. Select Your X-Cart Version.

  6. Download and install the ShipStation module for your X-Cart version.

  7. Enter your X-Cart administrator Username, Password, and the URL to X-Cart Store in the corresponding fields.

  8. X-Cart 5.x only: Map any custom statuses if needed. Both payment and shipping status should be included, with a | (pipe character) separating them. (Ex: Paid|New)

  9. Click Connect.

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.

Available Features for X-Cart

The ShipStation integration with X-Cart supports the following standard features:

Key: Green checkmark. Supported feature. Yes. = Supported; Red X mark. Unsupported feature. No. = Not Supported; Grey dash icon. Not applicable. = Does Not Apply

Feature

Supported?

Custom Statuses

Green checkmark. Supported feature. Yes.

Customer Emails

Green checkmark. Supported feature. Yes.

Customer Phone Numbers

Green checkmark. Supported feature. Yes.

Requested Service

Green checkmark. Supported feature. Yes.

Payment Method

Green checkmark. Supported feature. Yes.

Discounts

Red X mark. Unsupported feature. No.

Identifies Gift Orders

Red X mark. Unsupported feature. No.

Internal Notes

Red X mark. Unsupported feature. No.

Notes from Buyer

Green checkmark. Supported feature. Yes.

Order Weight

Green checkmark. Supported feature. Yes.

Item Weight

Green checkmark. Supported feature. Yes.

Item Images

Green checkmark. Supported feature. Yes.

Item Options

Green checkmark. Supported feature. Yes.

Item Warehouse Location

Red X mark. Unsupported feature. No.

Order Status Mapping

ShipStation Status

X-Cart v.4.x Status

X-Cart v.5.x Status

Awaiting Payment

Not Finished

Queued

Declined

Failed

Awaiting payment|New

Awaiting Shipment

Processed

Backordered

Paid|Processing

Paid|New

Shipped

Complete

Paid|Shipped

Cancelled

Not Supported

Cancelled|Will Not Deliver

Refunded|Will Not Deliver

On Hold

Not Supported

Declined|Will Not Deliver

Data Sent with Shipment Notification

This table indicates which data ShipStation sends to X-Cart 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

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

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

X-Cart Integration Notes

  • Configurable Time Zone: By default, ShipStation assumes that the X-Cart store's server uses UTC as the timezone.

    If your X-Cart account uses a different server timezone, please contact ShipStation support to change the timezone setting.

  • Custom Statuses are supported for X-Cart 5.x stores, but you can only set them when you connect the store to ShipStation.

    If you need to adjust statuses after you connect your store, you must contact ShipStation support for assistance.

  • Import Orders without Ship To data: To allow orders to import without ShipTo data, you must contact ShipStation support for assistance

X-Cart Troubleshooting Tips

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

Issue

How to troubleshoot or resolve

The Order Date in ShipStation is different than the Order Date in X-Cart

What it means: This problem usually occurs because the X-Cart server is using a different timezone than the timezone set in the store's settings in ShipStation. That difference causes the Order Date to be thrown off when X-Cart converts the timestamp based on time zone.

What to do: Contact ShipStation support and ask an agent to update the store's settings so the store will use the same timezone as the server your X-Cart store is hosted on.

Certain orders placed late in the day do not import into ShipStation

What it means: Similar to above, this problem usually occurs because the X-Cart server is using a different timezone than the timezone set in the store's settings in ShipStation. That difference causes our import process to inadvertently skip ahead.

What to do: Contact ShipStation support and ask an agent to update the store's settings so the store will use the same timezone as the server your X-Cart store is hosted on.

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

Didn't find what you were looking for?