Nutzen Sie unsere Schnittstellen
Nachfolgend erhalten Sie Erläuterungen zu unserer XML-Schnittstelle
um die KFZ-Daten im XML-Format abzufragen. Die Daten werden in Echtzeit
zur Verfügung gestellt und auch Klickmonitoring ist automatisch
integriert.
Release: V2.20
Der Basisaufruf der XML-Schnittstelle:
https://api.ebewerter.de/inc/flashxml.asp?authcode=[authcode]&source=[IhrSourceCode]
Den AuthCode und SourceCode erhalten Sie von uns, wenn der Kunde
uns die enstprechende Information zur Freigabe mitgeteilt hat.
Bitte führen Sie zur Sicherheit in jedem Aufruf den Authcode und den SourceCode
mit. Bitte beachten Sie zur Datenintegrität und Wartbarkeit: ab 15.02.2023 werden Aufrufe nur noch von api.ebewerter.de und mit Angabe Source und AuthCode akzeptiert.
Mit nachfolgenden Beispielen können Sie sich einen Einblick
in den Aufbau der XML geben
Aufruf der aktuell verfügbaren Marken in der Datenbank
https://api.ebewerter.de/inc/flashxml.asp?authcode=[authcode]&source=[IhrSourceCode]&type=brand[optional:&txtKategorie=]
Aufruf der Standorte
https://api.ebewerter.de/inc/flashxml.asp?authcode=[authcode]&source=[IhrSourceCode]&type=location
Aufruf der aktuell verfügbaren KFZ-Kategorien
https://api.ebewerter.de/inc/flashxml.asp?authcode=[authcode]&source=[IhrSourceCode]&type=category
Aufruf der aktuell verfügbaren Modelle zu einer Marke (nur
in Kombination sinnvoll)
https://api.ebewerter.de/inc/flashxml.asp?authcode=[authcode]&source=[IhrSourceCode]&type=models&txtMarke=audi
[optional:&txtKategorie=&useclass=1&txtModelClass=(nicht
kombinierbar mit useclass=1)]
Hinweis: Bei Mercedes-Benz wird marketingbedingt die -Klasse aktuell
nur noch bei Einzelbuchstaben mitgeführt (z.B. E-Klasse). Wenn Sie
z.B. alle Einzelmodelle der SL-Baureihe haben möchten so verwenden
Sie bei txtModell/txtModelClass dennoch konsequenterweise SL-Klasse
Aufruf der aktuell verfügbaren maximalen Basiswerte wie Kilometer,
Preis, Leistung, Treibstoffarten
https://api.ebewerter.de/inc/flashxml.asp?authcode=[authcode]&source=[IhrSourceCode]&type=maxval
Aufruf der Suche in der Datenbank - Basisauruf ohne Filter
https://api.ebewerter.de/inc/flashxml.asp?authcode=[authcode]&source=[IhrSourceCode]&type=search
Aufruf der Suche in der Datenbank - Filtermöglichkeiten (kombinierbar
mit "&")
txtpaging = Erstes KFZ in der Reihenfolge (nur kombinierbar mit
txtLimit z.B. txtLimit=50&txtPaging=51)
txtlimit = Maximale Anzahl Treffer pro Seite (nur kombinierbar mit
txtPaging max. 100)
txtMarke = Marke
txtModell = Modell
txtkfzneu = 0/1 nur Neu oder nur GebrauchtKFZ
txtkfzzustand = 1= nur Gebraucht/2= nur Neu (Alternative zu txtkfzneu
- nur eine Variante verwenden)
txtTreibstoff (ex. txtDiesel) = Diesel/Benzin/Gas/Hybrid/Elektro/Wasser
txtPreisVon = Ganzzahl (Minimale Preisuntergrenze)
txtPreisBis = Ganzzahl (Maximale Preisobergrenze)
txtKMVon = Ganzzahl (Minimale Kilometeruntergrenze)
txtKMBis = Ganzzahl (Maximale Kilometerobergrenze)
txtKWVon = Ganzzahl (Minimale KW-Leistung)
txtKWBis = Ganzzahl (Maximale KW-Leistung)
txtEZ = Jahreszahl ab der KFZ EZ haben sollen (4stellige Ganzzahl
- Alternativ: txtEZVon)
txtEZBis = Jahreszahl bis zu der KFZ EZ haben sollen (4stellige
Ganzzahl)
txtKategorie = Siehe Bezeichung type=category
txtnavigationssysten=1/2 (Nur KFZ mit dieser Ausstattung 2=nur Premiumnavi)
txtallrad=1 (Nur KFZ mit dieser Ausstattung)
txtleder=1 (Nur KFZ mit dieser Ausstattung)
txtxenon= 1=Xenon/2=LED/3=Xenon+Nachtsicht/4=LED+Nachtsicht (Nur
KFZ mit dieser Ausstattung)
txtsd=1 (Nur KFZ mit dieser Ausstattung - SchiebeDach)
txtpdc=1 (Nur KFZ mit dieser Ausstattung - ParkDistanceControl)
txtsh=1 (Nur KFZ mit dieser Ausstattung - Sitzheizung)
txtlm=1 (Nur KFZ mit dieser Ausstattung - LM-Felgen)
txtahk=1 (Nur KFZ mit dieser Ausstattung -Anhängerkupplung)
txtbtooth=1 (Nur KFZ mit dieser Ausstattung - Bluetooth-Handyanbindung)
txtmetal=1 (Nur KFZ mit dieser Ausstattung - Metallic-Aussenlack)
txtesp=1 (Nur KFZ mit dieser Ausstattung - ESP)
txtfree=[text] (IntNr, Modell und Ausstattung wird nach diesem Textteil
gefiltert)
txttueren=1 (Nur KFZ mit dieser Anzahl an Tueren)
txtklima=1 /2(Nur KFZ mit dieser 1)Klima manuell oder Klimaautomatik
2) nur Klimaautomatik)
txtautomatik=1 (Nur KFZ mit dieser Ausstattung)
txtmwst=1 (Nur KFZ mit Regelbesteuerung)
txtsiegel= Ganzzahl (Qualitätsprüfung || 2=WeltAuto, 3=Audi
GWPlus, 6=BMW Premium, 10=Junge Sterne, 52=Junge Sterne Transporter)
txtvfw=1 (Nur KFZ die als Vorführer deklariert sind)
txtoldt=1 (Nur KFZ die als Oldtimer deklariert sind)
txttagestip=1 (Nur KFZ die als Tagestip markiert sind)
txtnoreserv=1 (Nur KFZ die aktuell nicht reserviert sind)
txtyoungt=1 (Nur KFZ die als Youngtimer deklariert sind)
txtorder= Sortierreihenfolge (1=Preis ASC 2=Preis DESC 3= EZ ASC
4=EZ DESC 5=KM ASC 6=KM DESC 7=Marke 8=KFZ ID DESC, 9 = KFZ Intnr
ASC, 10=Hereinnahme ASC, 11=Hereinnahme DESC, 12=Rate ASC)
txtloc = Ganzzahl des Standortes (|-getrennt z.B. 2|3|9|12) (siehe
Aufruf type=location)
txtcount=0/1 Wenn 1 dann wird Anzahl der Treffer anhand der Filter
ermittelt
txtdw=0/1 (1=Nur KFZ die als Dienstwagen deklariert sind 0=Keine
Dienstwagen)
txttgz=0/1 (1=Nur KFZ die als Tageszulassung deklariert sind 0=Keine
Tageszulassung)
txtezmaxmon= Maximale Anzahl in Monate von EZ berechnet, die ein
KFZ maximal alt sein darf
txtjw=0/1 (Nur KFZ die als Jahreswagen deklariert sind)
txthdlware=0/1 (Nur KFZ die als Händlerware/Export deklariert
sind)
txtblocked=1/2 (1=Nur KFZ die gesperrt sind//2=Sowohl gesperrte
als auch freigegebene KFZ)
txtabs=0/1 (1=Nur KFZ die ABS haben)
txtfarbe=Farbbezeichnung des Exterieurs (Grundfarbe z.B. rot, grün,
weiss)
txtstdklima=0/1 (1=Nur KFZ die Standklima haben)
txtretarder=0/1 (1=Nur KFZ die Retarder/Intarder haben)
txtdpf=0/1 (1=Nur KFZ die Dieselpartikelfilter haben)
txttempo=0/1 (1=Nur KFZ die Tempomat haben)
txtstdheiz=0/1 (1=Nur KFZ die Standheizung haben)
txthydr=0/1/2/3 (1=Kipp/2=Schubboden/3=Tankboden)
txtumwelt=0/1 (1= Plakette gruen)
txtschads=E1-E6 (Euro-Norm 1-6)
txtfahrh=0/1/2 (1=Nahverkehr/2=Fernverkehr)
txtgewvon=Zulässiges Gsamtgewicht ab (Angaben in KG)
txtgewbis=Zulässiges Gsamtgewicht bis (Angaben in KG)
txtsitzvon=Anzahl Sitzplätze von
txtsitzbis=Anzahl Sitzplätze bis
txtachsvon=Anzahl Achsen von
txtachsbis=Anzahl Achsen bis
txteffclbis=Mindest-Effizizenzklasse oder besser, 1=A+ - 8=G
txtauction=0/1 (1=Zeigt aktive Auktionen an)
txtlights=0/1/2/3/4 (0=Halogen/1=Xenon/2=LED/3=Xenon+Nacht/4=LED+Nacht)
txtmaxrate = Ganzzahl (Eurobetrag den die maximale Monatsrate nicht
überschreiten darf)
txtminrate = Ganzzahl (Eurobetrag den die maximale Monatsrate nicht
unterschreiten darf)
txtsport=0/1 (1=Sportpaket)
txthead=0/1 (1=HeadUP)
txtkamera=0/1 (1=Rückfahrkamera)
txtsoft=0/1 (1=SoftClose)
txtsitzklima=0/1 (1=Sitzbelüftung)
txtabstand=0/1 (1=Abstandsregler)
txtspur=0/1 (1=Spurwechselhilfe)
txtnacht=0/1 (1=Nachtsichtgerät)
txtled=0/1 (1=VollLED-Scheinwerfer)
txtverkzeichen=0/1 (1=Verkehrszeichenerkennung)
txtpano=0/1 (1=Panoramadach)
txtisofix=0/1 (1=Isofix)
txtairsusp=0/1 (1=Luftfederung)
txtsitzklima=0/1 (1=Sitzbelüftung)
txtpromo=Signalwort für Aktionsware
nohttptag=0/1 (1=liefert alle Links ohne https:// oder https:// Tag
aus)
showdesc=0/1 (1=liefert mehr Info in Details zur Ausstattung aus)
showextpics=0/1 (1=liefert Zusatzbildinformationen
showextpics-Tags: carindividplaceholder, carindividqualiinfo, carindividinfo1, carindividinfo2,
carindividfinal1,carindividfinal2,carindividfinal3,carindividfinal4
Mögliche Werte für:
txtTreibstoff = Benzin - Diesel - Hybrid - Elektro - Gas - Wasser
leder = Vollleder - Teilleder - Stoff - Alcantara - Velour - Kunstleder
- Andere
Beispiel für kombinierte Suche:
https://api.ebewerter.de/inc/flashxml.asp?authcode=12345&source=[IhrSourceCode]&type=search&txtMarke=mercedes-benz&txtAutomatik=1
Aufruf einer Einzelanzeige inkl. detailierten Daten
Bevorzugte Variante über <dbid>[ID]</dbid>
https://api.ebewerter.de/inc/flashxml.asp?authcode=12345&source=[IhrSourceCode]&type=detail&id=121928&click=1
Über die <result id="[ID]">
https://api.ebewerter.de/inc/flashxml.asp?authcode=12345&source=[IhrSourceCode]&type=detail&intnr=94548&click=1
Mit sold=1 können auch KFZ-Details bereits verkaufter KFZ aufgerufen
werden, ggf. mit txtblocked=2 kombinieren
Mit txtnocode=1 können Sie Ausstattungscodes entfernen (relevant
Codes in der Syntax [CCC] [Text]
Hinweis: Der Parameter "click=1" erhöht bei diesem
KFZ den ClickCounter zur Auswertung.
Ebenfalls ist ein Aufruf über die Fahrgestellnummer möglich
jedoch ist diese aus Datenschutzgründen verdeckt
https://api.ebewerter.de/inc/flashxml.asp?type=detail&source=[IhrSourceCode]&chassis=WDB21100205565810
Die Schnittstelle liefert Daten gem. Abfragen. Je nach Einsatzzweck
der Informationen ist eine Prüfung und Datendarstellung durch
den Verwerter durchzuführen z.B. PKW-EnVKV oder andere Plausibiltätsprüfungen.
Für eine optimale Leadbearbeitung empfehlen wir in der Anfragenemail einen einheitlichen Subject-Beginn z.B. Homepage Fahrzeuganfrage.
Ebenfalls sollte in der Email am Ende (ggf. verdeckt) ein XML-Tag enthalten sein. Bei MultiPart-Emails sowohl in HTML als auch PlainText-Version.
Beispiel und Struktur:
<lead><vehicle><internalId>BEI-0037</internalId><make>Opel</make><model>Corsa D 1.2 Twinport Edition Klima*Parkpilot*</model><firstRegistration>02/2008</firstRegistration><mileage>74500</mileage><price>5790</price><conditionType>USED</conditionType><type>PKW</type></vehicle><potentialBuyer><name>Alex</name><email>test@o2.pl</email><message>Hallo, kann man noch was mit dem Preis machen? oder kann man in Raten bei Ihnen bezahlen? ich hab nur zurzeit 3000 € +++ Diese Anfrage erfolgte über Homepage. +++</message></potentialBuyer><source>HOMEPAGE</source></lead>
Sollten Sie Fragen haben kontaktieren Sie uns bitte einfach unter
xmlsupport@eautoseller.de
Abruf von Preisänderungen, Klickmerkmalen zur automatischen Weiterverarbeitung und Direktlink aus ext. Software.
Wir können Ihrer IT bzw. Ihrem bestandführenden Systemanbieter auf Wunsch Ihre Preisänderungen und die Ausstattung als XML-API zur Echtzeitabfrage zur Verfügung stellen. Hierzu erzeugen wir einen AuthCode und Source mit dem sich das andere System die Daten automatisiert abholen kann. Diese API ist nach entsprechender Absprache aufrufbar.
Bitte beachten Sie zur Datenintegrität und Wartbarkeit: ab 15.02.2023 werden Aufrufe nur noch von api.ebewerter.de und mit Angabe Source und AuthCode akzeptiert.
Eine optimierte API nur für Preise und Ausstattung (Wording analog mobile.de URL_Parameter) können Sie nach Freischaltung unter
https://api.ebewerter.de/inc/vklservice.asp aufrufen.
Der Aufbau der Parameter ist:
https://api.ebewerter.de/inc/vklservice.asp?authcode=[individuellerAuthCode]&type=[prices/equip/label/sold/tempprices/vehicle/reserv/videourl/getloc/chgloc/demand/demandcount/lead]&date=[yyyy-mm-dd]&page=[n]&vin=[Fahrgestellnr]&showadddocs=[0/1]&useremail=[Email des Users]&intnr=[InterneNummer]&setsold=[0/1]&resstatus=[0/1]&reservdate=[yyyy-mm-dd]&source=[Ihre Kennung]&pricesell=[verkaufspreis [integer] brutto in EUR]&leadcount=[Anzahl offener Leads [integer]]&leadlastdate=[aktuellstes Leadeingangsdatum yyyy-mm-dd hh:mm:ss]&chgkm=[Integer-Wert mit neuem KM-Stand]&videourl=[youtube-link inkl. https]&chgtofilid=[Integer-ID]&moclick=[Gesamtanzahl Aufrufe mobile.de [integer]]&mopark=[Gesamtanzahl Parkungen mobile.de [integer]]&asclick=[Gesamtanzahl Aufrufe Autoscout [integer]]&hpqr=[Gesamtanzahl QR-Aufrufe Homepage [integer]]&hpclick=[Gesamtanzahl Aufrufe Homepage [integer]]&hppark=[Gesamtanzahl Parkungen Homepage [integer]]&clickdate=[Aktualität der übermittelten Nachfragewerte]
Anzeigen pro Seite (page)&qualityprog=[1=Eigenzertifikat/10=JS/52=JST/54=Ford A1 Premium]&customertyp=[1=gewerblich/2=privat/3=KFZ-Händler]&paymenttyp=[1=bar/2=Finanzierung/3=Leasing]
= 50 (Beim Erreichen des Datenendes erhalten Sie ein EOF)
Beispiel um Preisanpassungen seit 04.03.2020 abzuholen und mit Seite 1 beginnend:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=prices&date=2020-03-04&page=1
Beispiel um Preisanpassungen (temporär) seit 04.03.2020 abzuholen und mit Seite 1 beginnend:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=tempprices&date=2020-03-04&page=1
Beispiel um KFZ-Ausstattungen seit 04.03.2020 nach einer Prüfungsfreigabe und mit Seite 1 beginnend
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=equip&date=2020-03-04&page=1
Beispiel um Exposes inkl. Dokumente inkl. einem konkreten Ansprechpartner im Expose abzurufen (nur für Kunden welche dies vorher beauftragt haben):
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=label&page=1&date=2021-1-27&vin=WAUZZZGB3LR007238&showadddocs=1&useremail=jonas.hamael@autohaus-test.de
Beispiel um ein einzelnes KFZ mit VIN abzurufen:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=vehicle&date=2000-01-01&page=1&vin=WAUZZZGB3LR000000
Beispiel um den KM-Stand eines einzelnen KFZ auf 5.800 KM mit VIN anzupassen:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=vehicle&date=2000-01-01&page=1&vin=WAUZZZGB3LR000000&chgkm=5800
Beispiel um ein einzelnes KFZ mit VIN verkauft zu melden:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=sold&date=2020-03-04&page=1&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&setsold=1&pricesell=17250&useremail=jonas.hamael@autohaus-test.de&qualityprog=10&customertyp=1&paymenttyp=1
Beispiel um ein einzelnes verkauftes KFZ mit VIN als Kaufstorno zu melden:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=sold&date=2020-03-04&page=1&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&setsold=0&pricesell=&useremail=jonas.hamael@autohaus-test.de
Beispiel um ein einzelnes KFZ mit VIN bis 08.03.2020 reserviert zu melden:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=reserv&date=2020-03-04&reservdate=2020-03-08&page=1&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&resstatus=1&useremail=jonas.hamael@autohaus-test.de
Beispiel um ein einzelnes KFZ mit VIN Reservierung aufheben:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=reserv&date=2020-03-04&page=1&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&resstatus=0&useremail=jonas.hamael@autohaus-test.de
Beispiel um offene Leadanzahl mit Intnr zu melden:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=lead&page=1&date=2021-1-27&intnr=1029102&leadopen=4&leadlastdate=2020-07-14 16:19:10&source=leadcrm2000&useremail=jonas.hamael@autohaus-test.de
Beispiel um ein einzelnes KFZ mit einem Youtube-Videolink zu ergänzen:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=videourl&videourl=https://www.youtube.de/video1.html&date=2000-01-01&page=1&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&useremail=jonas.hamael@autohaus-test.de
Beispiel um ein einzelnes KFZ mit einem Youtube-Videolink zu entfernen:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=videourl&videourl=empty&date=2000-01-01&page=1&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&useremail=jonas.hamael@autohaus-test.de
Beispiel um die verfügbaren Standorte und Standort FilIDs abzurufen:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=getloc&date=2000-01-01&page=1
Beispiel um den Standort eines einzelnen KFZ auf Standort Filid 5 zu wechseln:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=chgloc&date=2000-01-01&page=1&chgtofilid=5&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&useremail=jonas.hamael@autohaus-test.de
Beispiel um die Aufrufe eines einzelnen KFZ zu aktualisieren:
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=demand&date=2000-01-01&page=1&moclick=192&mopark=5&asclick=128&hpqr=0&hpclick=0&hppark=0&clickdate=2021-09-19&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&useremail=jonas.hamael@autohaus-test.de
Beispiel um die Aufrufe eines einzelnen KFZ über vklservice-Counter hochzuzählen (nur 0 bzw. 1 erlaubt):
https://api.ebewerter.de/inc/vklservice.asp?authcode=12345678&type=demandcount&date=2000-01-01&page=1&hpqr=0&hpclick=1&hppark=0&clickdate=2021-09-19&vin=WAUZZZGB3LR000000&source=OnlineKauf2000&useremail=jonas.hamael@autohaus-test.de
Ein Beispiel könnten Sie unter
https://www.ebewerter.de/doku/vklservice_example.xht aufrufen.
Die optionale flashxml-API ist unter https://api.ebewerter.de/inc/flashxml.asp erreichbar. Eine Dokumentation können Sie unter https://www.eautoseller.de/hp/eaxml.html aufrufen.
Die Grundsyntax um aktuelle Preisänderungen abzurufen lautet:
https://api.ebewerter.de/inc/flashxml.asp?authcode=[individuellerAuthCode]&type=search&txtlastpchg=[Anzahl Tage z.b. 1]&paging=0&limit=100
Die Grundsyntax um aktuelle Klickmerkmale abzurufen lautet:
https://api.ebewerter.de/inc/flashxml.asp?authcode=[individuellerAuthCode]&type=search&txtlastequip=[Anzahl Tage z.b. 1]&paging=0&limit=100
Die Grundsyntax um einen mobile.de LiveAufruf mit den optimalen Filtern aufzurufen lautet:
https://api.ebewerter.de/login.asp?modul=vklqc&intnr=[Intnr]&ebwview=0&guid=[individueller GuidAufruf für StandardUser]
optional:
https://api.ebewerter.de/login.asp?modul=vklqc&intnr=[Intnr]&ebwview=0&kdnr=[KdNr]&user=[Individueller Username]&pass=[Individuelles Passwort]
Steigern Sie Ihre Margen
In mühevoller Handarbeit werden DAT- / Schwackebewertungen für die Fahrzeuge erstellt und mit den Märkten auf den verschiedenen Verkaufsplattformen verglichen um den aktuellen Marktpreis zu ermitteln.
Unter hohem Zeitaufwand muss jedes einzelne Kfz vom Verkaufsleiter / Pricingverantwortlichen wie von einem Endkunden unter Berücksichtigung der verschiedenen Filtereinstellungen gesucht und verglichen werden. Je grösser Ihr Fahrzeugbestand ist, ist dies nicht mehr oder in nicht ausreichender Qualität möglich.
Mögliche Probleme die mit dieser Arbeitsweise auftreten:
ITKrebs greift hier mit automatisierter Marktrecherche unter kundenspezifischen Vorgaben ein. Von passenden Suchmustern über Mitbewerberpreise im gleichen Markt, bis zur automatisierten Umsetzung der Pricingstrategie unter Einhaltung der Firmen-CI werden alle relevanten Daten aufgearbeitet. Durch die Automatisierung der vormals manuellen Arbeiten kann der Pricingverantwortliche in kürzester Zeit Preise ermitteln, kontrollieren und durch die Schnittstellen zu allen relevanten Systemen sofort umsetzen.
Vorteile durch die Nutzung unserer Systeme sind: