Bitte beachten Sie, dass die SOAP-APIs nicht mehr aktiv weiterentwickelt werden. Neue Kunden sollten ausschließlich die RESTful API nutzen, bestehende Nutzer der SOAP-Schnittstellen sollten mittelfristig auf REST umstellen.
Dies ist eine alte Version der SOAP-API. Zur aktuellen Version 2.0
Eine allgemeine Beschreibung der SOAP-Schnittstelle finden Sie unter APIs.
http://www.autofokus24.de/SoapServer1.2.phpISO-8859-1autofokus24
Syntax: bool login ( string username, string password [ ,bool useSoapFaults = false] )
Mit dieser Funktion loggen Sie sich mit Ihrem Nutzernamen/Passwort im System ein. Der Login wird serverseitig in einer Session gehalten, dafür ist es aber notwendig, dass Sie clientseitig das Setzen von Cookies ermöglichen. Sollte dies nicht möglich sein, kann bei jedem anderen Funktionsaufruf der Nutzername und das Passwort als letzter optionaler Parameter übergeben werden.
Syntax: array calcCar(string hsn, string tsn, int year, int month, int miles [,string fuzzyText = "" [,string specialModel = "" [,string featureList = "" [,string color = "" [,int power = 0 [,int fuel = 0 [,int buildType = 0 [,int doorCount = 0 [,int dealerSize = 0 [,int priceClass = 0 [,int carVolume = 0 [,int garantieValue = 0 [,int monthWaitForSell = 0 [,string username = "" [,string password = "" ]]]]]]]]]]]]]]] )
Diese Funktion liefert Ihnen ein Array mit den Daten des erkannten Fahrzeuges, sowie den berechneten Verkaufspreis (price) und den Händlereinkaufspreis (priceEK). Wenn die übergebenen Parameter nicht eindeutig auf ein bestimmtes Fahrzeug verweisen (häufig der Fall bei fehlender Angabe des Sondermodells (specialModel) oder bei exotischen Fahrzeugen), wird eine Liste aus mehreren Arrays zurückgegeben. Für jedes Ergebnis werden dabei weiterhin die Preise berechnet. Sie können dann programmseitig filtern, oder die Parameter entsprechend einschränken. Seit Version 1.2 werden auch Standzeitinformationen (siehe Standzeiten) sowie Verkaufswahrscheinlichkeiten (siehe Verkaufswahrscheinlichkeit) zurückgegeben. Optional können auch weitere Parameter zur Händlergröße angegeben werden. Durch die Angaben der Händlerinformationen können realistischere Verkaufspreise ermittelt werden. Die Berechnung des Einkaufspreises bleibt davon unberührt. Zu den Händlerinformationen gehören die Parameter dealerSize, priceClass, carVolume sowie garantieValue. Weitere Informationen zur Händlergröße finden Sie unter Händlergrößen
Syntax: array getFeatureList ([username = "", password = ""])
Diese Funktion liefert Ihnen ein Array der möglichen Ausstattungen/Extras und dessen Kürzel/Shortcuts, welche bei der Funktion calcCar(…) explizit übergeben werden können.
Syntax: array getColors ([username = "", password = ""])
Diese Funktion liefert Ihnen ein Array der möglichen Farben und dessen Kürzel/Shortcuts, welche bei der Funktion calcCar(…) explizit übergeben werden können.
Syntax: array getLastError ()
Liefert den letzten aufgetretenen Fehler falls vorhanden.
Im folgenden Abschnitt werden einige einfache Beispiele zur Verwendung der SOAP-Schnittstelle von Autofokus24.de dargestellt.
Für die Verwendung in PHP benötigen Sie die PHP-SoapClient-Klasse.
Code:
<?php
try {
/* Initialisierung: WSDL-Datei angeben, Caching deaktivieren, Encoding festlegen*/
$client = new SOAPClient('http://www.autofokus24.de/SoapServer1.2.php?wsdl',
array('cache_wsdl' => WSDL_CACHE_BOTH,
'encoding'=>'ISO-8859-1')
);
/* Login: Mit eMail, Passwort. SoapFaults auf 1 setzen*/
$client->login("mymail@myhost.de","meinpasswort",1);
/* Fahrzeug ermitteln, Preis berechnen und Ergebnis formatiert ausgeben...*/
print_r($client->calcCar("0999", /* HSN */
"269", /* TSN */
2004, /* Jahr */
4, /* Monat */
123000, /* Laufleistung */
" /* Freitext (aus Inserat) */
C 220 T CDI Automatik DPF,Sportpaket.Modell 2005
Brillantsilber met.,Leder Twin schwarz, Sportpaket,
AHK abnehmbar, Regensensor, Scheibenwaschanlage
beheizt, Radio Audio 20 CD, Klimaautomatik,
Sitzheizung, Automatikgetriebe 5 Gang,
Dieselpartikelfilter, LM-Felgen 17 Zoll,
Eingabefehler u.Irrtümer behalten wir uns vor.
",
"Classic", /* Sondermodell */
"XEN,PDC", /* Explizite Ausstattungen */
"", /* Farbe, keine Angabe */
110, /* Motorleistung in Kilowatt */
2, /* Motorart = Diesel */
2, /* Aufbau = Kombi */
0, /* Türen = keine Angabe */
3, /* Unternehmensart = Freier Händler */
2, /* Preisklasse = 5.000 - 10.000 € */
4, /* Fahrzeugbestand = 20-50 */
2, /* Garantieleistungen = Verkäufe überwiegend mit Gewährleistung, ohne Garantie. */
2 /* Verkaufsperiode = 2 Monate */
));
}catch (SOAPFault $f)
{
print $f->faultstring;
}
?>
Ergibt folgende Ausgabe:
Array
(
[0] => Array
(
[make] => Mercedes-Benz
[model] => C-Klasse
[submodelName] => Modell ab 2004 (W203 Facelift)
[buildKind] => 2
[specialModel] => Classic
[power] => 110
[doorCount] => 5
[color] =>
[fuel] => 2
[packets] => Array
(
[0] => AMG/Sport Paket
)
[extras] => Array
(
[PAK3] => 1
[KLI] => 1
[KLIAU] => 1
[AIB] => 1
[BAB] => 1
[SAB] => 1
[WFS] => 1
[KAB] => 1
[FAB] => 1
[ABSS] => 1
[AFLS] => 1
[BC] => 1
[BRA] => 1
[REL] => 1
[ESPI] => 1
[FH] => 1
[ESI] => 1
[ESP] => 1
[ASR] => 1
[NSW] => 1
[SV] => 1
[TMP] => 1
[Z] => 1
[ZF] => 1
[SVT] => 1
[] => 1
[XEN] => 1
[PDC] => 1
[LED] => 1
[LLR] => 1
[AHK] => 1
[CD] => 1
[ALU] => 1
[MET] => 1
[PF] => 1
[REG] => 1
[SOUND] => 1
[SIH] => 1
[NO_OGEW] => 1
)
[extrasByDate] => Array
(
[KLI] => 1
[KLIAU] => 1
[AIB] => 1
[BAB] => 1
[SAB] => 1
[WFS] => 1
[KAB] => 1
[FAB] => 1
[ABSS] => 1
[AFLS] => 1
[BC] => 1
[BRA] => 1
[REL] => 1
[ESPI] => 1
[FH] => 1
[ESI] => 1
[ESP] => 1
[ASR] => 1
[NSW] => 1
[SV] => 1
[TMP] => 1
[Z] => 1
[ZF] => 1
[SVT] => 1
)
[significantExtras] => Array
(
[0] => OGEW
[1] => LED
[2] => ALL
[3] => GAS
[4] => SHZG
[5] => NAV
[6] => NAV
[7] => AUTOMATIK
[8] => PF
[9] => SD
[10] => ALU
[11] => XEN
[12] => AHK
[13] => PDC
[14] => SIH
[15] => REG
[16] => GAR
[17] => WR
[18] => TLED
[19] => IAA
[20] => BXEN
[21] => SPSI
[22] => SOUND
[23] => OTUEV
[24] => LLR
)
[price] => 9096
[priceEK] => 5967
[avgSellingTimeAtPrice] => 41
[avgSellingTimes] => Array
(
[0] => Array
(
[0] => 8600
[1] => 85
)
[1] => Array
(
[0] => 8700
[1] => 83
)
[2] => Array
(
[0] => 8800
[1] => 80
)
[3] => Array
(
[0] => 8900
[1] => 78
)
[4] => Array
(
[0] => 9000
[1] => 75
)
[5] => Array
(
[0] => 9100
[1] => 73
)
[6] => Array
(
[0] => 9200
[1] => 70
)
[7] => Array
(
[0] => 9300
[1] => 68
)
[8] => Array
(
[0] => 9400
[1] => 65
)
[9] => Array
(
[0] => 9500
[1] => 63
)
[10] => Array
(
[0] => 9600
[1] => 60
)
)
)
)
An der Ausgabe ist zu erkennen, dass zunächst Marke, Modell und Submodell anhang der HSN/TSN erkannt und zugeordnet wurden. Die Farbe wurde automatisch anhand des Freitextes erkannt. Das Paket "Sport" wurde auch am Freitext erkannt. Weiterhin wurden die serienmäßigen Extras sowie die am Freitext erkannten Extras zugeordnet. Im Funktionsaufruf wurde das Kürzel "XEN" und "PDC" übergeben, wodurch diese Extras explizit übergeben wurden. Die Extras LED, LLR, AHK, CD, ALU, MET, PF, REG, SOUND, SIH wurden ebenfalls anhand des Freitextes erkannt. Schließlich wird der Verkaufspreis (price) und Händlereinkaufspreis (priceEK) zurückgegeben.