Lieferantenportale und Bestellungen - Übersicht der Zugangsmerkmale für IDS/OCI-Lieferantenportale

MOSER Gesamtdokumentation - 2.1.3. Übersicht der Zugangsmerkmale für IDS/OCI-Lieferantenportale

2.1.3. Übersicht der Zugangsmerkmale für IDS/OCI-Lieferantenportale

Versionsgeschichte
Version 4.42.100	11.11.2021	MZ
erweitert (TFS-35535,TFS-35522,TFS-36194,TFS-36195)
	15.10.2021	MZ
Neu

In der nachfolgenden Tabelle finden Sie eine Übersicht der Zugangsmerkmale für Lieferantenportale (Beschreibung der Einrichtung unter Abschnitt 2.1.2, „Einrichtung von Zugangsdaten“):

Übersicht unterstützter Merkmale

Schnittstelle	Merkmal	Bezug	Beschreibung
IDS Abschnitt 2.1.4, „IDS-Portalschnittstelle“	`IDS Artikelverwaltung`	Adresse	Legt das Verfahren zur Übernahme der Artikelnummer fest: Dieses Merkmal wird standardmäßig mit dem Wert "Nur die Bestellnummer übernehmen" verwendet und muss dazu nicht konfiguriert werden. Für erweiterte Funktionen, wie z.B. den Artikel-Deeplink ist jedoch die Verfügbarkeit der Portalartikel in den Artikelstammdaten inklusive Artikelnummer, Bestellnummer und Hauptlieferant nötig und eine entsprechende Grundeinstellung erforderlich: Nur die Bestellnummer übernehmen [Standard] Bei der Übernahme eines Artikels aus dem Lieferantenwarenkorb in einen MOS'aik Vorgang werden Lieferant, Preis und Bestellnummer übernommen. Es wird kein neuer Stammartikel angelegt. Vorhandene Stammartikel mit dem jeweiligen Hauptlieferanten und passender Bestellnummer werden über die Artikelnummer im Feld Nummer referenziert. Es werden keine Preise in den Artikelstamm übernommen. Vorhandene Stammartikel ohne Hauptlieferant und passender Einkaufskondition zu Lieferant und Bestellnummer werden über die Artikelnummer im Feld Nummer referenziert. Die aktuellen Preise werden in die Kondition übernommen. Artikelnummer bei bereits vorhandenen Stammartikeln übernehmen Die Funktion dieser Auswahl unterscheidet sich aktuell nicht von der Option Nur die Bestellnummer übernehmen. Artikelnummer immer übernehmen (gegebenenfalls einen neuen Artikel anlegen) Bei der Übernahme eines Artikels aus dem Lieferantenwarenkorb in einen MOS'aik Vorgang werden Lieferant, Preis und Bestellnummer übernommen. Es wird ggf. ein neuer Stammartikel mit Hauptlieferant, Preis und Bestellnummer angelegt. Vorhandene Stammartikel mit dem jeweiligen Hauptlieferanten und passender Bestellnummer werden über die Artikelnummer im Feld Nummer referenziert. Es werden keine Preise in den Artikelstamm übernommen. Vorhandene Stammartikel ohne Hauptlieferant und passender Einkaufskondition zu Lieferant und Bestellnummer werden über die Artikelnummer im Feld Nummer referenziert. Die aktuellen Preise werden in die Kondition übernommen. Artikelnummer immer übernehmen und Stammdaten aktualisieren Bei der Übernahme eines Artikels aus dem Lieferantenwarenkorb in einen MOS'aik Vorgang werden Lieferant, Preis und Bestellnummer übernommen. Es wird ggf. ein neuer Stammartikel mit Hauptlieferant, Preis und Bestellnummer angelegt. Vorhandene Stammartikel mit dem jeweiligen Hauptlieferanten und passender Bestellnummer werden über die Artikelnummer im Feld Nummer referenziert und mit den aktuellen Preisen im Artikelstamm aktualisiert. Vorhandene Stammartikel ohne Hauptlieferant und passender Einkaufskondition zu Lieferant und Bestellnummer werden über die Artikelnummer im Feld Nummer referenziert. Die aktuellen Preise werden in die Kondition übernommen. Manuelle Artikelstammpflege Falls Sie Ihre Stammartikel manuell anlegen und pflegen, darf das Merkmal `IDS Artikelverwaltung` lediglich auf "Nur die Bestellnummer übernehmen" oder "Artikelnummer bei bereits vorhandenen Stammartikeln übernehmen" eingestellt sein, um zu vermeiden, dass ungewollt neue Artikel angelegt werden.
	`IDS Benutzername`	Adresse	Enthält den zentral hinterlegten Benutzernamen für die Anmeldung am Lieferantenportal. An den Aufrufstellen für IDS-Lieferantenportale werden nur Lieferantenportale angezeigt, für die dieses Merkmal eingerichtet ist. Falls Sie individuelle Zugangsdaten über das entsprechende Personalmerkmal `IDS.Username@<Lieferant>` (siehe unten) verwenden, hinterlegen Sie hier einen beliebigen Wert (z.B. "Unbekannt"), damit die Portalfunktion aktiviert wird. Weiterhin darf die Adresse für den Einsatz von Portalen aus kundenseitigen Vorgängen nicht ausgeblendet sein.
	`IDS Kennwort`	Adresse	Enthält das zentral hinterlegte Kennwort für die Anmeldung am Lieferantenportal.
	`IDS.Username@<Lieferant>`	Personal	Enthält den individuellen Anmeldenamen des Mitarbeiters für die Anmeldung am Lieferantenportal. Der Wert `<Lieferant>` repräsentiert dabei den Kurznamen des jeweiligen Lieferanten. An den Aufrufstellen für IDS-Lieferantenportale werden nur Lieferantenportale angezeigt, für die das Merkmal `IDS Benutzername` eingerichtet ist. Falls Sie individuelle Zugangsdaten verwenden, hinterlegen Sie für dieses Adressmerkmal einen beliebigen Wert (z.B. "Unbekannt"), damit die Portalfunktion aktiviert wird. Weiterhin darf die Adresse für den Einsatz von Portalen aus kundenseitigen Vorgängen nicht ausgeblendet sein.
	`IDS.Password@<Lieferant>`	Personal	Enthält das individuelle Benutzerkennwort des Mitarbeiters für die Anmeldung am Lieferantenportal. Der Wert `<Lieferant>` repräsentiert dabei den Kurznamen des jeweiligen Lieferanten.
	`IDS Kundennummer`	Adresse	Enthält die Kundennummer des IDS Benutzers für die Anmeldung am Lieferantenportal. Diese Information ist lediglich erforderlich, falls sie vom Portalanbieter bereitgestellt und explizit gefordert wird.
	`IDS Lieferantenkürzel`	Adresse	Enthält das DATANORM Lieferantenkürzel des IDS Anbieters. Dabei handelt es sich um den verwendeten Kurznamen des Lieferanten für die Hinterlegung als Artikel-Hauptlieferant.
	`IDS Hybrid`	Adresse	Enthält den Schalter zur Verwendung des Moser Application Server für die Warenkorbübergabe vom Lieferantenportal an MOS'aik. Der Schalter führt automatisch zur Verwendung des externen Standard-Internetbrowsers (z.B. Google Chrome, Mozilla Firefox® oder Microsoft Edge®). Voraussetzung für die Verwendung ist eine funktionsfähige Einrichtung für den hybriden Einsatz (siehe FAQ - Neue Produktgeneration). Falls Sie zu diesem oder einem anderen Thema Hilfe oder Unterstützung benötigen, wenden Sie sich bitte an den Moser Produktservice oder Ihren Moser Kundenberater (Kontakt). Beachten Sie dazu auch die Informationen unter Abschnitt 2.1.4.2, „Einrichtung für hybride Systeme“.
	`IDS Externer Browser`	Adresse	Enthält den Schalter zur Verwendung eines externen Internetbrowsers für den Aufruf des Lieferantenportals. Der Schalter wird nur für System benötigt, die den Moser Application Server nicht einsetzen. Mit Einführung des integrierten Internetbrowsers auf Basis von Microsoft Edge® ist der Einsatz dieses Merkmals nicht mehr erforderlich. Beachten Sie dazu auch die Informationen unter Abschnitt 2.1.4.3, „Einrichtung externer Browser ohne Anwendungsserver“.
	`IDS Parameter Trennzeichen` *	Adresse	Legt das Trennzeichen für die Parameterübergabe zur Kommunikation mit der Portalschnittstelle fest. Das Merkmal wird in der Regel nur für besondere Portale benötigt. Soweit erforderlich wird das Merkmal im Standard für diese Adressen mit ausgeliefert.
	`IDS Provider` *	Adresse	Legt die Unternehmenskennung des Lieferanten im SHK-Connect Portal fest. Über eine Anmeldung an diesem Portal wird die aktuelle Internetadresse des angeforderten Lieferantenportals automatisch ermittelt. Falls diese Lieferantennummer unbekannt ist, kann alternativ das Merkmal `IDS URL` verwendet werden, um die Internetadresse des Lieferantenportals direkt festzulegen. Wenden Sie sich an den Moser Produktservice (Kontakt), falls Sie hierzu weitere Fragen haben.
	`IDS URL`	Adresse	Enthält die URL des Lieferantenportals. Das Merkmal wird nach erfolgter automatischer Anmeldung am SHK-Connect Portal einmal täglich aktualisiert. Falls für ein Lieferantenportal keine gültige SHK-Connect-Unternehmenskennung vorliegt (siehe Merkmal `IDS Provider`), kann die Portaladresse (URL) mit diesem Merkmal manuell festgelegt werden. Das Merkmal muss also vom Anwender nur konfiguriert werden, falls keine oder kein gültige Lieferantennummer im SHK-Connect Portal für den Lieferanten bekannt ist. In diesem Fall kann hiermit die Adresse des IDS-Lieferantenportals direkt angegeben werden und muss das Merkmal `IDS Provider` entfernt werden. Um die IDS-Portaladresse zu erfahren, wenden Sie sich an Ihren Lieferanten. Auch wenn das Internetportal SHK-Connect temporär nicht verfügbar sein sollte, kann diese Einstellung für eine direkte Verbindung mit dem Lieferantenportal genutzt werden. Dazu muss jedoch der Wert des Merkmals `IDS Provider` gesichert (z.B. aufgeschrieben) und das Merkmal anschließend gelöscht werden. Die Änderung sollte unbedingt rückgängig gemacht werden, sobald das Portal wieder erreichbar ist. Für die diverse Lieferanten (z.B. Bürkle, Efg, Elmer, Famo, Fegime, Fischer, GC, Gut, Heix, Hti, Sonpar NO, Tfg, Zander) werden im Standard die aktuellen IDS-URLs in der Setup Datenbank ausgeliefert.
	`IDS Version`	Adresse	Steuert versionsabhängige Funktionen der Schnittstelle. Benötigt wird das Merkmal nur für besondere Funktion, wie z.B. die Abschnitt 2.1.4.4, „IDS Artikelsuche“.
