Order status mapping
page last edited on 08 November 2017
Order statuses used by ShippingEasy are not the same as those used by X-Cart, so, before orders from your X-Cart store can be exported to ShippingEasy, you will need to map order statuses in X-Cart to order statuses in ShippingEasy. To complete the task you will need to specify all the X-Cart statuses with which orders will need to be sent to ShippingEasy and - for each of these statuses - to specify the respective matching ShippingEasy statuses.
Here’s how you can do it:
In your X-Cart store’s Admin area, go to the ShippingEasy statuses page (Store setup > ShippingEasy statuses). You’ll see a screen like this (Initially, the ShippingEasy statuses page does not contain any items):
Select New item. This expands a section with two drop-down boxes:
Use this section to specify a pair of matching statuses.
For example, if you want order info to be sent to ShippingEasy when an order gets the payment status “Paid” in X-Cart, and you want this order to be marked as “Awaiting shipment” in ShippingEasy, you should select “Paid” from the drop-down box in the X-Cart payment status column and “Awaiting shipment” from the drop-down box in the ShippingEasy status column:
Click Save changes. The pair of matching statuses will be saved.
Repeat steps 1-4 if you need to specify more matching pairs of statuses.
As a result, you should have all the X-Cart payment statuses for which order info needs to be sent automatically to ShippingEasy listed in the X-Cart payment status column, and their respective matching ShippingEasy statuses listed on the opposite side in the ShippingEasy status column:
Your store will send order information to ShippingEasy no more than once per order. This means that when an order in X-Cart receives any of the statuses for which you have specified a matching status in ShippingEasy, information about this order will be automatically exported to ShippingEasy; if afterwards the status of this order in X-Cart changes to another status listed in the table, its information will not be sent to ShippingEasy again.
For example, according to the order statuses configuration demonstrated in the snapshot above (Partially Paid -> Awaiting shipment, Paid -> Awaiting payment), an order that gets the status “Partially Paid” in X-Cart will be sent to ShippingEasy; when this order is marked as “Paid”, it won’t be sent to ShippingEasy a second time.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.