Aktuelle Version vom 2. November 2023, 13:03 Uhr

Aufgrund der Anpassungen in der Datenstruktur des Shops gibt es zum VShop 4 einige Unterschiede in Funkionalität der eigenen Artikel. Die für OBS-Benutzer aufälligste Änderung ist der Wegfall der Zuornung zu einer Kategorie. Wo Artikel im VShop noch eine Kategorie benötigten, um angezeigt zu werden, können Artikel im brShop24 auch anderweitig für Kunden sichtbar bzw. unsichtbar gemacht werden. Aktuell gibt es in der Schnittstelle daher keine Möglichkeit Artikel in die Kategoriestruktur von Büroring einzupflegen. Außerdem gibt es beim Export nicht mehr die Frage in welchen Katalog exportiert werden soll. Die Kataloge führten in der Vergangenheit zu Problemen bei der Preispflege aus dem OBS heraus, da die Artikelnummer nicht eindeutig sein mussten. Statt die Artikel an Kataloge zu binden, werden diese jetzt nach Lager aufgeteilt. Jedes Lager hat zudem einen Partner zugeteilt. In der Schnittstellenkonfiguration vom OBS haben Sie die Möglichkeit den Partner mit einem Lieferanten zu verknüpfen. Bisher ist dies jedoch nur für Artikel, welche durch den Büroring gepflegt werden (z. B. für Büroring Zentrallager) spannend. Für eigene Artikel ist noch eine Sammelzuordnung für ganze Lieferanten geplant. Diese Funktionalität folgt jedoch zu einem späteren Zeitpunkt. Für die Zuordnung eigener Artikel bedeutet dies jedoch, dass Sie mindestens ein Lager zur Pflege eigener Artikel definiert haben müssen. Über die Shop-Einstellungen eines Artikels können Sie dann den Artikel einem oder mehreren Lagern zuweisen (Details siehe Depot-Einstellungen).

Durch Pflichtangaben für die API sind im Vergleich zum VShop zusätzliche Daten zu hinterlegen. Alle Daten, welche im VShop exportiert werden konnten, werden mit der Schnittstelle bereits exportiert.

Aktueller Umfang Datenexport

Stand: 14.04.2023

Exportierbare Daten	Hinweis	enthalten ab Version
Artikelnummer	Pflichtfeld Kann unabhängig von OBS-Artikelnummer definiert werden, bis Artikel im Shop übertragen wurde	004124
Lager/Depot	Pflichtangabe Änderbar bis zur Übertragung in den Shop. Pflege muss im OBS auf Eigene Artikel" stehen.	004124
API-ID	wird generiert oder aus dem Shop übernommen (siehe Depot-Zuordnung defnieren)	004124
Hersteller	Zuordnung Artikel-Shop-Einstellungen Vordefinition im Shop	004124
Marke	Zuordnung Artikel-Shop-Einstellungen Vordefinition im Shop	004124
Herstellerartikelnummer	Herstellernummer aus dem Artikelstamm	004124
Verpackungsmenge	Mengenangabe aus Verpackungsdefinition	004124
Artikeltyp	Artikel weitere Typen aktuell nicht unterstützt	004124
Aktiv	Artikel wird als aktiv übertragen, wenn im OBS-Artikelstamm aktiv und Pflegeeinstellungen auf Ja	004124
Einheit	Überträgt zugeordneten Wert für Feld Einheit aus dem Artikelstamm oder Stück, wenn keine Zuordnung vorhanden. Vordefinierte Einheiten aus dem Shop Zuordnung über die Schnittstelle (Konfiguration)	004124
Steuersatz	Überträgt zugeordneten Wert für Feld MwST-Schlüssel aus dem Artikelstamm oder Normalsatz (>= 16 %) order ermäßigter Satz (< 16 %), wenn keine Zuordnung vorhanden. Vordefinierte Steuersätze aus dem Shop Zuordnung über die Schnittstelle (Konfiguration)	004124
Gruppe Artikelbezeichnung	Zuordnung Artikel-Shop-Einstellungen der vordefinierten Gruppen aus dem Shop	004124
Gruppe Produkttyp	Zuordnung Artikel-Shop-Einstellungen der vordefinierten Gruppen aus dem Shop	004124
Verkaufspreise	VK1 für Menge 1 und Staffelpreise Gruppe 1	004124
Anzeigename	alternative Shopbezeichnung (Artikel-Shop-Einstellungen); ist keine alternative Bezeichnung angegeben, dass wird Name 1 und Name 2 aus dem Artikelstamm zusammen genommen.	004124
Anreißer/Kurztext	Zugeordneter Shop-Kurztext	004124
Beschreibung/Langtext	Zugeordneter Shop-Langtext	004124
Suchbegriffe	Felder Schlüsselworte in Webshop-Einstellungen und Lager-Zuordnung HINWEIS: Shop erwartet die einzelnen Werte/Suchworte mit Kommatrennung!	004126
EAN/GTIN	EANs aus dem Artikelstamm	004126
Bilder	Zugeordnete Bilder aus den Artikel-Shop-Einstellungen.	004127
Grundpreis	Grundpreis auf 1 Kilogramm, Meter, Quadratmeter, Kubikmeter oder Liter. Umrechnung bezogen auf die Angaben in den Feldern G-Faktor und G-Einheit im Reiter 2 des Artikelstamms.	004271
Lagerstatus / -bestand	Lagerstatus für Artikel ist in den Webshop-Einstellungen des Artikels einzutragen. Die Ermittlung des Bestands ist über das Lager zu definieren und ist abhängig vom Lieferstatus. Der Bestand wird nur exportiert, wenn der Lieferstatus auf Lagerartikel oder Auslaufartikel steht.	004271
Bestellmengen	Angabe von Mindest- und Maximumbestellmenge sowie die mögliche Schrittweise Erhöhung.	004419
Merkmale	Zuordnung von Artikelmerkmalen für Export. Dazu wird über die Merkmalsverwaltung das Merkmal der Shop-Schnittstelle zugeordnet. Ist im Shop interessant für die Artikelsuche.	004419

