Endgültige Abschaltung der Services VehicleIdentification und VehicleSelection

Transkript

1 Änderungen der SilverDAT Schnittstelle: Ausgabe Ausgabe 2014_04_Ges049 Endgültige Abschaltung der Services VehicleIdentification und VehicleSelection Endgültige Abschaltung des Service ConversionFunctions Ablösung von DAF durch VXS: Neuer Web-Service ConversionFunctionsService DAT uropa-code Lieferung: Erweiterung Zusatzelement 2 um Kennzeichen "Arbeit vorhanden?" und "Lackierarbeit vorhanden?" DAT uropa-code Lieferung: Erweiterung DAT uropa-code Lieferung Teil 2 DAT uropa-code Lieferung: Änderung des Encodings der DAT uropa-code Datenlieferung Allgemein: eindeutige Url für dat.de SilverDAT II: Neue Datenbank-Version SilverDAT II: Versand an Schadennetz myclaim: Zugriff über Schnittstelle nur noch mit sichtbaren und aktive Benutzern SD valuatefinance: Trennung von historischer und aktueller Bewertung in einem Vorgang SD valuatefinance: Neuer optionaler Parameter VXS: new Elements... Neue en im Service VehicleRepairOnline/services/VehicleRepairService Neue im Service VehicleRepairOnline/services/VehicleIdentificationService Neuer Service VehicleRepairOnline/services/VehicleRepairDossier Neuer CustomerService Endgültige Abschaltung der Services VehicleIdentification und VehicleSelection Die Webservices VehicleIdentification sowie VehicleSelection werden nun endgültig zum Update 12/2014 (Dezember 2014) abgeschaltet. Bitte führen Sie Ihre Anpassungen zeitnah durch. Endgültige Abschaltung des Service ConversionFunctions Der Web-Service ConversionFunctions ist abgelöst durch ConversionFunctionsService und wird zu 04/2015 eingestellt! Ablösung von DAF durch VXS: Neuer Web-Service ConversionFunctionsService Neuer Web-Service ConversionFunctionsService WSDL: Serviceaufruf: ConversionFunctionsService: enthält genau dieselben Methoden wie der neue Web-Service ConversionFunctions, außer dass die Methoden getequipmentfrommanufacturercode, getexistingequipment und getpossibleequipment als Rückgabewert eine VXS -Struktur (und nicht ein DAF ) liefern.

2 Zuordnungen: DAF equipmentclassification equipmentnumber equipmentstandardoroptional manufacturercode appraisalgroup equipmentlabeling VXS EquipmentClass DatEquipmentId Ergibt sich aus der Position des Elementes (SeriesEquipment, SpecialEquipment) ManufacturerEquipmentId EquipmentGroup Description DAT uropa-code Lieferung: Erweiterung Zusatzelement 2 um Kennzeichen "Arbeit vorhanden?" und "Lackierarbeit vorhanden?" Im Zusatzelement 2 ist gegenwärtig ersichtlich, ob hinter der jeweiligen DVN ein Ersatzteil steht oder nicht. Da es allerdings auch reine "Material-DVN" gibt soll mit weiteren Kennzeichen auch diese Aussage ab 12/2014 zur Verfügung gestellt werden. : Gibt es für die DVN einen Reparaturvorgang wird das Kennzeichen "Arbeit vorhanden?" auf 1 gesetzt, ansonsten ist es 0 Gibt es für die DVN eine Lackierarbeit wird das Kennzeichen "Lackierarbeit vorhanden?" auf 1 gesetzt, ansonsten ist es 0 Erweiterung DAT uropa-code Lieferung Teil 2 Die DAT uropa-code Datenlieferung wird ab 04/2015 um das Element Obertypgruppe erweitert. Dieses fasst mehrere Obertypen (Golf I, Golf II,, Golf VII) zu einer Gruppe (Golf) zusammen. Änderung des Encodings der DAT uropa-code Datenlieferung Zu 08/2015 wird die DAT uropa-code Datenlieferung von Länderspezifischen Codepages umgestellt nach UTF8. Allgemein: eindeutige Url für dat.de Bitte beachten Sie, dass Sie bei Ihrem Zugriff auf unsere Webseite nur noch die URLs mit www verwenden. Das bedeutet: sind die gültigen URLs. Die Webseiten ohne www werden ab dem nicht mehr unterstützt. SilverDAT II: Neue Datenbank-Version Ab DVD 12/2014 wird die Datenbank-Version von 4420 auf 4421 erhöht.

