Systemvoraussetzungen
Einführung
Datenmapping
Einschränkungen
Grundlagen - Shops
Artikel-Profile
Spezifische Einstellungen
Allgemeine Einstellungen
Feldzuordnung

• myfactory 7.0 oder höher mit freigeschaltetem Shop-Connector


• Magento ab Version 2.3

Die Schnittstelle überträgt Artikel, Lagerbestände, Kataloge sowie Auftragsstatus in Richtung des Shopsystems. Aus dem Shopsystem werden Aufträge mit den entsprechenden Kundendaten übernommen. Diese Aufträge können automatisiert in Verkaufsbelege umgewandelt werden.

Richtung	Datentyp	Beschreibung
myfactory > Magento	Artikeldaten	Stammdaten, Lagerinformationen, Artikelbilder, Zusatzartikel
myfactory > Magento	Artikelkataloge	Übertragung der Kataloge in den Shop
myfactory > Magento	Lagerbestände	Aktualisierung über Timer-Event
Magento > myfactory	Verkaufsbelege	Belegkopf, Belegpositionen, Lieferadresse, Rechnungsadresse etc.; manuell oder per Timer-Event
Magento > myfactory	Kundendaten	Aktualisierung bestehender Kunden und/oder Anlage neuer Kunden bei Auftragsimport

Alle Stammdaten werden über Mapping-Tabellen verbunden. Es wird für jeden Datensatz in der myfactory (Kunde, Artikel, Katalog) ein entsprechender interner Mapping-Eintrag zum externen Shop erstellt.

Die Möglichkeit, über z.B. Artikelnummer oder Kundennummer zu mappen, ist dazu da, den internen Mapping-Eintrag zu erzeugen. Wenn dieser besteht, erfolgt die Aktualisierung von Datensätzen nur noch über den internen Mapping-Eintrag.

• Varianten werden aktuell nicht unterstützt


• Konfigurierbare Artikel werden nicht unterstützt


• Artikelpreise aktuell nur aus einer Preisliste inkl. Staffelpreise

Zum Anfang


Jede Magento-Installation wird in der myfactory als einzelner "Shop" geführt. Magento Storeviews werden über die Artikelprofile abgebildet.

Betriebsstätte	Legt fest, in welche Betriebsstätte zum Beispiel Belege importiert werden. Die Shops selbst sind nicht nach Betriebsstätten getrennt.
Shopsystem	Shopsystem der zu konfigurierenden Schnittstelle (in diesem Fall muss Magento gewählt werden.)
API URL	URL der Schnittstelle, z.B. https://magento.myfactory.com /rest, wenn der Shop unter magento.myfactory.com läuft.
API-Benutzer / API Passwort	Benutzername und Passwort des Users, so wie er in der Magento-Benutzerverwaltung angelegt wurde.

