Aktuelle Version vom 28. September 2026, 13:51 Uhr

IDSConnect

Mit IDS Connect tauscht OBS Warenkörbe mit dem Online-Shop Ihres Großhändlers aus, zum Beispiel mit GCOnline. Sie senden die Positionen einer Anfrage, eines Angebots, eines Auftrags oder einer Bestellung in den Shop, bearbeiten den Warenkorb dort und übernehmen Mengen und Einkaufspreise anschließend zurück in den Vorgang. Artikel, die OBS noch nicht kennt, legt es dabei automatisch an. Aus dem Artikelstamm heraus suchen Sie Artikel direkt im Shop.

Steckbrief
Format	IDS-Connect-XML
Übertragungsweg	Hinweg über Ihren Browser in den Shop, Rückweg über einen Webhook
Rückmeldungen	Warenkorb ✓ · Warenkorb mit Bestellung ✓
Modul	kostenpflichtig
Übersicht	Kostenpflichtige Module

Voraussetzungen

Das Modul IDS Connect ist freigeschaltet.
Der Großhändler ist als OpenMasterData-Lieferant eingerichtet, mit Kundennummer und IDS Adresse (siehe OpenMasterData).
Damit OBS neue Artikel anlegen kann, sind die Warengruppen des Großhändlers in den Übernahmeparametern zugeordnet.

Einrichtung

Tragen Sie beim OpenMasterData-Lieferanten Kundennummer, Benutzername und Passwort Ihres Shop-Zugangs ein. Die übrigen IDS-Felder sind mit Standardwerten vorbelegt. Den Webhook für den Rückweg richtet Ihr OBS-Betreuer ein.

Danach erscheint in den Positionen von Anfragen, Angeboten, Aufträgen und Bestellungen im Kontextmenü (rechte Maustaste) das Untermenü IDS Connect. Ist das Modul nicht freigeschaltet oder kein Lieferant mit IDS Adresse und Kundennummer eingerichtet, fehlt das Untermenü.

Konfiguration

Die folgenden Einstellungen gelten für alle IDS-Lieferanten. Ihr OBS-Betreuer richtet sie ein.

Einstellung	Standard	Bedeutung
`Adresse.Land`	D	Länderkennzeichen Ihrer Anschrift. Der Firmenstamm führt kein Land.
`Adresse.EMail`	leer	E-Mail-Adresse Ihrer Anschrift. Der Firmenstamm führt keine E-Mail-Adresse.
`Versand.AbholCodes`	leer	Versandarten, die als Abholung an den Shop gehen, mit Semikolon getrennt. Alle anderen gehen als Lieferung.
`Versand.Waehrung`	EUR	Währung des Warenkorbs als dreistelliger ISO-Code.
`Versand.MengeneinheitMapping`	gängige Einheiten	Zuordnung der OBS-Mengeneinheit zum Code des Shops in der Form `Einheit=Code`, mit Semikolon getrennt, z.B. `Stk=PCE;m=MTR`. Links steht die Nummer oder der Name der Mengeneinheit in OBS.
`Versand.MengeneinheitDefault`	PCE	Code für Mengeneinheiten, die in der Zuordnung fehlen.
`Hook.TimeoutMinuten`	30	So viele Minuten wartet OBS auf den Warenkorb aus dem Shop. Bei 0 wartet OBS ohne Zeitgrenze.
`Api.Protokoll.Debug`	N	Schreibt die übertragenen Daten vollständig in `DATA\DEBUG\IDS.TXT`. Zugangsdaten werden dabei unkenntlich gemacht.

HINWEIS: Stimmt die Zuordnung der Mengeneinheiten nicht, erhält der Großhändler zum Beispiel für Meterware einen Stückpreis. Prüfen Sie Versand.MengeneinheitMapping deshalb gegen Ihre Mengeneinheiten.

Bedienung

Warenkorb senden

