Wie binde ich meinen Großhändler-Shop per IDS oder OCI an?

Viele Großhändler haben einen Online-Shop mit deinen Konditionen. Über IDS-Connect oder OCI öffnest du diesen Shop direkt aus WOODPLAN, stellst dort deinen Warenkorb zusammen und holst die Positionen mit Preisen in deine Lieferantenbestellung zurück. Du tippst keine Artikelnummern mehr ab.

IDS oder OCI: was ist der Unterschied?

Beide Schnittstellen erfüllen denselben Zweck: Du arbeitest im Shop des Großhändlers und bekommst den Warenkorb zurück in WOODPLAN. Welche du nutzt, bestimmt dein Großhändler, denn er muss sie in seinem Shop anbieten.

• IDS-Connect (Version 2.5) ist der Standard im Sanitär-, Heizungs- und Elektrohandel. Du hinterlegst Kundennummer, Benutzername und Passwort. WOODPLAN kann damit den Shop öffnen, deinen Warenkorb an den Shop senden und bei Artikeln Preis und Verfügbarkeit abfragen.
• OCI (Open Catalog Interface) ist ein Punchout-Verfahren, das viele Shops anbieten. Du hinterlegst die Shop-Adresse, Benutzername und Passwort. WOODPLAN öffnet den Shop, du stellst den Warenkorb zusammen und der Shop schickt ihn zurück. OCI gibt es nur in der Lieferantenbestellung.

Frag deinen Großhändler nach den Zugangsdaten für die jeweilige Schnittstelle. Es sind meist andere Daten als dein normaler Shop-Login.

Schritt 1: Zugangsdaten beim Lieferanten eintragen

1. Öffne den Lieferanten unter Einkauf › Lieferanten. Der Reiter IDS-Connect erscheint, sobald der Lieferant gespeichert ist.
2. Wähle oben bei Warenkorb-Schnittstelle für Bestellungen, was in der Bestellung angeboten wird:
   • Automatisch (IDS, sonst OCI): Ist eine IDS-Kundennummer hinterlegt, nutzt WOODPLAN IDS. Fehlt sie und ist eine OCI-Adresse eingetragen, nutzt WOODPLAN OCI.
   • IDS-Connect oder OCI: erzwingt genau diese Schnittstelle.
3. Für IDS füllst du die Karte IDS-Connect 2.5 aus: IDS-Endpunkt (die Shop-Adresse deines Großhändlers aus der Liste), IDS Kundennummer, IDS Benutzername und IDS Passwort. Findest du deinen Großhändler nicht in der Liste, bleibt der Endpunkt auf Manuell / Kein Endpunkt. Dann kann WOODPLAN die Shop-Adresse nur nutzen, wenn sie bereits am Lieferanten hinterlegt ist, sonst meldet es beim Öffnen des Shops, dass keine Shop-URL vorhanden ist.
4. Für OCI füllst du die Karte OCI (Open Catalog Interface) aus: OCI-Shop-Adresse, OCI Benutzername und OCI Passwort. Die Adresse darf Zusatzparameter enthalten, die der Shop verlangt.
5. Speichere den Lieferanten. Am Kartenkopf steht danach Zugangsdaten hinterlegt, am Reiter erscheint bei IDS das Kennzeichen Konfiguriert.

Verbindung testen (nur IDS)

Klicke in der IDS-Karte auf Verbindung testen. WOODPLAN prüft den Shop und zeigt dir die Shop-URL, die erkannte IDS-Version, ob die Versionsabfrage (SV) und die Login-Info (LI) antworten sowie die verwendete Kundennummer und den Benutzer. Bei Erfolg steht dort Verbindung erfolgreich, sonst Verbindung fehlgeschlagen mit einer Kurzbeschreibung.

Schritt 2: Im Shop einkaufen und Positionen übernehmen

1. Öffne oder lege eine Lieferantenbestellung für diesen Lieferanten an und speichere sie. Unter der Positionstabelle erscheint je nach Schnittstelle der Button Im Shop zusammenstellen (IDS) oder Im Shop zusammenstellen (OCI).
2. Klicke auf den Button. WOODPLAN meldet dich mit deinen hinterlegten Zugangsdaten im Shop an.
3. Stelle im Shop deinen Warenkorb zusammen und schicke ihn über die Funktion des Shops zurück an WOODPLAN.
4. Du landest wieder in der Bestellung. Dort öffnet sich das Fenster Positionen aus Shop übernehmen mit allen empfangenen Positionen. Hier prüfst du alles, bevor etwas in die Bestellung wandert.
5. Entferne das Häkchen bei Positionen, die du nicht übernehmen willst, und klicke auf Positionen übernehmen. Mit Verwerfen wirfst du den ganzen Warenkorb weg.

Warenkorb aus WOODPLAN an den Shop senden (nur IDS)

Auch der umgekehrte Weg geht: Hast du die Bestellung schon in WOODPLAN erfasst, sendest du sie mit dem Warenkorb-Symbol oben in der Bestellung (Hinweis An Lieferanten-Warenkorb senden (IDS)) in den Shop. Dort bestellst du fertig. Pro Position schickt WOODPLAN die Lieferanten-Artikelnummer, EAN, Hersteller-Nummer, Menge, Einheit und den Kurztext mit, außerdem die Bestellnummer als Kommission.

Wie ordnet WOODPLAN die Artikel zu?

Im Fenster Positionen aus Shop übernehmen prüft WOODPLAN jede Position gegen deine Artikelstammdaten, und zwar in dieser Reihenfolge:

