> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/shopware.md).

# Shopware

Koppel Shopware 6 met een integratietoegangssleutel voor bestel-, omzet- en productgegevens.

Verbind Shopware 6 zodat AdPage bestel- en productgegevens uit je shop kan lezen. Shopware gebruikt een Admin API-integratie met een client ID en secret, dus dit is een verbinding met inloggegevens en geen goedkeuringsflow.

AdPage leest alleen.

{% hint style="info" %}
Dit is voor **Shopware 6**. Shopware 5 heeft een andere API en wordt niet ondersteund.
{% endhint %}

### Voordat je begint

Je hebt beheerderstoegang tot de Shopware-admin nodig, en een shop die vanaf het internet bereikbaar is.

Je maakt een **integratie**, waarmee je twee waarden krijgt: een **toegangssleutel-ID** en een **geheime toegangssleutel**.

{% hint style="warning" %}
**De secret wordt één keer getoond.** Shopware toont hem wanneer je de integratie aanmaakt en nooit meer daarna. Kopieer hem voordat je het dialoogvenster sluit.
{% endhint %}

### Maak de integratie aan in Shopware

{% stepper %}
{% step %}

#### Open het integratiescherm

Ga in de Shopware-admin naar **Instellingen → Systeem → Integraties** en kies **Integratie toevoegen**. Geef het de naam `AdPage`.
{% endstep %}

{% step %}

#### Geef het leesrechten

Wijs een rol toe die bestellingen, producten en verkoopkanalen kan lezen. De ingebouwde beheerdersrol van Shopware werkt; een aangepaste alleen-lezenrol is betere praktijk als je die hebt.
{% endstep %}

{% step %}

#### Sla op en kopieer beide waarden

Sla op en kopieer direct de toegangssleutel-ID en de geheime toegangssleutel.
{% endstep %}
{% endstepper %}

### Verbind Shopware in AdPage

{% stepper %}
{% step %}

#### Open de tegel

Ga naar **Integraties**, selecteer de container en open de **Shopware** tegel.

<figure><img src="https://3085749494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5kjEu8mwstNkOrvFl6S%2Fuploads%2FHWJ6fcUmgEJe9ByRNLAh%2Fintegrations-shopware-tile-en.webp?alt=media" alt="Shopware tile opened with the client ID and secret fields"><figcaption><p>De Shopware-tegel op de integratiepagina.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Vul de shop-URL en beide waarden in

De **basis-URL** is de root van je shop — `https://yourshop.nl`, **niet** de `/api` pad en niet de admin-URL. AdPage voegt het API-pad zelf toe.

Plak de toegangssleutel-ID en de geheime toegangssleutel.
{% endstep %}

{% step %}

#### Opslaan

AdPage benadert je shop voordat iets wordt opgeslagen en leest het standaardverkoopkanaal om te controleren of de inloggegevens werken. Inloggegevens die mislukken worden nooit opgeslagen.

Bij succes toont de tegel de winkelnaam die uit Shopware is gelezen, waarmee wordt bevestigd dat je de juiste shop hebt verbonden.
{% endstep %}
{% endstepper %}

### Wat je krijgt

Bestellingen, omzet en productgegevens in **Business & Omzet** en **Productprestaties**, waarbij orderomzet wordt doorgegeven aan het **Marketing Mix Model**.

Als je shop via meerdere verkoopkanalen verkoopt — bijvoorbeeld een webshop plus een marketplace — kunnen die worden gescheiden. Dat is belangrijk omdat marketplace-bestellingen in je rapporten niet worden aangestuurd door de advertenties.

### De cijfers lezen

**De bestelstatus is belangrijk.** Shopware houdt bestelstatus, leverstatus en betaalstatus apart bij. Een omzettotaal dat er verkeerd uitziet telt meestal geannuleerde bestellingen mee, of sluit bestellingen uit die nog niet zijn betaald.

**Verkoopkanalen zitten in één API.** Alle kanalen komen weer samen, tenzij er een scope is ingesteld. Vraag support om de container te scopen als die slechts één kanaal moet omvatten.

**Marketplace-bestellingen komen via de shop binnen.** Wanneer bol.com of een vergelijkbare marketplace in Shopware binnenkomt, staat die omzet in dezelfde tabel als je eigen omzet. Het is echte omzet, maar niet toe te schrijven aan je campagnes — het apart uitsplitsen is meestal de juiste keuze voor rapportage.

### Problemen oplossen

**De verbindingstest mislukt onmiddellijk.** Controleer de basis-URL: shop-root, `https://`, geen `/api`, geen `/admin`. Dit is de meest voorkomende fout bij deze integratie.

**"Ongeldige clientgegevens".** De toegangssleutel-ID of de secret is onjuist, of de integratie is verwijderd in Shopware. Maak een nieuwe aan — een verloren secret kun je niet herstellen.

**Verbonden, maar geen bestellingen.** De rol van de integratie kan geen bestellingen lezen. Bewerk de rol in Shopware en geef leestoegang tot bestellingen.

**Het werkte en daarna stopte het.** De integratie is verwijderd, of de rol is gewijzigd. Controleer onder **Instellingen → Systeem → Integraties**.

Nog steeds vastgelopen? Neem contact op met <support@adpage.io> met de container en de shop-URL — nooit de secret.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/shopware.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
