Skip to content

Hilfe zur Page Artikel Schnittstelle

Die Produkt-Schnittstelle überträgt Daten von Business Central an Magento. Abhängig vom Typ des Artikels (existierende Varianten oder nicht) werden unterschiedliche Stammsätze und unterschiedliche Arten von Artikeln (Feld Produktart: simple, congigurable...) in Magento erzeugt. Nachfolgende Daten können abhängig von der Konfiguration synchronsiert werden. Bei der Synchronisation werden die Ereignisse Insert, Modify und Delete überwacht.

  • Artikelspezifische Daten der Artikel
  • Variantenspezifische Daten der Varianten
  • Variantenspezifische Daten der Variantenattribute

Über den Einrichtungsparameter "Artikel Übertragungsart" in der Einrichtung der Schnittstelle wird definiert, auf welche Artikeltiefe synchronisiert werden soll:

  • Produkte: Es werden nur Artikel übertragen
  • Produkte und Varianten: Es werden Artikel und ggf. Varianten inkl. der Attribute übertragen
  • Varianten: Es werden nur Varianten und deren Attribute übertragen.

Über den Einrichtungsparameter "Artikel Übertragungsebene" in der Einrichtung der Schnittstelle wird festgelegt, auf welcher Artikelebene synchronisiert werden soll:

  • Global: Artikel werden nur für den "Default Store per Website" übertragen, alle weiteren Stores der Website haben keine eigene Artikeldaten und nutzen den Stammsatz des "Default Stores".
  • StoreView: Es werden Storeview-spezifische Daten übertragen, bestimmte Felder des Magento-Datensatzes können Storeview-abhängig sein. Dies ist typischerweise der Fall, wenn Sie auf einer Website mehrere Storeviews für unterschiedliche Sprachen haben. In diesem Fall wird das Sprachkennzeichen des Storeviews herangezogen um die richtige Beschreibung des Artikels zu übertragen.

Sonderfall DELETE

Wird ein Artikel in Business Central deaktiviert "Feld Magento Aktiv", so wird der Artikel in Magento nicht gelöscht sondern lediglich deaktiviert.

Produktarten

Grundsätzlich gilt, dass alle Artikel mit vorhandenen Varianten in Magento die Produktart "configurable" erhalten während einfache Artikel ohne Varianten oder die Varianten selbst in Magnet Artikel vom Typ "simple" ergeben.

Die Artikel Schnittstelle überwacht Business Central-änderungen (siehe auch "Batchjobs" ) an Artikeln und Varianten und überträgt diese Änderungen an Magento.

Synchronisationsrichtungen für Kunden (siehe auch Das Cockpit):

Objekt Vorgang Richtung
Produkte Insert MAG <== NAV
Modify MAG <== NAV

Screenshot Über den Menüpunkt "Nächste Aktion ausführen" führen Sie die "nächste geplante Aktion" für den selektierten Datensatz manuell aus. Diese Aktion wird sonst vom "Worker" anhand der geplanten Batchzeit automatisch ausgeführt.


Screenshot Über den Menüpunkt "Artikel Attribute" wird der Pflegedialog Page "Artikel Attribute Schnittstelle" aufgerufen. In dem Dialog werden die Attribute der Artikel gepflegt. Bestimmte Produktattribute werden per Default aus den NAV Artikelstammdaten abgeleitet (Ableitung Attribut tax_class_id aus MwSt.-Produktbuchungsgruppe des Artikelstamms).


Screenshot Über den Menüpunkt "Shopkategorien pro Produkt" wird der Pflegedialog Page "Shopkategorien pro Produkt" aufgerufen. In dem Dialog werden die Shopkategorien den Artikeln zugeordnet.


Screenshot Über den Menüpunkt "Preise" wird der Business Central Standard-Pflegedialog Preise aufgerufen. In dem Dialog werden die Verkaufspreise (Staffelpreise) und Spezialpreise für die entsprechenden Preisgruppen und Artikel gepflegt.


Screenshot Über den Menüpunkt "Zeilenrabatte" wird der Business Central Standard-Pflegedialog Zeilenrabatte aufgerufen. In dem Dialog werden die Rabatte für die entsprechenden Rabattgruppen (Preisgruppen) und Artikel gepflegt.