3 SilverDAT II - Versand an Schadennetz myclaim: Zugriff über Schnittstelle nur noch mit sichtbaren und aktive Benutzern Für den Schnittstellenzugriff verwenden Sie künftig nur noch sichtbare und aktive Benutzer aus der SDII-Benutzerverwaltung. Der bisher gerne eingesetzte ICOPCOM-User für den Schnittstellenaufruf kann für den Versand an das neue Schadensnetz myclaim aufgrund nicht zusteuerbarer Zugangsdaten nicht verwendet werden. Für den Anwender bleibt der Versand-Button "an Versicherung" inaktiv. Folgender Lösungsvorschlag: Die Schnittstellenanwendung startet vor dem eigentlichen COM-Aufruf der gewünschten IDS- die Anwendung direkt mit dem Aufruf von autostrt.exe und den entsprechenden Parametern wie dem echten Benutzer und Passwort und der zu startenden Anwendung und entfernen den Logon über die COM-Schnittstelle. z.b.: c:\sdii\d\d\exe.w95\autostrt.exe -FPUMAIER FPPMYPASSWD -FPAFI -FPE -StopGUI AutoStart-Optionen Mögliche Parameter für den Start der AUTOSTRT.EXE FPU<Anwenderkürzel> Fremd Programm User FPP<Kennwort> Fremd Programm Password FPA<Applikation(en)> Fremd Programm Application FPE Fremd Programm Ende - Das Hauptmenü soll sich mit der SDII Applikation beenden. fi force login - Zwangsweise einloggen FS Filialserver Start; gilt nur in Verbindung mit -FPAGS! SRV SeRVermodus - Die Applikation bleibt sichtbar und startet automatisch den Servermodus. StopGUI Verhält sich wie -SRV, die Oberfläche bleibt jedoch unsichtbar. Gilt nur in Verbindung mit -FPAGS! Bedeutung der Parameter Mit -FPU und -FPP wird der Anmeldedialog umgangen. Hier müssen das Anwenderkürzel und das Anwenderkennwort übergeben werden, z.b. für Anwender TEST mit Kennwort TESTPWD: c:\sdii\d\d\exe.w95\autostrt.exe -FPUTEST FPPTESTPWD Wie bei SilverDAT II generell üblich, darf kein Leerzeichen zwischen den Optionen und den Parametern stehen. Mit -FPA kann angegeben werden, welche Applikation automatisch gestartet werden soll: Kürzel Applikation FI Fahrzeuginstandsetzung GS Gebrauchtfahrzeugsystem AU Abgasuntersuchung (sobald verfügbar) Bsp. -FPAFI Startet die Fahrzeuginstandsetzung Es können auch mehrere Applikationen, getrennt durch '+' gestartet werden. Bsp.: -FPAFI+GS+AU Startet FI, GS, AU, und VE Mit -FPE wird das Hauptmenü dazu veranlasst, sich selbst zu beenden, sobald alle von ihr gestarteten Applikationen beendet wurden. Mit dem -fl Parameter kann ein Login erzwungen werden, auch wenn der Benutzer gerade gesperrt ist. Die Sperrung wird dadurch nicht aufgehoben!

4 SD valuatefinance: Trennung von historischer und aktueller Bewertung in einem Vorgang Bislang war es möglich in einem Vorgang der SilverDAT valuatefinance eine aktuelle und eine historische Bewertung gleichzeitig zu verwalten. Diese Kombination ist ab 12/2014 nicht mehr zulässig, Zukünftig können in einem Vorgang nur noch die Bewertungsdaten einer Bewertungsart verwaltet werden. Mit dem Update findet eine entsprechende Migration der betroffenen Vorgänge statt. Alle Vorgänge, die eine historische und eine aktuelle Bewertung beinhalten, werden in zwei Vorgänge aufgeteilt. SD valuatefinance: Neuer optionaler Parameter im Webservice Evaluation Ab 12/2014 wird in den Schnittstellenfunktionen getvehicleapproximatevalue, getvehicleevaluation, getvehicletargetdateevaluationhistory, getnewvehicleforecast und getusedvehicleforecast ein neuer optionaler Parameter eingeführt, extendedmileagecorrection. Er ermöglicht die Aktivierung der erweiterten Kilometerkorrektur. Da es sich um einen optionalen Parameter handelt, werden nur Anpassungen in Ihrer Implementation notwendig, sofern Sie diesen Parameter nutzen möchten. Parameter Schreibweise extendedmileagecorrection Optional; Kennzeichen Erweiterte Kilometerkorrektur; Bei der erweiterten Kilometerkorrektur darf der Parameter Save nicht gesetzt sein. TRUE - mit, FALSE - ohne Um die Option nutzen zu können, muss die erweiterte Kilometerkorrektur freigeschaltet sein. VXS: neue Elemente LabourPosition (Arbeitslohn - Standardposition): Element Typ LabourPositionState String Hier kann der jeweilige Status der Arbeitsposition abgerufen werden. Z.B. Quelle der Arbeitswerte (Hersteller oder DAT) MaterialPosition (MaterialPosition(s)): Element Typ PartState String Hier kann der jeweilige Status eines Ersatzteils abgerufen werden, z.b. nicht zur Bestellung geeignet, oder nicht lieferbar Diese Elemente werden nur in SilverDAT calculatepro eingesetzt. Neue en im Service VehicleRepairOnline/services/VehicleRepairService