1. GH-Art.-Nr.: die Lieferanten-Artikelnummer, die du am Artikel im Reiter Lieferanten beim Lieferanten eingetragen hast.
2. EAN des Artikels.
3. Herst.-Nr.: die Hersteller-Artikelnummer des Artikels.
4. Art.-Nr.: die Artikelnummer im Artikelstamm.
5. Als letzter Versuch die GH-Art.-Nr. bei einem anderen Lieferanten.

Eine erkannte Position zeigt Gefunden mit Artikelnummer, Name und dem Grund der Zuordnung. Ist dein hinterlegter Einkaufspreis um mehr als einen Cent anders als der Preis aus dem Shop, wird dein Einkaufspreis farbig hervorgehoben. Eine nicht erkannte Position zeigt Kein Artikel und würde ohne Verknüpfung angelegt. Mit dem Button Anlegen erzeugst du direkt aus den Shop-Daten einen neuen Artikel (dafür brauchst du das Recht product.create), danach ist die Position verknüpft.

Preise und Einheiten

• In der Spalte EP steht der Preis pro Einheit. Gilt der Shop-Preis für mehrere Einheiten (zum Beispiel pro 100 Stück), rechnet WOODPLAN ihn auf den Preis pro Einheit herunter. Prüfe den EP trotzdem im Bestätigungsfenster, bevor du die Positionen übernimmst.
• Die Gesamtsumme der Position ist Menge mal Einzelpreis. Nach dem Übernehmen berechnet WOODPLAN die Netto-Summe der Bestellung neu.
• Die Mengeneinheit des Shops (zum Beispiel Stück, Meter, Kilogramm, Liter, Quadrat- und Kubikmeter) wird in die WOODPLAN-Einheit umgesetzt. Kennt WOODPLAN die Einheit nicht, wird Stück verwendet. Kontrolliere deshalb Einheit und Menge vor dem Übernehmen.

Wo IDS sonst noch hilft

• Artikel › Reiter Lieferanten (Recht product.read): Bei Lieferanten mit IDS-Zugang siehst du die Spalten IDS-Preis und Verfügbarkeit (verfügbar, teilweise, nicht verfügbar, bestellt, dazu Lieferzeit und Bestand, wenn der Shop sie liefert). Die Werte werden zwischengespeichert und mit ihrem Alter angezeigt. Pro Zeile gibt es die Symbole Preis & Verfügbarkeit abfragen, Artikelsuche (AS), In Warenkorb (WKS) und Artikelseite (ADL). Mit Alle IDS-Preise abfragen fragst du alle Lieferanten des Artikels auf einmal ab.
• Verkauf › Angebote und Verkauf › Aufträge (Rechte sales.quotation.read bzw. sales.order.read): Bei Gruppen im Angebot bzw. Auftrag gibt es den Button IDS Shop, außerdem im Dialog der Materialliste. Du wählst einen Lieferanten mit IDS-Zugang, wirst in den Shop geleitet und der Warenkorb kommt zur Prüfung zurück. Im Angebot erscheint dafür ebenfalls das Fenster Positionen aus Shop übernehmen. OCI gibt es in Angeboten und Aufträgen nicht.

Fehlersuche

• Der Button Im Shop zusammenstellen fehlt: Die Bestellung muss gespeichert sein und der Lieferant braucht Zugangsdaten. Bei Automatisch erscheint der OCI-Button nur, wenn keine IDS-Kundennummer hinterlegt ist. Sind beide hinterlegt und du willst OCI, stelle die Warenkorb-Schnittstelle auf OCI.
• Meldung Keine Shop-URL: Beim Lieferanten ist kein IDS-Endpunkt gewählt und keine Shop-Adresse hinterlegt. Wähle den Endpunkt deines Großhändlers.
• Meldung Kein IDS Connect konfiguriert: Die IDS-Kundennummer fehlt.
• Meldung Keine gültige OCI-Shop-Adresse: Die OCI-Shop-Adresse fehlt oder ist keine vollständige Internetadresse (sie beginnt mit https://).
• Verbindungstest schlägt fehl: Prüfe Endpunkt, Kundennummer, Benutzername und Passwort. Lass dir die Daten notfalls vom Großhändler bestätigen und frag, ob IDS-Connect für dein Konto freigeschaltet ist.
• Nach dem Shop kommt die Meldung, der Warenkorb konnte nicht verarbeitet werden: Der Shop hat keine lesbaren Positionen zurückgeschickt. Versuche es erneut und schicke den Warenkorb über die Rückgabe-Funktion des Shops. Die Rückgabe gilt nur einmal, öffne den Shop für einen neuen Versuch bitte neu über den Button in der Bestellung.
• Kein Artikel erkannt: Hinterlege am Artikel die Lieferanten-Art.-Nr., EAN oder Hersteller-Nummer, oder lege ihn direkt im Fenster mit Anlegen an.
• Keine Berechtigung: Für das Öffnen des Shops brauchst du purchase.order.read, für Positionen übernehmen und Verwerfen purchase.order.update.

Gut zu wissen

• Die Zugangsdaten gelten je Lieferant.
• Es wird nichts ohne dein Zutun in die Bestellung geschrieben. Erst Positionen übernehmen legt die Positionen an.
• Der Lieferanten-Reiter zeigt neben IDS und OCI auch die Karte Open Masterdata. Die ist nur eine Hinterlegung der Zugangsdaten mit Prüfen-Button; der Abruf der Artikeldaten ist dort laut Hinweis noch nicht angebunden.
• Wie du E-Mails und Bankkonten einrichtest, steht hier: E-Mail-Postfach einrichten und Bankkonto verknüpfen.