Standard APIs

XML-Schnittstelle für eAutoseller

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.17

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 mit.

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 (Start bei 0) (nur kombinierbar mit txtLimit z.B. txtLimit=50&txtPaging=50 = 51-100)
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
txtlastchg=KFZ die ab diesem Zeitpunkt verändert wurden [yyyy-mm-dd hh:nn:ss]
txtlastpicchg=KFZ-Bilddaten, die seit dieser Anzahl Tage verändert wurden [in Tagen - 0=heute]
txtlastequip=KFZ die seit dieser Anzahl Tage bzgl. Datenqualität bestätigt wurden [in Tagen - 0=heute]
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)
showdesc=0/1 (1=liefert mehr Info in Details zur Ausstattung aus)
txtnoenvkv=0/1 (1=entfernt die Standard ENVKV-Filterung)
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