Technical Documentation

Transkript

1 Technical Documentation Newsletter SilverDAT Schnittstellen Informationen für DAT Schnittstellenpartner Version [ No 051] Published [ ] Seite 1 von 14

2 Inhalt 1. Erste Seite 3 2. ACHTUNG WARTUNGSARBEITEN 3 3. Allgemein: Umstellung auf CDN-Provider 4 4. Allgemein: Beispielcode für Schnittstellen 4 5. DAT Developers Guide: Authentifizierung 4 6. Verwalten von Vorgängen: Ablösung der Funktion searchdossier 5 7. DAT uropa-code -Auswahl: Neue Funktion zur Fahrzeugidentifikation österreichischer Nationalcode 5 8. DAT uropa-code -Auswahl: Neue Funktion zur Ausgabe von Fahrzeugdaten in mehreren Sprachen 6 9. SilverDAT valuatefinance: Integration der Oberfläche SilverDAT valuatepro: Freigabe von Schnittstellen SilverDAT calculatepro: Änderungen 12/ SilverDAT calculatepro: Korrektur in GetDossier 8 13 SilverDAT myclaim: Neue Funktion für das Zuweisen von Vertragskonditionen SilverDAT myclaim: Neue Funktion Partnersuche Neue Funktion zur Ausgabe Druckvorlagen DAT uropa-code Lieferung: Kennzeichen KZGlas in der DAT uropa-code Datenlieferung VXS: Erweiterung der Technischen Daten für Fahrzeuge mit alternativen Antrieben VXS: Reorganisation Italy Newsletter-Schluss 14 Seite 2 von 14

3 1. Erste Seite Sehr geehrte Nutzer DAT Schnittstelle, mit dieser Ausgabe Newsletter 051 zum Schnittstellen-Kompendium Update August 2015 treffen Sie auf einige Neuerungen: Sie finden das Schnittstellen-Kompendium zukünftig n a c h dem Kunden-login unter mydat Services. Ihre Daten für den Kunden-Login erhalten Sie vom Vertrieb. Fragen zu Kunden-Login und Lizenzvertrag SilverDAT Schnittstellen: sales-support@dat.eu. Sie finden das Schnittstellen-Kompendium ab jetzt online. Bitte arbeiten Sie immer mit der aktuellsten Version! Bis Ende August können wir Ihnen auch die englische Ausgabe (interfaces compendium ) entsprechend aktuell zur Verfügung stellen. Fragen zum Schnittstellen-Kompendium beantwortet Ihnen unser Kundendienst für Schnittstellenpartner. Bitte wenden Sie sich an: interfaces@dat.eu Bitte geben Sie uns bei Anfragen Ihre Kundennummer <DAT-Kundennummer des Mandanten>, alternativ Ihre Adresse sowie einen Ansprechpartner und eine Rückrufnummer. Bei Anfragen zu Schnittstellenfunktionen benötigen wir von Ihnen die Angabe des SilverDAT Produkts, zu dem die Schnittstelle gehört sowie den Request und den Response, auf den sich die Anfrage bezieht. Nur mit diesen Angaben können wir Ihr Anliegen bearbeiten. Mit freundlichen Grüßen Ihr DAT SilverDAT Schnittstellen Team 2. ACHTUNG WARTUNGSARBEITEN Achtung Wartungsarbeiten an den folgenden Terminen: :00 Uhr :00 Uhr :00 Uhr :00 Uhr (eventuell auch am und für einige Stunden, genauere Angabe folgt.) Zu diesen Zeiten ist kein Zugriff auf die DAT-Anwendungen möglich. Bitte beachten! Seite 3 von 14

4 3. Allgemein: Umstellung auf CDN-Provider Voraussetzung zur Nutzung der Webseite Die DAT hat zum 22.Juni 2015 auf eine CDN-Lösung umgestellt. Damit ist die Webseite für den Anwender schneller und komfortabler. Bitte beachten Sie die folgenden Voraussetzungen: Aufruf nur über nicht über dat.de keine festen IP-Adressen der DAT-Domänen in Ihrer Firewall verwenden wir empfehlen keinen Proxy zu verwenden, und wenn Proxy, dann ohne zu cachen 4. Allgemein: Beispielcode für Schnittstellen Auf dem GitHub ist Beispielcode für Entwickler eingestellt. Die Beispiele zeigen die Integration von Oberflächen und die Nutzung von Schnittstellen: 5. DAT Developers Guide: Authentifizierung Die Erstellung der Signatur wird einfacher Bei der Erstellung der Signatur haben Sie jetzt die Wahl zwischen zwei grundlegend unterschiedlichen Methoden: PGP MD5/SHA256 Hash Bitte entnehmen Sie dem Schnittstellen-Kompendium weitere Informationen: > DAT Developers Guide > Authentifizierung über die neuen SilverDAT Webservices ff. Seite 4 von 14

