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

# Itsperfect

Koppel Itsperfect om de POS-ontvangsten van je eigen winkels in AdPage te integreren: omzet per winkel per week, naast je webshop. Beschikbaar op aanvraag.

Itsperfect is de ERP met een POS voor modemerken. Koppel het, en AdPage leest de bonnetjes van de kassa's in je eigen winkels, zodat winkelomzet naast je webshopomzet kan staan: per winkel, per week.

AdPage leest alleen: het kan in Itsperfect niets aanmaken, wijzigen of verwijderen, en er wordt niets teruggeschreven.

{% hint style="info" %}
**Itsperfect is op aanvraag beschikbaar.** De tegel verschijnt alleen voor accounts waarvoor deze is ingeschakeld. Vraag je contactpersoon bij AdPage, of <support@adpage.io>, om het voor je container in te schakelen.
{% endhint %}

### Voordat je begint

Je hebt drie dingen nodig:

* Een **AdPage-login met toegang tot de container** van je webshop. De koppeling wordt per container opgeslagen.
* Iemand die **een API-token kan aanmaken in Itsperfect**, meestal een Itsperfect-beheerder.
* Het **adres van je Itsperfect-omgeving**: het webadres waarmee je inlogt op Itsperfect. Weet je het niet zeker? De support van Itsperfect (<support@itsperfect.io>) kan het je vertellen.

### Stap 1: maak een API-token aan in Itsperfect

{% stepper %}
{% step %}

#### Een token toevoegen

Ga in Itsperfect naar **Instellingen › API** en kies **Toevoegen**. Geef het token een naam die je later herkent, zoals *AdPage*.
{% endstep %}

{% step %}

#### Geef alleen leesrechten

Sta op het tabblad Machtigingen **lezen (GET)** toe op deze vier, en verder niets:

| Machtiging     | Wat AdPage ermee doet                                                       |
| -------------- | --------------------------------------------------------------------------- |
| `bestellingen` | Leest de bonnetjes van je kassa's (POS-bestellingen)                        |
| `winkels`      | Leest je eigen winkels, zodat je kunt kiezen welke meetellen                |
| `klanten`      | Controleert bij een steekproef van bonnetjes of een klant geregistreerd was |
| `betalingen`   | Controleert bij een steekproef van bonnetjes of de bedragen btw bevatten    |

AdPage heeft nooit schrijfrechten nodig (PUT, POST of DELETE).
{% endstep %}

{% step %}

#### Kopieer het token

Sla het token op en kopieer het. Je plakt het in de volgende stap in AdPage.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Gebruik een algemeen API-token, niet het token van een webshop.** Itsperfect geeft ook elke webshop zijn eigen token (onder **Instellingen › Webshops**), maar dat ene ziet alleen webshopbestellingen, niet de bonnetjes van je winkels.

**Stuur het token niet per e-mail.** Plak het zelf in AdPage. Daarna toont AdPage alleen de laatste vier tekens.
{% endhint %}

Sommige Itsperfect-omgevingen vragen ook om een **gebruikersnaam en wachtwoord** voor de API, een extra beveiligingslaag die in Itsperfect wordt ingesteld. Als dat bij jou zo is, houd die dan ook bij de hand.

### Stap 2: koppelen in AdPage

{% stepper %}
{% step %}

#### Open de tegel

Ga naar **Koppelingen** en selecteer bovenaan de pagina je container. Open de **Itsperfect** tegel in de groep E-commerce. Zoeken op "pos" of "store" vindt hem ook.
{% endstep %}

{% step %}

#### Vul het adres en het token in

* **Itsperfect-adres**: het adres waarop je inlogt op Itsperfect. Als het eindigt op `/api/v2`, is dat ook prima.
* **API-token**: het token uit stap 1.
* Vraagt je Itsperfect-omgeving om een gebruikersnaam en wachtwoord? Vink **Itsperfect vraagt ook om een gebruikersnaam en wachtwoord** aan en vul ze in.
  {% endstep %}

{% step %}

#### Testen en koppelen

Selecteer **Testen & koppelen**. AdPage test eerst de verbinding: het haalt je winkels op en telt de POS-bonnen van de laatste 7 dagen. Pas als dat werkt, wordt er iets opgeslagen. Wil je eerst controleren? **Alleen testen** doet hetzelfde, zonder op te slaan.
{% endstep %}
{% endstepper %}

### Stap 3: kies de winkels die meetellen

Onder **Winkels** zie je je winkels uit Itsperfect, elk met het type (winkel of shop-in-shop) en het land. Actieve winkels en shop-in-shops staan aan; een winkel die in Itsperfect niet actief is, staat uit.

