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 Koppelingen 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 je klant en ga naar Koppelingen.
Open de tegel van Bol en kies Koppelen….
Plak de client-ID en het secret in de velden.
Kies Koppelen.
Kies op dezelfde pagina 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.
- Een bestand van Bol inlezen kan niet meer. De factuurspecificaties haalt Jelto zelf op bij Bol.
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 vanzelf 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.
Je klant las vroeger een bestand van Bol in
Wat toen is ingelezen, blijft staan. Een order die ook via de koppeling binnenkomt, telt één keer.
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.
De btw op de kosten van Bol
Dat hoeft niet. Jelto neemt de btw op de kosten per regel over van de factuur van Bol. Een regel die niet klopt, komt op "te beoordelen" bij het kantoor.
Bol betaalt een vergoeding voor een zoekgeraakt artikel
Bol ziet die vergoeding als schadevergoeding, zonder btw. Jelto neemt het volledige bedrag over op de factuur van Bol. Bij het boeken komt het op 8990 Overige opbrengsten buiten de btw. Je klant hoeft daarvoor niets te doen.
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
Open de tegel van Bol, kies Koppeling… en dan Ontkoppelen. Jelto verwijdert het secret. Wat al is opgehaald, blijft staan.