The Acumatica ERP Integration add-on synchronizes customer information between X-Cart and Acumatica ERP during the export of an X-Cart order to an Acumatica Sales Order.
During order synchronization, the integration checks whether the customer already exists in Acumatica. If no matching customer is found, a new Customer record is created in Acumatica using the data from the X-Cart order.
Customer profiles are synchronized automatically as part of the order export process.
Customer identification
To determine whether a customer already exists in Acumatica, the integration uses the identifier specified in the Customer ID setting in the Acumatica Configuration section.
Depending on the selected option, different values from the X-Cart order are used to identify the customer.
Customer ID logic
If the selected identifier is missing in the order data, the integration uses fallback values according to the following rules:
Selected Customer ID setting | Primary identifier | Fallback identifiers |
Profile ID | ||
Phone | Phone | Email → Profile ID |
Profile ID | Profile ID | — |
This logic ensures that the system can still identify or create a customer profile even when some contact data is missing in the order.
Customer data used for synchronization
When a new customer profile is created in Acumatica, the integration uses information from the Billing Address of the exported X-Cart order.
Customer name
The CustomerName field in Acumatica is generated by combining the First Name and Last Name from the billing address.
Address fields
All address-related fields are taken from the Billing Address of the X-Cart order.
If address fields are missing or empty, the customer profile can still be created successfully in Acumatica.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!
Related articles
Acumatica ERP Integration add-on
Connecting to Acumatica ERP and initial setup