Lieferantenportale und Bestellungen - IDS-Portalschnittstelle

MOSER Gesamtdokumentation - 2.1.4. IDS-Portalschnittstelle

2.1.4. IDS-Portalschnittstelle

Versionsgeschichte
Version 4.42.100	15.9.2021	MZ
erweitert (TFS-29302,TFS-35535,TFS-36194,TFS-36195)
	14.10.2021	MZ
Überarbeitung
Version 4.42.000	4.1.2021	MZ
erweitert (TFS-29665,TFS-29675,TFS-29673,TFS-29669,TFS-32798)
Version 4.41.000	14.1.2020	MZ
erweitert (TFS-11477,TFS-9578)
Version 4.40.000	31.1.2019	MZ
neu (TFS-7134, TFS-6264, TFS-8263, TFS-7670, TFS-6208, TFS-6209, TFs-8322, TFS-6235, TFS-6349)

In MOS'aik können IDS-Lieferantenportale auf folgende Weise eingesetzt werden:

Aufruf von IDS-Produktkatalogen aus kundenseitigen Vorgängen (z.B. Angebot).
Öffnen Sie einen kundenseitigen Vorgang und rufen Sie die Funktion Weitere Schritte > Plugins >> IDS Produktkataloge ... auf.
- Es wird eine Liste aller eingerichteten Lieferantenportale zur Auswahl angezeigt.
- Das Portal wird mit den hinterlegten Anmeldedaten in einem Internetbrowser geöffnet und Sie können wie gewohnt im Portal stöbern, Artikel suchen und einen Warenkorb zusammenstellen.
- Das Lieferantenportal stellt eine Funktion zum Senden des Warenkorbs über die die IDS-Schnittstelle an MOS'aik bereit.^[53] Warenkorbartikel können auf diese Weise direkt in den MOS'aik Vorgang übernommen werden.
Beispiele zum Einsatz finden Sie in Abschnitt 2.1.6, „Einsatz der Lieferantenportale“.
Aufruf des zugehörigen IDS-Produktkatalogs aus lieferantenseitigen Vorgängen (z.B. Bestellung).
Öffnen Sie einen lieferantenseitigen Vorgang und rufen Sie die Funktion Weitere Schritte > Plugins >> IDS Produktkatalog auf.
- Es wird eine Liste aller eingerichteten Lieferantenportale zur Auswahl angezeigt.
- Das Portal wird mit den hinterlegten Anmeldedaten in einem Internetbrowser geöffnet und Sie können wie gewohnt im Portal stöbern, Artikel suchen und einen Warenkorb zusammenstellen.
- Das Lieferantenportal stellt eine Funktion zum Senden des Warenkorbs über die die IDS-Schnittstelle an MOS'aik bereit.^[53]
  
  Warenkorbartikel können auf diese Weise direkt in den MOS'aik Vorgang übernommen werden.
Beispiele zum Einsatz finden Sie in Abschnitt 2.1.6, „Einsatz der Lieferantenportale“.
Aufruf von Artikelinformationen zu Artikeln einer Vorgangsgliederung aus kundenseitigen oder lieferantenseitigen Vorgängen.
Öffnen Sie einen Vorgang mit bereits zuvor aus einem Lieferantenportal eingefügten Artikeln, markieren Sie die gewünschte Artikelzeile und rufen Sie die Funktion Datensatz > Weitere Funktionen >> IDS Produktinformationen zum Artikel xxx auf.Damit wird die Internetseite des Lieferantenportals mit Informationen zum gewählten Artikel aufgerufen und angezeigt.Voraussetzungen für die korrekte Funktion des Artikel-Deeplink sind folgende:
- Der Artikel ist bereits in den MOS'aik Artikelstammdaten erfasst.
- Dem Artikel wurde in den Artikelstammdaten der Lieferantenkurzname zum Portal als Hauptlieferant zugeordnet.
- Der Artikel verweist mit dem Feld Nummer bzw. Artikelnummer der Artikelstammdaten auf die zugehörige Bestellnummer im Lieferantenportal.
Weitere Details finden Sie unter Abschnitt 2.1.6.2, „Anzeige von Produktdetails“.
Artikelsuche zur Lieferantenadresse
Öffnen Sie das Adressarbeitsblatt eines Lieferanten Stammdaten | Adressen | Adresse und rufen Sie die Funktion Weitere Schritte > Plugins >> IDS Produktkatalog auf.

Ab IDS Version 2.5 besteht die Möglichkeit einen oder mehrere Suchbegriffe direkt in MOS'aik einzugeben. Der Browser zeigt dann direkt die Suchergebnisse im Lieferantenportal an.

Mehr dazu unter Abschnitt 2.1.4.4, „IDS Artikelsuche“.
- Das Lieferantenportal wird im Internetbrowser geöffnet und Sie können wie gewohnt im Portal stöbern, Artikel suchen und einen Warenkorb zusammenstellen.
- Das Lieferantenportal stellt eine Funktion zum Senden des Warenkorbs über die die IDS-Schnittstelle an MOS'aik bereit.^[53]
  
  Warenkorbartikel können auf diese Weise direkt in den MOS'aik Vorgang und/oder in die MOS'aik Stammdaten übernommen werden.

Zur Kommunikation mit den Lieferantenportalen stehen in MOS'aik verschiedene Möglichkeiten zur Verfügung:

