How to use ShippingEasy with 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. To integrate your X-cart store with ShippingEasy, follow our step-by-step guide .

X-Cart versions supported by ShippingEasy:

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

Click through the sections below to find more details on how X-cart works with ShippingEasy.

Syncing Orders

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. The following are frequently asked questions about syncing orders from X-cart to ShippingEasy.

Are all orders automatically sent from X-Cart to ShippingEasy?

No. There is a configuration option in the X-Cart plugin for ShippingEasy where you can specify the status that an X-Cart order must have before it is sent automatically.

In X-Cart v4, select Settings > ShippingEasy  statuses. In this example, if an X-Cart order has a status of Processed it will be automatically sent to ShippingEasy where it will have a status of Awaiting Shipment - to add another status mapping, click the Add button:
 
In X-Cart v5, select Store setup > ShippingEasy statuses. In this example, if an X-Cart order has a status of Paid it will be automatically sent to ShippingEasy where it will have a status of Awaiting shipment - to add another status mapping, click the New item button:

How do I get existing X-Cart orders sent to my new ShippingEasy account?

In X-Cart v4, on the Order Management page, check the box next to the order and then click the Export to ShippingEasy button:

In X-Cart v5, on the X-Cart page for that order, just click the Export to ShippingEasy button at the bottom of the page:

What happens if I click Sync on the ShippingEasy ORDERS page?

For your X-Cart orders, "Sync with Store" has no affect.

Editing Orders and Shipments

ShippingEasy can recognize when certain changes have been made to an order in your store. For a complete overview, check out our FAQs on the topic. The following are frequently asked questions specific to X-cart orders that are still on the ORDERS page.

If I cancel an order in X-Cart, will it automatically be canceled in ShippingEasy?

Yes, if it was on the Orders screen in ShippingEasy, it will be removed from ShippingEasy automatically.

Shipment Changes and Updates

ShippingEasy updates your store with order information throughout the entire shipping process.

What information is sent back 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.

Will the shipment information be sent back to X-Cart if my web site uses HTTP instead of HTTPS?

No. ShippingEasy can only send shipment status information back to an X-Cart store if the web site is running on HTTPS.

What happens if I split an X-Cart order in ShippingEasy?

The X-Cart plugins for ShippingEasy support partial shipment. So as each of the orders that results from the split is shipped in ShippingEasy, the tracking numbers will be added in X-Cart. When the final order has shipped in ShippingEasy, the order status will be updated in X-Cart.

If I combine two orders in ShippingEasy, do both orders get updated in X-Cart?

No. Only the order that you selected in ShippingEasy for the address of the combined orders will be updated in X-Cart.

Orders and Product Information

ShippingEasy displays your order and product information on the ORDERS page, where you can customize what information you see. Learn more about customizing your ORDERS page.

Does ShippingEasy support X-Cart SKU values for my products?

Yes, these are displayed as the SKU in ShippingEasy.

Does ShippingEasy support X-Cart product options for my products?

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

Email Notifications

X-cart automatically sends shipment confirmation emails to your customer once their order has been shipped. Return label emails can be automatically sent to customers if they have included an email address with their order. Learn more about automatically sending prepaid return labels.

Customer Marketing

ShippingEasy offers a Customer Marketing solution to help build and grow relationships with your customers. Customer Marketing can be added to your ShippingEasy subscription at any time. A Customer Marketing subscription is managed by selecting a tier which determines how many emails you can send each month. Learn more about email credits.

Troubleshooting tips

The following are common issues and resolutions that can occur with ShippingEasy’s X-cart integration.

If an error occurs or an order does not get sent to ShippingEasy, how do I determine the problem when using X-Cart v4?

On X-Cart v4, within the X-Cart store, click the Tools tab and then select theMaintenance entry:

mn.png

Over on the right-hand side of the page, click See Also and then click Logs:

sa.png

Make sure the ShippingEasy option is checked, enter a 0 in the number of records field, and then click the Search button:

s.png

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 this message:

err.png

If an error occurs or an order does not get sent to ShippingEasy, how do I determine the problem when using X-Cart v5?

On X-Cart v5, within the X-Cart store, click the System settings tab and then select the View system logs entry:

sl.png

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 this message:

eoo.png

Was this article helpful?
0 out of 0 found this helpful

Comments

Add a Comment

Please sign in to leave a comment.