SZF: Ergänzungen in den Tabellen

Transkript

1 Änderungen der SilverDAT Schnittstelle: Ausgabe 2012_04_Ges042 SZF: Ergänzungen in den Tabellen SZF: Wiedergabe von CO2 Effizienzklassen SZF: Änderung der Werte für KAIS_RESERVE_2 SDII: identifyvehiclebyvin wird obsolet SDo: getapproximatevaluebykba ersetzt minimalevaluatebykba SD Online: Wegfall von leeren Elementen im Response Neue SilverDAT Produkte: erweiterte VIN-Abfrage für bislang gesperrte Hersteller DAT uropa-code Lieferung: Änderung in Schemata für Zusatzelement 5 SD Bankenlinie: Erweiterung für getvehicleevaluation und getvehicletargetdateevaluationhistory SD FI Online: Wiedergabe der Ölfüllstandsmengen VXS: neues Attribut in Dossiers für alle Glas-Anwendungen SZF: Ergänzungen in den Tabellen Ab 12/2012 wird die Tabelle DATRKAHA um weitere Adressdaten zum Fahrzeughalter, speziell zu den Eingabemöglichkeiten der Datenschutzerklärung, erweitert. Bitte entnehmen Sie die möglichen Werte der einzelnen Felder der aktuellen Ausgabe des Schnitstellenkompendiums > Datenaustauschformate > SZF-Referenzhandbuch > Tabellenbeschreibung > DATRKAHA. Weiterhin ab 12/2012 steht eine neue Tabelle DATRKFAD zur Verfügung. Sie enthält zentrale Adressdaten. Weitere Informationen zur Tabellenstruktur und möglichen Werten entnehmen Sie bitte dem Schnittstellenkompendium > SZF-Referenzhandbuch > Tabellenbeschreibung > DATRKFAD. SZF: Wiedergabe von CO2 Effizienzklassen Ab DVD 11/2012 werden die CO2 Effizienzklassen im SZF zurückgegeben. Sie befinden sich im Block DATRKABE. Die betreffenden KABE_LNR haben folgende Werte: KABE_LNR Wert 46 CO2-Effizienzklasse (ENVK) -- Define CO emissionsärmster Kraftstoff (ENVK) -- Define KST47 48 alternativer Kraftstoff (ENVK) -- Define AKS48 50 Verbrauch (ENVK) -- Define VBR50 51 Stromverbrauch (ENVK) -- Define SVB51 Die Werte sind nachzulesen im Kompendium > Datenaustauschformate > SZF-Referenzhandbuch > Domains > LFD_NR_BEMERKUNG_ART SZF: Änderung der Werte für KAIS_RESERVE_2 Die Byte-Belegung für das Feld KAIS_RESERVE_2 hat sich geändert. Folgende neue Belegung ergibt sich:

