Loading...
Documentatie

Documentatie

U bent hier : Home / Documentatie

Algemene omschrijving

Er zijn twee manieren om de voorraad te ontvangen

  • Bulk (batchgewijs)

    In deze methode van ontsluiting wordt op vaste (instelbare) tijdstippen de gehele voorraad geëxporteerd naar de FTP server van uw website-ontwikkelaar. Dit is, afhankelijk van de instellingen, een ZIP-bestand met daarin een XML-bestand met de voorraad en de bijbehorende foto’s. Om de bestanden niet onnodig groot te maken worden alleen nieuwe en gewijzigde foto’s uitgeleverd.

  • Incrementeel (real-time)

    Bij deze methode van ontsluiting wordt iedere mutatie (toevoegen/wijzigen/verwijderen) van een voertuig naar een pagina op uw webserver ('endpoint') gestuurd. Met deze methode is het mogelijk om uw website zonder merkbare vertraging up-to-date te houden.

Karakterset

Alle communicatie vindt plaats in Unicode (UTF-8). Gebruikt uw database of website een andere karakterset, zoals Windows-1252 of ISO-8859-1, dan zult u de gegevens eerst moeten converteren alvorens ze op te slaan.

Leads

Leads zijn berichten die vanaf de website gestuurd kunnen worden. Hiermee kan bijvoorbeeld informatie worden gevraagd, een testrit geboekt worden, een bod uitgebracht worden, een klacht ingediend worden en nog diverse andere berichten gestuurd worden. Leads die vanaf de website gestuurd worden kunnen worden opgevangen door het systeem. Dit kan door ze via SOAP of REST naar het systeem te sturen.

SOAP

De WSDL is te vinden op https://eigenwebsite.doorlinkenvoorraad.nl/v1/leads/deliver.html?wsdl. Als de aanvraag niet verwerkt kan worden levert dit een SOAP Fault op.

REST

Via REST (HTTP POST) kan de lead naar https://eigenwebsite.doorlinkenvoorraad.nl/v1/leads/deliver.html gestuurd worden. Dit levert of 'OK:nnnn' op waarbij nnnn een uniek id is, of 'ERR:ssss' waarbij ssss een foutmelding is.

Velden

Veel gestelde vragen

Welke koppelmethode (incrementeel of bulk) is beter?

Het antwoord op deze vraag is afhankelijk van uw wensen en technische mogelijkheden. Over het algemeen is de incrementele variant (XML POST) de meest voor de hand liggende keuze: de website is altijd actueel; is relatief eenvoudig te implementeren; u ontvangt de meest rijke dataset aan gegevens.

Ik wil slechts een deel van mijn voorraad adverteren. Hoe doe ik dit?
Hoe genereer ik thumbnails van de foto's?
Waarom staan er rare tekens in de teksten (bijv. Citroën)?
Het aantal voertuigen op mijn website komt niet overeen met het aantal voertuigen in mijn voorraadbeheerapplicatie. Wat nu?
Ik gebruikt een oudere versie, hoe zie ik de bijbehorende ondersteunde velden?