Skip to content

Die ersten Schritte

Der Magento Connector wird mit einem separaten Magento Menü ausgeliefert, in welchem sich die Funktionsaufrufe zur Anwendung und Einrichtung befinden.

Screenshot

Einrichtungsassistent

Screenshot

Im Menüpunkt "Magento Einrichtung" befindet sich der Aufruf des Einrichtungsassistenten. Der Einrichtungsassistent erleichtert das initiale Setup der Schnittstelle und führt Sie durch die 4 wichtigsten Einrichtungsschritte, die im Nachfolgenden erläutert sind.

Info

Die Funktionen des Einrichtungsassistenten sind auch nach der initialen Ausführung über das Menü verfügbar.

Schritt 1 (Grunddaten und Paket)

Im ersten Schritt sind folgende Einrichtungen vorzunehmen:

  • URL-Endpunkt Ihrer Magento-Anwendung
  • Art der Authorisierung in Magento
  • Grunddaten für die Auftragsanlage

In diesem Schritt kann ferner:

  • die Verbindung zum Magento-Endpunkt geprüft werden
  • und die Gen. Mapping Page "Standard Code Mapping" zur weiteren Pflege der Magento Codes zu den BC Codes aufgerufen werden.

Info

Bei der Erstinstallation der Extension wird ein Standardset an Grunddaten angelegt. Dazu gehören neben Herkunftscodes beispielsweise die Resourcenstammdaten zur Abbildung von Versandkosten und Rabatten im Auftrag. Die Standardeinrichtungsdaten können im Menü Magento Administration jederzeit eingesehen und überprüft werden.

Info

Bleiben Sie mit dem Mauszeiger 1 Sekunde auf der Überschrift des Feldes "Shop URL" stehen, so erscheint ein sogenannter "Tool-Tip". Tool-Tips sind weitere Felderläuterungen in der Applikation, die Ihnen eine nähere Beschreibung geben, wie das jeweilige Feld zu verwenden ist.

Screenshot

Die Felder im Einzelnen:

Feld Beschreibung
Shop URL Endpunkt des Magento RESTful-Services unter dem der Service erreichbar ist.
Zugriffsmethode Sie können zwischen den Zugriffsmethoden "APIKey" oder "OAUTH" wählen. Je nachdem welche Methode gewählt wurde, müssen die Felder "API" oder "Consumer" und "Access" gefüllt werden. Wenden Sie sich an Ihren Magento-Administrator, um festzulegen, auf welche Art Sie Business Central authorisieren.
Def. Resource f. Versandkosten Versandkosten eines Magentoauftrags werden in Business Central als eine weitere Position im Beleg abgebildet. Legen Sie in Business Central eine Ressource an, die diese Versandkosten reflektieren soll und tragen Sie diese in das dafür vorgesehene Feld ein.
Def. Lieferbedingung Frachtfrei Pflegen Sie hier die Lieferbedingung für "frachtfreie" Aufträge ein.
Def. Lieferbedingung Unfrei Pflegen Sie hier die Lieferbedingung für "unfreie" Aufträge ein.
Def. Zahlungsbedingung Pflegen Sie hier die allgem. Zahlungsbedingung für Aufträge ein.

Info

Die Zahlungsbedingungen und Lieferbedingungen werden in der Regel aus den jeweiligen Belegen übernommen und über eine Mapping-Tabelle in die Business Central-Codes übersetzt. Die Default-Felder werden nur dann gezogen, wenn Magento keinen Wert liefert.

Info

Über die Setup-Routinen werden alle initialen Mappings zur Versorgung der REST-Services geladen. Es werden examplarische Grunddaten generiert.

Schritt 2 (Initialisierung Stores)

Im zweiten Schritt:

  • laden Sie vorhandene Stores
  • laden Sie Produktkategorien
  • laden Sie Kundengruppen
  • führen Sie die Kunden-Template Einrichtung durch

Führen Sie die Funktion "Stores und Gruppen initialisieren" aus. Business Central ruft die "Stores", "Kategorien" und "Kundengruppen" aus Magento ab und lädt diese in die in Business Central dafür vorgesehenen Tabellen. Die Zahl reflektiert die Anzahl der geladenen Einträge, über einen Klick auf die Anzahl können Sie die Einträge an dieser Stelle direkt kontrollieren.

Warning

Pflegen Sie pro Website ID und Kundengruppe das Vorgabetemplate, indem Sie die Seite "Kunden Template Einrichtung" öffnen. Das Kundentemplate enthält wichtige Parameter, wie zum Beispiel Geschäftsbuchungsgruppen, die benötigt werden, um einen funktionsfähigen Kundenstamm in Business Central anzulegen. Pflegen Sie die Kundentemplates gemäß Ihren Anforderungen und Systemeinstellungen und ordnen Sie diese dann entsprechend zu.

Screenshot

Schritt 3 (Bearbeitung Kundengruppen)

Im dritten Schritt ordnen Sie den Magento Kundengruppen wichtige Business-Central-Parameter zu.

Screenshot

Die Felder im Einzelnen:

Feld Beschreibung
NAV Business Type Der NAV Business Type regelt, ob es sich bei Kunden dieser Gruppe um B2C oder B2B Kunden handelt. Das Kennzeichen hat eine Auswirkung auf die Adressverarbeitung in Business Central.
NAV Debitorenpreisgruppe Vor allem im B2B-Bereich werden auf die entsprechenden Kundengruppen häufig unterschiedliche Preise in NAV vorgehalten. Über die zugeordnete Debitorenpreisgruppe können für unterschiedliche Kundengruppen unterschiedliche Preislisten abgebildet werden. Dieses Feld ist optional.

Schritt 4 (Initialisierung Batch)

Im vierten Schritt des Einrichtungsassistenten initialisieren Sie die Batchjobs zur Synchronisation zwischen Business Central und Magento.

Der wiederkehrende Datenaustausch mit Magento ist über die Standardfunktionalität der Aufgabenwarteschlangen realisiert. Klicken Sie auf die Funktion "Initialisiere Batch Jobs", um die Standardeinträge in den Aufgabenwarteschlangenposten für die wiederkehrende Synchronisation mit Magento zu erstellen. Nachdem die Einträge erstellt sind, können Sie die Aufgabenwarteschlangenposten gemäß Ihren Anforderungen einplanen. Nach der Initialisierung befinden sich die Einträge im "Wartemodus". Damit eine Synchronisation stattfindet, müssen Sie die Jobs über die Funktion "Bereit" aktivieren.

Screenshot

Es werden zwei Arten von Jobs erzeugt:

  • Listabrufe
  • Aktionen

Die Synchronisation von Magento an Business Central erfolgt im Pull-Verfahren. Business Central ruft über die "List"-Jobs die in Magento neuen oder geänderten Objekte ab und setzt in der Schnittstelle die nächste auszuführende Ausgabe. Über die "Aktion"-Jobs werden diese Aufgaben dann ausgeführt.

Schritt 5 (Abschluss)

Die Initialisierung ist beendet. Um eine vollständige Funktionsfähigkeit des Conncectors herzustellen ist es notwendig die Produktstammdaten zu klassifizieren und für die Synchronisation vorzubereiten, siehe dazug Page "Hilfe zur Synchronisation von Produkten und Varianten".