WagenbeheerBeta

Koppelingen & publiceren

Publiceer je voorraad naar je eigen webshop, of laat een extern systeem (of je eigen website) hem ophalen via een gestandaardiseerde feed. Je koppelt altijd je eigen accounts — versleuteld opgeslagen, alleen in jouw omgeving gebruikt.

Je eigen accounts koppelen

Onder Koppelingen (eigenaar) verbind je je eigen externe accounts en sleutels. Ze worden versleuteld opgeslagen (AES-256) en alleen in jouw omgeving gebruikt — wij zien ze niet, en een opgeslagen sleutel wordt nooit teruggetoond.

Per kanaal zie je precies de velden die dat kanaal nodig heeft. Een voertuig publiceer je daarna met één klik vanaf de voertuigpagina, onder "Publiceren".

Webshop — WooCommerce (directe push)

Voertuigen worden als product in je WooCommerce-shop aangemaakt. Eenmalig instellen:

  • •Ga in WordPress naar WooCommerce → Instellingen → Geavanceerd → REST API en maak een sleutel aan met lees/schrijf-rechten.
  • •Vul bij Koppelingen → Webshop — WooCommerce je shop-URL (https://…), de consumer key (ck_…) en de consumer secret (cs_…) in.
  • •Klik op een auto bij "Publiceren" op Publiceren: de auto verschijnt direct als product (titel, prijs, omschrijving, kilometerstand/brandstof/opties als productdata). De status toont "gepubliceerd" of, bij een fout, de reden.

Webshop — Shopify (directe push)

Voertuigen worden als product in je Shopify-shop aangemaakt. Eenmalig instellen:

  • •Ga in je Shopify-admin naar Apps → Develop apps → Create an app, en geef de app de Admin API-rechten write_products.
  • •Installeer de app en kopieer de Admin API access token (begint met shpat_).
  • •Vul bij Koppelingen → Webshop — Shopify je shop-domein (jouwshop.myshopify.com) en de access token in. De API-versie mag je leeg laten (standaard 2024-10).
  • •Publiceer per auto vanaf de voertuigpagina, net als bij WooCommerce.

Auto-portals (Hexon, Mobile.de, AutoScout24, Marktplaats)

Voor de klassieke auto-portals zet Wagenbeheer de publicatie volledig klaar (content + koppeling gereed). Omdat elke portal een eigen, account-gebonden API heeft, wordt de live-push per portal met een geverifieerde adapter geactiveerd; tot dan staat de auto op "klaargezet".

Publicatieprijs: export vs Nederlands

Dezelfde auto heeft niet overal dezelfde prijs. Op een exportportal (bijvoorbeeld Mobile.de) adverteer je de exportprijs — netto, exclusief BTW en BPM. Op een Nederlandse consumentenportal (Marktplaats, AutoScout24, je eigen webshop) adverteer je de Nederlandse prijs — bruto, inclusief BTW en BPM.

Vul daarom op de auto zowel de Exportprijs als de Nederlandse prijs in. Bij publiceren kiest Wagenbeheer automatisch de juiste: een exportportal krijgt de exportprijs, een NL-portal de Nederlandse prijs. Laat je het typespecifieke veld leeg, dan valt de publicatie terug op de gewone verkoopprijs — één prijs invullen blijft dus werken.

  • •Standaard per portal: Mobile.de = export; Marktplaats, AutoScout24, Hexon en je webshop = Nederlands. Je kunt dit per portal overrulen onder Koppelingen → Publicatieprijs per portal.
  • •Auto-suggestie: op de auto stelt Wagenbeheer de Nederlandse prijs voor uit de exportprijs + BTW (bij een BTW-auto) + BPM, met het verschil zichtbaar. Het is een voorstel — je past 'm altijd zelf aan (ronde of strategische prijzen blijven van jou).

Uitgaande voorraadfeed (eigen website of tussenlaag)

Heb je geen standaard-adapter voor jouw systeem? Dan levert Wagenbeheer een gestandaardiseerde, token-beveiligde feed die je eigen website of een tussenlaag zélf ophaalt (pull). Activeer hem onderaan de Koppelingen-pagina; je krijgt een unieke URL van de vorm /api/feed/<token>/vehicles.json.

De feed bevat alléén de voertuigen die je op je eigen website toont (de markering "Op eigen website" op de auto), en nooit interne of kostprijs-data. Het antwoord is JSON met generatedAt, count en een vehicles-lijst.

  • •referentie — voertuignummer of kenteken (uniek per auto)
  • •merk, model, brandstof, km — kerngegevens
  • •prijs — Nederlandse consumentenprijs in euro's (valt terug op de verkoopprijs; of null)
  • •opties — de aangevinkte uitrusting (canonieke keys)
  • •teksten — advertentietekst in nl, de en en
  • •Token kwijt of gelekt? Vernieuw hem op Koppelingen; de oude URL vervalt dan meteen.

Veiligheid & privacy

  • •Alle externe sleutels worden versleuteld opgeslagen en uitsluitend in jouw omgeving gebruikt.
  • •De feed is alleen bereikbaar met jouw geheime token en bevat geen klant- of kostprijsgegevens.
  • •Je houdt zelf de regie: koppel je een account los, dan stopt de publicatie voor dat kanaal.