> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/shopware6_en_us/customer-management/customer-data-synchronization.md).

# Customer Data Synchronization

Customer data synchronization ensures that your customer master data is consistent in both systems.

#### 1. Synchronization Direction

{% columns %}
{% column %}
**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.
  {% endcolumn %}

{% column %}
**BC → Shopware**

At present, customer data is **not** transferred automatically from BC to Shopware. Changes must be made manually.
{% endcolumn %}
{% endcolumns %}

#### 2. Synchronized Fields

{% tabs %}
{% tab title="Master Data" %}

<table data-search="false"><thead><tr><th width="118.6300048828125">BC Field</th><th width="293.3887939453125">Shopware Field</th></tr></thead><tbody><tr><td>No.</td><td>Customer Number (customerNumber)</td></tr><tr><td>Name</td><td>First Name + Last Name</td></tr><tr><td>Address</td><td>Street</td></tr><tr><td>Post Code</td><td>Postal Code</td></tr><tr><td>City</td><td>City</td></tr><tr><td>Country/Region Code</td><td>Country</td></tr><tr><td>Email</td><td>Email Address</td></tr><tr><td>Phone No.</td><td>Phone</td></tr></tbody></table>
{% endtab %}

{% tab title="Bill-to Address" %}
The bill-to address is transferred to BC as the main address.
{% endtab %}

{% tab title="Ship-to Addresses" %}
Ship-to addresses that differ from the bill-to address are created as separate **Ship-to Addresses**:

1. The ship-to address from the order is checked.
2. If it differs from the bill-to address, a new ship-to address is created.
3. This address is assigned to the customer.
   {% endtab %}
   {% endtabs %}

#### 3. Customer Mapping / Customer Assignment

**3.1 Mapping Types / Assignment Types**

In the customer settings, you can define the mapping type:

<table><thead><tr><th width="164.3604736328125">Type</th><th width="273.883056640625">Description</th><th width="199.0538330078125">Recommendation</th></tr></thead><tbody><tr><td><strong>Customer Number</strong></td><td>Mapping by customer number</td><td>Standard for B2B</td></tr><tr><td><strong>Email</strong></td><td>Mapping by email address</td><td>Flexible for B2C</td></tr><tr><td><strong>Shopware ID</strong></td><td>Mapping by internal ID</td><td>Technically reliable</td></tr></tbody></table>

**3.2 New Customers**

If no matching customer is found, the following two scenarios are possible:

<table data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><p><strong>Automatic creation</strong> (if enabled)</p><p><i class="fa-right-long">:right-long:</i> A new customer is created.</p></td></tr><tr><td><strong>Manual assignment</strong>: The order is flagged with an error and the customer must be assigned manually.</td></tr></tbody></table>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FcnqUgYxvfnWaDVc6KxeD%2FBildschirmfoto%202026-04-09%20um%2011.27.15.png?alt=media&#x26;token=9fffec16-5b50-4754-9e7e-32c773863f39" alt=""><figcaption></figcaption></figure></div>

#### 4. Customer Template

When new customers are created, the *Customer Template* is used. Search for "Customer Templates" in BC to open the corresponding page.

{% columns %}
{% column width="33.33333333333333%" %}
The template defines:

* Posting groups
* Payment terms
* Default settings
  {% endcolumn %}

{% column width="66.66666666666667%" %}
{% hint style="warning" %}
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.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fu0ve4tmDRfVelhHqOXzf%2FBildschirmfoto%202026-04-16%20um%2010.04.14.png?alt=media&#x26;token=3002692e-4261-478e-a519-cd7119238622" alt=""><figcaption></figcaption></figure></div>

***

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".

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FHYVGhdzO1Zelu3lYTum3%2FBildschirmfoto%202026-04-16%20um%2009.36.40.png?alt=media&#x26;token=a4d1d5b3-c963-4d88-b71b-d1031292e8a1" alt=""><figcaption></figcaption></figure></div>

#### 5. Practical Example

{% columns %}
{% column width="50%" %}
**Order Import for a New Customer**

{% stepper %}
{% step %}
The customer places an order in Shopware for the first time.
{% endstep %}

{% step %}
The order is imported into BC.
{% endstep %}

{% step %}
The system searches for an existing customer (email or customer number).
{% endstep %}

{% step %}
No customer found <i class="fa-right">:right:</i> a new customer is created.
{% endstep %}

{% step %}
The order is assigned to the new customer.
{% endstep %}
{% endstepper %}
{% endcolumn %}

{% column width="50%" %}
**Order Import for an Existing Customer**

{% stepper %}
{% step %}
An existing customer places an order in Shopware.
{% endstep %}

{% step %}
The order is imported into BC.
{% endstep %}

{% step %}
The system finds the existing customer.
{% endstep %}

{% step %}
The customer data is updated (if it has changed).
{% endstep %}

{% step %}
The order is assigned to the customer.
{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}

{% hint style="success" %}
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**.
{% endhint %}

{% hint style="warning" %}
Do not change the customer number afterwards in either system, because this breaks the assignment.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/shopware/shopware6_en_us/customer-management/customer-data-synchronization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.