X-Cart

How to add a X-Cart store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

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.

X-Cart Requirements

Connection Requirements:

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

  • 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 ShipStation's scope of 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

Follow the steps below to connect your X-Cart store to ShipStation:

  1. Select the X-Cart tile.

    Xcart logo.
  2. Select Your X-Cart Version.

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

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

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

  6. Click Connect.

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 X-Cart Integration

ShipStation's integration to X-Cart supports for the following standard features:

Common ShipStation Features

Default Status Mappings

Status

X-Cart Status

Awaiting Payment

4.x: Not Finished, Queued, Declined, Failed

5.x: Awaiting payment|New

Awaiting Shipment

4.x: Processed, Backordered

5.x: Paid|Processing, Paid|New

Shipped

4.x: Complete

5.x: Paid|Shipped

Cancelled

4.x: Not Supported

5.x: Cancelled|Will Not Deliver, Refunded|Will Not Deliver

On Hold

4.x: Not Supported

5.x: Declined|Will Not Deliver

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.

Additional X-Cart Features

ShipStation's integration to X-Cart allows for the following additional features:

Feature

Description

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, you can define it in the store's settings.

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 X-Cart Integration

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

  • Custom Statuses are supported for X-Cart 5.x stores, but they must be set when connecting the store to ShipStation. If the statuses need to be adjusted after a store has been connected, you will need to [reconfigure the store connection].

X-Cart Troubleshooting Tips

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

Issue

How to troubleshoot or resolve

Why is the Order Date in ShipStation different than the Order Date in X-Cart?

This usually occurs because the X-Cart 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 the store is using the same timezone as the server your X-Cart 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 X-Cart 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 the store is using the same timezone as the server your X-Cart 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