2 Byte Bedeutung Werte 1 einmalige Rüstzeit (J / N, bzw. 1-4 / N speziell in der Schweiz: 1 - normales Auto nur Dellen, 2 - normales Auto kombinierte Reparatur, 3 - grosses Auto nur Dellen, 4 - grosses Auto kombinierte Reparatur) 2 Kennzeichen, ob ein Gerüst bei J / N Karosseriearbeiten eingesetzt wird - speziell bei (Motor-)Caravans 3 Preis für alle Reifengrössen übernehmen J / N 4 Kunststoffteil eingebaut lackieren J / N 5 Phantomkalkulation J / N 6 Abtretungserklärung J / N 7 Fahrzeugauswahl mit 0 - nichts aktiv, 1 - VIN aktiv, 2 - KBA aktiv (D), 3 - Typenschein aktive (CH), 4 - amtl. Kennzeichen aktiv (CH), X - kein Wert gesetzt) 8 sämtliche Umfassttexte ausgeben J / N 9 Kooperationspartner ausgewählt (speziell in Griechenland) 10 alternativer ET-Preis (speziell in Rumänien) J (Preis aus Rumänien) / N (Preis aus Deutschland) J / N 11 klassifizierende AVs geändert J / N 12 Opel Zeitmaß in Stunden J / N Nachzulesen sind die Werte im Kompendium unter > Datenaustauschformate > SZF-Referenzhandbuch > Domains > KENNZEICHEN_VEKTOR_INTERNE_DATEN_FI SDII: identifyvehiclebyvin wird obsolet Ab sofort stellt die DAT die Schnittstellenfunktion identifyvehiclebyvinextended zur Verfügung, mit der auch die Fahrzeugdaten der folgenden Hersteller abgefragt werden können: Renault Dacia Mazda Fiat Die Funktion identifyvehiclebyvinextended arbeitet grundsätzlich konform zur bislang gültigen identifyvehiclebyvin; die Eingabeparameter werden allerdings um zwei weitere Pflichtparameter zur Identifizierung ergänzt: Parametername Datentyp Beschreibung interfacecustomer string Kundennummer interfacesignature string symmetrischer Passwortschlüssel (PGP + AES), muß über vertrieb@dat.de angefordert werden. Die Rückgabedaten entsprechen grundsätzlich der identifyvehiclebyvin; sie werden allerdings um zwei optionale Felder mit Bauzeitinformationen erweitert. Um die zusätzlichen Nutzungsinformationen zu klären und die erweiterte Schnittstellenfunktion nutzen zu können, nehmen Sie bitte Verbindung zum Vertrieb der DAT, vertrieb@dat.de, auf. Ausserdem erhalten Sie über diese Adresse auch den Passwortschlüssel, den Sie als zusätzlichen Parameter benötigen. Mit Einführung der identifyvehiclebyvinextended wird die bisher genutzte identifyvehiclebyvin obsolet. Für eine Übergangszeit bis Januar 2013 werden aber beide Funktionen parallel laufen.

3 Ab Anfang Februar 2013 wird die Schnittstellenfunktion identifyvehiclebyvin dann nicht mehr zur Verfügung stehen. Bitte berücksichtigen Sie dies bei Ihrer Planung. Die neue Funktion steht - wie gewohnt - in den Technologien COM (IDS.dll) und SOAP (SD2_Common.wsdl) zur Verfügung. Alle weiteren technischen Informationen entnehmen Sie bitte dem aktuellen Schnittstellenkompendium > SilverDAT Produkte > SDII > Allgemeine SDII-Funktionen > [Allgemeine COM-Funktionen/Allgemeine SOAP-Funktionen]. SDo: getapproximatevaluebykba ersetzt minimalevaluatebykba Ab 11/2012 wird eine neue Schnittstellenfunktion getapproximatevaluebykba in die SDo eingeführt. Zu finden ist die Funktion im Webservice SDOnlineService. Mit dieser Operation lassen sich Fahrzeuge anhand eines KBA-Schlüssels bewerten. Da der KBA-Schlüssel nicht eindeutig ist, kommen in der Regel mehrere Fahrzeuge für die Bewertung in Frage. Aus diesem Grund wird über den Parameter calcmode definiert, wie SilverDAT Online das zu bewertende Fahrzeug auswählt. calcmode orientiert sich immer am Bewertungspreis (Händler-EK), um das gewünschte Fahrzeug zu bestimmen. Die Funktion getapproximatevaluebykba erweitert die Funktionalität der bestehenden Funktion minimalevaluatebykba um den zusätzlichen Wert 3 für calcmode: Übergebener Wert Welches der möglichen Fahrzeuge wird berücksichtigt 0 kleinster Fahrzeugpreis 1 höchster Fahrzeugpreis 2 der am nächsten am Durchschnittswert befindliche Fahrzeugpreis 3 der am nächsten zum übergebenen Listenneupreis befindliche Fahrzeugpreis Gleichzeitig wird ein neuer Fehlercode (-87) eingeführt, der den möglichen Fehlerfall abfangen soll. Bitte lesen Sie alle technischen Informationen zu dieser neuen Schnittstellenfunktion im Kompendium unter > SilverDAT Produkte > SD Online > Bewertung > Minimalbewertung anhand KBA-Schüssel, erweitert. > SilverDAT Produkte > SD Online > Fehler- und Rückgabecodes Die Funktion getapproximatevaluebykba wird die ältere Funktion minimalevaluatebykba zukünftig ersetzen. Die Abschaltung der minimalevaluatebykba erfolgt zu 04/2013. Bitte berücksichtigen Sie dies in Ihrer eigenen Implementierung und nehmen die Umstellung frühzeitig vor. SD Online: Wegfall von leeren Elementen im Response Ab 03/2013 entfällt die Rückgabe von leeren Elementen, also Elementen, die keinen Wert zurückgeben, für folgende Schnittstellenfunktionen der SD Online: reevaluatebypid reevaluate reevaluatewithdatdefaultsbypid reevaluatewithdatdefaults getfilereference Ausserdem betrifft dies die folgenden Export-Funktionen, die über die SD Online Oberfläche durchgeführt werden können: Alle AZ zu SDo exportieren Markierte AZ zu SDo exportieren