IDS HEIZUNGSlabel HEIZUNGSlabel	`IDS HEIZUNGSlabel Lieferantenkürzel`	Adresse	Enthält das Lieferantenkürzel des IDS Anbieters für das HEIZUNGSlabel Portal. Das Merkmal dient der Generierung von Energieverbrauchskennzeichnungen ("Energielabel") per IDS-Schnittstelle.
IDS HEIZUNGSlabel HEIZUNGSlabel	`IDS HEIZUNGSlabel URL`	Adresse	Enthält die URL des HEIZUNGSlabel Portals. Das Merkmal dient der Generierung von Energieverbrauchskennzeichnungen ("Energielabel") per IDS-Schnittstelle.
OCI Abschnitt 2.1.5, „OCI-Portalschnittstelle“	`OCI Artikelverwaltung`	Adresse	Legt das Verfahren zur Übernahme der Artikelnummer fest: Nur die Bestellnummer übernehmen Bei der Übernahme eines Artikels aus dem Lieferantenwarenkorb in einen MOS'aik Vorgang wird die Warenkorbbestellnummer in die Bestellnummer von MOS'aik übertragen. Artikelnummer bei bereits vorhandenen Stammartikeln übernehmen Sind die Bestellnummer und der passende Hauptlieferant bereits im MOS'aik Artikelstamm enthalten oder ist die Bestellnummer mit dem passenden Lieferanten in den Einkaufskonditionen bzw. auf der Registerkarte Lieferanten der Artikelstammdaten enthalten, wird auch die MOS'aik Artikelnummer in den Vorgang übernommen. Dadurch können Sie z.B. in einem Kundenangebot die Kalkulationsdaten aktualisieren. Artikelnummer immer übernehmen (gegebenenfalls einen neuen Artikel anlegen) Bei der Übernahme eines Artikels aus dem Lieferantenwarenkorb in einen MOS'aik Vorgang wird die Warenkorbbestellnummer in die Bestellnummer und in die Artikelnummer des MOS'aik Vorgangs übertragen. Zusätzlich wird (falls noch nicht vorhanden) ein Artikelstammsatz mit der Bestellnummer als Artikelnummer angelegt. Artikelnummer immer übernehmen und Stammdaten aktualisieren Bei der Übernahme eines Artikels aus dem Lieferantenwarenkorb in einen MOS'aik Vorgang wird die Warenkorbbestellnummer in die Bestellnummer und in die Artikelnummer des MOS'aik Vorgangs übertragen. Zusätzlich wird (falls noch nicht vorhanden) ein Artikelstammsatz mit der Bestellnummer als Artikelnummer angelegt. Beim Übernehmen von Artikeln aus einer OCI-Schnittstelle in ein Projekt werden alle Felder des Artikels in den Stammdaten aktualisiert.
	`OCI Benutzername`	Adresse	Enthält den Anmeldenamen des OCI Benutzers für die Anmeldung am Lieferantenportal. Nur Portale von Lieferanten mit diesem Merkmal werden an den entsprechenden Programmstellen zur Verwendung angeboten.
	`OCI Checkout`	Adresse	Enthält einen optionalen Makrobefehl, der nach der OCI Warenkorbübernahme ausgeführt wird. Bei OCI Plugins besteht die Möglichkeit über dieses Merkmal optional einen Befehl festzulegen, der nach der Übernahme des Warenkorbs ausgeführt wird. Damit kann beispielsweise der Makrobefehl [Close] zum automatischen Schließen des Browserfensters nach erfolgter Datenübernahme aus dem Portalwarenkorb verwendet werden.
	`OCI HOOKURL Parameter` *	Adresse	Enthält optionale Parameter für eine individuell angepasste Zuordnung der Portalwarenkorbfelder des Lieferantenportals zu MOS'aik. Die angepassten Parameter werden beim Portalaufruf der Adresse für die Warenkorbübergabe (sog. HOOK_URL) zugefügt. Eine Anpassung ist nur im Fall von individuellen Absprachen mit dem Lieferanten erforderlich erforderlich. Beispiele: AdditionalCostsCustomField=4 ListPriceCustomField=2&RawMaterialCustomField=1 Die erforderlichen Informationen finden Sie bei Bedarf in der OCI-Spezifikation Ihres Lieferanten.
	`OCI HTTP Methode`	Adresse	Legt die Anfragemethode (POST, GET) für die Kommunikation mit dem Lieferantenportal fest. Wenn die Einstellung nicht festgelegt wird, wird standardmäßig die POST-Methode verwendet.
	`OCI Kennwort`	Adresse	Enthält das Kennwort des OCI Benutzers für die Anmeldung am Lieferantenportal.
	`OCI Kundennummer`	Adresse	Enthält die Kundennummer des OCI Benutzers für die Anmeldung am Lieferantenportal.
	`OCI Lieferantenkürzel`	Adresse	Enthält das DATANORM Lieferantenkürzel des OCI Anbieters. Dabei handelt es sich um den Kurznamen des Lieferanten für die Hinterlegung von Hauptlieferanten für Artikel.
	`OCI Organisation`	Adresse	Enthält die regionale Organisationsbezeichnung des OCI Anbieters für die Anmeldung am Lieferantenportal.
	`OCI URL` *	Adresse	Das Merkmal enthält die URL und Parameter des Bestellsystems des OCI Anbieters. Auf diese Weise kann die OCI-Schnittstelle bei Änderungen von Portaladressen durch die Lieferanten jederzeit einfach angepasst werden. Über die OCI URL erfolgt der Aufruf des Lieferantenportals. Dabei werden die Merkmale `OCI Benutzername` und `OCI Kennwort` für die Benutzeranmeldung am Portal übergeben. Zusätzlich wird eine interne Adresse für die Rückgabe des Portalwarenkorbs (sog. HOOK_URL) dynamisch erzeugt und an das Portal übergeben. Dieser Adresse wird optional das Merkmal `OCI HOOKURL Parameter` zugefügt.
	`OCI URL Bestellübermittlung` *	Adresse	Das Merkmal enthält eine von der `OCI URL` abweichende URL und Parameter der Bestellübermittlung des OCI-Lieferantenportals.
	`OCI URL Deeplink` *	Adresse	Das Merkmal enthält die URL und Parameter des Lieferantenportals für den Link zur Artikelverfolgung ("Deeplink", s. auch Abschnitt 2.1.6.2, „Anzeige von Produktdetails“). Auf diese Weise kann die OCI-Schnittstelle bei Änderungen von Portaladressen durch die Lieferanten jederzeit einfach angepasst werden.