Zet elke winkel uit die niet moet meetellen, en selecteer **Keuze opslaan**. Nieuwe winkel geopend? Selecteer **Lijst verversen**: nieuwe winkels worden toegevoegd, en de winkels die je al hebt ingesteld behouden hun keuze.

### Stap 4: voer de test uit

De testuitvoering leest een week aan POS-bonnen en laat zien wat AdPage ervan maakt. Zo controleren we samen of de cijfers kloppen voordat ze ergens worden gebruikt.

1. Onder **Testuitvoering**, kies **Een dag in de week** die je wilt controleren, of laat het leeg voor de laatste volledige week.
2. Selecteer **Test uitvoeren**.
3. Vergelijk de omzet per winkel met het weekrapport in Itsperfect voor dezelfde week. AdPage toont omzet **exclusief btw**.

Naast de totalen beantwoordt de testuitvoering de vragen die we van buitenaf niet kunnen zien:

* of de bedragen in Itsperfect btw bevatten of niet;
* hoe retouren en ruilingen worden geregistreerd, en dat verkochte cadeaubonnen niet als omzet meetellen;
* welk deel van de bonnetjes een geregistreerde klant heeft;
* hoeveel andere bestellingen (groothandel en webshop) er die week waren, die AdPage buiten de winkelomzet laat.

{% hint style="info" %}
**Kies een week met een retour erin**, zodat de test ook laat zien hoe retouren worden geregistreerd. Laat ons daarna weten bij <support@adpage.io> of de totalen overeenkomen met je rapport. Een verschil van een paar euro per winkel is ook het vermelden waard.
{% endhint %}

### Wat AdPage leest en bewaart

AdPage leest je POS-bonnen en je winkels, en bij een steekproef van bonnetjes ook de klant en de betaling. Van de groothandels- en webshopbestellingen telt het alleen hoeveel er zijn, om ze buiten beschouwing te laten. Het leest geen voorraad, prijzen of inkoopgegevens.

Het bewaart:

* de verbinding: het adres, en het token en wachtwoord, die op de server blijven en nooit meer worden getoond (alleen de laatste vier tekens van het token);
* je winkels, elk aan of uit gezet;
* de laatste testuitvoering: **alleen aantallen en totalen**Er worden geen namen, e-mailadressen, telefoonnummers of postcodes van je klanten opgeslagen.

### Je Itsperfect API-limiet

Itsperfect staat toe **750 API-verzoeken per uur** voor je hele merk, gedeeld door al je koppelingen (webshop, logistiek, AdPage). AdPage stopt automatisch wanneer er minder dan 150 over zijn, zodat je andere koppelingen blijven werken. Een testuitvoering gebruikt maximaal 45 verzoeken, bij koppelen slechts een paar.

### Wat volgt

Na de testuitvoering zijn dit de volgende stappen. We schakelen ze samen met jou in zodra ze klaar zijn:

* **Winkelomzet in het Marketing Mix Model**, per winkel per week, naast je webshopomzet.
* **Regionale meting op de postcode van de klant**, zodat een regionale test webshop en winkels samen meet.
* **POS-aankopen van bekende klanten als offline conversies** naar Google Ads en Meta.

### Probleemoplossing

**De Itsperfect-tegel ontbreekt.** Deze wordt per klant ingeschakeld; zie de opmerking bovenaan deze pagina.

**Itsperfect weigert de sleutel.** Het token is onjuist of mist een machtiging. Controleer de vier leesrechten uit stap 1. Als je omgeving een gebruikersnaam en wachtwoord gebruikt voor de API, controleer die dan ook. Om een nieuw token in te voeren, selecteer **Adres of sleutel wijzigen** in de tegel.

**De winkels kunnen worden uitgelezen, de bestellingen niet.** Het token mist de leesmachtiging op `bestellingen`.

**Er verschijnen geen winkels.** Het token mist de leesmachtiging op `winkels`.

**Het adres wordt geweigerd.** Gebruik het adres waarmee je inlogt op Itsperfect, beginnend met `https://`.

**De limiet voor dit uur is bereikt.** Wacht tot het tijdstip dat AdPage noemt en probeer het opnieuw.

**De vorige test is net uitgevoerd.** Een testuitvoering kan eenmaal per twee minuten worden gedaan.

**Verbinding verbreken.** Selecteer **Verbinding verbreken** in de tegel. AdPage verwijdert zijn kopie van de sleutel. Het token blijft werken in Itsperfect totdat je het daar verwijdert, onder **Instellingen › API**.

{% hint style="warning" %}
**Itsperfect valt niet onder de dagelijkse verbindingscontrole**, dus een kapotte verbinding mailt je niet. Als je het token in Itsperfect wijzigt, controleer dan daarna de tegel.
{% endhint %}

Nog steeds vastgelopen? Neem contact op met <support@adpage.io> en vermeld de container en wat de tegel liet zien.


---

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