Wählen Sie in den Positionen im Kontextmenü IDS Connect → Warenkorb senden.
Sind mehrere IDS-Lieferanten eingerichtet, wählen Sie den Großhändler. Vorbelegt ist bei Anfragen und Bestellungen der Lieferant des Vorgangs, bei Angeboten und Aufträgen der Lieferant, der in den Positionen am häufigsten vorkommt.
OBS zeigt alle Artikelpositionen. Markieren Sie die Positionen, die in den Warenkorb sollen: Leertaste markiert eine Position, F6 markiert alle oder keine, F2 sendet den Warenkorb.
Hat ein Angebot oder Auftrag eine abweichende Lieferadresse, fragt OBS, ob sie an den Großhändler gehen soll. Bei Nein geht die Ware an Ihre eigene Anschrift.
OBS öffnet den Shop mit dem Warenkorb in Ihrem Browser. Bearbeiten Sie den Warenkorb dort und geben Sie ihn an OBS zurück.

Vorbelegt sind die Positionen des gewählten Lieferanten. Nicht vorbelegt sind Positionen anderer Lieferanten, Alternativ- und Optionspositionen sowie Positionen mit der Menge 0.

Findet OBS für eine Position keine Artikelnummer des Großhändlers oder ist sie länger als 15 Zeichen, hebt der Dialog die Zeile gelb hervor und nennt den Grund in der Spalte Hinweis. Markieren Sie eine solche Position trotzdem, geht sie als Freitextposition mit ihrer Bezeichnung in den Warenkorb.

Mussten beim Senden Angaben entfallen, zum Beispiel eine zu lange Vorgangsnummer, zählt OBS sie nach dem Senden auf.

Warten auf den Shop

Während OBS auf den Warenkorb wartet, steht in den Positionen „Warte auf Antwort von <Lieferant> …“. Sie können dabei in OBS weiterarbeiten.

Im Untermenü IDS Connect erscheint solange der Eintrag Warten abbrechen.
Nach der in Hook.TimeoutMinuten eingestellten Zeit beendet OBS das Warten von selbst und meldet das.
Senden Sie einen weiteren Warenkorb, während OBS noch wartet, fragt OBS vorher nach. Der erste Warenkorb kann dann nicht mehr zurückkommen.
Schließen Sie die Positionen, während OBS wartet, fragt OBS ebenfalls nach. Ein danach zurückgegebener Warenkorb geht verloren.

Warenkorb übernehmen

Kommt der Warenkorb aus dem Shop zurück, öffnet OBS den Dialog IDS Connect - Warenkorb uebernehmen. Je Zeile sehen Sie Menge und Einkaufspreis alt und neu, den Listenpreis, den Artikel, den Status und Hinweise des Shops.

Status	Bedeutung	Vorbelegt
zugeordnet	Die Zeile gehört zu einer gesendeten Position. OBS aktualisiert dort Menge und Einkaufspreis.	✓
neu	Der Artikel stand nicht im gesendeten Warenkorb. OBS fügt ihn als neue Position an.	✓
anderer Artikel	Der Shop liefert einen anderen Artikel als gesendet, etwa einen Nachfolgeartikel. OBS stellt die Position nicht auf den anderen Artikel um.	–
nicht eindeutig	Der Shop hat mehrere Positionen zu einer zusammengefasst, oder der Artikel steht mehrfach im Vorgang.	–

Zeilen mit der Menge 0 sind ebenfalls nicht vorbelegt. Prüfen Sie die nicht vorbelegten Zeilen und passen Sie die Positionen bei Bedarf von Hand an.

Leertaste markiert eine Zeile, F6 markiert alle oder keine, F2 übernimmt die markierten Zeilen. OBS rechnet die Gesamtpreise der geänderten Positionen neu. Staffelpreise ermittelt es dabei nicht neu.

Kennt OBS den Artikel einer neuen Zeile noch nicht, holt es die Artikeldaten über OpenMasterData und legt den Artikel an. Liefert OpenMasterData für einen Artikel keine Daten, nennt OBS ihn in einer Meldung und übernimmt diese Zeile nicht. Das passiert, wenn der Artikel dort nicht bekannt ist oder die Artikelpflege gerade läuft.

