Webserv.HAP
Inhaltsverzeichnis |
Händlerarbeitsplatz
Die Renault Deutschland AG führt seit Ende 2012 den Händlerarbeitsplatz (HAP) ein, der die Programme COS, OLM und LEAR ersetzt, aber auch weitere Funktionalitäten zur Verfügung stellt.
Bitte beachten Sie |
---|
Der Renault Händlerarbeitsplatz ist fast vollständig identisch mit den Nissan SMIT Händlerarbeitsplatz. Deswegen werden beide Integration in diesem Kapitel beschrieben. Sofern Abweichungen bestehen, wird auf diese gesondert hingewiesen. |
Konzept der Integration ECAROS - HAP
- Die Synchronisation zwischen ECAROS und HAP umfasst die Daten Kunde/Interessent, Fahrzeug, Potenzial, Rechnung. Unter einem Potenzial werden die im DMS erfassten möglichen zukünftigen Arbeiten an einem Fahrzeug verstanden.
- Das führende System für diese Daten ist ECAROS. Der HAP verfügt über eine Kopie dieser Daten aus ECAROS.
- Ziel der Schnittstelle HAP-ECAROS ist es, die genannten Daten im ECAROS und im HAP zu synchronisieren.
- Die Synchronisation zwischen ECAROS und HAP wird immer vom ECAROS initiiert, der HAP gibt einen Rückgabewert zur erfolgreichen oder fehlerhaften Verarbeitung der Daten und je nach Operation die von ECAROS angeforderten Daten zurück.
Konfiguration Plugins
Die Kommunikation zwischen ECAROS und dem HAP baut auf einer Anzahl von 6 unterschiedlichen Plugins auf. Diese können initial in der Systemverwaltung unter Plugins erstellt werden. Im folgenden werden die notwendigen Plugins aufgeführt:
Plugintyp | Bezeichnung |
---|---|
Adressen | Renault HAP - Adresssynchronisation |
Adressexport | Renault HAP - Adressexport |
Adressimport | Renault HAP - Adressimport |
Aufträge | Renault HAP - Auftragssynchronisation |
Fahrzeuge | Renault HAP - Fahrzeugsynchronisation |
Fahrzeugexport | Renault HAP - Fahrzeugexport |
für Nissan lauten die Plugins folgendermaßen:
Plugintyp | Bezeichnung |
---|---|
Adressen | Nissan SMIT - Adresssynchronisation |
Adressexport | Nissan SMIT - Adressexport |
Adressimport | Nissan SMIT - Adressimport |
Aufträge | Nissan SMIT - Auftragssynchronisation |
Fahrzeuge | Nissan SMIT - Fahrzeugsynchronisation |
Fahrzeugexport | Nissan SMIT - Fahrzeugexport |
Plugineigenschaften
Die folgenden Plugineigenschaften sind für die Integration von Bedeutung
PAYMENT_TYPE_CASH
Die Id der Zahlungsart für Barzahlung. Dieser Schlüssel wird ebenfalls von der Renault EDR Schnittstelle verwendet.
PAYMENT_TYPE_CREDITCARD
Die Id der Zahlungsart für Kreditkartenzahlung. Dieser Schlüssel wird ebenfalls von der Renault EDR Schnittstelle verwendet. Die Plugineigenschaften sind mandantenabhängig.
Bitte beachten Sie |
---|
Es ist zu beachten, dass für die Nissan SMIT Schnittstelle aus technischen Gründen ebenfalls die Plugineigenschaften der Renaultschnittstellen Verwendung finden. |
Erweiterte Plugineigenschaften
Im folgenden werden die Funktionen der erweiterten Plugineinstellungen näher erläutert.
Einstellungen
Datei:Erweiterte Plugineigenschaften - Einstellungen.png
Auf dem Tab Einstellungen kann das Zertifikat, sowie die pluginspezifischen Einstellungen eingestellt werden. Um ein Zertifikat hinzuzufügen kann nach einem Klick auf den Knopf „Zertifikat hinzufügen“ die Zertifikatsdatei ausgewählt werden. Im Anschluss wird zur Eingabe des Keystore-Kennworts aufgefordert. Wurde das Zertifikat erfolgreich hinzugefügt, so muss noch der zu verwendende Alias ausgewählt werden. Das Zertifikat muss nur einmal pro Hauptmandant konfiguriert werden.
Folgende Pluginspezifische Einstellungen können über das Tab Einstellungen konfiguriert werden:
Schlüssel | Beschreibung |
---|---|
BANK_ADDRESS_IDS | Die Adressnummern der schnittstellenspezifischen Bankadressen. Dient zur Bestimmung der Bankrechnungen. |
HAP_DATASET_LIMITATION | Beschränkt die Anzahl der Datensätze die maximal pro Übertragung gesendet werden. |
HAP_ORDER_START_DATE | Bestimmt ab welchem Erstelldatum die offenen Aufträge bei der Übertragung berücksichtigt werden. |
HAP_ORGANISATION_ID | Organisations-Id - wird vom Webserviceanbieter bereitgestellt. |
HAP_PASSWORD | Passwort – wird vom Webserviceanbieter bereitgestellt. |
HAP_REQUEST_TIMEOUT | Timeout für den Request in Millisekunden |
HAP_SERVICE_URL | Die Webservice-URL. (Adressen aktuell noch unbekannt) |
HAP_SYSTEM_ID | System-ID – wird vom Webserviceanbieter bereitgestellt. |
Wert-Zuordnungen
Folgende Mappings können auf dem Tab Wert-Zuordnungen vorgenommen werden:
- USt.-Kennzeichen
- Zuordnung welches Ust.-Kennzeichen als steuerpflichtig übermittelt werden soll.
- Bevorzugte Kommunikationsart
- Zuordnung der Kommunikationsarten zu den bevorzugten HAP/SMIT Kanälen. Wird in der aktuellen Version nur für den Sendeprozess verwendet.
- Fahrzeugkategorien
- Zuordnung der Fahrzeugkategorien zu den HAP/SMIT Fahrzeugarten.
- Treibstoffarten
- Zuordnung der Motorarten zu den HAP/SMIT Treibstoffarten. Die Mappings auf dem Tab Wert-Zuordnungen sind mandantenabhängig und gelten falls parallel betrieben sowohl für HAP als auch für SMIT.
SMIT-spezifisch
Spezielle Zuordnung nur für die Nissan SMIT Schnittstelle. Das Tab wird für die Renault HAP Plugins ausgeblendet. Zuordnung der Fahrzeugstatus zu den SMIT Lagerstatus. Wird nur zur Übertragung von Bestandsfahrzeugen verwendet.
Übertragungsprotokoll
Alle Schnittstellenanfragen an den Webservice werden protokolliert. Diese Anfragen lassen sich über den Tab Übertragungsprotokoll einsehen. Die detaillierten Nachrichten, sowie die Fehlermeldungen lassen sich für jede Übertragung über den Knopf Details anzeigen einblenden
Schnittstellentest
Über den Knopf Schnittstellentest wird die Testmethode der Schnittstelle angesprochen. Diese Funktion kann nach der Einrichtung verwendet werden um die Schnittstellen-Verbindung zu überprüfen.
Schnittstelle zurücksetzen
Laut Lastenheft muss die Schnittstellenumetzung eine Möglichkeit bieten, die Schnittstellendaten komplett zurückzusetzen.
Bitte beachten Sie |
---|
Diese Funktion darf nur vom Administrator verwendet werden und dies auch nur nach expliziter Aufforderung durch den HAP/SMIT Support. Diese Funktion löscht alle Übertragungsinformationen und stellt den Zustand wie er direkt nach der Ersteinrichtung vorliegt wieder her. |
Rechnungshistorie senden
Um bereits existierende Rechnungen an die Schnittstelle zu übermitteln kann in den erweiterten Plugineinstellungen die Rechnungshistorie übermittelt werden. Hierzu muss nach Betätigung des Knopfes Rechnungshistorie senden das Startdatum angegeben werden. Diese Funktion übermittelt alle passenden bereits freigegebenen bzw. fakturierten Rechnungen an den Webservice.
Adressexport
Wird die Schnittstelle neu in Betrieb genommen, oder wurde die Schnittstelle zurückgesetzt, so kann es sein, dass man den HAP/SMIT mit größeren Datenmengen befüllen möchte. Hierzu kann das Adressexport-Plugin verwendet werden. Der Anwender öffnet den Menüpunkt Stammdaten – Adressexport und sucht über die sich öffnende Suchmaske die gewünschte Adressmenge. In der Ergebnissmenge markiert der Benutzer die tatsächlich gewünschten Datensätze und bestätigt mit Export.
Im folgenden Dialog wählt der Anwender das entsprechende Plugin aus.
Mit OK werden alle selektierten Datensätze zur Übertragung markiert und falls möglich direkt an den Webservice übertragen. Eine Übertragung ist nur alle 5 Minuten im Rahmen einer Komplettsynchronisation möglich. Wurde dieses Interval noch nicht erreicht, so kann es passieren dass der Export nicht nicht sofort eine Übertragung auslöst.