geplante Erweiterungen

Erweiterung Bestandsübertragung, damit Bestand auch bei eigenem Lieferstatus übertragen werden kann.

Voraussetzungen und Vorbereitungen für Datenübertragung

Voraussetzungen

Um Artikel als eigene Artikel übertragen zu können, müssen bestimmte Voraussetzungen erfüllt sein. Diese sind über das Shop-Menü der Shop-Schnittstelle zu erledigen.
Verwaltung Shop-Schnittstellen: Menü: Stammdaten → I Schnittstellen → I - Internet-Shop

Definition importieren

Gehen Sie hier auf ihre brShop24-Schnittstelle und drücken F10 Menü. Führen Sie den Import der Shop-Definitionen aus: W Definitionen importieren.

Diese Funktion importiert diverse für die OBS-Pflege eigener Artikel und den anschließenden Artikelexport wichtige Definitionen aus dem Shop.

Lager und Partner (Pflichtangabe; API benötigt zu jeder Artikelnummer ein Lager)
Hersteller (Pflichtangabe; API erwartet zu jedem Artikel einen Hersteller)
Marken
Artikelbezeichnungsgruppen
Produkttypen
Mengeneinheiten

HINWEIS: Neue Definitionen müssen im Shop angelegt und dann ins OBS importiert werden

Shop-Lager für eigene Artikel

Es wird mindestens ein Shop-Lager (auch Depot) für eigene Artikel (Einstellungen Pflege im Shop-Lager) benötigt. In der Regel gibt es mindestens ein Lager für diese Zwecke bei der Installation des Shops. Bei Bedarf können Sie über den Adminbereich weitere Lager definieren.

Gehen Sie hier auf ihre brShop24-Schnittstelle und drücken F10 Menü. Öffnen Sie anschließend die Konfiguration/Einstellungen: X Konfiguration.

Als nächsten öffnen Sie das Zuordnungsmenü. Danach wählen Sie im Auswahlfenster den Punkt "L Lager und Lagerlieferanten"
F8 Zuord → L Lager und Lagerlieferanten

Lager für Artikel allgemein

Stellen Sie das gewünschte Lager in der Pflege auf "Eigene Artikel".
Auf Lagereintrag gehen → Ret Ändern → Pflege: "Eigene Artikel"

Lager für Artikel eines bestimmten Lieferanten