5 Die PGP Signaturen werden zukünftig durch SHA256 Hashes abgelöst. Dadurch wird es für den Kunden deutlich einfacher. Weitere Informationen zu SHA256 Hashes sowie Beispielcode gibt es hier: 6. Verwalten von Vorgängen: Ablösung der Funktion searchdossier In der Vorgangsverwaltung ersetzt die überarbeitete Suchfunktion searchdossierlist die veraltete Suche searchdossier. Bitte beachten Sie, dass die veraltete Funktion Anfang März 2016 abgeschaltet wird. Bitte entnehmen Sie dem Schnittstellen-Kompendium in folgenden Kapiteln weitere Informationen zu dieser Funktion: > SilverDAT Produkte > Allgemeine Services > Verwalten von Vorgängen > Funktionsumfang Vorgangsverwaltung > Suchen von Vorgängen ff. Bitte berücksichtigen Sie dies in Ihrer eigenen Implementierung. 7. DAT uropa-code -Auswahl: Neue Funktion zur Fahrzeugidentifikation anhand des österreichischen Nationalcodes Die Funktion getvehicleidentificationbynationalcodeaustria liefert anhand des österreichischen-nationalcodes (NatCode) die möglichen DAT uropa-codes und deren (DAT) Container. Diese Operation führt eine vollständige Fahrzeugidentifizierung anhand des österreichischen- Nationalcodes durch. Sie liefert eine Liste mit Elementen des folgenden Umfangs: Seite 5 von 14

6 DAT uropa-code Fahrzeugartbenennung Herstellerbenennung Haupttypbenennung Untertypbenennung Benennungen der klassifizierenden Ausstattungen der Untertypvariante Liste der Container und deren Bezeichnungen Mithilfe der DAT uropa-code Datenlieferung Teil 1B ist es ebenfalls möglich ein Fahrzeug über den NAT-Code zu identifizieren. Weitere Informationen finden sie im SilverDAT Schnittstellen-Kompendium unter: > SilverDAT Produkte > DAT uropa-code Fahrzeugauswahl > Fahrzeugidentifikation - Funktionen > Fahrzeugidentifikation anhand des österreichischen Nationalcodes ff. > Datenlieferungen > Satzbeschreibung DAT uropa-code > Beschreibung DAT uropa-code Teil 1B > Felderliste DAT uropa-code Teil 1B zu den Fahrzeugauswahldaten (NAT-Code-Ebene) 8. DAT uropa-code -Auswahl: Neue Funktion zur Ausgabe von Fahrzeugdaten in mehreren Sprachen Die Operation getvehicletranslation vollzieht eine vollständige Fahrzeugidentifizierung mit dem DAT uropa-code. Sie berücksichtigt DAT-Daten-Container, Bauzeit und Sonderausstattungen wenn sie vorhanden sind. Eine optionale Liste von Sprachen erzeugt die zusätzliche Ausgabe von Fahrzeugdaten je angegebener Sprache. Es werden alle potentiellen Kombinationen aus DAT uropa-code + Marktindex zuzüglich der Beschreibung aller Bestandteile in den gewünschten Sprachen ermittelt. Weitere Informationen finden sie im SilverDAT Schnittstellen-Kompendium unter: SilverDAT Produkte > DAT uropa-code Fahrzeugauswahl > Fahrzeugidentifikation - Funktionen > Fahrzeugidentifikation in mehreren Sprachen ff. Seite 6 von 14

