Itsperfect API koppelen aan je webshop.

Itsperfect is ERP-software voor mode: merken, groothandels en retailers in kleding en schoenen. Collecties, seizoenen, maten, kleuren, voorraad, inkoop, verkoop en facturatie zitten erin.

Het verschil met een algemeen ERP zit in de opbouw van het artikel. In de mode is een artikel geen enkelvoudig product maar een raster: kleuren keer maten, elk met een eigen barcode en een eigen voorraad. Alles in Itsperfect is daarop gebouwd, en een koppeling met je webshop hoort dat over te nemen in plaats van plat te slaan.

De API is REST met JSON en versie 2 is de huidige. Aanmelden gaat met een token dat je in het ERP aanmaakt: een algemene met rechten die je zelf kiest, of het token van een specifieke webshop.

Wat je kunt ophalen en wegschrijven is breed: artikelen met hun voorraad, prijzen, barcodes, kleuren en maten, klanten en klantgroepen, orders, facturen, retouren, picks en leveringen, inkooporders en leveranciers, plus seizoenen, merken en collecties.

Filteren kan met operatoren als gelijk aan, groter dan en bevat, en er is paginering met een totaalaantal in de antwoordheaders. De grens ligt op 750 aanroepen per uur.

Eerst het token. Een algemene API-token maak je aan onder Settings, API en Add; het token van een webshop staat onder Settings, Webshops en Details. Voor een webshop kiezen we het tweede, omdat het alleen geeft wat die webshop nodig heeft.

Dan de demo. Itsperfect biedt een demologin en een API-framework om te downloaden. Daarop controleren we hoe een artikel met zijn kleuren en maten binnenkomt, voordat er iets met de echte collectie gebeurt.

Daarna de eerste volledige import, in pagina’s met page en limit. De headers X-Pagination-Total-Count en X-Pagination-Page-Count vertellen hoeveel er nog komt, en X-Request-Limit-Remaining hoeveel aanroepen er dit uur over zijn. Datums komen binnen in ISO 8601, bedragen met een punt als decimaalteken.

Bij de livegang gaan we over op kleinere rondes: alleen de voorraad en de artikelen die zijn veranderd. De webshop zelf kan op WooCommerce, Shopify of maatwerk draaien; hoe je die keuze maakt, staat bij een webshop laten bouwen.

Wie een webshop bouwt op een mode-ERP, bouwt in de praktijk vooral een goede variantstructuur.

De bezoeker ziet één product met een kleurkeuze en een maatkiezer. Daaronder zitten tientallen varianten, elk met een eigen voorraad. Is maat 38 in zwart op, dan hoort die maat uitgegrijsd te zijn, en niet het hele artikel te verdwijnen.

Dat klinkt vanzelfsprekend en is het niet: veel integraties importeren elke variant als een los product, omdat dat de snelste import is. Je merkt het pas als de collectie groeit en je overzicht driehonderd bijna gelijke producten toont.

Wij spreken die structuur af voordat de eerste import draait, want achteraf omzetten raakt je adressen en dus je vindbaarheid.

Modemerken verkopen meestal allebei: aan consumenten via een eigen webshop en aan winkels via een verkooporder met eigen prijzen en staffels.

Itsperfect kent dat onderscheid, met klantgroepen en prijzen per groep. Op je site betekent het twee verschillende ervaringen: een consumentenshop die afrekent, en een besloten deel waar een winkelier inlogt, zijn eigen prijs ziet en op rekening bestelt.

Dat kan in één site, maar het is wel twee keer nadenken over wat iemand mag zien. Dat is precies waarom het token per webshop bestaat: je geeft de consumentenkant niet de gegevens van de zakelijke kant.

De fout die het vaakst voorkomt zit in het token. Klopt het niet, dan geeft de API een 401 met een melding als: The authentication token () is not correct. Staan de haakjes leeg, dan is er geen token meegestuurd, vaak omdat het uit het adres is weggevallen.

Een 405 betekent dat de methode niet past bij het onderdeel: GET om op te halen, POST om aan te maken, PUT om bij te werken en DELETE om te verwijderen. Een 404 wijst op een adres of onderdeel dat niet bestaat.

Dan de grens van 750 aanroepen per uur. Wie een hele collectie ophaalt met een aanroep per variant, zit daar snel aan. Pagineren met een hoge limit en daarna alleen de wijzigingen ophalen voorkomt dat.

Ter vergelijking: de CycleSoftware API telt per minuut en per dag. Hoe een limiet is opgebouwd bepaalt hoe vaak je ophaalt, en dat is per systeem een andere afweging.