Wenn Sie planen relative viele Artikel eines Lieferanten in den Shop zu übertragen, können Sie ein Lager entsprechend für dieses Vorhaben einstellen.
Auf Lagereintrag gehen → Lieferant zuordnen per F6 Zuord (falls noch nicht gemacht) → Ret Ändern → Pflege: "Eigene Artikel" → Feld: "Bestellnummer"

HINWEIS: Aktuell hat dies nur die Funktionalität, dass beim Anlegen der Lagerzuordnung in den Webshop-Einstellungen des Artikels nach der Auswahl des Lagers die Bestellnummer des Lieferanten statt der OBS-Artikel als Lager-Artikelnummer vorbelegt wird.

Vorbereitungen

Mengeneinheiten

Pflegen Sie die Zuordnungen der Mengeneinheiten.

Verwaltung der Shop-Einheiten öffnen: F8 Zuord → E Einheiten

Die Liste zeigt die importierten Einheiten des Shops.
Zuordnung der OBS-Einheit zur Shop-Einheit: Ret Ändern → Feld Einheit setzen → F2 Speich.

Falls Sie Mengeneinheiten des Shops in der Liste vermissen, können Sie die Mengeneinheiten des Shops mit Einfg aktualisieren.

HINWEIS: Die Mengeneinheit ist eine Pflichtangabe in der API. OBS muss also bei der Artikelanlage eine Einheit übertragen. Die Zuordnung bezieht sich auf das Feld "Einheit" im ersten Reiter des OBS-Artikelstamms. Ist der dortigen Einheit keine Shop-Mengeneinheit zugeordnet, wird in der Schnittstelle die Einheit Stück (ST) verwendet.

optionale Vorbereitungen

Lagerbestand übertragen

Sollen für eigene Artikel die Lagerbestände übermittelt werden, so kann die Datengrundlage pro Lager in den Lager-Einstellungen definiert werden.

ACHTUNG: Sämtliche Definitionen werden zu einem Bestand summiert. Anschließend zieht OBS von dieser Summe den offenen Auftragsbestand ab, um so bereits "verplanten" Bestand nicht mit auszuweisen!

Lagerbestand wird nur bei Artikel übertragen, bei denen ein Lieferstatus mit aktiviertem Bestandsexport gesetzt ist. "Lagerartikel" mit einem ermittelten Bestand von 0, können automatisch einen anderen Lieferstatus erhalten oder gesperrt/deakvitiert werden. Die Deaktivierung in Abhängigkeit vom Bestand ändert nicht die Einstellungen im OBS!

Bei Stücklistenartikeln werden die Bestände der einzelnen Artikel mit der definierten Stücklistenmenge verrechnet. Der niedrigste errechnete Bestand bestimmt dann den Bestand des Stücklistenartikels.

Auf Lagereintrag gehen → Ret Ändern

Export Bestand Artikelstamm
Wird dieses Häkchen gesetzt, so übernimmt OBS den Bestand aus dem OBS-Artikelstamm im Datenexport der Artikel. Mögliche Lagerdefinitionen (Modul Mehrlager) unter F6 Bestand, welche unter Definition Bestandsermittlung aufgeführt sind, werden dabei ignoriert, da der Bestand im Artikelstamm der Summe aller Lager entspricht.
Definition Bestandsermittlung
Tabellarische Anzeige der aktuellen Definition mit Namen und Datenquelle.
Liste Bestandsdefinition für Lager
Zeigt die bisherigen Definitionen für das Lager an. Neue Definitionen können Sie mit Einfg hinzufügen. Einzelne oder markierte Definitionen lassen sich mit Entf löschen.
Auswahl Definition hinzufügen
Öffnet eine Auswahlliste für die jeweilige Quelle. Markieren Sie die gewünschten Quellen mit F5 und übernehmen Sie die Auswahl anschließend per F2.

Einstellungen und Zuordnungen für Artikel

Shop-Einstellungen

Liste der Webshop-Einstellungen eines Artikels:
Artikelstamm → Reiter 5 Shop → Doppelklick/Enter auf Tabellenansicht

Einfg Einf. Neue Webshop-Einstellungen
Ret Ändern Webshop-Einstellungen bearbeiten