7 9. SilverDAT valuatefinance: Integration der Oberfläche Die bislang noch ausstehende Beschreibung zur Integration der Oberfläche der SilverDAT valuatefinance finden Sie jetzt im Schnittstellen-Kompendium. Bitte entnehmen Sie dem Schnittstellen-Kompendium in folgenden Kapiteln weitere Informationen zu dieser Funktion: > SilverDAT Produkte > SilverDAT valuatefinance > Integration der Oberfläche ff. 10. SilverDAT valuatepro: Freigabe von Schnittstellen SilverDAT valuatepro ist die Softwarelösung für Automobilbetriebe als Management-Tool für den Gebrauchtwagenhandel. Hierzu sind ab 08/2015 die folgenden Soap-Schnittstellen freigegeben: Fahrzeugauswahl VehicleSelectionService Fahrzeugidentifikation VehicleIdentificationService Konvertierungsoperationen ConversionFunctionsService Bewertung Evaluation Vorgangsverwaltung Dossier1 Die Freigaben der restlichen Soap-Schnittstellen, sowie diejenige zur Integration der Oberfläche werden voraussichtlich zu 12/2015 erfolgen. Bitte entnehmen Sie dem Schnittstellen- Kompendium in folgenden Kapiteln weitere Informationen zu diesen Funktionen: > SilverDAT Produkte > SilverDAT valuatepro > Schnittstellenoperationen ff. 11. SilverDAT calculatepro: Änderungen 12/2015 Neue Reihenfolge bei der Navigation Die Navigation der Oberflächenintegration wird angepasst an die Reihenfolge der CalculatePro: die Teileauswahl und die vorgangsbezogenen Daten werden getauscht. Die neue Reihenfolge ist: Auftragseröffnung -> Fahrzeugauswahl -> Ausstattungen -> Vorgangsbezogene Daten -> Teileauswahl -> Kalkulation -> Drucken und senden Seite 7 von 14

8 12. SilverDAT calculatepro: Korrektur in GetDossier Schreibfehler korrigiert: orderinfo.priority In der GetDossier() Soap Methode ist in der Eigenschaft orderinfo.proirity ein Schreibfehler. Mit dem jetzigen Release wird ein zusätzliches Property hinzugefügt es heißt:orderinfo.priority Die falschgeschriebene Property wird mit dem Dezember Release entfernt! Bitte entnehmen Sie dem Schnittstellen-Kompendium weitere Informationen: > SilverDAT Produkte > SilverDAT calculatepro > Datentypen > SortingCriterions 13. SilverDAT myclaim: Neue Funktion für das Zuweisen von Vertragskonditionen Die Funktion assignsettlementtocontract weist Vertragskonditionen einem spezifischen Auftrag für einen bestimmten Partner zu. Über einen Identifikationsparameter einer Vertragskondition, kann dann einem bestimmten Partner die Kondition innerhalb eines Auftrags zugesteuert werden. 14. SilverDAT myclaim: Neue Funktion Partnersuche Über die Funktion searchforpartners lassen sich alle Partner innerhalb eines bestimmten Netzes anzeigen. Das Suchergebnis kann zusätzlich über optionale Parameter z.b. nach Markenwerkstatt, Hersteller Reparatur oder dem Ort weiter eingeschränkt werden. Seite 8 von 14

9 15. Neue Funktion zur Ausgabe von Druckvorlagen Die Funktion getprintreport liefert anhand der Auftrags ID alle vorhandenen Druckvorlagen innerhalb eines Autrags. Durch einen optionalen Parameter "reportidentification", kann hierbei zwischen Standard,- oder individuellen Vorlagen unterschieden werden. 16. DAT uropa-code Lieferung: Kennzeichen KZGlas in der DAT Europa-Code Datenlieferung In der DAT uropa-code Datenlieferng Teil 2 wurde ein weiteres Kennzeichen KZGlas hinzugefügt. Es sind die Werte 'J' und 'N' möglich. der Wert 'J' bedeutet, dass eine Glaskalkulation möglich ist. Weitere Informationen finden sie im SilverDAT Schnittstellen-Kompendium unter: Datenlieferungen > Satzbeschreibung DAT uropa-code > Beschreibung DAT uropa-code Teil 2 > Felderliste Teil 2 zu den im DAT uropa-code enthaltenen Ausstattungen 17. VXS: Erweiterung der Technischen Daten für Fahrzeuge mit alternativen Antrieben Die Technischen Daten wurden im Bereich der Schnittstellenfunktionen (TechInfo) und der DAT uropa-code Datenlieferung um die Daten der alternativen Antriebe erweitert. Sofern in unserem System zu den jeweiligen Fahrzeugen Daten erfasst sind, werden diese entsprechend ausgegeben. Weitere Informationen finden sie im SilverDAT Schnittstellen-Kompendium unter: Datenaustauschformate > VXS - das Austauschformat > Aktenzeichen/Vorgänge (Dossiers) > Aktenzeichen/Vorgang (Dossier) > Fahrzeug (Vehicle) > Technische Daten (TechInfo) Datenlieferungen > Satzbeschreibung DAT uropa-code > Beschreibung Zusatzelement 3 > Felderliste technische Zusatzinformationen Seite 9 von 14

