In dit document wordt beschreven hoe de webshop specifiek voor EffectConnect versie 3 moet worden ingericht.
Met name de authenticatie gaat anders. Dus de API key en Secret gaan anders dan bij V2.
De andere geavanceerde instellingen zijn nog steeds van toepassing, en hier terug te vinden:
https://docs.retailvista.net/docs/hoe-werkt-de-retailvista-integratie-met-effectconnect
Authenticatie
De authenticatie voor V3 is op een andere manier opgezet. Namelijk via OAuth 2.0 en daarbij maken we gebruik van deverloper authentication. Wat inhoud dat RetailVista als app bekend is bij EffectConnect en de binnen EffectConnect geregistreerd moet worden.
Om een webshop aan te maken voor V3 moet er alleen een API Url worden opgegeven: https://api.effectconnect.com, en verder de standaard vinkjes bij tab export / orders, om aan te geven dat artikelen geëxporteerd moeten worden en orders worden opgehaald. Daarna kan de webshop worden opgeslagen.
Nu moeten er via de knop OAuth login, nog tokens worden opgehaald om verbinding te kunnen maken met de EffectConnect API voor de omgeving van de klant.
Er wordt een nieuw browser venster geopend, waar de klant zelf moet inloggen op zijn EffectConnect omgeving:
Met het inloggen volgt een pagina waarbij kan worden aangegeven welke rechten RetailVista mag hebben. Logischerwijs zijn de volgende rechten vereist voor het artikel onderhoud en ophalen van de orders:
- Product ophalen
- Product aanmaken + updaten
- Productselectie ophalen
- Order ophalen
- Order updaten
Het bijwerken van orders is nodig om er achteraf track&trace informatie aan toe te voegen voor de verstuurde pakketten.
Door dit op te slaan, wordt de gebruiker doorgestuurd naar een handler van RetailVista. Hier komt een code in mee waarmee RetailVista vervolgens de juiste tokens kan ophalen voor de toekomstige communicatie.