Hoe haal je productdata op via de Web API?
Met de Web API van PS in foodservice kun je productdata uit PS automatisch ophalen en verwerken in je eigen systemen. Denk bijvoorbeeld aan je interne systeem, webshop of bestelsite.
Via de Web API kun je onder andere commerciële informatie, productinhoudelijke gegevens en logistieke informatie ophalen. Zo kun je de productinformatie die in PS beschikbaar is direct gebruiken op de plekken waar jouw klanten deze nodig hebben.
Welke informatie kun je ophalen via de Web API?
Via de Web API is een groot deel van de productinformatie uit PS beschikbaar. Je kunt bijvoorbeeld de volgende gegevens ophalen:
| Productinformatie | Voorbeelden van gegevens |
| Afbeeldingen | Primaire packshot, aanvullende afbeeldingen en merklogo |
| Merk | Merknaam |
| Commerciële informatie | Korte en lange omschrijving |
| Ingrediënten | Ingrediëntendeclaratie |
| Allergenen | Allergenen en aanwezigheid |
Dit is slechts een selectie. Er is nog veel meer productinformatie beschikbaar.
Welke aanvullende productinformatie is beschikbaar?
Naast bovenstaande basisinformatie kun je bijvoorbeeld ook gegevens ophalen over:
- bereiding;
- bewaarcondities;
- logistieke informatie van de handelseenheid;
- palletinformatie;
- verpakkingsmaterialen;
- aanvullende productkenmerken.
In principe kan de productinformatie die binnen de productspecificatie van PS beschikbaar is via de Web API worden ontsloten, afhankelijk van de betreffende gegevens en jouw toegang.
Welke informatie toon je op je webshop of bestelsite?
Niet iedere gebruiker heeft dezelfde productinformatie nodig.
Kijk daarom naar het profiel van de bezoekers van jouw webshop of bestelsite en bepaal welke informatie voor hen belangrijk is om een product te kunnen beoordelen en bestellen.
Een zakelijke besteller kan bijvoorbeeld behoefte hebben aan logistieke gegevens, terwijl een eindgebruiker vooral kijkt naar ingrediënten, allergenen, voedingswaarden, afbeeldingen en commerciële productinformatie.
Je kunt via de Web API precies die gegevens ophalen die je in je eigen omgeving wilt tonen.
Voor de exacte technische opbouw en alle beschikbare velden kun je gebruikmaken van de documentatie van de Web API.
Productspecificaties tonen: Web API, Permalink of Digitale Catalogus?
Voor het beschikbaar maken van productinformatie zijn binnen PS verschillende mogelijkheden.
Met de Web API bepaal je zelf welke productinformatie je ophaalt en hoe je deze binnen je eigen systemen, webshop of bestelsite presenteert.
Wil je daarnaast de volledige en actuele productspecificatie van één product beschikbaar maken? Dan kun je gebruikmaken van een Permalink. Deze verwijst rechtstreeks naar de productspecificatie van het betreffende product.
Een Permalink wordt opgebouwd op basis van de EAN en het token van jouw organisatie:
https://permalink.psinfoodservice.com/prod/product/web/ean/{EANNUMMER}/{TOKEN}
Wil je juist alle productspecificaties uit jouw assortiment in één omgeving beschikbaar stellen? Dan kun je gebruikmaken van de Digitale Catalogus.
Ons advies
Gebruik de Web API om de informatie die voor jouw bezoekers belangrijk is rechtstreeks in je webshop of bestelsite te tonen. Voeg daarnaast op iedere productpagina een Permalink toe naar de volledige productspecificatie.
Zo combineer je een gebruiksvriendelijke productpresentatie met toegang tot de uitgebreide en actuele productinformatie uit PS.