Vraag toegang aan en ontvang je nieuwe inloggegevens, inclusief toegang tot de staging-omgeving om te testen. Zo zet je de overstap in gang op het moment dat het jullie uitkomt.
Er is dus ruim de tijd om over te stappen. Toch is het slim om nu al te beginnen met plannen, zodat de migratie niet op het laatste moment hoeft.
Voor wie is dit relevant?
Web API v7 is relevant voor iedereen die productdata automatisch ophaalt uit of instuurt naar PS via een koppeling. Dat geldt voor producenten, groothandels en afnemers: iedereen gebruikt dezelfde API, met rolgebaseerde toegang die bepaalt wat je mag zien of aanpassen.
Daarbij maakt het niet uit of je die koppeling zelf hebt gebouwd of dat een softwarepartij dit voor je heeft geregeld, bijvoorbeeld een menumanagementsysteem. In dat laatste geval voert je softwareleverancier de overstap uit. Wij informeren de bij ons bekende softwarepartijen, maar we raden je aan om dit ook zelf even bij je leverancier na te vragen. Zo weet je zeker dat jullie koppeling op tijd wordt omgezet.
Geen actie nodig? Gebruik je geen koppeling op de API, ook niet via een softwarepakket, en werk je alleen met Mijn PS of de Data Entry? Dan verandert er voor jou niets.
Wat verandert er in v7?
We hebben de Web API opnieuw opgebouwd. Dat betekent concreet:
Sneller en stabieler
V7 werkt met caching op de juiste manier. Het resultaat: merkbaar snellere reactietijden en minder storingen. Jullie koppeling wordt daardoor betrouwbaarder in het dagelijks gebruik.
Realtime updates via webhooks
Tot nu toe moesten koppelingen zelf regelmatig controleren of er iets was gewijzigd (pollen). In v7 werkt dat anders: wijzigingen worden realtime gedeeld via webhooks. Zodra productinformatie verandert, komt de update automatisch bij jullie binnen.
Hiermee voorkom je dat jullie systemen onnodig blijven controleren op wijzigingen, en werk je altijd met de meest actuele data.
Keuze uit JSON en XML
V7 ondersteunt zowel JSON als XML. Zo kies je zelf het formaat dat het beste past bij jullie systeem en werkwijze.
Welke data is beschikbaar via v7?
Via de nieuwe Web API kun je ophalen:
- logistieke gegevens
- productgegevens
- specificatiegegevens
- masterdata
- assortimentslijsten (zowel uploaden als inzien)
- verschillende zoekmogelijkheden via Lookups
Neem je deel aan de PS Impact Score? Dan kun je ook die data via de API ophalen. Zo ontvang je per product de duurzaamheidsdata, zoals CO₂-uitstoot, watergebruik, impact op biodiversiteit en dierenwelzijn.
Wat betekent dit praktisch?
Om over te stappen zetten jullie (of jullie IT-partij) de bestaande koppeling om naar de nieuwe v7-endpoints. Daarbij zijn drie dingen goed om te weten:
1. Nieuwe inloggegevens voor v7
Voor v7 ontvang je aparte inloggegevens die alleen op v7 werken. De huidige gegevens blijven gekoppeld aan v6. Zo kunnen beide versies tijdens de overstap naast elkaar draaien en stap je over op het moment dat het jullie uitkomt.
2. Sommige velden zijn anders opgebouwd
Een aantal velden heeft in v7 een andere structuur dan in de oude API. Denk aan meertalige teksten en metingen zoals gewicht en inhoud. De volledige uitleg en veldmapping vind je in de migratiehandleiding en het bijbehorende Excel-bestand. Loop deze mapping systematisch door met je huidige koppeling: dat is de belangrijkste eerste stap van de migratie.
3. V6 en v7 draaien een tijd naast elkaar
De oude omgeving blijft beschikbaar tot uiterlijk eind 2028. Er is dus geen haastige overstap nodig, maar wacht ook niet te lang: hoe eerder je begint, hoe rustiger de migratie verloopt.
Wat is de planning?
- Nu al: aanmelden voor de staging-omgeving om te testen. Deze omgeving wordt dagelijks ververst met de meest recente live data, zodat je test met realistische gegevens.
- Augustus 2026: v7 is live voor het ophalen van data.
- Kort daarna: ook het insturen van data via v7 wordt beschikbaar.
- Uiterlijk eind 2028: de oude omgeving (v6) gaat definitief uit.
Documentatie: Zo helpen we je op weg
Alles wat je nodig hebt om je koppeling om te zetten naar v7 vind je via deze link, inclusief de volledige veldmapping in Excel.
We zorgen ervoor dat de overstap zo soepel mogelijk verloopt. Beschikbaar voor jullie:
- Uitgebreide technische documentatie, inclusief Swagger en een Postman-collectie.
- Kant-en-klare packages om de integratie te versnellen: NuGet voor .NET en Composer voor PHP.
- Een migratiehandleiding met volledige veldmapping (inclusief Excel-bestand), zodat je precies ziet welke velden anders zijn opgebouwd.
- Een staging-omgeving waarin je veilig kunt testen voordat je live gaat.
De vervolgstap
- Lees de migratiehandleiding door, samen met je IT-partij.
- Meld je hieronder aan voor toegang tot de staging-omgeving en test de nieuwe koppeling.
- Plan de overstap ruim vóór eind 2028 in.
