Bol.com koppelen aan APIcenter

Je koppelt Bol.com aan APIcenter met client credentials uit je Bol.com-verkoopaccount. Client credentials bestaan uit een Client ID en een Client secret. Bol.com noemt ze zelf een soort gebruikersnaam en wachtwoord voor de API. Je doet dit één keer. Daarna gebruik je Bol.com in al je integraties.

Wat je nodig hebt

• Een Bol.com-verkoopaccount waarmee je bij de instellingen kunt.
• De gegevens van een technisch contactpersoon. Bol.com vraagt die in de API-instellingen. Zonder contactgegevens krijg je geen toegang tot de API.

Client credentials aanmaken in Bol.com

1. Log in op je Bol.com-verkoopaccount en open de instellingenpagina.
2. Ga onder Diensten naar API Instellingen.
3. Vul de gegevens van de technisch contactpersoon in en klik op Opslaan.
4. Klik onder Client credentials voor de Retailer API op Aanmaken.
5. Geef de set een naam, bijvoorbeeld APIcenter, en klik op Aanmaken.
6. Het Client ID staat nu in beeld. Klik op Toon secret om het Client secret te zien.

Maak voor APIcenter een eigen set aan en gebruik die niet voor andere software. Dan kun je de toegang van APIcenter intrekken zonder dat andere koppelingen stoppen. Bewaar het Client secret veilig en deel het met niemand, ook niet met Bol.com.

Meer uitleg staat bij Bol.com zelf: Toegang krijgen met API Client credentials en Authentication.

Zo koppel je Bol.com

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Bol.com.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je winkel, en klik op Opslaan.
3. Vul het Client ID en het Client secret van Bol.com in.
4. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is Bol.com klaar voor gebruik.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Toegang intrekken in Bol.com

In API Instellingen staat achter elke set een prullenbak. Verwijder je de set van APIcenter, dan werkt hij direct niet meer en verliest APIcenter de toegang. Wil je weer koppelen, dan maak je een nieuwe set aan en vul je de nieuwe gegevens in bij de Bol.com-verbinding in APIcenter.

Als het niet lukt

• Geeft Bol.com een fout 401 (Unauthorized) terug, dan zijn het Client ID of het Client secret niet juist. Maak zo nodig een nieuwe set aan.
• Geeft Bol.com een fout 403 (Forbidden) terug, dan kan het zijn dat je verkoopaccount bij Bol.com is geblokkeerd. Neem dan contact op met Bol.com.

Zie ook Verbinding of inloggen mislukt en Bol.com: veelvoorkomende fouten.

Volgende stappen

Maak een integratie met Bol.com en controleer de instellingen. Zie Bol.com verbindings- en integratie-instellingen.