In dit artikel word je door het proces geleid van het maken van een verbinding tussen Channable en Bol, het opzetten van een API-kanaal en het versturen van je productvermeldingen.
Dit artikel gaat ervan uit dat je al producten op Bol hebt staan. Als je voor de eerste keer je producten naar Bol stuurt, raadpleeg dan dit artikel over het toevoegen van nieuwe producten op Bol.
Inhoudsopgave
- Voorbereiding
- Een Bol-koppeling aanmaken
- Het API-kanaal aanmaken
- Productvermeldingen aanmaken
- Verwijderen van producten uit je Bol verkopersaccount
- Productvermeldingen versturen naar Bol
- Productvermeldingen controleren op foutmeldingen
Voorbereiding
- EAN-codes: Geldige EAN-codes zijn verplicht voor Bol. Zorg ervoor dat al je producten een geldige EAN-code hebben, want zonder deze data kun je geen producten vermelden.
- Uitloggen Bol-account: Zorg ervoor dat je uitlogt uit je Bol-account voordat je een verbinding aanmaakt in Channable. Als je ingelogd blijft, kan dit automatische aanmeldproblemen veroorzaken tijdens het verbindingsproces.
- Houdbaarheid Bol-verbinding: Je Bol-verbinding verloopt na een tijdje, wat leidt tot een 'Mislukte API'-melding. Als dit gebeurt, vernieuw dan je verbinding door de stappen in dit artikel te volgen.
- Bol NL of Bol BE: De stappen voor het opzetten van een API zijn voor zowel NL als BE hetzelfde, maar zorg ervoor dat je het juiste account en land selecteert bij het opzetten van je Bol API.
Stap 1: Een Bol-koppeling aanmaken
Vol onderstaande stappen om een Bol-koppeling aan te maken.
- Navigeer naar APIs en kies voor API koppeling toevoegen. Klik vervolgens op de volgende pagina op Koppeling toevoegen;
- Selecteer Bol, voeg een label toe en klik op Koppel met Bol;
- Je wordt doorverwezen naar het Bol-inlogportaal. Log hier in met je gegevens en volg de gegeven stappen.
Nadat je bovenstaande stappen hebt doorlopen is de koppeling tussen Channable en Bol aangemaakt en kun je verder aan de slag met het opzetten van je Bol API-kanaal! Je wordt automatisch teruggestuurd naar Channable.
Stap 2: Het API-kanaal aanmaken
Eenmaal terug in Channable, selecteer je jouw nieuwe Bol-koppeling en ga je verder met het opzetten van je API-kanaal. Volg onderstaande stappen om je API-kanaal aan te configureren en aan te maken.
- Geef je API-kanaal een naam;
- Kies het 'Unieke ID per item' (aanbevolen veld: 'id');
- Selecteer de taal van de item-inhoud;
- Klik op Volgende om je Bol API-kanaal aan te maken.
Je kunt er voor kiezen om alleen de content-gegevens naar Bol te sturen. Lees dit artikel voor meer informatie over deze functie.
Stap 3: Productvermeldingen aanmaken
Het instellen van je productvermeldingen omvat drie belangrijke stappen. Hieronder vind je deze stappen, inclusief uitleg per onderdeel.
1. Categorieën
Omdat Bol jouw EAN-codes al kent, kun je deze stap overslaan. In het geval je een foutmelding krijgt, omdat je nieuwe producten toevoegt of Bol je producten niet herkent, raadpleeg dan dit artikel.
2. Opbouw
In de Opbouw-stap configureer je de essentiële informatie voor je producten. Deze stap omvat het invullen van gedeelde attributen, het toevoegen van verzendcodes en het aanvullen van je info in de drie overige subtabs.
- Item: Koppel je geïmporteerde velden aan het template door de correcte velden te selecteren. Koppel bijvoorbeeld de het veld title, dat je titelwaarden bevat, aan het gevraagde veld 'Titel'.
- Item → Levertijd code: Vul hier de leveringscodes voor je producten in. In dit artikel lees je meer over dit specifieke veld.
Naast de Item-tab vind je nog drie tabbladen waarmee je verdere gegevens en voorkeuren kunt toevoegen aan de producten die je naar Bol gaat sturen.
- Volumekorting: Stel hier kortingen in voor consumenten die meerdere hoeveelheden kopen. Meer informatie over het instellen van volumekortingen vind je hier.
- Prijsverlaging: Bol biedt lagere commissies voor producten die voldoen aan specifieke maximumprijzen. Hier lees je meer over deze functie.
- Afbeelding: Koppel hier de afbeeldingen en/of media-assets die je naar Bol wilt sturen. Je kunt ook gelabelde assets toevoegen onder Gelabelde assets. Gedetailleerde instructies hierover vind je in dit artikel.
Zodra je alle benodigde informatie hebt ingevuld, klik je onderaan het scherm op Opslaan.
We raden aan om je productvermeldingen in eerste instantie naar Bol te sturen zonder de attributen in te vullen. Als Bol de EAN-codes van je producten al kent, is deze stap namelijk niet nodig. De Attributen-stap is automatisch niet beschikbaar als de Categorieën-stap wordt overgeslagen.
Stap 4: Verwijderen van producten uit je Bol verkopersaccount
Het is cruciaal om alle oude productvermeldingen van je Bol verkopersaccount te verwijderen voordat je jouw producten via de Bol API in Channable verstuurt. Volg onderstaande stappen om de bestaande productvermeldingen te verwijderen om zo synchronisatiefouten te voorkomen.
- Navigeer naar je producten: Ga binnen je Bol verkopersaccount naar Artikelen > Mijn artikelen;
-
Selecteer en verwijder productvermeldingen: Selecteer alle producten die ook via Channable verstuurd gaan worden middels de knop Alle. Klik vervolgens op Bewerk aanbod, scrol naar beneden en klik op Verwijderen om de geselecteerde producten te verwijderen.
Belangrijke opmerkingen:
- Behoud van productinformatie: Ook na bovenstaande actie blijft de productinformatie van je eerdere productvermeldingen opgeslagen in de Bol database. Daarom kun je de Categorieën-stap en Attributen per categorie-tab in de Opbouw-stap overslaan tijdens de API setup.
- Voltooi de Opbouw-stap: Zorg ervoor dat je het tabblad Gedeelde attributen invult in de Opbouw-stap, omdat dit essentiële informatie bevat voor je aanbod.
- Beoordelingen behouden: Je Bol-beoordelingen worden niet verwijderd en verschijnen weer zodra je producten opnieuw worden aangeboden middels Channable.
Stap 5: Productvermeldingen versturen naar Bol
Je productvermeldingen zijn nu klaar om verzonden te worden. Als je je project nog niet hebt geactiveerd, navigeer dan binnen je Channable-project naar je Configuratie aan de linkerkant van het scherm en klik op Activeer project.
Ga daarna terug naar het API-overzicht en ga naar [Jouw Bol API] > Instellingen, waar je de API activeert door op API activeren te klikken.
Zodra je het kanaal hebt geactiveerd, navigeer je terug naar het API-overzicht en klik je op de blauwe Uitvoeren-knop om je productvermeldingen naar Bol te sturen.
Stap 6: Productvermeldingen controleren op foutmeldingen
Je kunt je verzonden productmeldingen nu controleren op eventuele fouten. Dit doe je door naar de Restulaat-pagina van de API te navigeren, waarna je het tabblad Fouten opent. Door hier op een specifieke foutmelding te klikken, wordt er meer informatie weergegeven over de oorzaak van de fout. In dit artikel vind je voorbeelden van veelvoorkomende fouten.