Warenkorb empfangen

IDS Connect → Warenkorb empfangen öffnet den Shop, ohne Positionen mitzuschicken. Stellen Sie den Warenkorb im Shop zusammen und geben Sie ihn an OBS zurück. Im Übernahmedialog sind dann alle Zeilen neu.

Artikel im Shop öffnen

IDS Connect → Artikel im Shop oeffnen zeigt den Artikel der aktuellen Position im Shop. Dafür braucht OBS die Artikelnummer des Großhändlers.

Im Artikelstamm

Kontextmenü der Artikelliste mit den IDS-Einträgen

Im Kontextmenü der Artikelliste stehen zwei Einträge:

Suche Artikel über IDS zeigt den markierten Artikel im Shop.
Suche Suchbegriff über IDS sucht im Shop nach einem Suchbegriff. Artikel, die Sie dort finden, übernehmen Sie in den OpenMasterData-Stamm. OBS legt sie dann an.

Übertragener Inhalt

Vom Vorgang in den Shop

Angabe	Übertragen	Hinweis
Ihre Anschrift	✓	aus dem Firmenstamm, Land und E-Mail aus der Konfiguration
Ihre Kundennummer beim Großhändler	✓
Lieferadresse des Vorgangs	✓	Ist keine hinterlegt, geht Ihre eigene Anschrift. Bei Angeboten und Aufträgen fragt OBS vorher nach.
Vorgangsnummer	✓	höchstens 15 Zeichen, sonst entfällt sie mit Hinweis
Liefertermin	✓	nur, wenn im Vorgang eingetragen
Lieferung oder Abholung	✓	nach `Versand.AbholCodes`
Kommission	✓	Projektnummer des Vorgangs, sonst der Betreff
Artikelnummer des Großhändlers	✓	Bestellnummer der Position, sonst aus den Einkaufsdaten des Artikels. Höchstens 15 Zeichen.
EAN und Herstellernummer	✓	wenn am Artikel gepflegt
Menge und Mengeneinheit	✓	Einheit nach `Versand.MengeneinheitMapping`
Kurz- und Langtext	✓
Positionsnummer	✓	dient der Zuordnung auf dem Rückweg
Preise	–	Der Shop ermittelt die Preise selbst.

Vom Shop in den Vorgang

Angabe	Übertragen	Hinweis
Menge	✓
Einkaufspreis	✓	je Stück, eine abweichende Preiseinheit rechnet OBS um. In Anfragen und Bestellungen auch als Positionspreis.
Verkaufspreis	–	In Angeboten und Aufträgen bleibt der Positionspreis unverändert.
Neue Artikel	✓	als neue Position, mit dem Langtext aus dem Shop
Auftragsnummer des Großhändlers	✓	bei der Rückgabe mit Bestellung, im Vorgangskopf
Listenpreis	–	nur Anzeige im Übernahmedialog
Hinweise und Fehlermeldungen des Shops	–	nur Anzeige im Übernahmedialog
Texte bestehender Positionen	–
Mengeneinheit	–
Zuschlag	–
Mehrwertsteuer	–	OBS rechnet mit dem Steuerschlüssel des Artikels.

Siehe auch

OpenMasterData – Zugang zum Großhändler einrichten
Kostenpflichtige Module – Übersicht aller kostenpflichtigen Module

@@ Zeile 1: / Zeile 1: @@
 {{Vorlage:Kostenpflichtige Module}}
 {{Seitentyp|Schnittstelle}}
 = IDSConnect =
@@ Zeile 47: / Zeile 48: @@
 {{Hinweis|Stimmt die Zuordnung der Mengeneinheiten nicht, erhält der Großhändler zum Beispiel für Meterware einen Stückpreis. Prüfen Sie <code>Versand.MengeneinheitMapping</code> deshalb gegen Ihre Mengeneinheiten.}}