4 Bitte berücksichtigen Sie dies in Ihrer eigenen Implementation. Neue SilverDAT Produkte: erweiterte VIN-Abfrage für bislang gesperrte Hersteller Ab sofort steht Ihnen der Webservice Authentication zur Verfügung, der die folgenden Funktionalitäten zur Verfügung stellt: 1. Erweiterung der bisherigen VIN-Abfrage, sodass auch die Fahrzeugdaten der folgenden Hersteller über VIN abgefragt werden können: Renault Dacia Mazda Fiat Durch die Nutzung des Webservices Authentication anstelle der jeweiligen dologin Funktionen innerhalb der Anwendungen können die o.a. Hersteller, die bislang über unsere Schnittstellen nicht erreichbar waren, jetzt auch abgefragt werden. 2. Authentifizierung über dologin/dologout als Ersatz für die einzelnen Login-Funktionen der neuen SilverDAT Produkte: Die Login-Funktionen dologin/dologout innerhalb des neuen Webservices arbeiten grundsätzlich konform zum bislang gültigen dologin/dologout in den jeweiligen Anwendungen; die Rückgabedaten entsprechen dem gewohnten dologinresponse bzw. dologoutresponse, werden aber um zwei optionale Felder mit Bauzeitinformationen ergänzt; auch die Eingabeparameter werden um zwei weitere Pflichtparameter zur Identifizierung erweitert: Parametername Datentyp Beschreibung interfacepartnernumber string Kundennummer interfacepartnersignature string symmetrischer Passwortschlüssel (PGP + AES), muß über vertrieb@dat.de angefordert werden. Mit Einführung des Webservices Authentication werden die bisher genutzten dologin/dologout Funktionen innerhalb der neuen SilverDAT Produkte obsolet. Für eine Übergangszeit bis Februar 2013 werden die Funktionen aber parallel laufen. Ab Anfang Februar 2013 werden die Schnittstellenfunktionen dologin/dologout innerhalb der jeweiligen Webservices dann nicht mehr zur Verfügung stehen. Die Authentifizierung erfolgt dann grundsätzlich über den neuen Webservice Authentication. Bitte berücksichtigen Sie dies bei Ihrer Planung. Der neue Webservice ist über das jeweilige SilverDAT Produkt ansprechbar und kann über die folgenden Adressen angesteuert werden: WSDL: Serviceaufruf : Bitte ersetzen Sie dabei [ProduktName] durch die unten angegebene Syntax Ihrer genutzten SilverDAT Anwendung: [ProduktName] GlassRep FinanceLine VehicleRepairOnline SparePartRequest DATECodeSelection SilverDAT Produkt SilverDAT Glas Bankenlinie FI Online Schnellkalkulation Vehicle Selection