Internetbrowser für IDS-Portale	Einsatzfälle
Abbildung 2.4.	1	Sie verwenden den integrierten Internet-Browser (Standard) basierend auf Microsoft Edge®. Es können alle Lieferantenportale verwendet werden. Der Einsatz des integrierten MOS'aik Internetbrowsers erübrigt standardmäßig den Einsatz externer Browser. Über den Arbeitsbereich Allgemein \| Home \| Internet können Sie den integrierten MOS'aik-Internetbrowser aufrufen und über das blaue Fähnchen eine Liste der verfügbaren externen Artikel- und Leistungskataloge anzeigen. Bei Auswahl wird ggf. eine Liste einzelner Portale angezeigt. Durch einfache Auswahl eines Portals wird die zugehörige Seite aufgerufen (Details). Warenkörbe werden direkt aus dem Portal in den MOS'aik-Vorgang übernommen. Der Moser Application Server wird nicht verwendet. Abschnitt 2.1.4.1, „Einrichtung für den integrierten Internetbrowser“
	2	Sie verwenden ein System (ab Version 3.36) ohne den Moser Application Server und möchten Internet-Browser Google Chrome verwenden. Es werden nur ausgewählte Lieferantenportale unterstützt. Das IDS-Makro für die externe Anbindung des Browsers unterstützt aktuell die Lieferantenportale von Cordes & Graefe (GC) sowie J.W. Zander GmbH & Co. KG. Es wird lediglich der Internetbrowser Google Chrome unterstützt und es muss eine spezielle Browser-Erweiterung installiert werden. Der Moser Application Server wird nicht verwendet. Abschnitt 2.1.4.3, „Einrichtung externer Browser ohne Anwendungsserver“
	3	[Empfohlen] Sie verwenden ein hybrides System mit SQL-Datenbank (ab Version 4.41). Es können alle unterstützten Lieferantenportale und beliebige, aktuelle Internetbrowser verwendet werden. Warenkörbe werden über den Moser Application Server in der Mandantendatenbank abgelegt und können über die Funktion `Einfügen > Weitere >> Warenkorb einfügen...` anschließend in den Vorgang übernommen werden. Abschnitt 2.1.4.2, „Einrichtung für hybride Systeme“ (empfohlen)

Ablauf der Kommunikation mit IDS-Lieferantenportalen:

Ausgehend von einem MOS'aik-Vorgang rufen Sie eine der oben beschriebenen Portalfunktionen auf.
Falls vorhanden, erfolgt beim Aufruf einer IDS-Funktion mithilfe der Lieferantennummer aus dem Merkmal IDS Provider eine automatische Anmeldung und Anfrage im SHK-Connect Portal (siehe dazu auch DATANORM Web: SHK-Connect).

Das Portal liefert die erforderlichen Zugangsinformationen für das gewählte Lieferantenportal und aktualisiert (max. einmal täglich) das zugehörige Merkmal IDS URL.

Der Datenabruf vom Portal erfolgt verschlüsselt über das HTTPS-Protokoll.
Mit dem Merkmal IDS URL und Ihren persönlichen Zugangsdaten IDS Benutzername, IDS Kennwort sowie ggf. IDS Kundennummer erfolgt nun der Aufruf und die automatische Anmeldung am Portal des Lieferanten.

Suchen Sie Artikel und stellen Sie so ihren Warenkorb zusammen. Der Warenkorb kann anschließend an MOS'aik zurück übermittelt werden und die enthaltenen Artikel werden in den geöffneten Vorgang eingefügt und (abhängig von der Einstellung im Merkmal IDS Artikelverwaltung) in die Artikelstammdaten übernommen.

Weitere Details:

Generisches Plugin	Die IDS-Schnittstelle wird durch ein generisches Plugin bereitgestellt, das beliebige, dem IDS-Standard entsprechende Lieferantenportale unterstützt.
Hybrider Einsatz	Für den hybriden Einsatz der IDS-Schnittstelle in MOS'aik und 'allround' sind die Merkmale kompatibel.
Preisübernahme	Mit der Warenkorbübernahme werden Lieferant, Preis und Bestellnummer unabhängig von der Einstellung des Merkmals `IDS Artikelverwaltung` in den Vorgang eingefügt. Bereits vorhandene Einkaufskonditionen für entsprechende Stammartikel werden grundsätzlich aktualisiert (siehe Artikelverwaltung). 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.
Festpreise	Für bereits in den Stammdaten hinterlegte Artikel mit Festpreisen (VK1-5) wird beim Einfügen aus einem IDS-Warenkorb bei Auswahl der entsprechenden Kalkulationsart im Vorgang (z.B. VK2) der hinterlegte Festpreis zugeordnet.
Abholauftrag	Bei IDS-Warenkorbübergabe an ein Lieferantenportal wird ein beliebiger Versandtext mit dem Wort "Abholung" (siehe Registerkarte Anschrift der Vorgangseigenschaften) im Portal automatisch als "Abholauftrag" gekennzeichnet.
IDS-Warenkorbübergabe	Die Übermittlung von Warenkörben mit Artikeln, die in den MOS'aik Artikelstammdaten mit einer Auswahlsperre versehen sind, führt ggf. zu einem Fehler. Prüfen Sie deshalb zuvor die entsprechende Einstellung. Im Rahmen der IDS-Warenkorbübernahme wird die Lieferadresse des Vorgangs grundsätzlich nicht überschrieben. Bei IDS-Warenkorbübergabe an ein Lieferantenportal wird die Lieferadresse des Vorgangs nur übergeben, wenn diese nicht leer ist. Die Schnittstelle unterstützt die Verarbeitung von Formulardaten mit dem Encryption Type "multipart/form-data".

Nachfolgende Themen:

^[53]Die Beschriftung dieser Funktion hängt vom jeweiligen Lieferantenportal ab. Informieren Sie sich in der Dokumentation des Portals, welche Schaltfläche zur Übermittlung des Warenkorbs an die Handwerkersoftware verwendet wird.