+== Bedienung ==
+=== Warenkorb senden ===
+# Wählen Sie in den Positionen im Kontextmenü '''IDS Connect → Warenkorb senden'''.
+# Sind mehrere IDS-Lieferanten eingerichtet, wählen Sie den Großhändler. Vorbelegt ist bei Anfragen und Bestellungen der Lieferant des Vorgangs, bei Angeboten und Aufträgen der Lieferant, der in den Positionen am häufigsten vorkommt.
+# OBS zeigt alle Artikelpositionen. Markieren Sie die Positionen, die in den Warenkorb sollen: {{Key|Leertaste}} markiert eine Position, {{F6}} markiert alle oder keine, {{F2}} sendet den Warenkorb.
+# Hat ein Angebot oder Auftrag eine abweichende Lieferadresse, fragt OBS, ob sie an den Großhändler gehen soll. Bei ''Nein'' geht die Ware an Ihre eigene Anschrift.
+# OBS öffnet den Shop mit dem Warenkorb in Ihrem Browser. Bearbeiten Sie den Warenkorb dort und geben Sie ihn an OBS zurück.
+Vorbelegt sind die Positionen des gewählten Lieferanten. Nicht vorbelegt sind Positionen anderer Lieferanten, Alternativ- und Optionspositionen sowie Positionen mit der Menge 0.
+Findet OBS für eine Position keine Artikelnummer des Großhändlers oder ist sie länger als 15 Zeichen, hebt der Dialog die Zeile gelb hervor und nennt den Grund in der Spalte '''Hinweis'''. Markieren Sie eine solche Position trotzdem, geht sie als Freitextposition mit ihrer Bezeichnung in den Warenkorb.
+Mussten beim Senden Angaben entfallen, zum Beispiel eine zu lange Vorgangsnummer, zählt OBS sie nach dem Senden auf.
+=== Warten auf den Shop ===
+Während OBS auf den Warenkorb wartet, steht in den Positionen „Warte auf Antwort von <Lieferant> …“. Sie können dabei in OBS weiterarbeiten.
+* Im Untermenü '''IDS Connect''' erscheint solange der Eintrag '''Warten abbrechen'''.
+* Nach der in <code>Hook.TimeoutMinuten</code> eingestellten Zeit beendet OBS das Warten von selbst und meldet das.
+* Senden Sie einen weiteren Warenkorb, während OBS noch wartet, fragt OBS vorher nach. Der erste Warenkorb kann dann nicht mehr zurückkommen.
+* Schließen Sie die Positionen, während OBS wartet, fragt OBS ebenfalls nach. Ein danach zurückgegebener Warenkorb geht verloren.
+=== Warenkorb übernehmen ===
+Kommt der Warenkorb aus dem Shop zurück, öffnet OBS den Dialog '''IDS Connect - Warenkorb uebernehmen'''. Je Zeile sehen Sie Menge und Einkaufspreis alt und neu, den Listenpreis, den Artikel, den Status und Hinweise des Shops.
+{| class="wikitable"
+! Status !! Bedeutung !! Vorbelegt
+|-
+| ''zugeordnet'' || Die Zeile gehört zu einer gesendeten Position. OBS aktualisiert dort Menge und Einkaufspreis. || ✓
+|-
+| ''neu'' || Der Artikel stand nicht im gesendeten Warenkorb. OBS fügt ihn als neue Position an. || ✓
+|-
+| ''anderer Artikel'' || Der Shop liefert einen anderen Artikel als gesendet, etwa einen Nachfolgeartikel. OBS stellt die Position nicht auf den anderen Artikel um. || –
+|-
+| ''nicht eindeutig'' || Der Shop hat mehrere Positionen zu einer zusammengefasst, oder der Artikel steht mehrfach im Vorgang. || –
+|}
+Zeilen mit der Menge 0 sind ebenfalls nicht vorbelegt. Prüfen Sie die nicht vorbelegten Zeilen und passen Sie die Positionen bei Bedarf von Hand an.
+{{Key|Leertaste}} markiert eine Zeile, {{F6}} markiert alle oder keine, {{F2}} übernimmt die markierten Zeilen. OBS rechnet die Gesamtpreise der geänderten Positionen neu. Staffelpreise ermittelt es dabei nicht neu.
+Kennt OBS den Artikel einer neuen Zeile noch nicht, holt es die Artikeldaten über OpenMasterData und legt den Artikel an. Liefert OpenMasterData für einen Artikel keine Daten, nennt OBS ihn in einer Meldung und übernimmt diese Zeile nicht. Das passiert, wenn der Artikel dort nicht bekannt ist oder die Artikelpflege gerade läuft.
+=== Warenkorb empfangen ===
+'''IDS Connect → Warenkorb empfangen''' öffnet den Shop, ohne Positionen mitzuschicken. Stellen Sie den Warenkorb im Shop zusammen und geben Sie ihn an OBS zurück. Im Übernahmedialog sind dann alle Zeilen ''neu''.
+=== Artikel im Shop öffnen ===
+'''IDS Connect → Artikel im Shop oeffnen''' zeigt den Artikel der aktuellen Position im Shop. Dafür braucht OBS die Artikelnummer des Großhändlers.
+=== Im Artikelstamm ===
+[[Datei:IDSArtikel.png|mini|Kontextmenü der Artikelliste mit den IDS-Einträgen|ohne]]
+Im Kontextmenü der Artikelliste stehen zwei Einträge:
+* '''Suche Artikel über IDS''' zeigt den markierten Artikel im Shop.
+* '''Suche Suchbegriff über IDS''' sucht im Shop nach einem Suchbegriff. Artikel, die Sie dort finden, übernehmen Sie in den OpenMasterData-Stamm. OBS legt sie dann an.
 == Übertragener Inhalt ==