Basisdaten

Maske Webshop-Einstellungen Artikel für brShop24

1 Pflege/Bezeichnung/Schlagworte

Shoppflege / alternative Bezeichnung / Schlagworte
Feld	Beschreibung
Shoppflege	Damit ein Artikel im Shop als "Aktiv" geführt und angezeigt wird, muss diese auf Ja stehen.
Shopbezeichnung (alternativ)	Der Export priorisiert diese Angabe über den OBS-Artikelnamen (Felder Bezeichnung 1 + Bezeichnung 2).
Schlagworte	Angabe von Schlagworten für die Suche im Shop. Als Trennzeichen ist ein Komma zu verwenden.

2 Artikelgruppen / Hersteller / Marke

HINWEIS: Die Zuordnungen in diesen Feldern basieren auf Definitionen im Shop, welche ins OBS importiert werden müssen. Falls Sie eine bestimmte Definition vermissen, müssen Sie die Definitionen neu importieren. Fall die entsprechende Definition im Shop nicht vorhanden ist, können Sie diese im Adminbereich pflegen und anschließend den Import ins OBS ausführen. Eine Beschreibung für den Import finde Sie im Abschnitt Voraussetzungen Definition importieren.

Artikelgruppen / Hersteller / Marke
Feld	Beschreibung
Artikelbezeichnung	Gruppierungsmöglichkeit im brShop24.
Produkttyp	Alternative Gruppierungsmöglichkeit im brShop24
Hersteller	Pflichtangabe; Hinterlegen Sie hier einen der im Shop gepflegten Hersteller.
Marke	Hinterlegen Sie hier eine der im Shop gepflegte Marken
Lagerstatus	Hier geben Sie den Lagerstatus für den Artikel an. HINWEIS: Bei Lagerstatus Lagerartikel (Text: "Lieferung bei Bestand innerhalb von 48 Stunden") und aktiviertem Bestandsexport, wird in den exportierten Daten bei Bestand 0 der Lagerstatus automatisch auf LagerartikelZZtOhneBestand (Text: "Z. Zt. kein Bestand - Lieferung bei Bestand innerhalb von 48 Stunden") gesetzt. Dies ändert nicht die Einstellung in den Webshop-Einstellungen des Artikels!

3 Lagerzuordnungen

Shop Lagerzuordnungen
Spalte	Beschreibung
Name	Zeigt den Namen des Lagers an
Pflege	Zeigt den aktuellen Pflegestatus für das Lager

Über einen Doppelklick auf die Tabelle Shop Lagerzuordnungen oder ↩ Enter auf der Tabelle stehend, öffnet sich die Liste der Lager für den Artikel. Ein neues Lager können Sie mit Einfg hinzufügen. Ähnlich den Webshop-Einstellungen einer Person, wird beim Öffnen eines vorhandenen Datensatzes eine Abfrage im Shop gestartet. Dies passiert auch bei speichern eines neuen Datensatzes.

Die Felder Art-Nr., Shop-Nr. und API-ID können nicht manuell gesetzt werden. Bei Neuanlage und solange kein Export stattgefunden hat, können Sie die Angaben für Lager und Art-Nr. für Lager bearbeiten. Ist ein Artikel im Shop angelegt, so können Sie aktuell nur noch die Shoppflege und Schlagworte verändern.

Wenn Sie das Lager auswählen, so wird anhand der Lagereinstellungen entwerden die Bestellnummer des Lagerlieferanten (Lieferant, welcher dem "Partner" zugewiesen wurde) oder die Artikelnummer in das Feld Art-Nr. für Lager übernommen. Sie können die Artikelnummer bis zum Export ändern. Beachten Sie dabei, dass pro Lager eine Artikelnummer eindeutig sein muss. Für neue Artikel sollten Sie Artikelnummern verwendne, welche im Shop nicht enthalten sind. Wollen Sie einen im Shop vorhanden Artikel mit OBS verknpüfen, so müssen Lager und Artikelnummer exakt übereinstimmen (siehe auch Im Shop vorhandene Artikel mit OBS verknüpfen (manuelle Migration)).

