Customer Data Synchronization
Learn how customer data is synchronized between Shopware and BC.
Customer data synchronization ensures that your customer master data is consistent in both systems.
1. Synchronization Direction
Shopware → BC
Customer data is primarily synchronized from Shopware to Business Central:
Order Import
Customer data is updated with every order.
Manual Download
Customer data can be retrieved manually.
BC → Shopware
At present, customer data is not transferred automatically from BC to Shopware. Changes must be made manually.
2. Synchronized Fields
No.
Customer Number (customerNumber)
Name
First Name + Last Name
Address
Street
Post Code
Postal Code
City
City
Country/Region Code
Country
Email Address
Phone No.
Phone
The bill-to address is transferred to BC as the main address.
Ship-to addresses that differ from the bill-to address are created as separate Ship-to Addresses:
The ship-to address from the order is checked.
If it differs from the bill-to address, a new ship-to address is created.
This address is assigned to the customer.
3. Customer Mapping / Customer Assignment
3.1 Mapping Types / Assignment Types
In the customer settings, you can define the mapping type:
Customer Number
Mapping by customer number
Standard for B2B
Mapping by email address
Flexible for B2C
Shopware ID
Mapping by internal ID
Technically reliable
3.2 New Customers
If no matching customer is found, the following two scenarios are possible:
Automatic creation (if enabled)
A new customer is created.
Manual assignment: The order is flagged with an error and the customer must be assigned manually.
4. Customer Template
When new customers are created, the Customer Template is used. Search for "Customer Templates" in BC to open the corresponding page.
The template defines:
Posting groups
Payment terms
Default settings
Fields marked with a red asterisk are mandatory. However, we recommend that you enter as much information as possible in order to create a detailed and meaningful template.
The customer template is stored in the configuration. To do this, navigate to the Shopware settings and scroll to the "Customer Settings" area. Then select the template you want under "Customer Template".
5. Practical Example
Order Import for a New Customer
The customer places an order in Shopware for the first time.
The order is imported into BC.
The system searches for an existing customer (email or customer number).
No customer found a new customer is created.
The order is assigned to the new customer.
Order Import for an Existing Customer
An existing customer places an order in Shopware.
The order is imported into BC.
The system finds the existing customer.
The customer data is updated (if it has changed).
The order is assigned to the customer.
Make sure you use consistent customer numbers, keep email addresses up to date, and avoid creating duplicates.
In addition, check the customer assignments regularly, run a duplicate check, and clean up inactive customers.
Do not change the customer number afterwards in either system, because this breaks the assignment.