Handleiding BBT-koppeling
Wagens uit BBT automatisch op je website
Met de BBT-koppeling komen de stockwagens uit BBT Cloud vanzelf op je website. Je hoeft ze niet zelf in te voeren: de website haalt ze regelmatig op, zet nieuwe wagens erbij, werkt prijzen en foto's bij en haalt verkochte wagens weg.
In deze handleiding lees je wat je bij BBT moet regelen, wat je aan ons doorgeeft, welke instellingen je zelf kan aanpassen en wat je bezoekers op de site zien.
Kort samengevat
1. Zoek je API-sleutel in BBT (Instellingen > Algemeen > Bedrijf).
2. Bezorg ons die sleutel op een veilige manier, samen met je keuzes uit hoofdstuk 2.
3. Wij zetten de koppeling op en laten de import automatisch lopen.
4. Zet in BBT de wagens die online moeten op publiceren. Prijzen pas je zelf aan via Dashboard > Externe voorraad.
1. Wat regel je in BBT?
De website meldt zich bij BBT Cloud aan met een API-sleutel van je bedrijf en haalt zo je stockwagens op. Je hebt geen aparte XML-feed of link nodig.
- Zoek je API-sleutel in BBT onder Instellingen > Algemeen > Bedrijf. Vind je ze niet, vraag ze dan aan bij de helpdesk van BBT: helpdesk@bbt-cloud.be.
- Beslis welke wagens op de site komen. Standaard zijn dat enkel de wagens die je in BBT op publiceren zet. Zo kies je per wagen in BBT zelf of hij online komt.
- Kijk na dat bij je wagens de foto's, de gewenste verkoopprijs, de opties en de tekst bij Belangrijke opmerkingen in orde zijn. Die tekst komt als omschrijving op de website.
- Bezorg ons de API-sleutel op een veilige manier (zie hoofdstuk 2).
Goed om te weten: wat je in BBT wijzigt (prijs, foto's, publiceren aan of uit, verkocht), komt bij de volgende import vanzelf op je website. Je past je wagens dus op één plek aan: in BBT.
2. Wat bezorg je ons?
Bezorg ons deze gegevens. Weet je iets nog niet? Geen probleem, je kan het later zelf aanpassen.
- API-sleutel van BBT
Niet per gewone e-mail: bel ons, of spreek een veilige manier af. - Welke wagens?
Enkel de wagens die in BBT op "publiceren" staan (aangeraden), of alle stockwagens. - Opslag op de prijs
Geen, een percentage (bv. 8 %) of een vast bedrag (bv. € 750). - Afronden naar boven
Niet, of op € 10, € 50 of € 100. - Eigen eindprijs per wagen?
Ja / nee. Zo ja: wat tonen voor een wagen zonder eigen prijs? De prijs met opslag, of "Prijs op aanvraag". - Verkochte wagen
Van de site halen (standaard), of laten staan met "Verkocht".
3. Wat doen wij?
- We maken de koppeling aan in je website, met de gegevens en keuzes die je ons bezorgde.
- We doen een test en een eerste import. De eerste keer kan dat enkele minuten duren, omdat alle foto's gedownload worden.
- We zetten de automatische import aan: de website haalt je wagens dan zelf op, normaal elk uur.
Daarna loopt alles vanzelf. Wil je iets wijzigen, dan kan je dat zelf (hoofdstuk 4 tot 6) of vraag je het aan ons.
4. De koppeling in je dashboard
- Meld je aan op je website (via /login achter je domeinnaam, bv. www.jouwgarage.be/login).
- Open het Dashboard en kies Externe voorraad.
Per koppeling zie je hoeveel wagens er op de site staan en wanneer de laatste import was, met wat er veranderde. De knoppen:
| Knop | Wat doet hij? |
|---|---|
| Test | Toont welke wagens de site uit BBT krijgt, met prijs, bouwjaar, km, brandstof en aantal foto's. Onderaan staan ook de ruwe gegevens van de eerste wagen. Er wordt niets gewijzigd. |
| Nu importeren | Haalt de wagens meteen op en werkt de site bij, zonder te wachten op de volgende automatische import. Laat de pagina open tot het klaar is. |
| € Prijzen | Enkel zichtbaar als "Eindprijs per wagen kunnen aanpassen" aan staat (hoofdstuk 6). |
| Bewerken | De instellingen van de koppeling aanpassen. |
| Prullenbak (rood) | De koppeling verwijderen. Opgelet: alle wagens ervan verdwijnen dan van de site, met hun foto's. |
5. De instellingen
Klik bij je koppeling op Bewerken. Bovenaan staan de gegevens om aan te melden bij BBT:
| Veld | Wat vul je in? |
|---|---|
| Naam | Voor jezelf, bv. "BBT". Bezoekers zien die niet. |
| Bron | BBT Cloud (API). |
| API-sleutel van BBT | Na het bewaren wordt de sleutel niet meer getoond. Laat het veld leeg om hem te behouden; vul het enkel in als je een nieuwe sleutel hebt. |
| Enkel wagens die in BBT op "publiceren" staan | Aangevinkt (aangeraden): enkel de wagens die je in BBT publiceert. Uitgevinkt: al je stockwagens. |
| Taal van de uitrusting en omschrijving | De taal van je website. |
Verder in het formulier:
| Veld | Wat vul je in? |
|---|---|
| Wagens plaatsen onder | Meestal "Onze voertuigen". Laat dit staan zoals wij het instelden. |
| Een wagen verdwijnt (verkocht) | Naar de prullenbak met de foto's (aangeraden), of laten staan met status "Verkocht" (dan verwijder je hem later zelf). |
| Maximum aantal foto's per wagen | 0 = alle foto's. |
| Actief | Uitvinken zet de automatische import stil. De wagens blijven dan staan zoals ze zijn. |
6. De prijs op je website
Opslag op de prijs
Onder Prijs op de website kies je hoe de prijs op je site berekend wordt: geen opslag (de prijs uit BBT), een percentage of een vast bedrag, eventueel naar boven afgerond op € 10, € 50 of € 100. Het formulier toont meteen een voorbeeld. De opslag geldt voor alle wagens van de koppeling; bij het bewaren worden de prijzen op de site meteen herberekend.
Een eigen eindprijs per wagen
Vink Eindprijs per wagen kunnen aanpassen aan en bewaar. In het overzicht verschijnt de knop € Prijzen: per wagen zie je de prijs uit BBT, een veld Eindprijs website en de prijs die nu op de site staat. Vul de prijzen in en klik op Prijzen bewaren.
Je eigen eindprijs gaat voor op de opslag en blijft staan bij elke volgende import. Kies ook wat de site toont voor een wagen zonder eigen eindprijs: de prijs met je opslag, of "Prijs op aanvraag".
7. Hoe vaak wordt je site bijgewerkt?
- De website haalt je wagens automatisch op, normaal elk uur. Een wijziging in BBT staat dus meestal binnen het uur online.
- Kan je niet wachten? Klik op Nu importeren.
- Enkel wat veranderde wordt bijgewerkt. Foto's worden maar één keer gedownload, of opnieuw als ze veranderen.
- Veiligheid: is BBT even onbereikbaar of komt er plots minder dan de helft van de wagens door, dan wordt er niets verwijderd. Je wagens blijven online. Klopt het toch, dan bevestig je dat in het verslag met "Klopt: importeren en ook verwijderen".
8. Wat zien je bezoekers?
Elke wagen uit BBT wordt een gewone occasiepagina, tussen de wagens die je eventueel zelf invoert. Bezoekers zien geen verschil.
- De wagen staat in de voertuigenlijst op "Onze voertuigen", met de filters op merk, brandstof, transmissie en prijs, en in de sliders met stockwagens.
- De wagenpagina toont de foto's (de eerste is de hoofdfoto), de prijs en de gegevens: merk, model, uitvoering, bouwjaar, kilometerstand, brandstof, transmissie, carrosserie, vermogen, kleur, euronorm, deuren, CO₂, btw aftrekbaar en status.
- Onder de foto's: de tekst bij Belangrijke opmerkingen als omschrijving en je opties als uitrusting.
- Delen, afdrukken en het aanvraagformulier werken ook voor deze wagens.
- Een verkochte wagen verdwijnt van de site (of blijft staan als "Verkocht", als je dat zo instelde).
9. Zelf een wagen aanpassen
Pas je wagens bij voorkeur aan in BBT: de volgende import neemt het over. Wil je toch op de website zelf iets wijzigen (een andere tekst, extra foto's)?
- Open de wagen op je site, klik op het tandwiel en kies Kenmerken.
- Vink bij Externe voorraad "Niet bijwerken door de import" aan.
- Pas de pagina aan en publiceer.
Zonder dat vinkje overschrijft de volgende import je wijzigingen. Wagens die je zelf invoert, worden nooit door de import aangeraakt.
10. Problemen oplossen
| Probleem | Wat kan je doen? |
|---|---|
| Melding dat de aanmelding bij BBT mislukt | De API-sleutel klopt niet (meer). Zoek ze opnieuw in BBT onder Instellingen > Algemeen > Bedrijf, plak ze bij Bewerken en bewaar. |
| Een wagen staat er niet op | Staat hij in BBT op publiceren? Wacht de volgende import af of klik op Nu importeren. Met Test zie je welke wagens de site uit BBT krijgt. |
| De omschrijving ontbreekt | De site gebruikt de tekst bij Belangrijke opmerkingen in BBT. Vul die in. |
| Geen uitrusting | Vink in BBT de opties van de wagen aan. |
| De prijs is anders dan verwacht | De site gebruikt de gewenste verkoopprijs uit BBT. Kijk ook je opslag na, en of er bij € Prijzen een eigen eindprijs staat. |
| Melding: meer dan de helft verdwijnt | Uit voorzorg verwijdert de site dan niets. Klopt het, klik dan op "Klopt: importeren en ook verwijderen". |
Kom je er niet uit? Neem contact met ons op en vermeld wat je ziet bij Laatste import.
← Alle handleidingen · Vragen? Neem contact op.






