> 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/magento.md).

# Magento

Verbind Magento 2 met integratiegegevens voor bestellingen, omzet, producten en voorraad.

Verbind Magento 2 zodat AdPage bestellingen en productgegevens rechtstreeks uit je winkel kan lezen. Magento heeft geen consumenten-OAuthstroom, dus dit is een verbinding op basis van inloggegevens: je maakt een integratie aan in het Magento-beheer en plakt vier waarden in AdPage.

AdPage leest alleen. Het schrijft nooit een bestelling, een product of een prijs.

### Voordat je begint

Je hebt **beheerdersrechten in het Magento-beheer** nodig, en de REST-API van je winkel moet vanaf internet bereikbaar zijn. Een staging-omgeving achter een IP-allowlist of basisauthenticatie zal de verbindingstest laten mislukken — terecht, want AdPage kan er daadwerkelijk geen verbinding mee maken.

Je maakt een Magento *integratie* aan, die vier waarden oplevert:

| Waarde                   | Magento's benaming ervoor |
| ------------------------ | ------------------------- |
| Consumentensleutel       | Consumentensleutel        |
| Consumentengeheim        | Consumentengeheim         |
| Toegangstoken            | Toegangstoken             |
| Geheim van toegangstoken | Geheim van toegangstoken  |

{% hint style="warning" %}
**Magento toont deze eenmalig.** Nadat je de integratie hebt geactiveerd, worden de vier waarden één keer op één scherm weergegeven en nooit meer. Kopieer ze alle vier voordat je het sluit. Als je ze kwijtraakt, moet je de integratie verwijderen en een nieuwe aanmaken.
{% endhint %}

### Maak de integratie aan in Magento

{% stepper %}
{% step %}

#### Open het scherm Integraties

Ga in de Magento-beheeromgeving naar **Systeem → Extensies → Integraties** en selecteer **Nieuwe integratie toevoegen**. Geef het een herkenbare naam, zoals `AdPage`.
{% endstep %}

{% step %}

#### Geef leestoegang tot de juiste resources

Onder **API**, stel Resource Access in en selecteer ten minste **Verkoop → Bestellingen**, **Catalogus → Producten**, en **Winkels → Instellingen** (de verbindingstest leest de winkelconfiguratie). Volledige toegang geven werkt ook als je beleid dat toestaat.
{% endstep %}

{% step %}

#### Activeer en kopieer de vier waarden

Sla op en selecteer vervolgens **Activeren** in de rij van de integratie en keur goed. Magento toont de vier waarden — kopieer ze nu allemaal.
{% endstep %}
{% endstepper %}

### Verbind Magento in AdPage

{% stepper %}
{% step %}

#### Open de tegel

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

{% step %}

#### Vul de basis-URL en de vier waarden in

De **basis-URL** is je REST-eindpunt, inclusief het API-pad — bijvoorbeeld `https://yourshop.nl/rest/V1`. Een afsluitende schuine streep wordt automatisch verwijderd.

Plak de consumentensleutel, het consumentengeheim, het toegangstoken en het geheim van het toegangstoken.
{% endstep %}

{% step %}

#### Opslaan

AdPage maakt eerst verbinding met je winkel voordat er iets wordt opgeslagen en leest de winkelconfiguratie om te bewijzen dat de inloggegevens werken. Inloggegevens die niet werken worden nooit opgeslagen, dus de tegel kan niet beweren verbonden te zijn terwijl elke widget leeg blijft.

Bij succes toont de tegel de naam van je winkel, rechtstreeks uit Magento zelf gelezen — wat ook jouw bevestiging is dat je de bedoelde winkel hebt gekoppeld.
{% endstep %}
{% endstepper %}

### Wat je krijgt

Bestellingen-, omzet- en productgegevens in **Business & Revenue** en **Productprestaties**, plus voorraad die beschikbaar is voor de Data-assistent: voorraadniveaus, weergaven zonder voorraad en vraag afgezet tegen beschikbaarheid.

Omzet uit bestellingen voedt ook de **Marketingmixmodel**, die veel meer behoefte heeft aan een betrouwbare omzetreeks dan aan bijgehouden conversies.

### De cijfers lezen

**De orderstatus is van belang.** Magento bewaart bestellingen in behandeling, verwerking, voltooid, geannuleerd en gesloten op dezelfde plek. Een omzetcijfer dat te hoog lijkt, bevat meestal statussen die je niet als verkoop zou meetellen.

**Meerdere winkelweergaven delen één endpoint.** Een Magento-installatie met meerdere winkelweergaven geeft ze allemaal terug. Als een container maar één winkelweergave moet omvatten, geef dat dan door aan support zodat de scope kan worden ingesteld.

**De weergave van belasting verschilt.** Magento kan totalen inclusief of exclusief belasting rapporteren, afhankelijk van de configuratie. Controleer welke van toepassing is voordat je vergelijkt met een andere bron.

### Probleemoplossing

**De verbindingstest mislukt meteen.** Controleer eerst de basis-URL — die moet bevatten `/rest/V1`, en het moet de publieke URL zijn. `http://` in plaats van `https://`, of een staging-host die AdPage niet kan bereiken, falen hier allebei.

**"Unauthorized" of een 401.** Een van de vier waarden is onjuist, of de integratie is nooit geactiveerd. Een integratie die wel is opgeslagen maar niet is geactiveerd, levert tokens op die niet werken.

**"Forbidden" of een 403.** De inloggegevens zijn geldig, maar de integratie heeft geen toegang tot resources. Bewerk deze in Magento en geef de hierboven vermelde resources vrij.

**Het werkte en toen stopte het.** Iemand heeft de integratie in Magento verwijderd of opnieuw geactiveerd — opnieuw activeren geeft nieuwe tokens uit en maakt de oude ongeldig. Maak nieuwe inloggegevens aan en plak ze opnieuw.

**Er ontbreken bestellingen voor één winkelweergave.** Zie multi-store hierboven.

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


---

# 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/magento.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.