Koppel Jumia aan AskBiz: orders, uitbetalingen en voorraad voor Afrikaanse marktplaatsen
Hoe je je Jumia Vendor Center-account koppelt aan AskBiz met een Client ID en Refresh Token, wat er daadwerkelijk wordt gesynchroniseerd, en wat nog buiten scope valt.
Key Takeaways
- Jumia bevindt zich onder Sources > E-commerce naast Shopify, Amazon FBA, eBay, Etsy, WooCommerce en Walmart — maar in tegenstelling tot die bronnen gebruikt het geen OAuth-verbinding met één klik.
- Je koppelt het handmatig, door een Client ID en Refresh Token te plakken die je zelf genereert in Jumia Vendor Center > Settings > Applications (Self Authorisation).
- Elke synchronisatie haalt recente orders en actuele voorraadniveaus op uit je Jumia-winkels; het uitbetalingscijfer dat per order wordt getoond, is een schatting op basis van orderomzet, niet Jumia's officiële afgehandelde uitbetalingsoverzicht.
- Jumia-voorraad voedt rechtstreeks je CFO-voorraadweergave en per kanaal gelabelde voorraadwaarschuwingen — Jumia-verzendingen en bezorgtracking vallen bewust buiten de scope van deze connector.
- Dit is een nieuw gebouwde connector, intern getoetst aan Jumia's API maar nog niet end-to-end geverifieerd op een live verkopersaccount — het is de moeite waard je eerste synchronisatie te controleren tegen de eigen cijfers van Vendor Center.
Wat de Jumia-connector doet
Jumia is een van de E-commerce-bronnen onder Sources in AskBiz, naast Shopify, Amazon FBA, eBay, Etsy, WooCommerce en Walmart. Eenmaal gekoppeld is het een alleen-ophalen-synchronisatie: AskBiz leest je recente orders en actuele voorraadniveaus uit Jumia Vendor Center en verwerkt ze in je uniforme bedrijfsgegevens, dezelfde plek waar elk ander kanaal — je fysieke kassa, je Shopify-winkel, je Amazon-listings — terechtkomt. Dat is het hele punt van koppelen: in plaats van apart in te loggen bij Vendor Center om te checken hoe je Jumia-winkel het doet, verschijnen de orders en voorraad naast al het andere, in één dashboard, in je lokale valuta.
Waarom er geen knop 'Connect' met één klik is
Shopify, Amazon FBA, eBay en Etsy gebruiken allemaal standaard OAuth — je klikt op Connect, wordt doorgestuurd om bij dat platform in te loggen, keurt toegang goed, en landt terug in AskBiz al gekoppeld. Jumia's Vendor Center biedt dat niet voor apps van derden. In plaats daarvan werkt het met wat Jumia Self Authorization noemt: je maakt je eigen Applicatie aan binnen je eigen Vendor Center-account, en dat genereert een Client ID en een Refresh Token die specifiek zijn voor jouw winkel. Er is geen door AskBiz beheerde app die je goedkeurt en er wordt nooit een wachtwoord tussen de twee doorgegeven — je genereert een inloggegevenspaar dat alleen jouw Jumia-account beheert, en geeft die twee waarden vervolgens rechtstreeks door aan AskBiz.
Je account koppelen, stap voor stap
Log in bij Jumia Vendor Center en ga naar Settings, dan Applications. Klik op Create Application en kies Self Authorisation als type. Jumia toont je een Client ID — kopieer die — en laat je een Refresh Token genereren — kopieer die ook. Terug in AskBiz ga je naar Sources, zoek je Jumia onder E-commerce, en plak je het Client ID in het veld Client ID en het Refresh Token in het veld Refresh Token (dit laatste is gemaskeerd, zoals een wachtwoord). AskBiz controleert de gegevens meteen door een toegangstoken van Jumia op te vragen en te bevestigen dat het je winkellijst kan lezen voordat de koppeling wordt opgeslagen. Als die controle mislukt, is de meest voorkomende oorzaak dat de Applicatie geen Order- of Product-machtigingen heeft ingeschakeld in Vendor Center — ga terug en controleer of die rollen zijn aangevinkt, en probeer het dan opnieuw.
Wat er daadwerkelijk wordt gesynchroniseerd — en wat niet
Elke synchronisatie haalt je recente orders op (een doorlopend venster, meest recente eerst) en, voor elke order, de individuele orderregels — Jumia's model levert één rij per verkocht stuk in plaats van een hoeveelheidsveld, dus een regel van 3 stuks in je winkel komt terug als drie afzonderlijke items, elk met zijn eigen prijs, korting, belasting en verzendcijfer. Voorraadniveaus komen van een apart catalogus-eindpunt, gesorteerd op SKU. Goed om te weten: het uitbetalingsbedrag dat je ziet bij een Jumia-order in AskBiz is berekend op basis van de netto-omzet van die order na kortingen, niet opgehaald uit Jumia's officiële afrekeningsoverzicht — Jumia toont echte commissie- en kostenaftrekken alleen via een apart uitbetalingsoverzicht-eindpunt dat deze connector momenteel niet leest. Behandel het uitbetalingscijfer als een bruikbare schatting om trends te volgen, niet als vervanging voor het uitbetalingsoverzicht binnen Vendor Center zelf wanneer je het exacte bedrag nodig hebt. De connector is ook aan beide kanten alleen-ophalen in scope: hij schrijft nooit terug naar je Jumia-listings, prijzen of voorraad, en raakt bewust nooit de verzend- of bezorgtrackinggegevens van Jumia — deze connector gaat over verkoop- en voorraadinzicht, niet over logistiek.
Waar je het terugziet in AskBiz
Jumia-orders tellen mee voor je gecombineerde omzet- en ordertotalen over elk gekoppeld kanaal, elk geprijsd in de eigen lokale valuta van de winkel. Voorraadniveaus voeden je CFO-voorraadweergave, samengevoegd met hetzelfde product waar mogelijk — let op: Jumia's voorraadfeed bevat geen productnaam, dus totdat deze is gekoppeld aan een benoemde listing uit een ander kanaal, toont AskBiz in plaats daarvan de SKU. Voorraadwaarschuwingen zijn gelabeld per kanaal, zodat een waarschuwing dat een Jumia-SKU bijna op is niet wordt verward met dezelfde SKU die het prima doet in je fysieke winkel. En in het kanaalfilter van het tabblad Intelligence is Jumia een selecteerbare optie, zodat je Jumia-prestaties los van al het andere dat je verkoopt kunt bekijken.
Goed om te weten voordat je erop vertrouwt
Deze connector is recent toegevoegd. Hij is intern gebouwd en getoetst aan Jumia's gedocumenteerde Vendor Center-API, maar is nog niet end-to-end getest tegen een live, actief Jumia-verkopersaccount — behandel je eerste synchronisatie dus als iets om te controleren tegen de eigen order- en voorraadcijfers van Vendor Center, in plaats van aan te nemen dat het vanaf dag één exact is. Als een synchronisatie stopt met werken met een fout over het refresh-token, betekent dat vrijwel altijd dat het is ingetrokken of verlopen in Vendor Center — genereer een nieuw Client ID en Refresh Token en koppel opnieuw vanuit Sources. Achter de schermen genereert AskBiz bij elke synchronisatie ook een vers toegangstoken vanuit je refresh-token in plaats van te proberen er een te hergebruiken, aangezien Jumia's toegangstokens kortlevend zijn, en het spreidt bewust zijn verzoeken om onder Jumia's snelheidslimiet te blijven in plaats van ze allemaal tegelijk af te vuren. Omdat elke synchronisatie een beperkte batch van je meest recente orders ophaalt, kan een winkel met zeer hoog volume zijn volledige recente geschiedenis over een paar synchronisaties zien invullen in plaats van in één keer bij de eerste run.