5 getcontractlist importdossier getassemblygroups getassemblygroupgraphic Mit der getcontractlist ist es möglich eine Liste von Vorgängen abzurufen. Mittels Filtern können Sie definieren welche Vorgänge zurückgegeben werden sollen. Mit der importdossier ist es möglich einen Vorgang über SOAP zu importieren. Sie können mittels des Parameters <CRUD> entscheiden, ob einen neuer Vorgang angelegt werden soll, oder ein bestehender Vorgang überschrieben werden soll. Mit der getassemblygroups können Sie alle Baugruppen (ID und Name) eines bestimmten Fahrzeug Haupttyps abrufen. Mit der getassemblygroupgraphic können Sie eine Grafik einer bestimmten Baugruppe abrufen. Die Grafik wird als String (SVG-Format) zurückgeliefert. Neue im Service VehicleRepairOnline/services/VehicleIdentificationService getvinbyocr Die ermöglicht es über ein hochgeladenes Bild eine VIN zu ermitteln. Diese VIN können Sie dann mit der getvehicleidentificationbyvin nutzen, um ein Fahrzeugdatensatz abzurufen. Neuer Service VehicleRepairOnline/services/Dossier getdossier Mittels der getdossier können Sie einen Vorgang (VXS) abrufen. Bislang was es nur möglich kalkulierte Vorgänge mit der getcalculationresult abzurufen. Mit getdossier können Sie auch nicht kalkulierte Vorgänge abrufen. In den folgenden Releases werden dem VehicleDossierService noch weitere en hinzugefügt. createdossier updatedossier searchdossier deletedossier changedossier exportdossier Neuer CustomerService Eine deutliche Verbesserung ist z.b. die Aufrufsequenz für die Erzeugung des Kunden. Bisher: dologin, createcustomer, getcustomer, dologout; neu: createcustomer Die Verbesserungen werden ab dem 13. November für Testzwecke zur Verfügung gestellt. Die produktive Umstellung kann ab Dezember 2014 bis März 2015 erfolgen. Ihre Bestandskunden werden im Einzelnen durch die DAT auf den neuen CustomerService umgestellt. Die Umstellung erfolgt nach Rücksprache, hierzu wird Sie die DAT im Einzelnen kontaktieren.

6 Changes to SilverDAT interfaces: Release 2014_04_Ges049 Reminder: Final deactivation of the services VehicleIdentification and VehicleSelection Reminder: Final deactivation of the service 'ConversionFunctionsService' Replacement of DAF by VXS: New web service 'ConversionFunctionsService' DAT uropa-code delivery: Auxiliary element 2 extended by indicators "Work available?" and "Paint work available?" DAT uropa-code delivery: Extension DAT uropa-code delivery part 2 DAT uropa-code delivery: Change of encoding from DAT uropa-code delivery General: unique Url for dat.de SilverDAT II: New database version SD valuatefinance: Separation of historic and actual valuation in one dossier SD valuatefinance: New optional parameter in Web service Evaluation VXS: new Elements New Functions in Service VehicleRepairOnline/services/VehicleRepairService New Functions in Service VehicleRepairOnline/services/VehicleIdentificationService getvinbyocr New Service VehicleRepairOnline/services/Dossier New CustomerService Reminder: Final deactivation of the services VehicleIdentification and VehicleSelection The discontinuation of the web services VehicleIdentification and VehicleSelection will be finally done in 12/2014 (December 2014). Please make your adjustments as early as possible. Reminder: Final deactivation of the service ConversionFunctionsService The discontinuation of the web service ConversionFunctions will be finally done in 04/2015 (April 2014). Please make your adjustments as early as possible. Replacement of DAF by VXS: New web service ConversionFunctionsService New web service ConversionFunctionsService WSDL: Service request: ConversionFunctionsService: contains exactly the same method as the new web service ConversionFunctions, except for the methods getequipmentfrommanufacturercode, getexistingequipment and getpossibleequipment provide a "VXS" structure as return value (instead of a "DAF").

