Een feed is voor de meeste sellers de eenvoudigste manier om data in en uit Channable te krijgen, maar niet altijd de beste. Zodra je realtime voorraad nodig hebt of orders automatisch wilt terugkoppelen naar je systeem, kom je uit bij een API-koppeling. Die maakt een tweerichtingsstroom mogelijk: productdata gaat eruit, orders komen erin. Deze gids legt uit wanneer een API-koppeling de juiste keuze is en hoe je import en order-terugkoppeling betrouwbaar inricht.
Twijfel je nog tussen feed, API of plug-in als importmethode, lees dan eerst het blog Channable import-bronnen vergelijken. Deze gids gaat dieper op de API-route in.
01. Wanneer een API de juiste keuze is
Een API-koppeling loont in twee situaties. De eerste is snelheid: als je voorraad bijna realtime moet bijwerken om oversells te voorkomen, is een feed die een paar keer per dag ververst te traag. De tweede is tweerichtingsverkeer: als orders automatisch terug moeten naar je shop of ERP.
Voor een simpele eenrichtingsexport van producten naar één kanaal volstaat vaak een gewone feed. De API wordt pas interessant als de stroom complexer wordt. Hoe data in het algemeen door de keten loopt, behandelt de gids over de architectuur van een datafeed.
02. Standaardkoppelingen versus maatwerk
Channable biedt kant-en-klare API-koppelingen met veel gangbare shop- en ERP-systemen. Die activeer je met inloggegevens of een autorisatieflow; geen ontwikkelaar nodig. Begin daarom altijd met de vraag: bestaat er al een standaardkoppeling voor mijn platform?
Pas bij een eigen of minder gangbaar systeem komt maatwerk kijken, en dan ook technische kennis. Hoe een ERP-koppeling er in de praktijk uitziet, behandelt het blog Channable ERP-integratie.
03. De import-kant inrichten
Aan de importkant haalt de API je productdata op uit het bronsysteem. Net als bij een feed geldt: er is één leidende bron per veld, en wat hier binnenkomt is de basis voor alles daarna. Controleer na het inrichten een preview van de data, precies zoals je bij een feed-import zou doen.
- Stel de ophaalfrequentie af op het soort data: voorraad vaak, catalogus minder vaak
- Controleer of velden overlappen met een bestaande bron, om tegenstrijdige data te voorkomen
- Verifieer dat verplichte velden compleet binnenkomen voordat je live gaat
04. Order-terugkoppeling
Het grootste voordeel van een API-koppeling is de terugstroom van orders. Komt er een bestelling binnen op een kanaal, dan haalt Channable die op en stuurt hem door naar je shop of ERP. Je voorraad wordt automatisch bijgewerkt en je werkt niet langer in twee systemen tegelijk.
Dat scheelt niet alleen handwerk maar verkleint ook de kans op oversells, omdat een verkoop op het ene kanaal direct de voorraad op de andere kanalen verlaagt. Hoe die terugkoppeling precies werkt, lees je in het blog Channable bestellingen terugkoppelen.
05. De koppeling betrouwbaar houden
Een API-koppeling is gevoeliger voor wijzigingen dan een statische feed: als het systeem waarmee je koppelt verandert, kan de stroom haperen. Daarom is monitoring geen luxe maar een vereiste. Je wilt het merken zodra een koppeling stilvalt, niet pas als een klant klaagt.
Stel controles in op of data binnenkomt, of orders worden teruggekoppeld en of voorraad meeloopt. Hoe je zo'n monitoringsysteem opzet, behandelt de gids over een monitoringsysteem voor je feeds bouwen.
06. Veelvoorkomende valkuilen
Een paar valkuilen komen telkens terug bij API-koppelingen:
- Twee bronnen die hetzelfde veld vullen, waardoor onduidelijk is welke wint
- Een ophaalfrequentie die te laag staat voor voorraad, met oversells als gevolg
- Geen monitoring, waardoor een stille hapering pas laat wordt opgemerkt
- Aannemen dat maatwerk nodig is terwijl er een standaardkoppeling bestaat
Stuk voor stuk te voorkomen met een nette inrichting en goede controles vooraf.
07. Zelf doen of uitbesteden?
Een standaard API-koppeling activeren is goed zelf te doen: het lijkt op het inrichten van een feed, met inloggegevens in plaats van een bestand. De keuze tussen feed en API, en de inrichting van de ophaalfrequentie, is denkwerk dat je prima zelf doet.
Gaat het om een maatwerk-integratie met een eigen systeem, of moet de order-terugkoppeling waterdicht zijn, dan loont een ervaren blik. Daarvoor bestaat de setup-dienst voor de inrichting. Loopt een bestaande koppeling onverwacht vast, dan helpt de audit en troubleshooting dienst. Twijfel je over de juiste route? Leg het voor via contact.
08. Veelgestelde vragen
Een API-koppeling is de juiste keuze wanneer je realtime of bijna-realtime data nodig hebt, bijvoorbeeld voorraad die direct moet bijwerken, of wanneer je orders automatisch wilt terugkoppelen naar je systeem. Voor een eenvoudige eenrichtingsexport van producten volstaat vaak een feed. De API wordt interessant zodra de stroom twee kanten op moet of de snelheid telt.
Voor de standaard API-koppelingen die Channable kant-en-klaar aanbiedt met grote shop- en ERP-systemen niet: die activeer je met inloggegevens of een autorisatieflow. Pas bij een maatwerk-integratie met een eigen of minder gangbaar systeem komt technische kennis kijken. Begin daarom altijd met de vraag of er al een standaardkoppeling bestaat voor jouw platform.
Bij order-terugkoppeling haalt Channable orders op die op een kanaal binnenkomen en stuurt die door naar je shop of ERP, zodat je voorraad automatisch wordt bijgewerkt en je niet in twee systemen werkt. De API maakt die tweerichtingsstroom mogelijk: productdata gaat eruit, orders komen erin. Dat scheelt handwerk en verkleint de kans op oversells.
Niet per definitie; ze zijn anders. Een API kan sneller en in twee richtingen werken, maar is gevoeliger voor wijzigingen aan de kant van het systeem waarmee je koppelt. Een feed is eenvoudiger en robuuster voor eenrichtingsexport. De betrouwbaarheid hangt vooral af van goede monitoring: zonder controle merk je een hapering bij beide methodes te laat.
Verder in de kennisbank: De architectuur van een datafeed: de complete gids · Een monitoringsysteem voor je feeds bouwen: de complete gids · Channable-projecten structureren: de complete gids