5 Beispiel: Nutzung des Services mit der Bankenlinie; Aufruf über: Um die zusätzlichen Nutzungsinformationen zu klären und die erweiterte Schnittstellenfunktion nutzen zu können, nehmen Sie bitte Verbindung zum Vertrieb der DAT, auf. Ausserdem erhalten Sie über diese Adresse auch den Passwortschlüssel, den Sie als zusätzlichen Parameter benötigen. Alle weiteren technischen Informationen entnehmen Sie bitte dem aktuellen Schnittstellenkompendium. DAT uropa-code Lieferung: Änderung in Schemata für Zusatzelement 5 Die Dateinamen und die Namen der Root- und Satzelemente für das Zusatzelement 5 haben sich geändert. Inhaltlich bleibt allerdings alles gleich. Bitte entnehmen Sie die Änderungen dem Kompendium Datenlieferungen > Satzbeschreibung DAT uropa-code > Beschreibung Zusatzelement 5 ff. SD Bankenlinie: Erweiterung für getvehicleevaluation und getvehicletargetdateevaluationhistory Ab 11/2012 werden die beiden Schnittstellenfunktionen getvehicleevaluation und getvehicletargetdateevaluationhistory um ein optionales Element condition erweitert, das wiederum weitere optionale Elemente enthalten kann. Diese Erweiterung der Bewertungsfunktionen soll eine genauere Zustandsbewertung ermöglichen. Bisher war es lediglich möglich, einen pauschalen Korrekturfaktor zwischen 70 und 130 % anzugeben, um den ermittelten Verkaufswert durch den Benutzer zu beeinflussen. Nun kann durch Angabe von momentan maximal 9 weiteren Parametern eine genauere Wertkorrektur bezüglich des Fahrzeugzustandes vorgenommen werden. Bitte entnehmen Sie dem Schnittstellenkompendium in folgenden Kapiteln weitere Informationen zu dieser Erweiterung: > SilverDAT Produkte > SilverDAT Bankenlinie > Schnittstellenoperationen > Bewertung oder Restwertprognose mit Minimal-Eingabe > Minimale Bewertung > SilverDAT Produkte > SilverDAT Bankenlinie > Schnittstellenoperationen > stichtagsbezogene Bewertung durchführen (Historische Bewertung) Ausserdem ändert sich hierdurch die VXS-Struktur im Element Condition. Es wurde komplett überarbeitet und gibt nun die Ergebnisse des Fahrzeugzustands der oben genannten Funktionen zurück. Weitere Informationen finden Sie im Kompendium unter > Datenaustauschformate > VSX - das Austauschformat > Aktenzeichen/Vorgänge (Dossiers) > Aktenzeichen/Vorgang (Dossier) > Bewertungsdaten (Valuation) > Condition SD FI Online: Wiedergabe der Ölfüllstandsmengen Mit dem kommenden Update werden die Schnittstellenfunktionen auch die Ölfüllstandsmengen zurückgeben: calculate calculatecontract

6 getmaintenanceintervals getcalculationresults Weitere Informationen zur Rückgabe der Ölfüllstandsmengen finden Sie in der VXS-Struktur im Schnittstellen-Kompendium > Datenaustauschformate > VXS - das Austauschformat > Aktenzeichen/vorgänge (Dossiers) > Aktenzeichen/Vorgang (Dossier) > Fahrzeug (Vehicle) > Technische Daten (TechInfo) VXS: neues Attribut in Dossiers für alle Glas-Anwendungen Ab 11/2012 wird das Element Dossiers um ein neues Attribut erweitert, das eine genauere Kennzeichnung der verwendeten Glas-Anwendung möglich machen soll. Zur Übersicht noch mal die genaue Definition der möglichen Attribute in Dossiers: Element Typ Beschreibung source string Das System, das den Inhalt generiert hat, Für Importe in eine der Glas-Anwendungen: SD3. Für Importe aus Fremdanwendungen wird hier der Name der Anwendung vermerkt. type string Die Art bzw. den Zweck der Generierung, etwa spezielle abgespeckte Börsenexporte, z.b. SparePartRequest, GlassRep. Bei Übergabe an eine Glas-Anwendung muß - zusätzlich zum source=sd3 - einer der folgenden Werte in type gesetzt werden: - glassrep.mbg für Mercedes Benz Glas - glassrep.vwg für Volkswagen Glas - glassrep.sdg für SilverDAT Glas - glassrep.agp für autoglas Plus - glassrep.aug für Audi Glas - glassrep.nsg für Nissan Glas Die beiden oben genannten Attribute müssen bei jeder Übergabe eines Dossiers angegeben werden, z.b: <!-- für Import aus Nissan Glas --> <Dossiers source="sd3" type="glassrep.nsg" xmlns:vxs=" Diese Informationen können im Kompendium nachgelesen werden, unter > Datenaustauschformate > VXS - das Austauschformat > Aktenzeichen/Vorgänge (Dossiers) Bitte beachten Sie die Änderungshistorie der jeweiligen Schnittstellen-Dokus. Dort finden Sie weitere Änderungen zu den Services. Die geänderte Schnittstellenbeschreibung steht Ihnen ab 15. Dezember 2012 zur Verfügung.