|
|
| (44 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| {{Kostenpflichtige Module}}
| | #WEITERLEITUNG [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/Eigene Artikel übertragen]] |
| {{Hinweis|Freigegeben ab Version 004124.}}
| |
| =Vorwort=
| |
| 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|Depot-Einstellungen]]).<br />
| |
| <br />
| |
| 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: 19.10.2022
| |
| {| class="wikitable"
| |
| !|'''Exportierbare Daten'''
| |
| |'''Hinweis'''
| |
| |'''enthalten ab Version'''
| |
| |-
| |
| |Artikelnummer
| |
| |Pflichtfeld<br />Kann unabhängig von OBS-Artikelnummer definiert werden, bis Artikel im Shop übertragen wurde
| |
| |004124
| |
| |-
| |
| |Lager/Depot
| |
| |Pflichtangabe<br />Ä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<br />Vordefinition im Shop
| |
| |004124
| |
| |-
| |
| |Marke
| |
| |Zuordnung Artikel-Shop-Einstellungen<br />Vordefinition im Shop
| |
| |004124
| |
| |-
| |
| |Herstellerartikelnummer
| |
| |Herstellernummer aus dem Artikelstamm
| |
| |004124
| |
| |-
| |
| |Verpackungsmenge
| |
| |Mengenangabe aus Verpackungsdefinition
| |
| |004124
| |
| |-
| |
| |Artikeltyp
| |
| |Artikel<br />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.<br />Vordefinierte Einheiten aus dem Shop<br />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.<br />Vordefinierte Steuersätze aus dem Shop<br />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
| |
| |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
| |
| |Suchbegriff + Suchtext aus Artikelstamm {{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
| |
| |}
| |
| ==geplante Erweiterungen==
| |
| *;Grundpreisangabe
| |
| :Entsprechende Felder sind bereits in der API enthalten. Im OBS kann mit einem Faktor geabreitet werden. Dies ist im Sho pnicht der Fall. Abhängig von Verpackungen und Menheneinheiten muss hier noch die Umrechnung implementiert werden. Eine Umsetzung ist für die nahe Zulunft geplant.
| |
| *;Lagerbestand und Lieferstatus pflegen
| |
| :In der aktuellen API gibt es die Möglichkeit einen Lieferstatus für einen artikel zu übergeben. Ob noch ein Lagerbestand übergeben werden kann, muss noch geklärt werden. Je nach Möglichkeiten der API folgt eine entsprechende Funktionalität für den Export mittel oder langfristig.
| |
| =Voraussetzungen und Vorbereitungen für Datenübertragung=
| |
| ==Voraussetzungen==
| |
| Um Artikel als eigene Artikel übertragen zu können, müssen bestimmte Voraussetzungen erfüllt sein:
| |
| #Es wird mindestens ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|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.
| |
| #Der Hersteller muss in den Shop-Einstellungen des Artikels hinterlegt werden können. Der Hersteller ist für die Datenübertragung eine '''Pflichtanhabe'''. Für die Zuordnung stehen Ihnen die im Shop definierten Hersteller (sofern Importiert) zur Verfügung. Werden weitere Hersteller benötigt, müssen diese im Shop definiert und die Liste der Shop-Hersteller im OBS anschließend aktualisiert werden. Die Aktualisierung führen Sie über das Shop-Menü mit Punkt ''W Definitionen importieren'' durch.
| |
| | |
| ==Vorbereitungen==
| |
| #Pflegen Sie die [[Kostenpflichtige_Module/Internet-Shop/brShop24#Zuordnungen|Zuordnungen]] der [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Einheiten|Mengeneinheiten]]. Ohne eine gültige Zuordnung wird einem eigenen Artikel beim Export ''Stück'' als Mengeneinheit hinterlegt.
| |
| | |
| =Einstellungen und Zuordnungen für Artikel=
| |
| ==Shop-Einstellungen==
| |
| ===Basisdaten===
| |
| {|class="wikitable"
| |
| |+ Shoppflege und alterantive Bezeichnung
| |
| |-
| |
| ! 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).
| |
| |-
| |
| |}
| |
| ----
| |
| {|class="wikitable"
| |
| |+ 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
| |
| |-
| |
| |}
| |
| ----
| |
| {|class="wikitable"
| |
| |+ Shop Lagerzuordnungen
| |
| |-
| |
| ! Spalte !! Beschreibung
| |
| |-
| |
| | Name || Zeigt den Namen des Lagers an
| |
| |-
| |
| | Pflege || Zeigt den aktuellen Pflegestatus für das Lager
| |
| |-
| |
| |}
| |
| ===Reiter Texte===
| |
| Zeigt die aktuell zugeordneten Texte. Eine Änderung der Zuordnung oder Bearbeitung des Textes ist über {{Key|F4 Kurz T.}} (Kurztext) und {{Key|F5 Texte}} (Langtext) möglich.
| |
| ===Reiter Bilder===
| |
| Diese Liste kann nur Bilder aus dem lokalen Netzwerk anzeigen. Für den Datenexport in den Shop sind jedoch URLs erforderlich. Bilder können Sie zuorden, indem Sie {{Key|F6 Bilder}} drücken oder im Reiter Bilder auf der Tabelle stehend Return bzw. mit der Maus einen Doppelklick auf die Tabelle ausführen. Dies öffnet die Bildverwaltung.{{Hinweis|Beachten Sie bitte, dass Sie die '''Bild-Typen''' '''9001''' und '''9002''' verwendet. Diese weisen einen Datensatz in der Bildverwaltung als Shop-Hauptbild bzw. Shop-Zusatzbild aus.}}
| |
| | |
| ===Reiter Dateien===
| |
| {{Achtung|Wie Bidler nur per URL zu pflegen. Aktuell noch nicht im Export enthalten!}}
| |
| | |
| ==Depot-Einstellungen==
| |
| Über einen Doppelklick auf die Tabelle ''Shop Lagerzuordnungen'' oder Return 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.<br />
| |
| <br />
| |
| 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'' verändern.<br />
| |
| <br />
| |
| 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.
| |
| ===Kann ich hier einen eigenen Artikel eintragen, welcher bereits im Shop ist?===
| |
| Die sist natürlich eine interessante Frage, wenn bereits ein VShop im Einsatz war und die migrierten Artikel, aus OBS gepflegt werden sollen. Haben Sie einen solchen Artikel, können Sie das Lager auswählen und die Artikelnummer aus dem Shop eintragen. Wird der Datensatz gespeichert führt OBS zuvor eine Prüfung aus. Findet OBS dann den Artikel im Shop, so kann der Artikel verknüpft werden.
| |
| | |
| ==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 {{Key|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. Datensätze mit einer Zuordnung zur aktuellen Schnittstelle werden in der Liste Fett dargestellt.<br />
| |
| <br />
| |
| 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.<br />
| |
| [[image:BrShop24_eigenBild.png]]
| |
| {{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.}}
| |
| | |
| =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.
| |