Die Eingabe im Feld Schlagworte ist additiv zu den Schlagworten in den Webshop-Einstellungen. Dieses Schlagworte in der Lagerzuordnung ermöglicht Ihnen die Schlagworte anhand des Lager zu individualisieren.

4 Kurztext (Einleitung)

Adminbereich Eingabefeld Einleitung

Feld im Webshop-Einstellungen dient nur zur Anzeige. Eingabe/Bearbeitung erfolgt über die Verwaltung der externen Artikeltexte.
Die Eingabe von Kurztexten öffnen Sie mit F4 Kurz T..

HINWEIS: Der aktuell für den Artikel aktive Datensatz für die Schnittstelle wird in der Liste Fett dargestellt.

5 Langtext (Beschreibung)

Adminbereich Eingabefeld Text

Feld im Webshop-Einstellungen dient nur zur Anzeige. Eingabe/Bearbeitung erfolgt über die Verwaltung der externen Artikeltexte.
Die Eingabe von Langtexten öffnen Sie mit F5 Texte.

HINWEIS: Der aktuell für den Artikel aktive Datensatz für die Schnittstelle wird in der Liste Fett dargestellt.

6 Bilder

Für die Hinterlegung eigener Bilder im Shop-Datensatz, werden die Bilder in der OBS-Bildverwaltung hinterlegt. Über die Artikel-Shop-Einstellungen gelangen Sie mit F6 Bilder in die Verwaltung für die Shop-Bilder des Artikels. In dieser Liste sehen Sie alle Einträge des Artikels, die in Shops verwendet werden sollen.

HINWEIS: Datensätze mit einer Zuordnung zur aktuellen Schnittstelle werden in der Liste Fett dargestellt.

Bei der Anlage bzw. Bearbeitung achten Sie darauf, dass der Typ (siehe im Bild 1; 9001=Shop Hauptbild / 9002=Shop Zusatzbild) gesetzt ist und eine gültige Web-URL (siehe im Bild 2) eingetragen ist.

HINWEIS: Die Angabe im Feld Datei funktioniert nicht, da die API derzeit keine Möglichkeit bietet die Datei selbst zu übertragen. Wenn Sie mit lokalen Dateien arbeiten, müssen Sie diese über den Adminbereich hinterlegen.

OBS-Artikelstamm

Grundpreisangabe

ACHTUNG: Beachten Sie bitte, das die gesetztlich definierten Mengeneinheiten in ihrer Vergleichsmenge für den Export beschränkt sind:
Die Mengeneinheit für den Grundpreis ist jeweils 1 Kilogramm, 1 Liter, 1 Kubikmeter, 1 Meter, 1 Quadratmeter, 100 Gramm oder 100 Mililiter der Ware.
§ 5 Abs.1 PAngV Stand: 21.04.2023

Weitere Informationen finden Sie auch Online z. B. von der IT-Recht Kanzlei

Die Grundpreisangabe dient der Vergleichbarkeit von Preisen gleicher Produkte, welche in unterschiedlichen Verpackungs- bzw. Verkaufsmengen angeboten werden. Dazu finden Sie im OBS-Artikelstamm auf Reiter 2 die Felder G-Faktor und G-Mengeneinh.
Aktuell untersützt OBS standardmäßig die Angabe eines Grundpreises auf Menge 1 der folgenden Einheiten:

Meter (M)
Quadratmeter (M2)
Kubikmeter (M3)
Liter (L)
Kilogramm (KG)

Erweitert wird dies mit Version 004379 um Gramm und Milliliter sowie die Möglichkeit weitere Einheiten für Grundpreise zu verwenden. Tragen Sie dazu in der Einheitenzuordnung eine Vergleichs- bzw. Basismenge ein. Die zuvor erwähnten Einheiten können in der Vergleichs-/Basismenge nicht angepasst werden. Wenn Sie die Shop-Einheiten bearbeiten (z. B. Zuordnung OBS-Mengeneinheit), wird immer 1 oder 100 entsprechend der Definition eingetragen.
Geben Sie im Faktor (G-Faktor) den Prozentsatz des Inhalts zur jeweiligen Grundpreismenge an.

Beispiel:
Artikel wird als Flasche (1) mit einem Inhalt von 200 ml (3) angeboten.

Für die Umrechnung auf einen Liter geben Sie daher als Faktor 20 % und die Mengeneinheit Liter an.

