X-Cart

ShippingEasy supports receiving orders from an X-Cart store and shipping those orders to your customers. Our partners at X-Cart have built plugins that provide support for using X-Cart with ShippingEasy. After you install a plugin on your X-Cart server, you will also add an X-Cart store into your ShippingEasy settings. When an order is entered on your X-Cart store, the plugin for ShippingEasy will connect to the ShippingEasy application and send the order details to your ShippingEasy account.

X-Cart Integration Requirements

Connection Requirements:

  • You must have a live account with X-Cart.

  • X-Cart 4 (v4.4.0 and higher) and X-Cart 5.3 are both supported.

Create Shipment Requirements:

  • Shipment and tracking information will not be sent from ShippingEasy to X-Cart if your store website uses HTTP instead of HTTPS. ShippingEasy can only send shipment information back to an X-Cart store if the website is running on HTTPS.

Connect X-Cart to ShippingEasy

Our partners at X-Cart have built integrations to ShippingEasy that you can use with either X-Cart v4 or X-Cart v5.  The steps for installing and configuring vary depending on your version of X-Cart.

If you are using X-Cart v4, this article from X-Cart shows how to install the plugin in X-Cart. To complete the integration, read the X-Cart article on integrating your X-Cart plugin with ShippingEasy.

Integrate X-Cart v4 with ShippingEasy

If you are using X-Cart v4, this article from X-Cart shows how to install the plugin in X-Cart. To complete the integration, read the X-Cart article on integrating your X-Cart plugin with ShippingEasy.

It is not necessary to add a rewrite rule into the .htaccess file, as outlined in Step 7 of the integration guide from X-Cart.

Integrate X-Cart v5 with ShippingEasy

If you are using X-Cart v5, installation of the plugin in X-Cart is simple.

  1. Log into your X-Cart store and search for ShippingEasy in the Modules Marketplace.

    201401969-1.png
  2. Click the Install option to install the ShippingEasy plugin.

    201480925-2.png
  3. The final step is to integrate the X-Cart plugin with ShippingEasy.

Support for Connecting X-Cart and ShippingEasy

If you run into any problems, feel free to reach out to the X-Cart Support team or ShippingEasy's Customer Success team.

X-Cart is your best resource for questions related to the X-Cart configuration of the integration. Submit a support ticket to X-Cart.

X-Cart Order Data

X-Cart Standard Data Supported

ShippingEasy's X-Cart integration supports the following features and order data fields:

Shipment Information Sent from ShippingEasy to X-Cart

In X-Cart v4, the carrier, service, tracking number, and shipping cost are displayed in the order detail as an order note that is not visible to your customer.

In X-Cart v5, the tracking number is displayed in the order detail screen.

Syncing X-Cart Orders to ShippingEasy

Unlike most ShippingEasy store integrations, X-Cart orders are not periodically read into your ShippingEasy account by the ShippingEasy application. Instead, orders are sent by your X-Cart store - in this case, specifically by the X-Cart plugin that supports ShippingEasy. The orders are sent as soon as they are entered, so there is no delay. Manually syncing your X-Cart store in ShippingEasy has no effect.

Troubleshoot Syncing Orders from X-Cart

If an error occurs or an order does not get sent to ShippingEasy, you can determine the cause of the error in X-Cart.

In X-Cart v4:

  1. Click the Tools tab within the X-Cart store, then select the Maintenance entry.

    X-Cartv4_Tools-Maintenance_MRK.png
  2. Click the See also tab on the righthand side of the page, then click Logs.

    X-Cartv4_Logs_MRK.png
  3. Make sure the ShippingEasy option is checked. Enter a 0 in the number of records field, then click the Search button.

    X-Cartv4_SearchLogs_MRK.png
  4. Look at the displayed log entries for any errors that occurred when the plugin was attempting to send the order to ShippingEasy. For example, if the API key values were entered incorrectly, you will see the error message Access denied.

    X-Cartv4_Logs_SearchResults_MRK.png

In X-Cart v5:

  1. Click the System settings drop-down menu within the X-Cart store, then select the View system logs entry.

    X-Cartv5_ViewSystemLogs_MRK.png
  2. Look at the displayed log entries for any errors that occurred when the plugin was attempting to send the order to ShippingEasy. For example, if the API key values were entered incorrectly, you will see the error message Access denied.

    X-Cartv5_Logs_Example_MRK.png

X-Cart Integration Notes

Canceling, Combining, and Splitting Orders

  • If you cancel an order in X-Cart, it will be automatically removed from your ShippingEasy account as long as it is still on the ORDERS page in ShippingEasy.

  • If you combine two or more X-Cart orders in ShippingEasy, only the order that you selected for the shipping address of the combined orders in ShippingEasy will be updated with the shipment and tracking information in X-Cart.

  • The X-Cart plugins for ShippingEasy support partial shipments. If you split an X-Cart order in ShippingEasy, the tracking numbers will be added in X-Cart as each part of the split order is shipped in ShippingEasy. When the final order has been shipped, the order status will be updated in X-Cart.

Product Details

If you define options for your products in X-Cart, the selected options will be displayed in ShippingEasy.

Be sure to enable Display Product Options in your ShippingEasy store settings for X-Cart. This information can be found by navigating to SETTINGS > Edit Store Settings link under the X-Cart store listing.

201639289-display_Prod._options.png

Email Notifications

X-cart automatically sends shipment confirmation emails to your customer once their order has been shipped.

Comments

Add a Comment

Article is closed for comments.

    Tags: