Hilfe zur Page Artikel Schnittstelle
Die Produkt-Schnittstelle überträgt Daten von Navision 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 Navision 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 Navision-änderungen (siehe auch "Batchprozesse" ) 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 |
Menüpunkte
Ü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.
Ü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).
Über den Menüpunkt "Shopkategorien pro Produkt" wird der Pflegedialog Page "Shopkategorien pro Produkt" aufgerufen. In dem Dialog werden die Shopkategorien den Artikeln zugeordnet.
Über den Menüpunkt "Preise" wird der Navision Standard-Pflegedialog Preise aufgerufen. In dem Dialog werden die Verkaufspreise (Staffelpreise) und Spezialpreise für die entsprechenden Preisgruppen und Artikel gepflegt.
Über den Menüpunkt "Zeilenrabatte" wird der Navision Standard-Pflegedialog Zeilenrabatte aufgerufen. In dem Dialog werden die Rabatte für die entsprechenden Rabattgruppen (Preisgruppen) und Artikel gepflegt.
Ü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. | Navision Nr. des Artikels |
| NAV Variantencode | Variantennr. Navision |
| 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 Navision-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 (Navision-Tabelle Artikel), Verkaufspreise (Navision-Tabelle Verkaufspreise), Rabatte (Navision-Tabelle VK-Zeilenrabatte) und Spezialpreise (Navision-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 Navision-Anwendung die Preise eingetragen werden. Die Preise dieser Preisgruppen (VK, Rabatte und Spezialpreise) werden dann mit der Produktschnittstelle an Magento übertragen.
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 Navision 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 Navision 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 Navision 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 Navision 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.
Webviewer
Nach erfolgreicher Übertragung kann im Magento Webviewer das Produkt und die Darstellung im Magento-Shop direkt aus der Produktschnittstelle heraus angezeigt werden.
Info
Um die Anzeige der Magento Produktseiten in Navision zu ermöglichen muss in der Magento-Konfiguration die Umgebungsvariable "x-frame-options" in der env.php entsprechend gesetzt sein.
Die Pflege in Navision
Page "Artikel Attribute Schnittstelle"
In dieser Page werden die Attribute und Optionen den Artikeln 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 Navision synchronisiert worden sein. Siehe dazu auch Page Attributschnittstelle
Standard Produktattribute
Bestimmte Produktattribute wie zum Beispiel tax_class_id werden direkt aus dem NAV 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 "Shopkategorien pro Produkt"
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 Shopkategorien 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.