AS24 Data Interface
Werbung
AutoScout24 Datenschnittstelle XML Schema Technische Dokumentation AutoScout24 XML Inhalt Einleitung ................................................................................................. 5 Über dieses Dokument .............................................................................. 5 Über AutoScout24 XML ............................................................................. 5 Über STX3 ............................................................................................... 5 Schema .................................................................................................... 6 Überblick ................................................................................................. 6 XML Elemente ........................................................................................ 11 STX3.................................................................................................. 11 Vehicle Data ....................................................................................... 11 Vehicles ............................................................................................. 12 Vehicle ............................................................................................... 12 Fuel Types .......................................................................................... 18 Consumption....................................................................................... 19 Liquid................................................................................................. 19 Gas.................................................................................................... 21 Electric ............................................................................................... 21 Emission............................................................................................. 22 Service ............................................................................................... 23 Prices ................................................................................................. 23 Price .................................................................................................. 24 Seite 2 von 52 AutoScout24 XML Financing ............................................................................................ 25 Initial Payment .................................................................................... 26 Rate .................................................................................................. 26 Ending Rate ........................................................................................ 28 Gross Credit Amount ............................................................................ 28 Service Fee ......................................................................................... 29 Rate Insurance .................................................................................... 29 Net Credit Amount ............................................................................... 30 Delivery ............................................................................................. 30 Equipments ........................................................................................ 31 Equipment .......................................................................................... 32 Seals ................................................................................................. 33 Seal ................................................................................................... 33 Media ................................................................................................. 34 Images .............................................................................................. 35 Image ................................................................................................ 35 Videos ................................................................................................ 36 Video ................................................................................................. 36 Product Bookings ................................................................................. 37 Product, ............................................................................................. 37 Previous Owner ................................................................................... 38 Notes ................................................................................................. 38 Seite 3 von 52 AutoScout24 XML Sealtabelle ............................................................................................ 41 XSD ...................................................................................................... 43 XML Beispiel .......................................................................................... 43 Historie .................................................................................................. 49 Kontakt .................................................................................................. 52 Seite 4 von 52 AutoScout24 XML Einleitung Über dieses Dokument Die AutoScout24 – Datenschnittstelle Fahrzeugdaten schnell, unkompliziert AutoScout24 zu veröffentlichen. bietet Ihnen die Möglichkeit, Ihre und ohne Qualitätseinbußen bei Damit Sie das Potenzial der AutoScout24 Datenschnittstelle optimal ausschöpfen können, liefern wir Ihnen mit dieser Beschreibung detaillierte Informationen über Aufbau, Einrichtung und Betrieb der Schnittstelle zu AutoScout24. Unsere Schnittstelle bietet Ihnen umfangreiche und vielfältige Möglichkeiten, um Ihre Fahrzeuge den Interessenten in bester Qualität zu präsentieren. Neben einer geringen Anzahl von Pflichtfeldern, bleibt es Ihnen überlassen, welche Fahrzeuginformationen Sie übermitteln wollen. Je mehr Fahrzeuginformationen Sie angeben, desto schneller und öfter werden Ihre Angebote von potentiellen Käufern gefunden. Um Ihre Nachfrage zusätzlich zu steigern, können Sie Ihre Anzeigen mit bis zu 15 Bildern hervorheben. Über AutoScout24 XML Das AutoScout24 XML Schema wird verwendet um Fahrzeugdaten und –bilder an AutoScout24 zu übermitteln. In diesem Dokument werden die Definition des AutoScout24 XML Schema’s und einzelne Funktionalitäten ergänzend zur “autoscout24_xml.xsd” Datei beschrieben. Das AutoScout24 XML Schema ist ein echtes Subset des STX3 Schema‘s, so dass AutoScout24 XML Dateien gegen die STX3 XML Schema Definition validiert werden können. Über STX3 STX3 ist ein eingetragener Verein, dessen Mitglieder Automobil-Portale, Datendienstleister und andere Industrie-Organisationen im Automobil-Umfeld sind. Das primäre Ziel von STX3 ist die Schnittstellen-Standardisierung im Automobil-Vertrieb. Der Verein stellt die STX3-Schnittstelle kostenfrei für alle IT Systeme im Automobil-Umfeld zur Verfügung. Seite 5 von 52 AutoScout24 XML Schema Überblick Dieser Abschnitt ermöglicht einen schnellen Überblick über die Eltern-Knoten (grau) und ihre Kind-Elemente (weiß). Weitere Informationen können dem Kapitel “XML Elemente” entnommen werden. stx3 (NODE) vehicle_data (NODE) vehicles (NODE) vehicle (NODE) dealer_id ownersvehicle_id status visibility vin country_version type category body brand model version title body_color body_colorgroup body_painting Seite 6 von 52 AutoScout24 XML interior_color covering doors gear_type gears fuel_type fuel_types (NODE) primary_fuel_type fuel_type transmission capacity kilowatt cylinder consumption (NODE) liquid (NODE) urban extra_urban combined gas (NODE) urban extra_urban combined electric (NODE) combined emission (NODE) class sticker Seite 7 von 52 AutoScout24 XML co2_liquid co2_gas co2_electric efficiency_class mileage service (NODE) last_technical_service last_change_cam_belt hsn tsn schwacke_code initial_registration general_inspection licence_number1 notes prices (NODE) price (NODE) type vat_type currency negotiable value financing (NODE) initial_payment (NODE) value rate 1 Nur Niederlande Seite 8 von 52 AutoScout24 XML (NODE) value duration eff_rate_of_interest ending_rate (NODE) value bank_name gross_credit_amount (NODE) value service_fee (NODE) value rate_insurance (NODE) value debit_interest_rate debit_interest_type net_credit_amount (NODE) value warranty_duration delivery (NODE) delivery_time delivery_date equipments (NODE) equipment (NODE) text seals (NODE) seal (NODE) name status Seite 9 von 52 AutoScout24 XML media (NODE) images (NODE) image (NODE) local or uri videos (NODE) video (NODE) uri product_bookings (NODE) product (NODE) name status previous_owner (NODE) count accident_free kerb_weight alloy_wheels_size seats Seite 10 von 52 AutoScout24 XML XML Elemente STX3 Der “stx3” Knoten ist der Wurzelknoten aller anderen Elemente und öffnet und schließt AutoScout24 XML Dateien. Element Name Vorkommen Typ / Werte Pflichtfeld <stx3> 1 Root Node ja <vehicle_data> 1 Node ja XPath: stx3 Vehicle Data Der “vehicle_data” Knoten enthält den “vehicles” Knoten. Element Name Vorkommen Typ / Werte Pflichtfeld <vehicle_data> 1 Node ja <vehicles> 1 Node ja XPath: stx3/vehicle_data/ Seite 11 von 52 AutoScout24 XML Vehicles Der “vehicles” Knoten enthält alle “vehicle” Knoten. Element Name Vorkommen Typ / Werte Pflichtfeld <vehicles> 1 Node ja <vehicle> 1-n Node ja XPath: stx3/vehicle_data/vehicles Vehicle Der “vehicle” Knoten enthält alle Daten Elemente eines Fahrzeugs. Element Name Vorkommen Typ / Werte Pflichtfeld <vehicle> 1-n Node ja <dealer_id> 1 Int ja <ownersvehicle_id> 0-1 String nein <status> 0-1 String nein [active;inactive] <visibility> 0-1 String nein [public;dealer] <vin> 0-1 String nein Seite 12 von 52 AutoScout24 XML Element Name Vor- Typ / Werte Pflichtfeld kommen <country_version> 0-1 String nein <type> 1 String ja [bike;car] <category> 1 String ja [classic;demonstration; employee;new; pre_registered;used] <body> 1 String ja [cars: bus_van;compact; convertible; coupe;off_road; other_car;sedan station_wagon; transporter; bikes: chopper_cruiser; enduro;sidecar; kids_motorcycle; tourer;moped; motocross; naked_bike; other_bike; quad_atv;rally; travel_enduro racing; scooter; street_figher; super_moto; supersport; sporttourer; trial; trike] <brand> 1 String ja <model> 1 String ja Seite 13 von 52 AutoScout24 XML Element Name Vorkommen Typ / Werte Pflichtfeld <version> 0-1 String nein <title> 0-1 String nein <body_color> 0-1 String nein <body_colorgroup> 1 String ja [beige;black;blue; bronze; brown;green;grey; orange; red;silver; violet;white;yellow] <body_painting> 0-1 String nein [metallic;uni] <interior_color> 0-1 String nein [beige;black;brown; grey;other] <covering> 0-1 String nein [alcantara; cloth;full_leather; part_leather;velour; other] <doors> 0-1 <gear_type> 0-1 Int nein String nein [automatic;semiautomatic; manual] Seite 14 von 52 AutoScout24 XML Element Name Vorkommen Typ / Werte Pflichtfeld <gears> 0-1 Int nein <fuel_type> 1 String [diesel; 2T gasoline; gasoline; electric_gasoline; electric_diesel; electric; ethanol; hydrogen; lpg; cng; other] ja <fuel_types> 0-1 Node nein <transmission> 0-1 String nein [front;rear;4wd] <capacity> 0-1 Int nein <kilowatt> 0-1 Int nein <cylinder> 0-1 Int nein <consumption> 0-1 Node nein <emission> 0-1 Node nein <mileage> 0-1 Int ja <service> 0-1 Node nein <hsn> 0-1 Int nein <tsn> 0-1 String nein Seite 15 von 52 AutoScout24 XML Element Name Vor- Typ / Werte Pflichtfeld kommen <schwacke_code> 0-1 Int nein <initial_registration> 0-1 Date nein [YYYY-MM-DD] <general_inspection> 0-1 Date nein [YYYY-MM-DD] <licence_number>1 0-1 String nein <notes> 0-1 String nein <prices> 1-2 Node ja <financing> 0-1 Node nein <warranty_duration> 0-1 Int nein <delivery> 0-1 Node nein <equipments> 0-1 Node nein <seals> 0-1 Node nein <media> 0-1 Node nein <product_bookings> 0-1 Node nein 1 Nur Niederlande Seite 16 von 52 AutoScout24 XML Element Name Vor- Typ / Werte Pflichtfeld kommen <previous_owner> 0-1 Node nein <accident_free> 0-1 Boolean [true;false] nein <kerb_weight> 0-1 Int nein <alloy_wheels_size> 0-1 Int nein [10;11;12;13;14;15;16;17; 18;19;20;21;22;23;24;25;26] <seats> 0-1 Int nein XPath: stx3/vehicle_data/vehicles/vehicle Seite 17 von 52 AutoScout24 XML Fuel Types Der “fuel_types” Knoten enthält die Elemente “primary_fuel_type“ (Energieträger/Kraftstoff nach EnVkV) und “fuel_type“ (alle unterstützten Kraftstoffe gemäß Energiekennzeichnungsverordnung (PKW-EnVKV)). Element Name Vorkommen Typ / Werte Pflichtfeld <fuel_types> 0-1 Node nein <primary_fuel_type> 0-1 String nein [biodiesel; biogas; diesel; domestic gas H; domestic gas L; electricity; ethanol; hydrogen; liquid petroleum gas (LPG); regular/benzine 91; regular/benzine E10 91; super 95; super E10 95; super plus 98; super plus E10 98; vegetable oil] <fuel_type> 0-1 String nein [biodiesel; biogas; diesel; domestic gas H; domestic gas L; electricity; ethanol; hydrogen; liquid petroleum gas (LPG); regular/benzine 91; regular/benzine E10 91; super 95; super E10 95; super plus 98; super plus E10 98; vegetable oil] XPath: stx3/vehicle_data/vehicles/vehicle/fuel_types Seite 18 von 52 AutoScout24 XML Consumption Der “consumption” Knoten enthält die Knoten “liquid“, “gas“ und “electric“. Element Name Vorkommen Typ / Werte Pflichtfeld <consumption> 0-1 Node nein <liquid> 0-1 Node nein <gas> 0-1 Node nein <electric> 0-1 Node nein XPath: stx3/vehicle_data/vehicles/vehicle/consumption Liquid Der “liquid” Knoten enthält die Kraftstoffverbrauchs-Elemente für den ebenfalls als Element aufgeführten Flüssigkraftstoff. Element Name Vorkommen Typ / Werte <liquid> 0-1 Node <fuel_type> 0-1 String Pflichtfeld nein nein [biodiesel; diesel; ethanol; hydrogen; regular/benzine 91; regular/benzine E10 91; super 95; super E10 95; super plus 98; super plus E10 98; vegetable oil] <urban> 0-1 Decimal nein Seite 19 von 52 AutoScout24 XML <extra_urban> 0-1 Decimal nein <combined> 0-1 Decimal nein XPath: stx3/vehicle_data/vehicles/vehicle/consumption/liquid/ Seite 20 von 52 AutoScout24 XML Gas Der “gas” Knoten enthält die Kraftstoffverbrauchs-Elemente für Gaskraftstoffe. Element Name Vorkommen Typ / Werte <gas> 0-1 Node <fuel_type> 0-1 String Pflichtfeld nein nein [biogas; domestic gas H; domestic gas L; liquid petroleum gas (LPG)] <urban> 0-1 Decimal nein <extra_urban> 0-1 Decimal nein <combined> 0-1 Decimal nein XPath: stx3/vehicle_data/vehicles/vehicle/consumption/gas/ Electric Der “electric” Knoten enthält die Kraftstoffverbrauchs-Elemente für Strom. Element Name Vorkommen Typ / Werte Pflichtfeld <electric> 0-1 Node nein <fuel_type> 0-1 String nein [electricity] <combined> 0-1 Decimal nein Seite 21 von 52 AutoScout24 XML XPath: stx3/vehicle_data/vehicles/vehicle/consumption/electric/ Emission Der “emission” Knoten enthält alle Abgas-Emissions-Elemente. Element Name Vorkommen Typ/ Werte Pflichtfeld <emission> 0-1 Node nein <class> 0-1 String nein [euro1;euro2;euro3; euro4;euro5;euro6] <sticker> 0-1 String nein [green;yellow;red;none] <co2_liquid> 0-1 Decimal nein <co2_gas> 0-1 Decimal nein <co2_electric> 0-1 Decimal nein <efficiency_class> 0-1 String nein [a+;a;b;c;d;e;f;g] XPath: stx3/vehicle_data/vehicles/vehicle/emission Seite 22 von 52 AutoScout24 XML Service Der “service” Knoten enthält Information über die zuletzt an den Fahrzeugen durchgeführten Services. Element Name Vorkommen Typ / Werte Pflichtfeld <service> 0-1 Node ja <last_technical_service> 0-1 Date nein [YYYY-MM-DD] <last_change_cam_belt> 0-1 Date nein [YYYY-MM-DD] XPath: stx3/vehicle_data/vehicles/vehicle/service Prices Der “prices” Knoten enthält den “price“ Knoten. Element Name Vorkommen Typ / Werte Pflichtfeld <prices> 1 Node ja <price> 1-2 Node ja XPath: stx3/vehicle_data/vehicles/vehicle/prices Seite 23 von 52 AutoScout24 XML Price Der “price” Knoten enthält alle Preis Informationen. Element Name Vorkommen Typ / Werte Pflichtfeld <price> 1-2 Node ja <type> 1 String ja [public;dealer;export] <vat_type> 0-1 String nein [reclaimable; non_reclaimable] <currency> 1 String [eur] ja <negotiable> 0-1 Boolean [true;false] nein <value> 1 Int ja XPath: stx3/vehicle_data/vehicles/vehicle/prices/price Seite 24 von 52 AutoScout24 XML Financing Der “financing” Knoten enthält die Daten des Finanzierungsangebots eines Fahrzeugs. Wird “financing” aktiviert, müssen die Felder <initial_payment>, <rate>, <duration>, <bankname>, <gross_credit_amount>, <service_fee>, <debit_interest_type>, <debit_interest_rate> gefüllt sein. Element Name Vorkommen Typ / Werte Pflichtfeld <financing> 0-1 Node nein <initial_payment> 0-1 Node nein1 <rate> 0-1 Decimal nein1 <duration> 0-1 Int nein1 <eff_rate_of_interest> 0-1 Decimal nein <ending_rate> 0-1 Decimal nein <bankname> 0-1 String nein1 <gross_credit_amount> 0-1 Node nein1 <service_fee> 0-1 Decimal nein1 <rate_insurance> 0-1 Decimal nein <debit_interest_rate> 0-1 Decimal nein1 1 Pflichtfeld, wenn <financing> gesetzt ist Seite 25 von 52 AutoScout24 XML Element Name Vorkommen Typ / Werte Pflichtfeld <debit_interest_type> 0-1 String nein1 [combined;changeable; fixed] <net_credit_amount> 0-1 Node nein XPath: stx3/vehicle_data/vehicles/vehicle/financing Initial Payment Der “initial_payment” Knoten enthält das Element “value”. Element Name Vorkommen Typ / Werte Pflichtfeld <initial_payment> 0-1 Node nein <value> 0-1 Decimal nein XPath: stx3/vehicle_data/vehicles/vehicle/financing/initial_payment Rate Der “rate” Knoten enthält das Element “value”. 1 Element Name Vorkommen Typ / Werte Pflichtfeld <rate> 0-1 Node nein Pflichtfeld, wenn <financing> gesetzt ist Seite 26 von 52 AutoScout24 XML <value> 0-1 Decimal nein XPath: stx3/vehicle_data/vehicles/vehicle/financing/rate Seite 27 von 52 AutoScout24 XML Ending Rate Der “ending_rate” Knoten enthält das Element “value”. Element Name Vorkommen Typ / Werte Pflichtfeld <ending_rate> 0-1 Node nein <value> 0-1 Decimal nein XPath: stx3/vehicle_data/vehicles/vehicle/financing/ending_rate Gross Credit Amount Der “gross_credit_amount” Knoten enthält das Element “value”. Element Name Vorkommen Typ/ Werte Pflichtfeld <gross_credit_amount> 0-1 Node nein <value> 0-1 Int nein XPath: stx3/vehicle_data/vehicles/vehicle/financing/gross_credit_amount Seite 28 von 52 AutoScout24 XML Service Fee Der “service_fee” Knoten enthält das Element “value”. Element Name Vorkommen Typ/ Werte Pflichtfeld <service_fee> 0-1 Node nein <value> 0-1 Decimal nein XPath: stx3/vehicle_data/vehicles/vehicle/financing/service_fee Rate Insurance Der “rate_insurance” Knoten enthält das Element “value”. Element Name Vorkommen Typ/ Werte Pflichtfeld <rate_insurance> 0-1 Node nein <value> 0-1 Decimal nein XPath: stx3/vehicle_data/vehicles/vehicle/financing/rate_insurance Seite 29 von 52 AutoScout24 XML Net Credit Amount Der “net_credit_amount” Knoten enthält das Element “value”. Element Name Vorkommen Typ/ Werte Pflichtfeld <net_credit_amount> 0-1 Node nein <value> 0-1 Int nein XPath: stx3/vehicle_data/vehicles/vehicle/financing/net_credit_amount Delivery Der “delivery” Knoten enthält Daten über die Verfügbarkeit eines Fahrzeugs. Element Name Vorkommen Typ / Werte Pflichtfeld <delivery> 0-1 Node nein <delivery_time> 0-1 Int nein <delivery_date> 0-1 Date nein [YYYY-MM-DD] XPath: stx3/vehicle_data/vehicles/vehicle/delivery Seite 30 von 52 AutoScout24 XML Equipments Der “equipments” Knoten enthält alle “equipment” Knoten eines Fahrzeugs. Element Name Vorkommen Typ/ Werte Pflichtfeld <equipments> 0-1 Node nein <equipment> 0-n Node nein XPath: stx3/vehicle_data/vehicles/vehicle/equipments Seite 31 von 52 AutoScout24 XML Equipment Der “equipment” Knoten enthält die Ausstattungsbezeichnungen. Element Name Vorkommen Typ / Werte Pflichtfeld <equipment> 0-n Node nein <text> 0-1 String nein [abs;air_conditioning;airbag;alarm;alloy_wheels;auxilia ry_heating;bending_light;cab_or_rented_car;central_do or_lock;climate_control; electrical rear-view mirrors; passenger_airbag;cruise_control; daytime_running_light; electrical_adjustable_seats;esp; sunroof; fog_lights;full_service_history; handicapped_enabled;heated_seats; immobilizer;hands-free equipment; multifunctional_wheel;radio;mp3;cd; rain sensor;bluetooth;head-up display; inspections_new;isofix; parking assistance system sensors front; parking assistance system sensors rear; parking assistance system camera; parking assistance system self-steering; light sensor; navigation_system; roof_rack; nonsmoking_vehicle;ski_bag; side_airbags;particulate_filter; onboard_computer;park_distance_control;panoramic_ro of; power_steering;power_windows; sport_seats;sport_suspension; sport_package;start_stop_automatic; towing_hook;xenon_lights; traction_control;used_car_warranty; bikes (excl.): heated_bar;topcase; wind_shield;roll_bar;fairing; electric_starter;kick_starter;catalyzer] XPath: stx3/vehicle_data/vehicles/vehicle/equipments/equipment Seite 32 von 52 AutoScout24 XML Seals Der “seals” Knoten enthält alle Hersteller-, Garantie- und Qualitäts-Siegel eines Fahrzeugs. Element Name Vorkommen Typ/ Werte Pflichtfeld <seals> 0-1 Node nein <seal> 0-n Node nein XPath: stx3/vehicle_data/vehicles/vehicle/seals Seal Der “seal” Knoten enthält Siegel-Bezeichnung und -Status. Element Name Vorkommen Typ/ Werte Pflichtfeld <seal> 0-n Node nein <name> 0-1 String nein [Audi GW Plus; Bmw Premium Selection; Citroen Select; Dekra Siegel; Ford A1; Hyundai i-Best; Lexus Select; Mercedes-Benz Junge Sterne; Mini Next; Mitsubishi Diamant; Opel; Peugeot; Porsche; Renault 7 Sterne; Seat Selection; Smart; Volvo Selekt; VW TradePort; Welt Auto] Seite 33 von 52 AutoScout24 XML Element Name Vorkommen <status> 0-1 Typ/ Werte Pflichtfeld String nein [active;inactive] XPath: stx3/vehicle_data/vehicles/vehicle/seals/seal Media Der“media” Knoten enthält den “images” und den „videos“ Knoten. Element Name Vorkommen Typ/ Werte Pflichtfeld <media> 0-n Node nein <images> 0-1 Node nein <videos> 0-1 Node nein XPath: stx3/vehicle_data/vehicles/vehicle/media Seite 34 von 52 AutoScout24 XML Images Der “images” Knoten enthält alle Bilder eines Fahrzeugs. Element Name Vorkommen Typ/ Werte Pflichtfeld <images> 0-1 Node nein <image> 0-15 Node nein XPath: stx3/vehicle_data/vehicles/vehicle/media/images Image Der “image” Knoten enthält den Bildnamen des mitgelieferten Bildes. Element Name Vorkommen Typ/ Werte Pflichtfeld <image> 0-15 Node nein <local> oder <uri> 0-1 String nein [AB001CD_01.jpg oder http://test.com/testimages/Bild_01.jpg] XPath: stx3/vehicle_data/vehicles/vehicle/media/images/image Seite 35 von 52 AutoScout24 XML Videos Der “videos” Knoten enthält alle Videos eines Fahrzeugs. Element Name Vorkommen Typ/ Werte Pflichtfeld <videos> 0-1 Node nein <video> 0-1 Node nein XPath: stx3/vehicle_data/vehicles/vehicle/media/videos Video Der “video” Knoten enthält den Link auf das Video des Fahrzeugs bei Youtube. Element Name Vorkommen Typ/ Werte Pflichtfeld <video> 0-1 Node nein <uri> 0-1 String nein XPath: stx3/vehicle_data/vehicles/vehicle/media/videos/video Seite 36 von 52 AutoScout24 XML Product Bookings Der “product_bookings” Knoten enthält alle Händlerwerbeprodukte eines Fahrzeugs. Element Name Vorkommen Typ/ Werte Pflichtfeld <product_bookings> 0-1 Node nein <product> 0-n String nein XPath: stx3/vehicle_data/vehicles/vehicle/product_bookings Product 1, 2 Der “product” Knoten enthält Produkt-Bezeichnung und Status. Element Name Vorkommen Typ / Werte Pflichtfeld <product> 0-n Node nein <name> 0-1 String nein [top_insertion; featured_ad; homepage_ad] <status> 0-1 String nein [active;inactive] 1 Die Buchung dieses Produkts ist kostenpflichtig. Weitere Informationen entnehmen Sie bitte den Produktinformationen hier: http://ww2.autoscout24.de/as24-b2b-products-online-activation.aspx („top_insertion“ = AS24 Top-Inserat, „featured_ad“ = AS24 Inserats-Gestaltung) 2 Wird die <visibility> als ‘dealer’ aktiviert, so werden die Produkte ignoriert Seite 37 von 52 AutoScout24 XML XPath: stx3/vehicle_data/vehicles/vehicle/product_bookings/product Previous Owner Der “previous_owner” Knoten enthält die Anzahl der Vorbesitzer. Element Name Vorkommen Typ/Werte Pflichtfeld <previous_owner> 0-1 Node nein <count> 0-1 Int nein XPath: stx3/vehicle_data/vehicles/vehicle/previous_owner Notes Für die „Notes“ kann eine Formatierung vorgenommen werden. Element Name Vorkommen Typ/Werte Pflichtfeld <Notes> 0-1 String [max. nein 4000 Charakters] Aus der folgenden Tabelle geht hervor, wie die von AutoScout24 unterstützten Formatierungen übermittelt werden können. Für jedes der vier FormatierungsElemente (Spalte 1) gibt es eine Formatierungs-Syntax (Spalte 2) analog der bewährten Formatierungsvorschriften von wikicreole.org (http://www.wikicreole.org/wiki/Elements). Neben dem Ergebnis (Spalte 3) der jeweiligen Formatierung ist die äquivalente HTML Syntax dargestellt (Spalte 4), sowie einige Erläuterungen (Spalte 5). Seite 38 von 52 AutoScout24 XML FormatierungsElement Formatierungs-Syntax Zeilenumbruch \\ Horizontale Linie ---- Fettschrift Aufzählung Ergebnis Äquivalente HTML Syn- Erläuterung tax <br> Zeilenumbrüche werden nur mittels dieser FormatierungsSyntax unterstützt und dürfen nicht ohne diese FormatierungsSyntax in das Bemerkungsfeld eingefügt werden. _________________ <hr> Nach der horizontalen Linie wird automatisch ein Zeilenumbruch eingefügt. **lorem ipsum** lorem ipsum <b>lorem ipsum</b> Vor und nach dem fett zu druckenden Text müssen als Formatierungbefehl je 2 Asterisk Symbole (Sternchen) eingefügt werden. * Punkt Eins\\ * Punkt Zwei\\ Punkt Eins Punkt Zwei <ul> <li> Punkt Eins</li> <li> Punkt Zwei</li> </ul> Das Einfügen eines Asterisk Symbols resultiert in einem Aufzählungspunkt. Nach jedem Aufzählungseintrag muss ein Zeilenumbruch eingefügt werden. Anhand dieses Beispiels wird verdeutlicht wie das Resultat bei Verwendung der Formatierungsbefehle dargestellt wird. Fahrzeugbeschreibung „Lorem ipsum dolor sit amet, consectetur adipisici elit, sed eiusmod tempor incidunt ut labore et dolore magna aliqua.\\----*lorem\\*ipsum\\*dolor\\\\Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquid ex ea commodi consequat.“ Seite 39 von 52 AutoScout24 XML Ergebnis Seite 40 von 52 AutoScout24 XML Sealtabelle In der folgenden Tabelle werden alle Siegel genannt, die in Deutschland über die Schnittstelle übertragen werden können. Es können lediglich die vorgegebenen Werte gemäß der Auswahlliste eingelesen und verarbeitet werden. Erwarteter Wert via Schnittstelle Siegel Name Audi GW Plus Audi Gebrauchtwagen:plus Bentley pre owned Bentley PRE-OWNED Bmw Premium Selection BMW Premium Selection Citroen Select Citroen select Dekra Siegel Dekra Siegel Ford A1 Ford A1 Euro-Garantie Hyundai i-Best Hyundai i-Best Lexus Select Lexus Select Mercedes-Benz Junge Sterne Mercedes-Benz Junge Sterne Mini Next MINI NEXT Mitsubishi Diamant DIAMANT Gebrauchtwagen von Mitsubishi Opel Opel Zertifizierte Gebrauchtwagen Seite 41 von 52 AutoScout24 XML Peugeot PEUGEOT Qualitäts-Gebrauchtwagen Porsche Porsche Approved Renault 7 Sterne Renault 7 Sterne Seat Selection SEAT [SELECTION] Smart jung@smart Toyota Toyota Geprüfte Gebrauchtwagen Volvo Selekt VOLVO SELEKT VW TradePort VW TradePort Gütesiegel Welt Auto Volkswagen „Das WeltAuto“ Seite 42 von 52 AutoScout24 XML XSD Durch den Einsatz der “autoscout24_xml.xsd” Datei können XML-Dateien gegen die AutoScout24 XML Schema Definition validiert werden, um sicherzustellen, dass valide AutoScout24 XML Dateien generiert werden. XML Beispiel <?xml version="1.0" encoding="UTF-8"?> <stx3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <vehicle_data> <vehicles> <vehicle> <dealer_id>1234567890</dealer_id> <ownersvehicle_id>102030</ownersvehicle_id> <status>active</status> <visibility>dealer</visibility> <vin>12345678901234567</vin> <country_version>DE</country_version> <type>car</type> <category>used</category> <body>convertible</body> <brand>Mini</brand> <model>Cooper</model> <version>Cabrio</version> <title>top condition, garage car</title> <body_color>Pure Silver</body_color> <body_colorgroup>silver</body_colorgroup> <body_painting>metallic</body_painting> <interior_color>black</interior_color> <covering>full_leather</covering> <doors>2</doors> <gear_type>manual</gear_type> <gears>6</gears> <fuel_type>gasoline</fuel_type> Seite 43 von 52 AutoScout24 XML <fuel_types> <primary_fuel_type>super</primary_fuel_type> <fuel_type>super</fuel_type> <fuel_type>super e10</fuel_type> <transmission>front</transmission> <capacity>1598</capacity> <kilowatt>128</kilowatt> <cylinder>4</cylinder> <consumption> <liquid> <fuel_type>super</fuel_type> <urban>7.9</urban> <extra_urban>5.2</extra_urban> <combined>6.2</combined> </liquid> </consumption> <emission> <class>euro_5</class> <sticker>green</sticker> <co2_liquid>149</co2_liquid> <efficiency_class>b</efficiency_class> </emission> <mileage>100</mileage> <service> <last_technical_service>2011-07-01</last_technical_service> <last_change_cam_belt>2011-07-01</last_change_cam_belt> </service> <hsn>0005</hsn> <tsn>801</tsn> <schwacke_code>10630510</schwacke_code> <initial_registration>2008-01-31</initial_registration> <general_inspection>2011-07-01</general_inspection> <licence_number>SZGN95</licence_number> <notes>great car, please ask for more details</notes> Seite 44 von 52 AutoScout24 XML <prices> <price> <type>public</type> <vat_type>reclaimable</vat_type> <currency>eur</currency> <negotiable>true</negotiable> <value>3000</value> </price> <price> <type>dealer</type> <value>2900</value> </price> </prices> <financing> <initial_payment> <value>1000,99</value> </initial_payment> <rate> <value>100,99</value> </rate> <duration>36</duration> <eff_rate_of_interest>3.99</eff_rate_of_interest> <ending_rate> <value>50</value> </ending_rate> <bankname>Musterbank AG, Musterstr. 1, 12345 Musterstadt</bankname> <gross_credit_amount> <value>4000</value> </gross_credit_amount> <service_fee> <value>120</value> </service_fee> <rate_insurance> <value>80</value> Seite 45 von 52 AutoScout24 XML </rate_insurance> <debit_interest_rate>4.57</debit_interest_rate> <debit_interest_type>combined</debit_interest_type> <net_credit_amount> <value>3000</value> </net_credit_amount> </financing> <warranty_duration>12</warranty_duration> <equipments> <equipment> <text>abs</text> </equipment> <equipment> <text>alloy_wheels</text> </equipment> <equipment> <text>climate_control</text> </equipment> </equipments> <seals> <seal> <name>bmw_premium_selection</name> <status>active</status> </seal> <seal> <name>dekra</name> <status>active</status> </seal> </seals> <media> <images> <image> <local>60_1.jpg</local> </image> Seite 46 von 52 AutoScout24 XML <image> <local>60_2.jpg</local> </image> <image> <local>60_3.jpg</local> </image> <image> <local>60_4.jpg</local> </image> <image> <local>60_5.jpg</local> </image> </images> <videos> <video> <uri>www.youtube.com/watch?v=hR10_vBZtjM</uri> </video> </videos> </media> <product_bookings> <product> <name>top_insertion</name> <status>active</status> </product> <product> <name>featured_ad</name> <status>active</status> </product> </product_bookings> <previous_owner> <count>3</count> </previous_owner> <accident_free>true</accident_free> <kerb_weight>1500</kerb_weight> Seite 47 von 52 AutoScout24 XML <alloy_wheels_size>17</alloy_wheels_size> <seats>4</seats> </vehicle> </vehicles> </vehicle_data> </stx3> Seite 48 von 52 AutoScout24 XML Historie DATUM BESCHREIBUNG 03.02.2015 Fußnoten für „financing“ hinzugefügt 20.01.2015 Änderung der Formatierungsmöglichkeiten für Beschreibung Fußnoten für ‚Kennzeichen‘ 05.06.2014 Leasingelemente entfernt 21.05.2014 Siegelwerte aktualisiert Siegeltabelle hinzugefügt 30.04.2014 Layout Änderungen im gesamten Dokument 02.04.2014 Formatierungsmöglichkeiten für Beschreibung (Knoten „notes“) 10.02.2014 Neues Feld zur Übergabe von Finanzierungsdaten (Knoten „financing“): Nettodarlehensbetrag: (stx3/vehicle_data/vehicles/vehicle/financing/net_credit_amount) 05.09.2013 Änderung Wert Radio/CD in Radio (Knoten “equipment“). Neue Werte für die PKW-Ausstattung (Knoten “equipment“): „electrical rear-view mirrors”, “bluetooth”, “head-up display”, “hands-free equipment”, “mp3”; “isofix”, “light sensor”, “rain sensor”, “parking assistance system sensors front”, “parking assistance system sensors rear”, “parking assistance system camera”, “parking assistance system self-steering”, “cd” Neuer Wert zur Übergabe eines kostenpflichtigen Händler-Werbeproduktes (Knoten „product“): „homepage_ad“ 07.08.2013 Neuer Wert bei Element „type“ (Knoten „Price“): Export. Nur für Österreich. Seite 49 von 52 AutoScout24 XML 22.05.2013 Neuer Wert um das Herkunftsland des Fahrzeuges anzugeben (Knoten „vehicle“): country_version. Der Wert muss in ISO-3166-1 alpha-2 Format kodiert sein. Beispiel: DE 15.11.2012 Änderung bei einigen Elementen (Knoten „financing“ und „leasing“) auf Typ/Wert „decimal“ 10.08.2012 Neuer Wert für PKW-Ausstattung (Knoten “equipment“): panoramic_roof 10.04.2012 Neue Felder v.a. zur Übergabe von Ausstattungsdetails u. Service-Informationen: Letzer Kundendienst: stx3/vehicle_data/vehicles/vehicle/service/last_technical_service Letzter Zahnriemenwechsel: stx3/vehicle_data/vehicles/vehicle/service/last_change_cam_belt Innenausstattung: stx3/vehicle_data/vehicles/vehicle/covering Farbe der Innenausstattung: stx3/vehicle_data/vehicles/vehicle/interior_color Antriebsart: stx3/vehicle_data/vehicles/vehicle/transmission Alufelgengröße: stx3/vehicle_data/vehicles/vehicle/alloy_wheels_size Verhandlungspreis: stx3/vehicle_data/vehicles/vehicle/price/negotiable Video Link: stx3/vehicle_data/vehicles/vehicle/media/videos/video/uri - Gelöschte Werte der Ausstattungen für PKW (Knoten “equipment“): „4wd”, “leather_seats”, “radio”, “tuned_car” - Neue Werte der Ausstattungen für PKW (Knoten “equipment“): „nonsmoking_vehicle“, „cab_or_rented_car”, “sport_package”, “start_stop_automatic”, “multi_functional_wheel”, “daytime_running_light”, “sport_suspension”, “sport_seats”, “bending_light”, “ski_bag”, “inspections_new” Neuer Wert für die Getriebeart (Knoten „gear_type“): „semi-automatic“ 20.01.2012 Neue Elemente zur Übergabe der Verfügbarkeit von Fahrzeugen (Knoten “delivery“): Lieferbar ab (Lieferdatum): stx3/vehicle_data/vehicles/vehicle/delivery/delivery_date Verfügbar nach Bestellung in (Lieferfrist): Seite 50 von 52 AutoScout24 XML stx3/vehicle_data/vehicles/vehicle/delivery/delivery_time - Geänderte Werte der Karosserieformen für PKW (Knoten “body“): 26.10.2011 Alt Neu 2/3_doors compact 4/5_doors saloon station_wagon station_wagon off_road off_road convertible convertible coupe van bus coupe transporter transporter van_bus Neue Elemente zur Übergabe der Kraftstoffverbrauchsangaben gemäß der erweiterten Energieverbrauchskennzeichnungsverordnung (PKW-EnVKV): Energieträger/Kraftstoff nach EnVkV: stx3/vehicle_data/vehicles/vehicle/fuel_types/primary_fuel_type Unterstützte Kraftstoffe: stx3/vehicle_data/vehicles/vehicle/fuel_types/fuel_type Verbrauch Gas: stx3/vehicle_data/vehicles/vehicle/consumption/gas Verbrauch Strom: stx3/vehicle_data/vehicles/vehicle/consumption/electric CO² Emission Gas: stx3/vehicle_data/vehicles/vehicle/emission/co2_gas CO² Emission Strom: stx3/vehicle_data/vehicles/vehicle/emission/co2_electric CO² Effizienzklasse: stx3/vehicle_data/vehicles/vehicle/emission/efficiency_class 03.03.2011 Neue Elemente zur Übergabe kostenpflichtiger Händler-Werbeprodukte (Knoten ”product_bookings“ und “product“). 16.02.2011 Erste Version der AutoScout24 XML Schema Beschreibung. Seite 51 von 52 AutoScout24 XML Kontakt Haben Sie noch Fragen oder wünschen Sie noch weitere Informationen? Wir stehen Ihnen gerne zur Verfügung! AutoScout24 Kundenservice Schnittstellen Sie erreichen uns: Mo. bis Fr. 8.00 Uhr bis 18.00 Uhr Telefon: +49-(0)89 444 56-1000 E-Mail: [email protected] Seite 52 von 52
