> 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

Verbind Shopware 6 met een integratietoegangssleutel voor bestellingen, omzet en productgegevens.

Koppel Shopware 6 zodat AdPage bestellingen en productgegevens uit je shop kan lezen. Shopware gebruikt een Admin API-integratie met een client-id en secret, dus dit is een verbinding op basis van inloggegevens en geen autorisatieflow.

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 beheerdersrechten nodig in de Shopware-admin en een shop die via internet bereikbaar is.

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

{% hint style="warning" %}
**De geheime sleutel wordt één keer getoond.** Shopware toont die wanneer je de integratie maakt en daarna nooit meer. 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 selecteer **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 rol met alleen-lezenrechten is beter als je die hebt.
{% endstep %}

{% step %}

#### Sla beide waarden op en kopieer ze

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

### Koppel Shopware in AdPage

{% stepper %}
{% step %}

#### Open de tegel

Ga naar **Integraties**, selecteer de container en open de **Shopware** tegel.
{% endstep %}

{% step %}

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

De **basis-URL** is de hoofdpagina van je shop — `https://yourshop.nl`, **niet** het `/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 doet vóór het opslaan eerst een aanvraag bij je shop en leest het standaardverkoopkanaal om te bewijzen dat de inloggegevens werken. Inloggegevens die niet werken, worden nooit opgeslagen.

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

### Wat je krijgt

Bestellingen, omzet en productgegevens in **Business & Revenue** en **Productprestaties**, waarbij orderomzet doorstroomt naar het **Marketingmixmodel**.

Als je shop via meerdere verkoopkanalen verkoopt — bijvoorbeeld een webshop plus een marktplaats — dan kunnen die worden gescheiden, en dat is belangrijk omdat marktplaatsbestellingen niet door de advertenties in je rapporten worden gedreven.

### De cijfers lezen

**De bestelstatus is belangrijk.** Shopware houdt bestelstatus, leveringsstatus en betalingsstatus apart bij. Een omzetbedrag dat er fout uitziet, telt meestal geannuleerde bestellingen mee, of sluit bestellingen uit die nog niet betaald zijn.

**Verkoopkanalen zitten in één API.** Alle kanalen komen weer samen, tenzij ze worden afgebakend. Vraag support om de container af te bakenen als die slechts één kanaal moet bestrijken.

**Marktplaatsbestellingen komen via de shop binnen.** Als bol.com of een vergelijkbare marktplaats in Shopware stroomt, staat die omzet in dezelfde tabel als je eigen omzet. Het is echte omzet, maar die is niet toe te schrijven aan je campagnes — die eruit splitsen is voor rapportages meestal de juiste keuze.

### Probleemoplossing

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

**"Ongeldige clientgegevens".** De toegangssleutel-ID of 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 leesrechten voor 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 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.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/shopware.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.