7 Mapping: DAF equipmentclassification equipmentnumber equipmentstandardoroptional manufacturercode appraisalgroup equipmentlabeling VXS EquipmentClass DatEquipmentId Results on the position of the element (SeriesEquipment, SpecialEquipment) ManufacturerEquipmentId EquipmentGroup Description DAT uropa-code delivery: Auxiliary element 2 extended by indicators "Work available?" and "Paint work available?" Auxiliary element 2 currently shows whether the individual DVN incorporates a spare part or not. Since there are also pure "Material DVN", this statement shall also be made available and indicated by further indicators as of 12/2014. Description If a repair procedure exists for the DVN, the indicator "Work available?" is set to 1, otherwise it is set to 0 If paint work exists for this DVN, the indicator "Paint work available?" is set to 1, otherwise it is set to 0 Extension DAT uropa-code delivery part 2 The DAT uropa-code delivery part 2 will be extended with element main type group (04/2015). This is a summary of main types (Golf I, Golf II,, Golf VII) to a main type group (Golf). Change of encoding from DAT uropa-code delivery At 08/2015 the DAT uropa-code delivery will be changed from specific codepages to UTF8. General: unique Url for dat.de Please note that only the URLs with www. should be used to access our website. This means: are the valid URLs. The support for URLs without www. ends on April 1, 2015 SilverDAT II: New database version Starting from DVD 12/2014, the database version is incremented from 4420 to SD valuatefinance: Separation of historic and actual valuation in one dossier So far it was possible to maintain an actual and a historic evaluation in one dossier of SilverDAT valuatefinance. Starting from 12/2014 this combination will be no more possible, prospective dossiers can only maintain valuation data of one valuation type.

8 With the update there will be a corresponding migration of the affected dossiers. All dossiers maintaining an actual and a historic evaluation will be splitted into two dossiers. SD valuatefinance: New optional parameter in Web service Evaluation Starting from 12/2014, in the interface functions getvehicleapproximatevalue, getvehicleevaluation, getvehicletargetdateevaluationhistory, getnewvehicleforecast and getusedvehicleforecast a new optional parameter will be introduced, extendedmileagecorrection. It enables activation of the extended mileage correction. Since this is an optional parameter, adjustments in your implementation are only necessary if you want to use this parameter. Parameter Description Notation extendedmileagecorrection Optional; flag extended mileage correction; With extended mileage correction the parameter Save must not be set. TRUE - with, FALSE - without For using this option, the extended mileage correction must be activated. VXS: new Elements There are new elements in the VXS. LabourPosition (Wages - standard position): Element Typ LabourPositionState String Here, the respective status of a working position is retrieved, eg. source of labor values (manufacturer or DAT) MaterialPosition (MaterialPosition(s)): Element Typ PartState String Here, the respective status of a spare part is retrieved, eg "Not suitable for order", or "not available" These elements are used only in SilverDAT calculatepro. New Functions in Service VehicleRepairOnline/services/VehicleRepairService getcontractlist importdossier getassemblygroups getassemblygroupgraphic With the getcontractlist function it is possible to retrieve a list of processes. Using filters, you can define which processes are to be returned. With the importdossier function it is possible to import a process via SOAP. You can decide by means of the parameter <CRUD> whether a new process should be created, or an existing process is to be overwritten. With the getassemblygroups function, you can retrieve all assembly goups (ID and name) of a particular vehicle main type. With the getassemblygroupgraphic function you can retrieve a graphic of a particular assembly group. The graphic is returned as a String in SVG format.

9 New Functions in Service VehicleRepairOnline/services/VehicleIdentificationService getvinbyocr getvinbyocr The function makes it possible to determine a VIN by an uploaded image of the VIN. This VIN you can then use with the getvehicleidentificationbyvin function, to retrieve a vehicle record. New Service VehicleRepairOnline/services/Dossier getdossier Using the getdossier function, you can retrieve a task in any status. The result is in VXS format. this functions will be added in the next releases createdossier updatedossier searchdossier deletedossier changedossier exportdossier New CustomerService Considerable improvements has been made to the new customer service, for example the calling sequence for creating customers. Until now: dologin, createcustomer, getcustomer, dologout; new: createcustomer. The improvements will be provided from the 13th of november for testing purposes. The productive adjustment may happen from december 2014 and ending on march Your existing customers will be migrated to the new CustomerService by DAT. The migration will happen after consultation, concerning this the DAT will contact you in detail.