Koppel Linnworks aan AskBiz voor voorraadsynchronisatie via meerdere kanalen
Stap-voor-stap gids voor het koppelen van Linnworks aan AskBiz — wat de OAuth-flow doet, welke gegevens daadwerkelijk worden gesynchroniseerd, en hoe vaak ze worden ververst.
Key Takeaways
- Linnworks bevindt zich onder Sources > Voorraad & Logistiek, naast Cin7 en ShipStation, en koppelt via OAuth — je autoriseert in Linnworks zelf, AskBiz ziet nooit een wachtwoord.
- Toegang is alleen-lezen: AskBiz kan je orders ophalen, maar kan niets aanmaken, bewerken of annuleren in je Linnworks-account.
- Wat wordt gesynchroniseerd zijn je openstaande orders — SKU, product, hoeveelheid, prijs, kanaal en afhandelingsstatus per orderregel — waar AskBiz omzet- en voorraadmutatiecijfers per kanaal van maakt. Het is geen aparte live-magazijnvoorraadfeed.
- Synchronisatiefrequentie volgt je AskBiz-abonnement zoals elke andere bron: dagelijks op Gratis, elke 6 uur op Growth, elk uur op Business.
- Dit is een volwaardig werkende connector met een eigen synchronisatiehandler en gegevensnormalisator — niet hetzelfde als AskBiz's oudere artikelen die Linnworks alleen noemen als voorbeeld van een multichannelplatform dat bedrijven zouden kunnen gebruiken.
Waar je het vindt
Ga vanuit je AskBiz-dashboard naar Sources. Scrol naar beneden naar de sectie Voorraad & Logistiek — Linnworks staat daar naast Cin7 en ShipStation, met een korte beschrijving eronder: "Voorraad, orders, orderafhandeling voor meerdere kanalen." Zowel Cin7 als ShipStation vragen je een API-sleutel te plakken (en bij Cin7 ook een account-ID) voordat ze koppelen. Linnworks is anders — het is de enige van de drie die een volledige OAuth-verbinding gebruikt, dus je klikt op de tegel en alles daarna gebeurt op de eigen site van Linnworks in plaats van in een formulier in AskBiz.
Voordat je koppelt
Je hebt beheerder- of ten minste app-autorisatietoegang nodig op je Linnworks-account — hetzelfde toegangsniveau dat je nodig hebt om elke externe app binnen Linnworks zelf goed te keuren. Je hoeft vooraf geen API-sleutels, geheimen of tokens te genereren of kopiëren; AskBiz vraagt je niets te plakken voor deze specifieke connector, wat het belangrijkste praktische verschil is met Cin7 direct ernaast. De Sources-pagina vertelt je precies wat je kunt verwachten voordat je ergens op klikt: "Doorverwijzing naar Linnworks — alleen-lezen toegang." Die regel is een letterlijke beschrijving van wat er hierna gebeurt, geen marketingtekst — AskBiz vraagt toestemming om je orders te lezen, en niets meer.
Stap 1 & 2: autoriseren in Linnworks
Als je op de Linnworks-tegel klikt, kom je op het eigen OAuth-autorisatiescherm van Linnworks, waar je inlogt (als je dat nog niet bent) en precies bekijkt wat AskBiz wil lezen voordat je het goedkeurt. Je wordt nooit binnen AskBiz zelf om een Linnworks-wachtwoord gevraagd — de hele uitwisseling vindt plaats op het domein van Linnworks, wat standaard OAuth-praktijk is en hetzelfde patroon dat AskBiz gebruikt voor Shopify, Xero en zijn andere OAuth-gebaseerde bronnen. Als je besluit niet door te gaan, kun je dat scherm gewoon sluiten of verlaten; er wordt niets gekoppeld totdat je daadwerkelijk goedkeurt. Zodra je dat wel doet, stuurt Linnworks je automatisch rechtstreeks terug naar de Sources-pagina van AskBiz — er is geen code om ergens te kopiëren of te plakken.
Stap 3: wat er gebeurt nadat je hebt goedgekeurd
Op de terugweg wisselt AskBiz de autorisatiecode die Linnworks doorgeeft in voor een toegangstoken, en slaat dat token vervolgens versleuteld op in je account, samen met de Linnworks-server-URL die Linnworks aan je account toewijst. Dat token is permanent — het verloopt niet zoals een normaal sessietoken — maar AskBiz gebruikt het nooit rechtstreeks tegen de order-API van Linnworks. In plaats daarvan presenteert het bij elke synchronisatie dat permanente token aan het AuthorizeByApplication-eindpunt van Linnworks om een vers, kortlevend sessietoken aan te maken (Linnworks' eigen sessietokens duren slechts ongeveer 20 minuten, veel korter dan elk realistisch synchronisatie-interval), en dat vers aangemaakte sessietoken wordt daadwerkelijk gebruikt om je orders op te halen. Je ziet hier niets van gebeuren — het is het mechanisme dat de verbinding betrouwbaar en onbeperkt in werking houdt, zonder je ooit te vragen opnieuw te koppelen of te autoriseren. Zodra je verbinding is opgeslagen, start AskBiz ook automatisch een eerste synchronisatie, dus er is niets meer te klikken.
Welke gegevens daadwerkelijk worden gesynchroniseerd
Elke synchronisatie haalt je openstaande orders op uit Linnworks. Voor elke orderregel in elke order registreert AskBiz de SKU, productnaam, hoeveelheid, stukprijs, kostprijs per stuk (waar Linnworks er een levert), via welk verkoopkanaal de order binnenkwam, en de status van de order. Dat wordt genormaliseerd naar dezelfde velden per record die AskBiz gebruikt voor elke andere gekoppelde bron — bruto-omzet, kosten, marge, verkochte eenheden en voorraadmutatie — zodat je Linnworks-orders in je rapporten naast je Shopify-, Amazon- of POS-verkopen staan in plaats van als een aparte silo die je apart moet controleren. Als een order binnenkomt zonder orderregels, registreert AskBiz deze nog steeds als één rij met het ordertotaal, zodat er niets stilletjes verdwijnt alleen omdat het regelniveaudetail niet beschikbaar was. Het is de moeite waard om hier precies over te zijn: wat vandaag wordt gesynchroniseerd is orderactiviteit, geen op zichzelf staande live-magazijnvoorraadfeed. AskBiz leidt voorraadmutatie af van verkochte eenheden per order in plaats van rechtstreeks de absolute voorradige hoeveelheden van Linnworks op te halen — elke gesynchroniseerde order verlaagt het voorraadmutatiecijfer voor die SKU, maar AskBiz vraagt Linnworks niet apart "hoeveel heb ik er nu nog in het magazijn". Als je op Linnworks vertrouwt als je echte voorraadtelbron, blijf dat dan doen. AskBiz's weergave hier is ordergedreven, wat accuraat is voor omzet-, kanaal- en productprestatieanalyse, maar het is geen vervanging voor het controleren van live magazijntellingen in Linnworks zelf voordat je een inkoopbeslissing neemt.
Hoe vaak het opnieuw synchroniseert
Eenmaal gekoppeld volgt Linnworks hetzelfde synchronisatieschema als elke andere bron, bepaald door je AskBiz-abonnement: eenmaal per dag op Gratis, elke 6 uur op Growth, en elk uur op Business. Linnworks heeft geen eigen tragere ondergrens zoals een paar andere connectoren dat wel hebben — Stripe is beperkt tot 3 uur en Etsy tot 8 uur zelfs op Business, omdat hun onderliggende gegevens simpelweg niet snel genoeg veranderen om vaker pollen te rechtvaardigen — dus Linnworks volgt gewoon welk tempo je abonnement toestaat, net als Shopify, Amazon of Xero. Als je vlak na een grote verkoopactie over je kanalen heen frissere cijfers wilt, ga dan terug naar de Sources-pagina, zoek Linnworks in je lijst met gekoppelde bronnen, en klik op Nu synchroniseren — dat start een synchronisatie op aanvraag buiten het reguliere schema, zonder invloed op wanneer de volgende geplande synchronisatie plaatsvindt. Dezelfde rij op die pagina toont een statuspunt (groen zodra het probleemloos synchroniseert, oranje of rood als er iets aandacht nodig heeft) en een "laatst gesynchroniseerd"-tijdstip, zodat je in één oogopslag ziet hoe actueel je Linnworks-gegevens zijn voordat je erop vertrouwt.
Als je AskBiz's gids over multichannelverkoop hebt gelezen
AskBiz's algemene Academy-content over multichannelverkoop noemt Linnworks als voorbeeld van het soort platform dat bedrijven gebruiken om orders over kanalen heen te centraliseren — dat is een generieke verwijzing naar de categorie tool, geschreven voordat AskBiz rechtstreeks met Linnworks koppelde. Dit artikel gaat over iets anders: AskBiz's eigen directe koppeling met je Linnworks-account, hierboven beschreven. Als je Linnworks al gebruikt als je multichannelhub, dan is het koppelen hier wat die gegevens daadwerkelijk in de rapporten van AskBiz krijgt.