WebsiteID	Website-ID(s), zu welcher der betreffende Shop in Magento gehört.
Attributset-ID	Standard Attribute-Set-ID des zu verwendenden Atrribute-Sets aus Magento (kann übersteuert werden im Bereich "Attributegruppen" oder bei der Konfiguration des Artikelexports.
Sichtbarkeits-ID	Standard-Sichtbarkeit der Artikel in Magento: 1: nicht sichtbar 2: Katalog 3: Suche 4: K&S

In diesem Dialog wird die Zuordnung von Artikel und Katalogen aus der myfactory zu Magento definiert. Wird ein neuer Artikel oder Katalog übertragen, so werden die IDs von Shopware intern in der myfactory gespeichert.

Um in Magento bereits bestehende Artikel oder Kataloge erstmalig zu übertragen, kann die bestehende Magento-ID in myfactory eingetragen werden, oder es kann ein bestimmtes Merkmal (wie z.B. die Artikelnummer) gewählt werden. Anhand des Merkmals wird der bestehende Artikel oder Katalog in Magento erkannt, aktualisiert und seine ID wird in der myfactory intern abgespeichert. Bei folgenden Übertragungen erfolgt die Aktualisierung immer anhand der internen IDs.

Artikel-Zuordnung	Festlegen, anhand welchen Feldes Artikel zugeordnet werden sollen. Primär prüft das System immer die Tabelle tdSCProducts. Danach ist neben der Artikelnummer z.B. ein Kennzeichen möglich. Artikel werden dann anhand dieses Feldes ermittelt und bei einem 1:1-Treffer in der Tabelle tdSCProducts registriert. Gibt es keinen Treffer, wird der Artikel neu angelegt.
Katalog-Zuordnung	Festlegen, anhand welchen Feldes Kataloge zugeordnet werden sollen. Primär prüft das System immer die Tabelle tdSCCatalogs. Alternativ ist nur ein Kennzeichen möglich. Kataloge werden dann anhand dieses Kennzeichens ermittelt und bei einem 1:1-Treffer in der Tabelle tdSCCatalogs registriert. Gibt es keinen Treffer, wird der Katalog neu angelegt.
ID der Root-Kategorie "Shop"	Basis-Katalog des Shops, unterhalb welchem die myfactory-Kataloge eingehängt werden.
Root-Kategorie myfactory	Basis-Katalog in der myfactory. Der hier gewählte Katalog wird in Magento als erste Ebene angelegt.
Artikelkataloge übertragen	Mit dieser Funktion werden die myfactory-Artikelkataloge zu Magento übertragen. Szenario 1: Kataloge in Magento komplett neu anlegen Mit dieser Funktion können Sie z.B. den myfactory-Katalogbaum unterhalb eines bestehenden Magento-Katalogbaumes neu einhängen. Dazu hinterlegen Sie unter "ID der Root-Kategorie Shop" bitte die Magento-ID des übergeordneten Katalogs. Zusätzlich wählen Sie im Feld "Root-Kategorie myfactory" bitte noch die entsprechende myfactory-Root-Kategorie, von welcher aus die Katalogstruktur exportiert werden soll. Szenario 2: Bestehende Kataloge in Magento aktualisieren In diesem Fall muss entweder bereits eine Zuordnung der Kataloge in der Tabelle tdSCCatalogs bestehen, oder es muss ein Kennzeichen zur "Katalog-Zuordnung" gewählt und befüllt sein. Im entsprechenden Kennzeichen muss die Magento-ID des myfactory-Kataloges eingetragen sein. Dabei reicht es aus, wenn das Kennzeichen der myfactory-Root-Kategorie mit der Magento-ID befüllt ist. Der Baum unterhalb der Root-Kategorie wird dann unterhalb des entsprechenden Magento-Kataloges eingehängt. Die Aktualisierung wird dann sowohl für die Bezeichnungen als auch für die Struktur ausgeführt. Übersetzungen der Kataloge Für die Übersetzungen der Kataloge werden die bestehenden Artikelprofile geprüft. Pro Profil kann eine Storeview hinterlegt und eine Sprache eingetragen werden. Bei Übertragung der Kataloge werden alle angelegten Artikelprofile mit Storeviews durchlaufen und die Kataloge in der Sprache des Shop-Profils übertragen.

Zum Anfang


Attributegruppen entsprechen bei Magento den "Attribute Sets". Über diese wird definiert, welche Eigenschaften an einem Artikel angezeigt und gepflegt werden können. Die Attribute Sets können auf myfactory-Artikelgruppen gemappt werden. Alternativ können Sie in den Grundeinstellungen der Schnittstelle einen festen Wert definieren.

Artikelgruppe	myfactory-Artikelgruppe
Shop-Wert Attributegruppe	ID des Attribute-Sets in Magento

Der Lagerabgleich wird über den Timer-Dienst automatisch ausgeführt. Dabei werden nur Artikel berücksichtigt, welche in Verkaufsbelegen oder Einkaufsbelegen verwendet wurden.

Lagerbestände autom. Exportieren	Aktiviert oder deaktiviert die automatische Übertragung der Lagerbestände.
Intervall für Lagerexport	Intervall in Minuten für den Export, mindestens 5 Minuten
Bestandsermittlung	Methode zur Bestandsermittlung

Vorlage-Kunde B2C	Zu verwendender Kunde, falls ein B2C-Kunde beim Import nicht zugeordnet werden kann. Priorität hat der unter “Länder” eingestellte Vorlagekunde (falls hinterlegt).
Vorlage-Kunde B2B	Zu verwendender Kunde, falls ein B2B-Kunde beim Import nicht zugeordnet werden kann. Priorität hat der unter “Länder” eingestellte Vorlagekunde (falls hinterlegt).
Ansprechpartner bei Kundenneuanlage B2C	Diese Option legt fest, ob beim Import von Kunden Ansprechpartner angelegt werden sollen.
Ansprechpartner bei Kundenneuanlage B2B	Identisch zu "Ansprechpartner anlegen B2C”, allerdings für B2B-Kunden
Name bei Adressen (B2C)	Wie auch im Adresselement im Webportal stehen hier verschiedene Modi zur Anlage einer Adresse zur Verfügung. z.B. “Vorname Nachname, Ort” etc. Gilt für B2C-Kunden
Name bei Adressen (B2B)	Identisch zu “Option Adressanlage B2C”, allerdings für B2B-Kunden
Unterscheidung B2B / B2C	Hier kann ein Unterscheidungskriterium für B2C und B2B ausgewählt werden. Bei Magento kann der Firmenname als Kriterium angegeben werden.
Kunden-Zuordnung (zur Erzeugung Mapping-Eintrag)	Festlegen, anhand welchen Feldes Kunden zugeordnet werden sollen. Primär prüft das System immer die Tabelle tdSCCustomers. Möglich ist neben “Kundennummer myfactory” auch “E-Mail-Adresse" oder “Kennzeichen Kundennummer Shop”. Kunden werden dann anhand ihrer E-Mail-Adresse ermittelt und bei einem 1:1-Treffer in der Shopinterface-DB registriert. Gibt es keinen Treffer, wird ein neuer Kunde angelegt. Sofern ausgewählt, wird im Kennzeichen die ID des Kunden im Shopsystem erwartet.

Zum Anfang


Die Magento-Schnittstelle meldet die Erstellung eines Lieferscheins oder einer Rechnung direkt an Magento zurück. Dies kann übersteuert werden, indem für diese beiden Status ein manueller Wert gesetzt wird. Soll nichts übermittelt werden, so kann das Feld "Shop-Wert" einfach leergelassen werden.

Myfactory-Status
Neu	Auftrag noch nicht importiert
Aktualisiert	Auftrag aus Shopsystem aktualisiert
Importiert	Auftrag importiert, Verkaufsbeleg erzeugt
Lieferschein erstellt	Verkaufsbeleg mit Lagerbuchung erstellt
Rechnung erstellt	Verkaufsbeleg mit Finanzwirkung erstellt
Vollständig geliefert	Alle Positionen geliefert ("Completed1" = True)
Storniert	Initialbeleg storniert
Erledigt	Alle Positionen geliefert und verrechnet

Die Standard-Shopsprache wird für den Artikelexport verwendet, wenn keine explizite Sprache ausgewählt ist. Eine weitere Verwendung gibt es bei Magento nicht.


Hier werden die Zahlungskonditionen des Shops auf myfactory-Zahlungskonditionen gemappt.
Das Mapping erfolgt dabei über die ID der Zahlungsmethode. An der Zahlungskondition kann angegeben werden, ob diese bezahlt ist.


Ermittlung der ID der Zahlungsmethode

Zum Anfang


Als Versandartikel wird beim Import der Bestellung der auf der Versandart konfigurierte Artikel verwendet. Unter “Belegimport” kann festgelegt werden, ob die Versandkosten vom Shop oder aus der Versandart in der myfactory übernommen werden sollen.


Dieser Reiter erlaubt das Abbilden (Mapping) von myfactory-Steuerklassen auf Shop-Steuerklassen. Diese können Sie in Magento über die Developer Tools des Browsers am Eingabefeld einsehen. Die ID muss in der myfactory auf den entsprechenden Steuersatz gemappt werden.


Es müssen die Währungen, welche in der Magento-Installation zusammen mit der myfactory verwendet werden sollen, gemappt werden. Die Standard-Währung ist auszuwählen.

Zum Anfang



Übersetzungen werden in Magento mit “Sprachshops” gelöst. Daher muss für eine andere Sprache eine abweichende Storeview im Artikelexport angegeben werden.

Es gibt für diese Anwendung die Option "Aktualisierung mehrsprachige Inhalte" auf dem Artikelprofil. Dabei werden nur die Artikeltexte übertragen. Würden Sie alle Felder in die Storeview übertragen, so würden diese jeweils von der Option "Standardwert nutzen" entbunden werden. Dies führt dazu, dass eine Aktualisierung der Werte in einer anderen Storeview keine Auswirkung mehr auf die Werte in der Storeview hat, in welche exportiert wurde. Bei vielen Feldern ist dies nicht gewünscht.

Der Name und die Beschreibung jedes Artikels müssen für jede zu exportierende Sprache vorhanden sein.

Es muss ein Preis in der Preisliste hinterlegt sein, welche für den Export konfiguriert wurde – andernfalls wird das Produkt nicht aktualisiert.

Der Katalog, welchem der Artikel zugewiesen ist, muss in einer Hierarchie eingebunden sein. Andernfalls wird der Artikel nicht übertragen.

Die Artikelbilder müssen als Webshop-Dokumente zugeordnet sein. Die Reihenfolge der Anlage der Bilder ist hierbei entscheidend – z.B. muss das erste Bild zuerst angelegt werden und mit der Option "Artikelübersicht" sowie "Artikeldetails" versehen sein.

Zum Anfang

StoreviewCode

Storeview-Code der Storeview, in die exportiert werden soll (sofern der Export in eine bestimmte Storeview ausgeführt werden soll)

Sprache	Wählen Sie hier die Sprache der Quelle aus. Beachten Sie bitte, dass unterschiedliche Sprachen für Ihre Kataloge und Artikel natürlich zuerst in der myfactory hinterlegt werden müssen.
Nur mehrsprachige Inhalte exportieren	Diese Funktion exportiert nur Artikelstammdaten, die mehrsprachig ausgelegt sind. Im Mapping zugewiesene Felder werden ebenfalls übertragen.
Artikelkatalog	Wählen Sie hier die Quelle bzw. den Artikelkatalog für den Export aus, der das logische Root-Verzeichnis darstellt. In der Auswahl werden alle verfügbaren Artikelkataloge mit Ihren Baumpositionen angezeigt.
Artikel in untergeordneten Katalogen übertragen	Mit dieser Checkbox bestimmen Sie, ob nur der ausgewählte Quell-Artikelkatalog übertragen werden soll, oder ob auch sämtliche untergeordnete Kataloge des gewählten Quell-Artikelkatalogs übertragen werden sollen.
Artikel exportieren	Mit dieser Checkbox bestimmen Sie, ob die Artikeldaten (also Bezeichnungen, Beschreibungen, Preise etc.) in den Shop übertragen werden sollen.
Bestehende Artikel aktualisieren	Damit bestimmen Sie, ob bereits in den Shop transferierte Katalog- und Artikeldaten aktualisiert werden sollen oder nicht.
Artikelbilder exportieren	Damit bestimmen Sie, ob die in der myfactory hinterlegten Artikelbilder mit übertragen werden sollen. Diese Option setzt voraus, dass das Übertragen der Artikeldaten aktiviert wurde.
Zusatzartikel exportieren	Zusatzartikel (Zubehör und ähnliche Artikel) mit übertragen

Zum Anfang


Die Feldzuordnung erlaubt ein individuelles Feld-Mapping für folgende Objekte:

• Artikeldaten


• Artikeltexte


• Kennzeichen


• Verkaufspreise


• Webshop-Details

Unter «myfactory Feld» kann das gewünschte Stammdatenfeld gewählt werden. Danach aktualisieren sich automatisch die auswählbaren Parameter rechts von diesem Feld.

(Beispiel: Auswahl «Staffelpreis» zeigt die Felder "Preisliste" und "Staffelmenge" als Parameter)

Shop Feld
Hier können vordefinierte Felder aus dem Shopsystem ausgewählt werden.

Shop Feld Manuell
Freitextfelder, welche die Magento-Attribute beschreiben.

Beispiel:

Zum Anfang