Screenshot Über die Menüfunktion "Artikelbild übertragen" kann eine manuelle Übertragung der Produktdarstellung der selektierten Produktzeile stattfinden.

Felder

Die wichtigsten Felder im Einzelnen:

Feld Beschreibung
NAV Artikelnr. Business Central Nr. des Artikels
NAV Variantencode Variantennr. Business Central
SKU SKU
WebSeite ID Magento Interne WebSite ID zu der dieser Satz gehört
Shop ID Magento Shop ID zu der dieser Satz gehört
Portfolio Code Kennzeichen zu welchem Produktportfolio der Satz gehört
Status Magento Anrede
Beschreibung Vorname
EAN Nachname
Produktart Magento "Product Type" des Artikels
Basiseinheit Mengeneinheit
VK-Preis Grundpreis des Artikels aus dem Business Central-Artikelstamm der auf alle Preissätze in Magento angwendet wird. (siehe auch Preise )
Spezial-Preis Sonderpreis
Spezial-Preis von Datum Gültigkeitsbeginn des Spezial Preises
Spezial-Preis bis Datum Gültigkeitsende des Spezial Preises
Sichtbarkeit Kennzeichen zur Darstellung in Magento
Nächste Aktion nächste auszführende Aktion des Schnittstellen-Datensatzes
Letzte Aktion letzte ausgeführte Aktion des Schnittstellen-Datensatzes
Letzte Ausführung Zeitstempel der letzten, ausgeführten Aktion
Letzte Aktion Status Status der letzten, ausgeführten Aktion
Letzte Aktion Nachricht Nachricht/Meldung der letzten Aktion
NAV Business Type Business Type des Kunden
Aufgaben Status aktueller Status der Aufgabenwarteschlange

Was ist ein Produktportfolio?

Unterschiedliche Produktportfolien werden auf Website-Ebene abgebildet, d.h. über das Portfolio ist es möglich, dass bestimmte Produkte die zum selben Portfolio gehören in den Shops dieser Website je nach Kategoriezuordnung angezeigt werden können, während Produkte eines anderen Portfolios nur auf den Shops einer anderen Website zu sehen sind. Über das Portfolio ist es also möglich, inhaltlich völlig unterschiedliche Shops aufzubauen.

Preise

Grundsätzlich können Grundpreise (Business Central-Tabelle Artikel), Verkaufspreise (Business Central-Tabelle Verkaufspreise), Rabatte (Business Central-Tabelle VK-Zeilenrabatte) und Spezialpreise (Business Central-Tabelle Verkaufspreise) an Magento übergeben werden.

Es können Preise für Artikel und Varianten verarbeitet werden. Existiert für Varianten kein variantenspezifischer Preis, so wird nach artikelspezifischen Preisen gesucht und diese für die Varianten ggf. übertragen. Existieren für konfigurierbare Artikel keine Varianten so werden die Preise für den Artikel übertragen. Existieren für konfigurierbare Artikel Varianten, so wird auf Ebene des konfigurierbaren Artikels kein Preis übertragen.

Beim Grundpreis handelt es sich um den Standard Magentopreis (Feld Price), bei den Verkaufspreisen, Rabatten und Spezialpreisen um "erweiterte Preise". Verkaufspreise und Rabatte werden dabei in Magento als Staffelpreise (Tier-Price) hinterlegt und Spezialpreise als "Special Price".

Je nach Einstellung der Preis Übertragungsebene können unterschiedliche Preise pro Website gepflegt werden. Dazu wird pro Store eine Preisgruppe gepflegt für die dann in den Preis- und Rabatttabellen der Business Central-Anwendung die Preise eingetragen werden. Die Preise dieser Preisgruppen (VK, Rabatte und Spezialpreise) werden dann mit der Produktschnittstelle an Magento übertragen.

Folgende Tabelle gibt eine Übersicht über die preisrelevanten Konfigurationsparameter und deren Wirkung:

Preisherkunft \ Preisverwendung Im Produkt In Tierpreisen In Gruppenpreisen Sonderpreise
aus Produkten ja - - -
aus Preislisten ja ja - ja
aus Preisgruppen ja ja
Gruppe aus Store
ja
Gruppe aus Kundengruppe
ja
Gruppe aus Store

Warning

Bei Preisen der Kategorie "Spezialpreise" darf pro Artikel und Preisgruppe nur ein Datensatz existieren. Es ist eine Gültigkeit anzugeben und die Menge auf Null zu setzen. Bei Spezialpreisen ist keine Mengenstaffel anwendbar.

Wann werden Preise an Magento übertragen?

"Erweiterte Preise" haben in Magento kein Gültigkeitsdatum. D.h. es wird bei einem Artikel- oder Preisupdate in Business Central zum Zeitpunkt der Übertragung nach den aktuell gültigen Preisen gesucht und diese übertragen. Im Voraus gepflegte Preise werden mit dieser Methode nicht übertragen.
Damit in Business Central gepflegte Preise mit einer Gültigkeit in der Zukunft zum Zeitpunkt der Gültigkeit übertragen werden ist es notwendig eine Batchaufgabe auszuführen. Die Batchaufabe RUN_ITEMBATCHACTION liest die Eintrage in der Tabelle Item-Batch-Action und triggert die Übergabe an Magento. Der Job sollte bestmöglich täglich um 00:00 oder kurz danach laufen.

Rabatte

Neben den Preisen ist es möglich Rabatte für die entsprechenden Rabattgruppen (Preisgruppen) und Artikel zu pflegen. Die Rabatte werden in den Business Central Standardtabellen für die Verkaufsrabatte abgelegt.

Die Rabatte werden analog der Verkaufspreise als Typ "Discount" im Magentomodul "erweiterte Preise" übertragen.

Warning

Eine Pflege von Rabatten über Artikelrabattgruppen ist nicht vorgesehen. Rabatte können in der Standardschnittstelle wie Verkaufspreise nur pro Rabattgruppe (Preisgruppe) und Artikel angelegt werden.

Bestände

Abhängig vom Einrichtungsparameter Bestand Übertragungsart stehen nachfolgend aufgeführte Optionen zur Übertragung der Bestände zur Verfügung:

  • Integriert: Die Übertragung erfolgt über die Produktschnittstelle
  • per FTP: Die Übertragung erfolgt separat über einen FTP-Export

Bei der integrierten Variante werden die Bestandsdaten mit der Übermittlung der Produkte direkt übertragen.

Die Übertragung per FTP ist für eine häufige Änderung der Bestandsdaten und eine große Anzahl von Bestandsdatensätzen empfehlenswert.

Info

  • Der Export der Bestände für beide Übertragunsarten wird über die Aufgabenwarteschlange angestossen. Voraussetzung zum Export ist also ein gültiger Eintrag in der Aufgabenwarteschlange zur Initialisierung des Exports.
  • Es werden Bestände für Artikel vom Magento-Produkttypen "simple" übertragen.
  • Das Magento-Kennzeichen "In Stock" wird automatisch übertragen
  • Bestände werden separat nach Variante übertragen

Produktdarstellungen

Die im Business Central Artikelstamm hinterlegten Produktdarstellungen können in der Produktschnittstelle kontrolliert werden. Die Produktbilder werden mit der Produktschnittstelle direkt übertragen und mit den "Tags" "image, small_image und thumbnail" versehen.

Screenshot

Webviewer

Nach erfolgreicher Übertragung kann im Magento Webviewer das Produkt und die Darstellung im Magento-Shop direkt aus der Produktschnittstelle heraus angezeigt werden.

Screenshot

Info

Um die Anzeige der Magento Produktseiten in Business Central zu ermöglichen muss in der Magento-Konfiguration die Umgebungsvariable "x-frame-options" in der env.php entsprechend gesetzt sein.

Die Pflege in Business Central

Page "Magento Produktattribute"

In dieser Page werden die Magento Produktattribute und Optionen den Artikelvarianten zugeordnet. Es wird zwischen Produkt- und Konfigurationsattributen unterschieden. Ein Produktattribut charakterisiert einen Artikel näher, ein Konfigurationsattribut steht dem Kunden bei der Produktauswahl zur Selektion zur Verfügung.