UGL UGL-Schnittstelle	`UGL Eingangsrechnung Belegnummer`	Adresse	Das Merkmal enthält die Einstellung zum Festlegen der Belegnummer beim Import einer UGL Eingangsrechnung. Möglicher Werte sind: `<Nicht festlegen>` `Wie Fremdbelegnummer`
	`UGL Eingangsrechnung Kostenstelle`	Adresse	Das Merkmal enthält die Einstellung zum Festlegen der Kostenstelle beim Import einer UGL Eingangsrechnung: Möglicher Werte sind: `<Nicht festlegen>` `Aus dem Kundenauftragstext`
	`UGL FTP Benutzername`	Adresse	Das Merkmal enthält den Anmeldenamen des UGL FTP Benutzers für den Zugriff auf den FTP-Server.
	`UGL FTP Downloadverzeichnis`	Adresse	Das Merkmal enthält den vollständigen UGL FTP Verzeichnisnamen zum Herunterladen von Dateien vom FTP-Server. Es sollte darauf geachtet werden, dass hier nur der Verzeichnisname ohne den Protokollnamen (z.B. `"ftp://"`) eingetragen wird. Am Ende des Verzeichnisnamen muss in den meisten Fällen noch ein abschließendes `"/"` angehängt werden.
	`UGL FTP Hostname`	Adresse	Das Merkmal enthält den Namen des UGL FTP-Servers.
	`UGL FTP Kennwort`	Adresse	Das Merkmal enthält das Kennwort des UGL FTP Benutzers für den Zugriff auf den FTP-Server.
	`UGL FTP Uploadverzeichnis`	Adresse	Das Merkmal enthält den vollständigen UGL FTP Verzeichnisnamen zum Hochladen von Dateien auf den FTP-Server. Es sollte darauf geachtet werden, dass hier nur der Verzeichnisname ohne den Protokollnamen (z.B. `"ftp://"`) eingetragen wird. Am Ende des Verzeichnisnamen muss in den meisten Fällen noch ein abschließendes `"/"` angehängt werden.
	`UGL Kundennummer`	Adresse	Das Merkmal enthält die Kundennummer des Handwerkers beim Großhändler, also Ihre Kundennummer beim Portalanbieter.
	`UGL Lieferantennummer`	Adresse	Das Merkmal enthält die Lieferantennummer des Großhändlers beim Handwerker, also Ihre Lieferantennummer beim Portalanbieter.
	`UGL Lieferzeitraum`	Adresse	Das Merkmal enthält die Anzahl der Tage zum Ermitteln des gewünschten Liefertermins aus dem Tagesdatum bei Bestellungen ohne individuellen Liefertermin. Wenn eine MOS'aik Bestellung selbst keinen Liefertermin enthält, kann der Liefertermin von UGL-Bestellungen anhand des `UGL Lieferzeitraums` (in Anzahl Tagen ab dem Tagesdatum) vorgegeben werden.
UGS	`UGS URL`	Adresse	Das Merkmal enthält die Adresse der Webseite zum Übermitteln einer UGS-Datei an einen Lieferanten. Falls Sie Bestelldaten im UGS-Format exportieren möchten, müssen Sie dieses Merkmal mit `user` (Benutzername) und `pwd` (Kennwort) erfassen.

*) Erforderliche Merkmale dieses Typs werden standardmäßig in (ggf. ausgeblendeten) Lieferantenadressen für bekannte Portalanbieter bereitgestellt (auch beim Update).

Sie finden die aktuellen Einstellungen (z.B. Merkmal OCI URL oder IDS Provider) in der jeweiligen, ggf. ausgeblendeten Lieferantenadresse.
- Die im Standard hinterlegte OCI URL für das Lieferantenportal der Firma Würth wurde aktualisiert.
Ausgeblendete Lieferantenadressen können einfach eingeblendet und individuell ergänzt werden, um das zugehörige Lieferantenportal einzusetzen.