10 18. VXS: Reorganisation Italy Insurance Calculation - VXS Extension Development The changes which are described in the following chapters will be implemented like following: For the demo rollout: "Rename" tasks: old fields retained à old and new fields will be filled "Delete" tasks: fields retained "New" tasks: old and new fields will be filled For the productive December rollout (first gold delivery): "Rename" tasks: old fields will be deleted "Delete" tasks: fields will be deleted "New" tasks: only new fields will be filled General changes Rename: CalcResultDomus CalcResultDomusOptimized CalcResultDomusGlass WithDomusCalculation DomusVehicleData CalcResultItaly CalcResultOptimizedItaly CalcResultGlassItaly WithCalculationItaly VehicleItaly DomusVehicleType VehicleTypeItaly DomusManufacturer ManufacturerItaly DomusBaseModel BaseModelItaly DomusSubModel SubModelItaly DomusVehicleTypeName VehicleTypeNameItaly DomusManufacturerName ManufacturerNameItaly DomusBaseModelName BaseModelNameItaly DomusSubModelName SubModelNameItaly Seite 10 von 14

11 Delete: DomusLacquerExtraCharges DomusExtraCharges DomusAggregates DomusAggregate DomusAggregateComponents DomusAggregateComponent MaterialPosition.DomusProcessId LabourPosition.DomusProcessId LacquerPosition.DomusProcessId IsDomusPart (If the new field "PositionItaly.ItalyProcessId" contains a value, it is a "Domus" part) New calculation structure domuscalcresult à calcresultitaly (rename): PositionsItaly new SummariesItaly new New positions structure PositionsItaly = List of single positions PositionItaly: Type ( aggregate", aggregateitem", single", required" (Not-Include of Spare parts/repair positions), correction" (Surcharge and deduction)) Position (Sort number) DatProcessId (DVN) ItalyProcessId (ET-Code) PartNumber Amount Description Location ( left", right", unique") WorkTimeReplace (SR) WorkTimeOverhaul (LA) WorkTimeMechanic (ME) WorkTimeLacquer (VE) WorkLevelReplace (SR) (Work level: easy", medium", hard", replace", manufacturer", manual") Seite 11 von 14

12 WorkLevelOverhaul (LA) WorkLevelMechanic (ME) WorkLevelLacquer (VE) ValueParts PartDiscountPerc (Discount for spare parts in percent) PartDiscountValue (Discount value) ValuePartsCorrected ParentPosition (Aggregate sort number or not include spare parts number) New summary structure SummariesItaly: BaseSummaryItaly LacquerSummaryItaly WorkSummaryItaly TotalSummaryItaly BaseSummaryItaly: WorkTimeReplace (SR) WorkTimeOverhaul (LA) WorkTimeMechanic (ME) WorkTimeLacquer (VE) ValueParts LacquerSummaryItaly = List of lacquer summary positions LacquerSummaryItemItaly: Identifier ( positions", multilayer", alllayers", layerdependant", "total") Description Percentage Hours Seite 12 von 14

13 WorkSummaryItaly = List of work summary positions WorkSummaryItemItaly Identifier ( body", mechanic", lacquer", total") Description Hours WagePerHour TotalWage DiscountPerc DiscountValue TotalWageCorrected TotalSummaryItaly = List of total summary positions TotalSummaryItemItaly: Identifier ( labour", spareparts", lacquermaterial", wastedisposal", repairbench", total") Description ValueNet ValueNetDiscountPerc ValueNetDiscountValue ValueNetCorrected ValueVat ValueGross Seite 13 von 14

14 19. Newsletter-Schluss Bitte beachten Sie bei jedem Kapitel den Änderungsnachweis. Bitte arbeiten Sie immer nur mit der aktuellsten Version. Das nächste Update für das Schnittstellen-Kompendium erscheint Dezember 2015 oder früher. Fragen zum Schnittstellen-Kompendium beantwortet Ihnen unser Kundendienst für Schnittstellenpartner. Bitte wenden Sie sich an: Seite 14 von 14