@@ Zeile 106: / Zeile 163: @@
 | Mehrwertsteuer || – || OBS rechnet mit dem Steuerschlüssel des Artikels.
 |}
-== Besonderheiten ==
-=== Warenkorb senden ===
-# Wählen Sie in den Positionen im Kontextmenü '''IDS Connect → Warenkorb senden'''.
-# Sind mehrere IDS-Lieferanten eingerichtet, wählen Sie den Großhändler. Vorbelegt ist bei Anfragen und Bestellungen der Lieferant des Vorgangs, bei Angeboten und Aufträgen der Lieferant, der in den Positionen am häufigsten vorkommt.
-# OBS zeigt alle Artikelpositionen. Markieren Sie die Positionen, die in den Warenkorb sollen: {{Key|Leertaste}} markiert eine Position, {{F6}} markiert alle oder keine, {{F2}} sendet den Warenkorb.
-# Hat ein Angebot oder Auftrag eine abweichende Lieferadresse, fragt OBS, ob sie an den Großhändler gehen soll. Bei ''Nein'' geht die Ware an Ihre eigene Anschrift.
-# OBS öffnet den Shop mit dem Warenkorb in Ihrem Browser. Bearbeiten Sie den Warenkorb dort und geben Sie ihn an OBS zurück.
-Vorbelegt sind die Positionen des gewählten Lieferanten. Nicht vorbelegt sind Positionen anderer Lieferanten, Alternativ- und Optionspositionen sowie Positionen mit der Menge 0.
-Findet OBS für eine Position keine Artikelnummer des Großhändlers oder ist sie länger als 15 Zeichen, hebt der Dialog die Zeile gelb hervor und nennt den Grund in der Spalte '''Hinweis'''. Markieren Sie eine solche Position trotzdem, geht sie als Freitextposition mit ihrer Bezeichnung in den Warenkorb.
-Mussten beim Senden Angaben entfallen, zum Beispiel eine zu lange Vorgangsnummer, zählt OBS sie nach dem Senden auf.
-=== Warten auf den Shop ===
-Während OBS auf den Warenkorb wartet, steht in den Positionen „Warte auf Antwort von <Lieferant> …“. Sie können dabei in OBS weiterarbeiten.
-* Im Untermenü '''IDS Connect''' erscheint solange der Eintrag '''Warten abbrechen'''.
-* Nach der in <code>Hook.TimeoutMinuten</code> eingestellten Zeit beendet OBS das Warten von selbst und meldet das.
-* Senden Sie einen weiteren Warenkorb, während OBS noch wartet, fragt OBS vorher nach. Der erste Warenkorb kann dann nicht mehr zurückkommen.
-* Schließen Sie die Positionen, während OBS wartet, fragt OBS ebenfalls nach. Ein danach zurückgegebener Warenkorb geht verloren.
-=== Warenkorb übernehmen ===
-Kommt der Warenkorb aus dem Shop zurück, öffnet OBS den Dialog '''IDS Connect - Warenkorb uebernehmen'''. Je Zeile sehen Sie Menge und Einkaufspreis alt und neu, den Listenpreis, den Artikel, den Status und Hinweise des Shops.
-{| class="wikitable"
-! Status !! Bedeutung !! Vorbelegt
-|-
-| ''zugeordnet'' || Die Zeile gehört zu einer gesendeten Position. OBS aktualisiert dort Menge und Einkaufspreis. || ✓
-|-
-| ''neu'' || Der Artikel stand nicht im gesendeten Warenkorb. OBS fügt ihn als neue Position an. || ✓
-|-
-| ''anderer Artikel'' || Der Shop liefert einen anderen Artikel als gesendet, etwa einen Nachfolgeartikel. OBS stellt die Position nicht auf den anderen Artikel um. || –
-|-
-| ''nicht eindeutig'' || Der Shop hat mehrere Positionen zu einer zusammengefasst, oder der Artikel steht mehrfach im Vorgang. || –
-|}
-Zeilen mit der Menge 0 sind ebenfalls nicht vorbelegt. Prüfen Sie die nicht vorbelegten Zeilen und passen Sie die Positionen bei Bedarf von Hand an.
-{{Key|Leertaste}} markiert eine Zeile, {{F6}} markiert alle oder keine, {{F2}} übernimmt die markierten Zeilen. OBS rechnet die Gesamtpreise der geänderten Positionen neu. Staffelpreise ermittelt es dabei nicht neu.
-Kennt OBS den Artikel einer neuen Zeile noch nicht, holt es die Artikeldaten über OpenMasterData und legt den Artikel an. Liefert OpenMasterData für einen Artikel keine Daten, nennt OBS ihn in einer Meldung und übernimmt diese Zeile nicht. Das passiert, wenn der Artikel dort nicht bekannt ist oder die Artikelpflege gerade läuft.
-=== Warenkorb empfangen ===
-'''IDS Connect → Warenkorb empfangen''' öffnet den Shop, ohne Positionen mitzuschicken. Stellen Sie den Warenkorb im Shop zusammen und geben Sie ihn an OBS zurück. Im Übernahmedialog sind dann alle Zeilen ''neu''.
-=== Artikel im Shop öffnen ===
-'''IDS Connect → Artikel im Shop oeffnen''' zeigt den Artikel der aktuellen Position im Shop. Dafür braucht OBS die Artikelnummer des Großhändlers.
-=== Im Artikelstamm ===
-[[Datei:IDSArtikel.png|mini|rechts|Kontextmenü der Artikelliste mit den IDS-Einträgen]]
-Im Kontextmenü der Artikelliste stehen zwei Einträge:
-* '''Suche Artikel über IDS''' zeigt den markierten Artikel im Shop.
-* '''Suche Suchbegriff über IDS''' sucht im Shop nach einem Suchbegriff. Artikel, die Sie dort finden, übernehmen Sie in den OpenMasterData-Stamm. OBS legt sie dann an.
 == Siehe auch ==
 * [[OBS/Kostenpflichtige Module/OpenMasterData|OpenMasterData]] – Zugang zum Großhändler einrichten
 * [[Kostenpflichtige Module|Kostenpflichtige Module]] – Übersicht aller kostenpflichtigen Module