> 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/configuration/basic-settings.md).

# Basic Settings

Once you have successfully completed the [Authentication to the Online Shop](/shopware/shopware6_en_us/configuration/authentication-to-the-online-shop.md), you should define the basic settings. Of course, you can adjust them at any time so that they match your requirements as closely as possible.

{% hint style="warning" %}
Without the basic settings, using the Shopware Connector will produce error messages and its functionality will be severely impaired.
{% endhint %}

#### 1. Shopware Configuration

You define the basic settings in the *"Configuration"* menu of the Shopware 6 API Connector in Business Central.

{% hint style="info" %}
Where is this?

Under [Authentication to the Online Shop](/shopware/shopware6_en_us/configuration/authentication-to-the-online-shop.md) you will find detailed step-by-step instructions with images showing how to find the "Configuration" menu.
{% endhint %}

The following subpages describe the tabs on the *"Settings"* page:

* **Shopware Information** was covered under [Authentication to the Online Shop](/shopware/shopware6_en_us/configuration/authentication-to-the-online-shop.md).
* **Order configuration** is described under [Order Configuration](/shopware/shopware6_en_us/configuration/basic-settings/order-configuration.md).
* **Customer configuration** is described under [Customer Configuration](/shopware/shopware6_en_us/configuration/basic-settings/customer-configuration.md).
* **Inventory configuration** is described under [Inventory Configuration](/shopware/shopware6_en_us/configuration/basic-settings/inventory-configuration.md).

<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%2FE4lmSy9jhwiSLPBEDTYO%2FBildschirmfoto%202026-04-27%20um%2014.40.45.png?alt=media&#x26;token=727074ce-f784-4148-9f16-af3b05241c7a" alt=""><figcaption></figcaption></figure></div>

#### 2. Shopware Mapping

In addition to the basic settings, you must configure the Shopware *"Mapping"*. It maps values between Business Central and Shopware.

{% hint style="info" %}
If, for example, you add a new shipping method or a different payment service provider to Shopware, you need to start a new initial download and match the new information. Existing mappings are not affected by this.
{% endhint %}

{% hint style="warning" %}
**IMPORTANT**

Before you can define these settings, a successful *"Shopware Initial Download"* must have taken place. You will find more information about the *"Shopware Initial Download"* here: [Initial Download](/shopware/shopware6_en_us/configuration/authentication-to-the-online-shop.md#initialdownload)
{% endhint %}

Open it via *"Shopware"* <i class="fa-right">:right:</i> *"Mapping"* in the action bar in BC.

<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%2FGv1g7mdGTxxU5Py1Yn1z%2FBildschirmfoto%202026-01-22%20um%2013.17.57.png?alt=media&#x26;token=5a6053f6-e8b3-45f5-94cc-74a5874655f2" alt="" width="563"><figcaption></figcaption></figure></div>

In the window that opens, you now need to configure the "*Module Name Filter"*. It indicates which subsection you are currently in. You can navigate through the various categories using the drop-down menu to its right.

<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%2F9a7OaTm0Kz2tsOnRTJMB%2FBildschirmfoto%202026-01-22%20um%2013.18.07.png?alt=media&#x26;token=45e3aa3c-db5c-4728-bf35-a908bbb1b2dc" alt="" width="563"><figcaption></figcaption></figure></div>

Assign the appropriate Business Central code to every Shopware function that is relevant to you, and vice versa.

The individual "*Module Name Filter"* options are described in more detail below:

**2.1 Payment Mapping**

In this table, each payment method from Shopware must be mapped once to a payment method in BC so that this information can be processed correctly.\
If you add a new payment method to your online shop at a later point in time, it must be matched as well. To do so, a new initial download must be performed first.

**2.2 Shipping Mapping**

In this table, every shipping method available in Shopware must be mapped to a shipping method, a shipping agent (for example DHL, DPD, and so on) and a shipping agent service (for example Standard, Express).\
If you add a new shipping method to your online shop at a later point in time, it must be matched as well. To do so, a new initial download must be performed first.

**2.3 VAT Mapping**

In this table, the tax rates from Shopware are mapped to a general business posting group and a general product posting group in Business Central so that the taxes on the entries in Business Central can be processed correctly.

If you add new tax rates to your online shop at a later point in time (for example when you start selling to a new country/region), they must be matched as well. To do so, a new initial download must be performed first.

**2.4 Item VAT Mapping**

In this table, the VAT product posting groups must be assigned to a Shopware code so that the tax assignment of the individual entries is correct here too.

**2.5 Currency**

In this table, the currency code is mapped between Shopware and Business Central. Currently only one currency is supported. Select the "*Is Selected*" checkbox for the currency you want to use.

**2.6 Sales Channel**

Nothing needs to be filled in in this table. However, you can hide unwanted sales channels by clearing the *"Is Selected"* checkbox.

**2.7 Salutations**

Mapping of salutations from Shopware to salutations in Business Central. This is relevant when you upload customers and is particularly common in B2B scenarios.

**2.8 Customer Groups**

Here you map a Shopware customer group to a customer group from Business Central.

**2.9 Country/Region**

Nothing needs to be filled in in this table.

**2.10 Language**

Check that the languages are mapped correctly.

**2.11 Status Management**

Here you can see the status of the order.

**2.12 Status Transition**


---

# 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/configuration/basic-settings.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.