Migratie van V6 naar V7 (FAQ)

De grootste wijzigingen tussen de oude API (V6) en V7 zitten in de manier waarop je producten zoekt en ophaalt, en in het verdwijnen van de "sets". Hieronder de meest gestelde vragen voor wie overstapt van V6 naar V7.

Waarom is de `search`-aanroep opgesplitst in `lookup` + `get`?

In V6 deed één aanroep alles: POST api/Product/Search zocht producten én gaf de volledige productdata in hetzelfde antwoord terug (met een limiet van maximaal 50 volledige producten per aanroep).

In V7 zijn dit twee losse stappen geworden:

1. Lookup — zoek producten en krijg een lijst met PS-id's (psids) terug.
2. Get — haal vervolgens per psid de volledige productdata op.

Zo is zoeken sneller en lichter: je haalt de volledige data alleen op van de producten die je daadwerkelijk nodig hebt.

Hoe zoek ik nu producten? (lookup)

Gebruik één van de lookup-routes. Elke route zoekt op een andere sleutel en geeft de psids terug die jouw account mag zien (de toegang is ingebakken — zie verderop). Voeg /minimal toe aan de route om alleen de psids (als getallen) terug te krijgen; dat is precies wat je nodig hebt voor de volgende stap.

                        
                            POST /v7/json/lookup/assortment

                            POST /v7/json/lookup/assortment/minimal

                            {

                              "assortmentId": "…",

                              "lastUpdatedAfter": "2026-07-01T00:00:00",

                              "targetMarket": 1,

                              "pageNumber": 1,

                              "pageSize": 250

                            }

Beschikbare zoeksleutels: gtin, psid, articlenumber, gln, assortment, brandid en all. Het antwoord verdeelt de resultaten in changed, deleted, notFound, notChanged en superseded.

Hoe haal ik de productdata op? (get)

Roep per psid de productsheet op:

                        
                            GET /v7/json/productsheet/{psid}

                            GET /v7/json/productsheet/{taal}/{psid}

Gebruik xml in plaats van json voor een XML-antwoord. De taal (nl, en, de, fr) is optioneel. Let op: de OutputType (hoeveel velden je terugkrijgt) staat niet meer in de URL, maar wordt bepaald door je account/token.

Wat is er met de sets (public, brand, producer, catalog) gebeurd?

De aparte sets bestaan niet meer in V7. In V6 zette je booleans aan zoals ShowPublicProductSet of ShowMyCatalogProductSet in de Search-body. In V7 is de toegang ingebakken: op basis van je token (rollen, relatie en abonnementen) bepaalt de API automatisch welke producten je mag zien. Je krijgt dus altijd alleen de producten terug waar je recht op hebt.

Wil je een specifieke "set" nabootsen, dan doe je dat via de bijbehorende lookup-route:

V6 set	V7
Catalog set	`lookup/assortment` — catalog = assortment
Brand set	`lookup/brandid` (op `brandId`)
Public set (alles)	`lookup/all`
Producer set	Geen aparte aanroep nodig — je eigen producten zitten automatisch in de toegang

Let op: dit onderdeel is nog in ontwikkeling en niet elke V6-set heeft een exacte 1-op-1 tegenhanger. Mis je een specifiek scenario? Neem dan contact met ons op.

Een typische V7-flow

                        
                            // 1. Zoek de psids (bijv. van een assortiment)

                            POST /v7/json/lookup/assortment/minimal

                            //    → { "changed": [59, 12345, …], … }

                            // 2. Haal per psid de productsheet op

                            GET /v7/json/productsheet/59

                            GET /v7/json/productsheet/nl/59