Info

Die Attributcodes und deren Optionen (Attributwerte) müssen vor der Pflege in Magento existieren und nach Business Central synchronisiert worden sein. Siehe dazu auch Page Attributschnittstelle

Standard Produktattribute

Bestimmte Produktattribute wie zum Beispiel tax_class_id werden direkt aus dem BC-Artikelstamm (MwSt.-Produktbuchungsgruppe) abgeleitet.

Es kann pro Attributcode nur ein Attributwert zugeordnet werden.

Felder

Die Felder im Einzelnen:

Feld Beschreibung
Webseite ID Webseite auf der das Attribut angewendet werden soll
Attribut Code Code der das Attribut identifiziert
Attribut Wert Wert der Attribut Ausprägung
Ist Produktattribut Bei der Attributausprägung handelt es sich um ein Produktattribut

Page "Magento Produktkatgorien"

In dieser Page werden die Kategorien unter denen dieses Produkt veröffentlich werden soll gepflegt.

Info

Damit eine Zuordnung erfolgen kann, müssen vorher die Produktkategorien aus Magento geladen werden.

Felder

Die Felder im Einzelnen:

Feld Beschreibung
Artikelnr. Artikelnummer
Kategorie ID Code der die Kategorie identifiziert
Kategorie Name Bezeichnung der Kategorie

Bearbeitung

Abhängig vom Kennzeichen "Tasks über JobQueue verarbeiten" im "Magento SetUp" werden die auszuführenden Aktionen direkt oder über die Aufgabenwarteschlange ausgeführt. Ist das Kennzeichen gesetzt wird für jeden Verarbeitungsschritt ein Warteschlangenposten erzeugt der dann über die JobQueue abgearbeitet wird. Am Eintrag im Feld "Aufgabenwarteschlangen Status" erkennen Sie, ob eine Verarbeitung über die Aufgabenwarteschlange geplant ist. Es sind folgende Einträge möglich:

  • Leer: Es ist aktuell keine Verarbeitung geplant
  • Geplant für Buchung: Es ist eine Verarbeitung geplant, jedoch hat diese noch nicht begonnen
  • Fehler: Die letzte Verarbeitung war fehlerhaft
  • Buchung: Die Verarbeitung befindet sich in der Ausführungsphase

Info

Befindet sich ein Datensatz im "Aufgabenwarteschlangestatus" "Fehler", so findet keine weitere automatisierte Bearbeitung statt bis der Fehler behoben ist.

Die Richtung und den Ausführungstypen entnehmen Sie der Spalte "Nächste Aktion". Es stehen nicht alle Aktionen für alle Objekte zur Verfügung. Wird eine Aktion erfolgreich ausgeführt und steht keine weitere Bearbeitung an, ist das Feld leer. Die letzte erfolgreiche Aktion wird in die Spalte "Letzte Aktion" übertragen. In der Spalte "Letzte Aktion Status" ist sichtbar, ob die vorangegangene Aktion erfolgreich oder ggf. fehlerhaft ausgeführt wurde.

War die Ausführung fehlerhaft, so wird der Status auf "error" gesetzt und die automatisierte Verarbeitung gestoppt.

Über die Funktionen "Warteschlange", "Fehler anzeigen" und "Fehler zurücksetzen" werden typischerweise die fehlerhaften Einträge bearbeitet. Dabei haben die Funktionen folgende Bedeutung:

  • "Warteschlange": Über diese Funktion zeigen Sie einen ggf. vorhandenen Warteschlangeneintrag an, d.h. Sie öffnen direkt die Seite "Aufgabenwarteschlangenposten"
  • "Fehler anzeigen": Öffnet die Protokolleinträge des Warteschlangenpostens um ggf. weitere Informationen zum Fehler zu erhalten.
  • "Fehler zurücksetzen": Setzt den "Letzte Aktion Status" zurück, löscht ggf. den dazugehörigen Warteschlangenposten und "cleared" die Spalte "Aufgabenwarteschlangen Status".

Warning

Führen Sie "Fehler zurücksetzen" nur dann aus, wenn Sie die Fehlerursache ermittelt und den Fehler bereinigt haben.