De Bol-winkel van een klant koppelen
Je klant maakt bij Bol een API-sleutel voor de Retailer API. Met de client-ID en het secret koppel je Bol op Webwinkel van je klant. Jelto haalt de orders daarna elke ochtend zelf op.
Stappen
Vraag je klant om een API-sleutel voor de Retailer API, gemaakt in het Bol Partnerplatform bij Instellingen → API-instellingen.
Open bij je klant Webwinkel en kies Kanalen koppelen.
Kies Koppelen… op de kaart van Bol.
Plak de client-ID en het secret in de velden.
Kies Koppelen.
Kies op dezelfde kaart het standaard btw-tarief voor Bol-artikelen, als je klant dat nog niet deed.
Wat Jelto zelf doet
- Jelto controleert de sleutel met één leesvraag aan Bol. Het secret bewaart Jelto versleuteld.
- Direct na het koppelen haalt Jelto orders en facturen van Bol op. Daarna doet Jelto dat elke ochtend.
- Ook orders die Bol zelf verstuurt (FBB), komen binnen. Geannuleerde artikelen laat Jelto weg.
- Ophalen boekt niets. Wat Jelto niet zeker weet, legt Jelto aan je voor.
Als het anders loopt
Jelto meldt dat Bol de sleutel weigert
Laat je klant de client-ID en het secret opnieuw kopiëren, of een nieuwe sleutel maken. Koppel daarna opnieuw.
Je zoekt een order van langer dan drie maanden geleden
Bol bewaart orders maar drie maanden. Oudere orders haalt Jelto uit de specificatie bij de Bol-factuur. Daar staat alleen het EAN in, geen artikelnaam. Het btw-tarief komt uit de artikellijst van je klant.
Een retour staat nog niet in Jelto
Jelto boekt een retour als Bol de terugbetaling op de factuur zet. Dat geldt ook voor een annulering na betaling of een zoekgeraakte retour. Bol factureert twee keer per maand.
Je klant verkoopt aan een bedrijf in een ander EU-land
Bol verlegt de btw nooit. Jelto boekt zo'n order daarom met btw, net als een order van een particulier. Er komt geen vraag om een btw-nummer.
Een koppeling vraagt om opnieuw koppelen
Bol weigert de opgeslagen sleutel dan, bijvoorbeeld omdat je klant hem verwijderde. Op Vandaag staat een signaal. Koppel opnieuw met een nieuwe sleutel.
Je wilt de koppeling stoppen
Kies op de kaart van Bol Koppeling… en dan Ontkoppelen. Jelto verwijdert het secret. Wat al is opgehaald, blijft staan.