Im Shop sieht dies dann wie folgt aus:

Im Shop vorhandene Artikel mit OBS verknüpfen (manuelle Migration)

ACHTUNG: Für die Verknüpfung im Shop vorhandener Artikel gelten die Punkte unter Voraussetzungen und Vorbereitungen für Datenübertragung ebenso wie für die Neuanlage. Stellen Sie also sicher, dass die Definitionen auf dem neusten Stand sind und die benötigten Lager entsprechend eingestellt sind.

Lager und Artikelnummer

Das Vorgehen ähnelt dem Vorgehen für die Neuanlage. Der Unterschied besteht in der Eingabe der Lagerzuordnung. Während für eine Neuanlage eine Artikelnummer im Feld Art-Nr. für Lager eingetragen werden muss, welche im Shop nicht existiert, muss für die Verknüpfung das richtige Lager und die exakte Artikelnummer aus dem Shop eingetragen werden. Die Informationen finden Sie bei Bedarf im Artikel-Datensatz über den Adminbereich.

Beim Speichern sollte OBS den Artikel per API-Abfrage finden und Sie fragen, ob doe beiden Datensätze verknüpft werden sollen. Bestätigen Sie diese Frage mit Ja.

Beschreibung des Artikels

Wenn die Beschreibung des Artikels keine besondere Formatierung beinhaltet, kann der Text einfach aus dem Adminbereich kopiert werden.
Text markiere → Strg+C → Wechsel nach OBS-Maske Langetextfeld → Strg+V

Wurde der Text mit formatiert, so geht die Formatierung bei einem einfachen kopieren des Textes verloren. Wenn Sie den Text im OBS nicht nachformatieren möchten, gibt es eine alternative Möglichkeit, den Text zu kopieren. Allerdings erforder dies die Verwendung der Entwicklerwerkzeuge des Browsers.

HINWEIS: Es empfiehlt sich die Verwendung von Firefox für diesen Weg, da nach dem Kopieren keine Bearbeitung des HTML-Textes nötig ist.

Beispiel für den Browser Firefox:
1. Als erstes öffnen Sie die Seite des Artikels im Shop und scrollen Sie zur Beschreibung.
2. Führen Sie als nächstes möglich nach am Beginn der Beschreibung einen Rechtsklick aus und wählen Sie im Kontext-Menü den Punkt "Untersuchen". Dies öffnet den HTML-Inspektor mit dem Position im HTML, an dessen Stelle der Rechtsklick ausgeführt wurde.

3. Suchen Sie von der Position aus das übergeordnete div-Element. Der Beginn muss lauten <div class="br-body select-text". Wenn Sie das div-Element gefunden haben, führen Sie danach einen Rechtsklick auf das Element aus und Navigieren im Kontext-Menü über Kopieren zu dem Punkt Inneres HTML und klicken Sie darauf. Damit haben Sie den Inhalt des div-Elements im Zwischenspeicher.

4. In der OBS-Eingabemaske für externe Artikeltexte setzen Sie das Häkchen bei HTML (1). Die Texteingabe wechselt dadurch in den HTML-Modus. Markieren Sie alles nach {HTMLREADY} und ersetzen Sie den Teil mit dem kopierten HTML-Text per Strg+V (2).

5. Entfernen Sie nun wieder das Häkchen im Feld HTML. Die Ansicht wechselt wieder auf Texteingabe und Sie sollten jetzt den formatierten Text im OBS sehen.

HINWEIS: Die Darstellung zwischen OBS und Shop kann abweichen, dafür die Darstellung im Shop noch weitere Angaben für die Darstellung vorhanden sein können, welche OBS nicht kennt (siehe Cascading Style Sheets (CSS)).

Export

ACHTUNG: Aktuell werden Artikel nur beim Speichern im Artikelstamm übertragen. Weitere Exportmöglichkeiten folgen.

Artikelstamm

Wenn Sie einen Artikel mit einer Definition für brShop24 im Artikelstamm speichern (Eingabemaske Artikelstamm), wird die Datenübertragung ausgeführt.

Kostenpflichtige Module/Internet-Shop/brShop24/Eigene Artikel übertragen: Unterschied zwischen den Versionen