DAT Schnittstelle SOAP procar informatik AG 1 Stand: FS 06/2016
Inhaltsverzeichnis 1 Aktivieren der Plugins...3 2 Einrichten der Plugins...5 3 Berechtigungen...7 4 Übergabe von Fahrzeugen an DAT...8 5 Übernahme von bewerteten Fahrzeugen...10 6 Übernahme eines Kostenvoranschlages...11 7 SilverDAT II Servermodus...12 8 Fragen und Probleme:...13 8.1 Keine Verbindung zwischen DAT und ecaros...13 8.1.1 Port wird geblockt...13 8.1.2 Port ist nicht korrekt...13 8.1.3 Port ist korrekt & frei, trotzdem keine Antwort...14 procar informatik AG 2 Stand: FS 06/2016
1 Aktivieren der Plugins DAT Schnittstelle SOAP Administration > Systemverwaltung > Plugins > Typ: Fahrzeugimport Über die Funktion Plugin hinzufügen können Sie das entsprechende Fahrzeugimport Plugin hinzufügen. Nach der Auswahl muss bei ASP-Betrieb noch der Haken bei Client-seitig gesetzt werden! Administration > Systemverwaltung > Plugins > Typ: Auftragsimport Über die Funktion Plugin hinzufügen können Sie das entsprechende Auftragsimport Plugin hinzufügen. Nach der Auswahl muss bei ASP-Betrieb noch der Haken bei Client-seitig gesetzt werden! procar informatik AG 3 Stand: FS 06/2016
Administration > Systemverwaltung > Plugins > Typ: Fahrzeuge Über die Funktion Plugin hinzufügen können Sie das entsprechende Fahrzeuge Plugin hinzufügen. Nach der Auswahl muss bei ASP-Betrieb noch der Haken bei Client-seitig gesetzt werden! procar informatik AG 4 Stand: FS 06/2016
2 Einrichten der Plugins DAT Schnittstelle SOAP Administration > Systemverwaltung > Plugineigenschaften > Typ: Auftragsimport / Plugin: KVA aus SilverDAT II SOAP Administration > Systemverwaltung > Plugineigenschaften > Typ:Fahrzeuge / Plugin: SilverDAT II SOAP Fahrzeugexport Administration > Systemverwaltung > Plugineigenschaften > Typ: Fahrezeugimport / Plugin: Gebrauchtwagen aus SilverDAT II SOAP Über eine der drei Oberflächen kann die DAT Schnittstelle SOAP konfiguriert werden, diese Einstellungen gelten dann automatisch für die anderen Plugins auch. DAT_CUSTOMER_NUMBER: Hier geben Sie die DAT-Kundennummer an. DAT_DEALER_NUMBER: Geben Sie hier die Betriebsnummer von DAT an. DEFAULT_STOCK_LOCATION: Hier geben Sie die ID des Standard-Lagerortes an, diese kann über Teiledienst > Lagerverwaltung > Lagerort > Lagerortdetails ausgelesen werden. DAT_POSITION_DESCRIPTION: TRUE = Es wird der Positionstext aus DAT übernommen. FALSE = Es wird nur der Positionstext aus DAT übernommen, wenn die Position im ecaros nicht bekannt ist. ORDER_BY_DAT: TRUE = Es wird die Sortierung aus DAT übernommen. FALSE = Es wird die Sortierung von ecaros verwendet. PRICES_FROM_DAT: TRUE = Es werden immer die Preise aus DAT übernommen. FALSE = Es wird nur der Preis aus DAT übernommen, wenn die Position im ecaros nicht gefunden wird. SD2_FI_PORT: Hier geben Sie den Port für die Kommunikation mit dem SilverDAT II FI Modul an, standardmäßig ist dieser Port 56787 und muss nicht geändert werden. procar informatik AG 5 Stand: FS 06/2016
SD2_GS_PORT: Hier geben Sie den Port für die Kommunikation mit dem SilverDAT II GS Modul an, standardmäßig ist dieser Port 56791 und muss nicht geändert werden. SD2_SERVER: Hier geben Sie die IP-Adresse des Servers an, auf dem das SilverDAT II installiert wurde. USED_CAR_DIFFERENCE_ACCOUNTINGCODE: Hier muss der Fibucode für Gebrauchtwagen differenzbesteuert angegeben werden. USED_CAR_REGULAR_ACCOUNTINGCODE: Hier muss der Fibucode für Gebrauchtwagen regelbesteuert angegeben werden. VEHICLE_EXPORT_DEFAULT_STRUCTURE: Dieser Wert wird durch die Einstellung der Standard Fahrzeugkategorie im TAB Fahrzeugkategorie gesetzt. Diese Einstellung ist nur im Typ: Fahrzeuge / Plugin: SilverDATII SOAP Fahrzeugexport > Erweiterte Einstellungen öffnen zu finden. Erweiterte Einstellungen öffnen: In den Erweiterten Einstellungen müssen jetzt noch Mappings für Hersteller, Fahrzeugkategorie, Kraftstoffart, Getriebeart, Schadstoffklasse und Verrechnungssatzcode hinterlegt werden. Diese Einstellungen müssen zweimal vorgenommen werden, einmal für eines der Import-Plugins und einmal für das Export-Plugin. procar informatik AG 6 Stand: FS 06/2016
3 Berechtigungen Administration > Stammdaten > Mitarbeiter-Berechtigungen Jeder Anwender der diese Schnittstelle nutzen möchte, muss die im Bild aufgeführte Berechtigungsrolle besitzen. procar informatik AG 7 Stand: FS 06/2016
4 Übergabe von Fahrzeugen an DAT Vertrieb > Fahrzeugverwaltung > Lagerfahrzeuge Vertrieb > Fahrzeugverwaltung > Kundenfahrzeuge Kundendienst > Fahrzeugverwaltung > Kundenfahrzeuge Um die Bearbeitung eines KVA oder einer Fahrzeugbewertung in DAT zu vereinfachen, können die Fahrzeugdaten, eines bereits im ecaros angelegten Fahrzeuges, an DAT übergeben werden. Über den Button Blatt mit Pfeil nach rechts > SilverDAT II SOAP Fahrzeugexport kann das Fahrzeug übermittelt werden, hierzu muss für die Übergabe ein Aktenzeichen angegeben werden. Von ecaros wird Ihnen bereits ein Name für das Aktenzeichen vorgeschlagen, diesen können Sie aber auch noch anpassen. Nach erfolgreicher Übergabe erhalten Sie noch eine Bestätigungsmeldung. procar informatik AG 8 Stand: FS 06/2016
WICHTIG! Die Übergabe erfolgt immer in das FI-Modul (Fahrzeuginstandsetzung), um ein Fahrzeug im GS- Modul bewerten zu können, darf im GS-Modul unten rechts der Haken bei Nur GS-AZ nicht gesetzt sein. procar informatik AG 9 Stand: FS 06/2016
5 Übernahme von bewerteten Fahrzeugen Vertrieb > Fahrzeugverwaltung > Lagerfahrzeuge Ein wichtiges Feature für den Kfz-Handel stellt die Bewertung von Gebrauchtwagen dar. Die Bewertung des Fahrzeuges findet in SilverDAT II statt. Das Fahrzeug wird mit Ausstattung und Preisen in den Lagerbestand von ecaros übernommen. Über den Button Blatt mit Pfeil nach links > Gebrauchtwagen aus SilverDAT II SOAP kann nur nach dem Aktenzeichen gesucht werden. ACHTUNG! Das Aktenzeichen muss bei der Suche so eingegeben werden, wie Sie es auch in SilverDAT II angegeben haben (mit oder ohne Leerzeichen/Bindestrich, Groß-/Kleinschreibung). Weiterhin können Bestandsfahrzeuge über die gleiche Funktion im ecaros aktualisiert werden, hierzu einfach das Bestandsfahrzeug in ecaros aufrufen und die gleiche Funktion wie oben beschrieben ausführen. procar informatik AG 10 Stand: FS 06/2016
6 Übernahme eines Kostenvoranschlages Kundendienst > Auftragsbearbeitung > Auftragsannahme Vertrieb > Auftragsbearbeitung > Auftragsannahme Teiledienst > Auftragsbearbeitung > Auftragsannahme Ein weiteres Leistungsmerkmal der Schnittstelle zu SilverDAT II ist die Übernahme eines Kostenvoranschlages. Dieses Feature ermöglicht die komplette Übernahme und Anlage als Kostenvoranschlag oder den Import der Daten in einen bestehenden ecaros Auftrag. Über den Button Blatt mit Pfeil nach links > KVA aus SilverDAT II SOAP kann nur nach dem Aktenzeichen gesucht werden. ACHTUNG! Das Aktenzeichen muss bei der Suche so eingegeben werden, wie Sie es auch in SilverDAT II angegeben haben (mit oder ohne Leerzeichen/Bindestrich, Groß-/Kleinschreibung). procar informatik AG 11 Stand: FS 06/2016
7 SilverDAT II Servermodus Um die zuvor beschriebenen Funktionen in ecaros ausführen zu können, muss das SilverDAT II auf Ihrem Server im sogenannten Servermodus gestartet werden. Bitte haben Sie Verständnis, dass hier nur eine stark vereinfachte Beschreibung dieser Funktion möglich ist. Bei aufkommenden Fragen oder Problemen würden wir Sie bitten, sich direkt mit der technischen Hotline von SilverDAT II in Verbindung zu setzen. Legen Sie sich zunächst eine neue Verknüpfung auf dem Desktop des SilverDAT II Server an (Rechte Maustaste > Neu > Verknüpfung). Hier muss nun folgender Parameteraufruf eingegeben werden.?:\<pfad zur SilverDATII Installation>\SDII\D\D\EXE.W95\autostrt.exe -FPAFI+GS -FPU<Benutzername aus SilverDAT II> -FPP<Passwort des Benutzers aus SilverDAT II> -SRV -FPE -C<IP-Adresse des SilverDAT II Server> -D<IP-Adresse des SilverDAT II Server> Beispiel: D:\Programme\SDII\D\D\EXE.W95\autostrt.exe -FPAFI+GS -FPUTEST -FPPTEST -SRV -FPE -C192.168.98.167 -D192.168.98.167 danach klicken Sie auf Weiter. Geben Sie nun der Verknüpfung einen Namen und schließen Sie den Vorgang mit Fertig stellen ab. Dieser Servermodus muss immer gestartet sein, ggf. muss dieser Aufruf auch in den Autostart aufgenommen werden, damit auch nach einem Server-Neustart der Servermodus automatisch gestartet wird. procar informatik AG 12 Stand: FS 06/2016
8 Fragen und Probleme: DAT Schnittstelle SOAP 8.1 Keine Verbindung zwischen DAT und ecaros 8.1.1 Port wird geblockt Wie auf Seite 5 bereits zu sehen ist, wird für die Kommunikation ein sehr hoher Port (56787/56791) verwendet. Hierzu ist es manchmal notwendig, den entsprechenden Port in der Firewall freizuschalten. 8.1.2 Port ist nicht korrekt Es werden von unserer Seite immer die Ports für FI =56787 und für GS = 56791 vorgegeben, in manchen Fällen stimmen diese aber nicht mit den Ports von DAT überein. Um zu kontrollieren, welche Ports von DAT verwendet werden, gehen Sie wie folgt vor: - Starten Sie das DAT Hauptmenü - Melden Sie sich als Admin an - Gehen Sie auf Datei > IDS-Parameter einstellen Hier können Sie im TAB FI-Server und GS-Server den jeweiligen Port auslesen. procar informatik AG 13 Stand: FS 06/2016
8.1.3 Port ist korrekt & frei, trotzdem keine Antwort Hier muss in DAT kontrolliert werden, ob für die Module FI und GS auch alle Haken gesetzt wurden. - Starten Sie das DAT Hauptmenü - Melden Sie sich als Admin an - Gehen Sie auf Datei > IDS-Parameter einstellen Hier können Sie im TAB FI-Server und GS-Server den jeweiligen Haken aktivieren. procar informatik AG 14 Stand: FS 06/2016