Jede Shop-Instanz wird in der myfactory als einzelner "Shop" geführt. In Shopware werden die Sub-Shops über die Artikelprofile abgebildet.

Register "Grundlagen"
Register "Artikel & Kataloge"
Register "Dimensionen"
Register "Attributegruppen"
Register "Lagerabgleich"
Register "Kunden"
Register "Preisgruppen"
Register "Belegimport"
Register "Belegstatus"
Register "Einheiten"
Register "Länder"
Register "Sprachen"
Register "Zahlung"
Register "Versand"
Register "Steuer"
Register "Währungen"
Register "Anreden"


In diesem Reiter können Sie die grundlegende Verbindung zu Ihrem bevorzugten Shopsystem herstellen (Shopware oder Magento).



Tragen Sie in dieses Feld bitte einen sinnigen Namen für Ihre Shop-Konfiguration ein.


Hiermit legen Sie fest, in welche Betriebsstätte zum Beispiel Belege importiert werden. Die Shops selbst sind nicht nach Betriebsstätte getrennt.


Hier bestimmen Sie das Shopsystem der zu konfigurierenden Schnittstelle.


Hier definieren Sie die Schnittstellenversion Ihres jeweils favorisierten Shopsystems. Inzwischen können Sie hier als neueste Shop-Version auch Shopware 6.4 selektieren.



Bei Shopware 5: URL der Schnittstelle, z.B. https://shopware.myfactory.com /api , wenn der Shop unter shopware.myfactory.com läuft.
Bei Shopware 6: URL der Schnittstelle, z.B. https://shopware.myfactory.com/api, wenn der Shop unter shopware.myfactory.com läuft.
Bei Magento: URL der Schnittstelle, z.B. https://magento.myfactory.com /rest, wenn der Shop unter magento.myfactory.com läuft.


Die hier ausgewählte TLS-Version für https muss sowohl von dem myfactory-Server als auch dem Shopsystem-Server unterstützt werden. Ist die TLS-Version jeweils nicht korrekt bzw. veraltet, dann kann es passieren, dass der Verbindungstest fehlschlägt. Zur Auswahl stehen hier die TLS-Versionen 1.2 und 1.3 (wird unterstützt ab Server 2019).


Bei Shopware 5: Benutzername des API-Users, API-Passwort ist der API-Key aus Shopware. Weitere Informationen dazu erhalten Sie im Hilfekapitel Shopware-Schnittstelle 5.x.


Bei Shopware 6: Hier ist im Eingabefeld "API-Benutzer" der Zugangsschlüssel des API-Users einzutragen (ClientID), das Feld "API-Passwort" ist mit dem Sicherheitsschlüssel aus dem Shopware-Backend zu befüllen (Client-Secret). Detaillierte Informationen dazu, wie Sie diese Zugangsdaten erhalten können, finden sich im Hilfekapitel Shopware-Schnittstelle 6.x.


Bei Magento: Benutzername und Passwort des Users, so wie er in der Magento-Benutzerverwaltung angelegt wurde. Wichtig ist, dass Sie keine speziellen Zeichen - also z.B. Sonderzeichen wie “_” - für den Namen des API-Users verwenden. Es kann sonst zu Fehlern beim Verbindungsaufbau kommen. Nähere Informationen dazu erhalten Sie im Hilfekapitel Magento-Schnittstelle.






Hier tragen Sie die Website-ID(s) ein, zu welcher der betreffende Shop in Magento gehört.


In diesem Feld lässt sich eine Standard Attributset-ID des zu verwendenden Attributsets aus Magento hinterlegen (kann übersteuert werden im Bereich "Attributegruppen" oder bei der Konfiguration des Artikelexports). Dieses Feld ist besonders dann wichtig, wenn keine Attributesets pro Artikelgruppe definiert werden. Ohne ein Attributset-Mapping fehlen im Magento-Shop sonst ggf. einige Felder.

Die ID kann mittels Mouse-Over über den entsprechenden Tooltip in der Magento-Konfiguration (Admin-Backend) aus der dann angezeigten URL ermittelt werden ("Stores --> Attributes --> Attribute Sets"). Alternativ gelangen Sie zu der benötigten Standard Attributset-ID, indem Sie auf das Attributset "Default" klicken. Dann können Sie sich die ID aus der Browser-Adresszeile hinauskopieren.



Standard-Sichtbarkeit der Artikel in Magento (d.h. in welchen Bereichen im Shop sollen Artikel angezeigt und ermittelt werden können) :

1. nicht sichtbar


2. Katalog


3. Suche


4. K&S (Katalog & Suche)

Hier definieren Sie die Standard-Sichtbarkeit der Bestandteile von Configurable Products (Varianten) in Magento. Da Varianten in der Regel nicht über die Suche auffindbar sein sollen, sondern nur auf Artikeldetail-Seiten sichtbar sind, tragen Sie hier üblicherweise die ID 1 für "nicht sichtbar" ein).


Dies ist das Feld für die Ermittlung der Positionspreise beim Belegimport. Hier können Sie es üblicherweise bei der Einstellung "Standard (Price)" belassen. Sollten Sie beim Belegimport feststellen, dass falsche Preise in die myfactory übertragen werden, dann ändern Sie die Standardeinstellung bitte in "Bruttopreis (PriceInclTax)".



Wurde aus einem importierten Beleg eine Rechnung oder ein Lieferschein in der myfactory erzeugt, dann wird im Regelfall über die Schnittstelle ein Feedback an den Magento-Shop gesendet. Dabei wird in Magento auch ein entsprechender Status gesetzt. Wenn Sie dies nicht möchten, dann können Sie das anhand dieser beiden Checkboxen unterbinden.


Magento verfügt in der Admin-Oberfläche über eine globale "Backorder"-Option, mit der Sie bestimmen können, ob die Artikel in Ihrem Sortiment „auf Rückstand“ bestellt werden dürfen oder nicht. Damit steuern Sie also, ob Artikel trotz nicht vorhandenen Lagerbestands bestellt werden können.

Standardmäßig ist in Magento die systemseitige Option "No Backorders" aktiviert. In diesem Fall wird eine Bestellung bei nicht vorhandenem Lagerbestand nicht unmittelbar ausgelöst. Vielmehr kommt ein Kunde dann solange in eine Art "Warteliste", bis wieder Bestand vorhanden ist. Erst dann wird die Bestellung ausgelöst.

Mit dieser Option können Sie festlegen, dass die Einstellung "No Backorders" übersteuert wird, wenn in der myfactory im Artikelstamm pro Artikel negative Bestände erlaubt sind und in den Exportoptionen eingestellt ist, dass auch Artikel mit Nullbestand oder Negativem Bestand übertragen werden dürfen. Dann können Artikel trotz nicht vorhandenem bzw. negativem Lagerbestand unmittelbar bestellt werden.

Ist diese Option deaktiviert, dann ist ein Artikel im Falle eines Exports mit Minus- oder Nullbeständen nicht bestellbar und wird im Magento-Shop als „Nicht lieferbar“ angezeigt.


Wenn diese Option aktiv ist, dann werden die einzelnen Bestandteile von einem Magento-Handelsset übernommen und separat in die myfactory importiert. Ist dies nicht der Fall, dann wird das Set als Ganzes eingelesen.


Im Konfigurationsbereich des Magento-Backends gibt es bei den Optionen zum Lagerbestand die Möglichkeit, eine Out-of-Stock-Threshold anzugeben. Mit dieser Checkbox können Sie den Parameter dafür beim Artikelexport am Artikel selbst setzen. Dieser auf Produktebene definierte Schwellenwert übersteuert dann alle Werte, die auf globaler Ebene für diesen Parameter gesetzt wurden.

Sie legen damit die tatsächlich verkäufliche bzw. verwertbare Menge an Artikeln fest. Das heißt, wenn Sie in der Backend-Konfiguration einen negativen Wert für diesen Schwellenwert angeben, dann definieren Sie damit die maximale Menge an Produkten, die durch Ihre Kunden trotz fehlendem Lagerbestand nachbestellt werden darf, bevor dieser Artikel als tatsächlich "Nicht mehr auf Lager" gilt.


Ist diese Checkbox gesetzt, dann werden die in Magento-Bestellungen hinterlegten Rechnungsadressen beim Belegimport nicht mit in die myfactory übertragen.


Wenn Sie viele Bilder oder ähnliches über die Magento-Schnittstelle übertragen und folglich mit längeren Serveranfragen kalkulieren müssen, dann können Sie in dieses Eingabefeld einen höheren Wert für das Timeout eingeben und somit das Standard-Timeout beim Anlegen und Aktualisieren von Artikeln überschreiben.

Schnittstellenspezifische Einstellungen (Shopware 6)



Dies ist das Feld für die Ermittlung der Positionspreise beim Belegimport. Hier können Sie es üblicherweise bei der Einstellung "Standard (oPos.unitPrice)" belassen. Damit wird ein pauschaler Stückpreis pro Artikel übermittelt. Sollten Sie beim Belegimport feststellen, dass falsche Preise in die myfactory übertragen werden, dann ändern Sie die Standardeinstellung bitte abhängig von Ihrer individuellen Preisermittlungskonfiguration und Ihrer Kundenzielgruppe (B2B vs. B2C) in "Bruttopreis (gross)" oder "Nettopreis (net)". Alternativ können Sie mithilfe einer im Shopware-Backend erstellten Preisregel auch einen zuvor definierten abweichenden Preis aus der Shopware-Kategorie der "Erweiterten Preise" ("Kataloge / Produkte / Erweiterte Preise") in die myfactory importieren ("oPos.Price.UnitPrice"). Dies kann beispielsweise ein Streichpreis oder der günstigste Preis der letzten 30 Tage sein.



Wenn diese Option aktiv ist, dann wird der gesamte Inhalt der Schnittstellenanfragen mitprotokolliert. Ist die Option nicht gesetzt, dann werden ausschließlich relevante Ereignisse wie Fehler oder Warnungen mitgeloggt.


Hier können Sie einen spezifischen Vorlageartikel für die Zuordnung und den ordnungsgemäßen Ausweis eines Gutscheines im Shop-Beleg hinterlegen (analog zum "Zugeordneten Artikel" unter "Verkauf / Gutscheine / Gutscheine").


Hier tragen Sie die GUID (Globally Unique Identifier) eines Shopware 6-Katalogtemplates für neu in das Shopsystem zu übertragende Artikelkatalog-Exporte ein. Ohne Angabe eines solchen Katalog-Templates muss das Layout im Shopware 6-Backend jeder Kategorie manuell zugewiesen werden.




Ist diese Checkbox gesetzt, dann wird der Katalogname im Bereich "Allgemein" der Kategorien im Shopware 6-Backend ("Kataloge / Kategorien") mit der Bezeichnung aus dem myfactory-Artikelkatalogestamm ("Webportal / Webshop / Artikelkataloge") befüllt, andernfalls wird der Eintrag im Eingabefeld "Name" hierfür herangezogen.



Gleichzeitig wird ein hinterlegter Langtext 1 aus dem Dialog "Katalogbezeichnungen bearbeiten" ("Schaltfläche [ Daten ] --> Langtext 1") in das Feld "Beschreibung" im "Kategorien"-Bereich übertragen.






Diese Option erlaubt es, per GUID für jeden Shop eine eigene Storeview anzugeben. Gibt man hier keine Storeview an, so werden bei mehreren konfigurierten Storeviews automatisch alle Storeviews abgerufen, auf die der API-User Zugriff hat. Dies kann unter Umständen dazu führen, dass Shop-Belege mehrfach über die Shopware-Schnittstelle in die Myfactory übertragen werden.



Zum Anfang


In diesem Dialog wird die Zuordnung von Artikeln und Katalogen aus der myfactory zu dem jeweiligen Shopsystem definiert. Wird ein neuer Artikel oder Katalog übertragen, so werden die IDs des Shopsystems intern in der myfactory gespeichert.


Um im Shop bereits bestehende Artikel oder Kataloge erstmalig zu übertragen, kann die bestehende Shop-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 im Shopsystem erkannt, aktualisiert und seine ID wird in myfactory intern abgespeichert. Bei folgenden Übertragungen erfolgt die Aktualisierung immer anhand der internen IDs.


Hiermit können Sie 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.


Neben den beiden Auswahlmöglichkeiten entweder keine Varianten-Zuordnung vorzunehmen oder die Varianten-ID in einem Kennzeichen in den Shop zu übertragen, steht hier noch eine dritte Option namens "Standard (ArtikelID-VariantenID)" zur Auswahl. Ist diese Auswahl gesetzt, dann werden Varianten standardmäßig anhand einer zusammengesetzten Variantennummer - bestehend aus Artikel-ID und Varianten-ID - in die Magento-Datenbank übertragen und im Shopsystem angelegt.





Legen Sie hier bitte fest, anhand welchen Feldes Kataloge zugeordnet werden sollen. Primär prüft das System immer die Tabelle tdSCCatalogs. Danach 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. Man kann mit dieser Funktion z.B. den myfactory-Katalogbaum unterhalb eines bestehenden Shopware-Katalogbaumes einhängen. Dazu muss man dem Root-Katalog in der myfactory die Shopware-ID des Zielkataloges aus Shopware im entsprechenden Kennzeichen hinterlegen.


Basis-Katalog des Shops, unterhalb welchem die myfactory-Kataloge eingehängt werden. Hier ist entweder eine ID (Magento und Shopware 5) oder eine UUID (Shopware 6) einzutragen.




Basis-Katalog in der myfactory. Die hier gewählte Kategorie wird in Shopware/Magento als erste Ebene angelegt.


Ist diese Checkbox aktiviert, so wird der auf der rechten Seite einzutragende Basis-Katalog nicht aus der myfactory in das Magento-Shopsystem übertragen, sondern es werden nur alle ihm untergeordneten Kataloge exportiert und im Shop angezeigt.


Mit dieser Funktion werden die myfactory-Artikelkataloge zu Shopware übertragen.

Szenario1: Kataloge in Shopware komplett neu anlegen
Man kann mit dieser Funktion z.B. den myfactory-Katalogbaum unterhalb eines bestehenden Shopware-Katalogbaumes komplett neu einhängen. Dazu muss man in der Einstellung "ID der Root-Kategorie Shop" die Shopware ID des übergeordneten Kataloges hinterlegen. Im Feld "Root-Kategorie myfactory" muss die myfactory Root-Kategorie gewählt werden, von der aus die Struktur exportiert werden soll.

Szenario2: Bestehende Kataloge in Shopware 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 Shopware-ID des myfactory-Kataloges eingetragen sein. Es reicht dabei aus, wenn das Kennzeichen der myfactory Root-Kategorie mit der Shopware-ID befüllt ist. Der Baum unterhalb der Root-Kategorie wird dann unterhalb des entsprechenden Shopware-Kataloges eingehängt.

Die Aktualisierung wird sowohl für Bezeichnungen als auch für die Struktur ausgeführt.





Zum Anfang


Das Mapping der myfactory-Dimensionen auf die Attribute bzw. Eigenschaften der verfügbaren Shop-Schnittstellen funktioniert sowohl für Magento als auch für Shopware ab Version 6.4. Die Mapping-Einträge bzw. Verknüpfungen für die Dimensionen werden über IDs bzw. UUIDs erzeugt, teilweise auch über interne Bezeichner (Codes).










Zum Anfang





Attributegruppen entsprechen bei Shopware den "Eigenschaftsgruppen". Über diese wird definiert, welche Eigenschaften an einem Artikel angezeigt und gepflegt werden können. Die Eigenschaftsgruppen können auf myfactory-Artikelgruppen gemappt werden.


Um die ID der Eigenschaftsgruppe zu ermitteln, muss in Shopware die Tabelle “s_filter” geprüft werden. Der Wert der Spalte "ID" muss auf die entsprechende Artikelgruppe gemappt werden.



Bei der Übertragung von Artikeln werden automatisch alle Kennzeichenwerte aus Kennzeichen, welche der Artikelgruppe zugewiesen sind, auf die Eigenschaftsgruppe in Shopware übertragen.

Die Namen der Kennzeichen müssen dabei mit den Namen der Eigenschaftswerte in Shopware übereinstimmen.

myfactory-Artikelgruppe

ID der Eigenschaftsgruppe in Shopware (= Feld-ID aus Tabelle "s_filter")


Für Magento können Sie die ID mittels Mouse-Over über den entsprechenden Tooltip in der Magento-Konfiguration (Admin-Backend) aus der angezeigten URL ermittelt werden ("Stores --> Attributes --> Attribute Sets"). Alternativ gelangen Sie zu der benötigten Attributset-ID, indem Sie auf das Attributset "Default" klicken. Dann können Sie sich die ID aus der Browser-Adresszeile hinauskopieren. Mit einer in diesem Bereich hinterlegten Attributset-ID lässt sich die Standard-Attributset-ID übersteuern, welche im Bereich der "Schnittstellenspezifischen Einstellungen" im "Grundlagen"-Register eingetragen werden kann (siehe oben)


Zum Anfang


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



Aktiviert oder deaktiviert die automatische Übertragung der Lagerbestände.


Hier können Sie definieren, in welchem zeitlichen Abstand (in Minuten) ein Export durchgeführt werden soll (Mindestintervall = 5 Minuten).


Wählen Sie bitte hier aus, welche Methode zur Bestandsermittlung herangezogen werden soll.


Hier selektieren Sie bitte das Lager, dessen Bestand übermittelt wird.


Wählen Sie hier bitte aus, wie mit einem Lagerexport im Falle von Null- bzw. Minusbestand verfahren werden soll. Die hier getroffene Auswahl kann pro Artikel-Profil noch einmal übersteuert werden (siehe auch Hilfekapitel Artikel-Profile).


Diese Option kommt vor allem bei Magento zum Tragen. Wenn Sie ein automatisches Lagerupdate (Option "Lagerbestände autom. exportieren") zu Magento über die Schnittstelle senden, dann erwartet diese neben der obligatorischen Lagermenge noch weitere Informationen bzw. lagerbezogene Felder aus dem Register "Feldzuordnung" im Artikelprofil. Werden diese Informationen aus den Zusatzfeldern nicht mit übermittelt, dann kann es passieren, dass bestehende Daten in solchen Feldern im Shop zurückgesetzt werden. Daher können Sie mit dieser Option ein bestimmtes Artikelprofil mitschicken. Sind in diesem Artikelprofil (z.B. Profil "Automatischer Lagerabgleich") im Bereich der Feldzuordnung noch Zusatzfelder (z.B. „Artikel Lagerort“) konfiguriert, so werden diese beim Export mit übertragen.


Ist diese Option gesetzt, dann wird nach Produktverkäufen im externen Shop auf myfactory-Seite nur der Lagerbestand der unter "Webportal / Webshop / Artikel" als "webshopfähig" gekennzeichneten Artikel aktualisiert. Alle anderen Artikel aus dem myfactory-Artikelstamm werden für den Lagerabgleich nur dann berücksichtigt, wenn diese Checkbox nicht gesetzt ist.


Hier können Sie alle kundenspezifischen Einstellungen vornehmen, z.B. was die Unterscheidung zwischen Privat- und Firmenkunde angeht.



Hier kann ein Unterscheidungskriterium für Privat- und Firmenkunden ausgewählt werden. Bestimmte Shopsysteme respektive Schnittstellen (z.B. Shopware) senden fix ein Feld mit der Information mit, ob es sich um einen Firmen- oder Endkunden handelt. Bei anderen hingegen kann z.B. der Firmenname als Kriterium angegeben werden. Die zur Auswahl stehenden Kriterien sind in diesem Fall, ob etwa ein Firmenname oder eine Umsatzsteuer-ID vorliegt. Alternativ können Sie auch die Schnittstelle selbst darüber entscheiden lassen.


Hier wird der zu verwendende Privatkunde hinterlegt, welcher herangezogen wird, falls ein B2C-Kunde beim Import nicht zugeordnet werden kann. Priorität hat der unter "Länder" eingestellte Vorlagekunde (falls hinterlegt).


Hier wird der zu verwendende Firmenkunde hinterlegt und herangezogen, falls ein B2B-Kunde beim Import nicht zugeordnet werden kann. Priorität hat der im Register “Länder” eingestellte Vorlagekunde (falls hinterlegt).


Diese Option legt fest, ob beim Import von Kunden Ansprechpartner angelegt werden sollen


Identisch zu "Ansprechpartner Neuanlage Privatkunde".


In diesem Bereich legen Sie fest, wie ein als Privatadresse gekennzeichneter Adressdatensatz gebildet werden soll. Mit der Einstellung "Standard" wird bei einem bestehenden Adressdatensatz das dort verwendete Formatierungsmuster für die Bildung der Adresskurzbezeichnung herangezogen.

Die folgenden Adressmuster stehen Ihnen hier zur Verfügung:



Dies ist das Gegenstück für die Adressbildungsmöglichkeiten bei den Firmenkunden.



Wie auch im Adresselement im Webportal stehen hier für die Adressanlage bei Privatkunden verschiedene Modi zur Anlage einer Adresse zur Verfügung. z.B. “Vorname Nachname, Ort” etc.

Dabei stehen die folgenden Formatierungsmöglichkeiten zur Bildung einer Privatadresse zur Verfügung:



Identisch zu “Name Adressen Privatkunden”.


Wenn Sie diese Option setzen, dann wird im Kundenstamm für einen mit dem Belegimport übermittelten Kunden die Checkbox "Privatadresse" in dessen Datensatz aktiviert. Folglich wird der betreffende Kunde als Privatkunde mit den entsprechenden Feldern "Nachname" und "Vorname" hinterlegt.


Hiermit legen Sie fest, 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.


Mit dieser Einstellung kann eine Anrede für gewerbliche Bestellungen hinterlegt werden. Der Ansprechpartner erhält die gemappte Anrede aus Shopware. Das Mapping selbst führen Sie über das Register "Anrede" durch.

Zum Anfang



Für das Mappen von Preisen und Rabatten kann auf Magento-Seite die Kundengruppe herangezogen werden.


Die Magento-Kundengruppe "Wholesale" kann z.B. auf die korrespondierende Myfactory-Kundenpreisgruppe (hier: "Großkunde") gemappt und die ID in die Spalte "Shop-Wert" eingetragen werden. Hierzu lässt sich die ID der Magento-Kundengruppe mithilfe des Browser-Entwicklertools (erreichbar über F12) auslesen:


Einem Artikel, der in das angebundene Shopsystem exportiert werden soll und einer bestimmten Artikelpreisgruppe zugeordnet ist, kann in Abhängigkeit der Kundenpreisgruppe "Großkunde" über entsprechende Einträge in der Preis-/Rabattmatrix somit ein entsprechender Preis/Rabatt für den Export mitgegeben werden (funktioniert auch für Staffelpreise).


Wenn Bestellungen für Ihre zu Shopware übertragenen Artikel eingehen, dann können Sie in diesem Reiter Konfigurationen für den Import dieser Bestellungen vornehmen, z.B. lässt sich festlegen, dass alle Belege automatisch importiert werden.



Unter der Voraussetzung, dass auf Ihrem Server der Myfactory-Timerdienst aktiv und diese Checkbox gesetzt ist, können Sie Belege automatisiert aus dem jeweiligen Shopsystem in die Myfactory importieren.


Neben der Möglichkeit, ein Datum zu bestimmen, ab welchem Aufträge aus dem Shop importiert werden sollen (siehe nachfolgende Optionsbeschreibung), ist auch die maximale Zeit in Minuten rückwirkend konfigurierbar, bis zu der Belege automatisch in die myfactory übermittelt werden. Ohne weitere Konfiguration sind es standardmäßig 300 Minuten.


Hier können Sie auf bestimmte Status-IDs filtern und z.B. nur solche Bestellungen importieren, die bereits den Status "Bezahlt" aufweisen.


Es werden nur Aufträge importiert, die gleichen oder neueren Datums sind.


Legen Sie hier fest, in welchen Abständen der automatische Belegimport (sofern aktiv) erfolgen soll. Ist hier nichts eingetragen, dann überprüft die myfactory die Schnittstelle über den Timerdienst standardmäßig alle 10 Minuten auf neu eingegangene Shop-Bestellungen.


Anhand dieser Auswalliste legen Sie fest, ob ein während der Shopbestellung hinterlegter Kundenkommentar mit der Bestellung übertragen werden soll oder nicht.


Mit der Option "als Belegposition (Langtext) einfügen" wird ein Kundenkommentar aus dem Shopsystem nicht nur in der "Kommentar"-Spalte in der Bestellübersicht hinterlegt, sondern auch als Langtextposition in einen Verkaufsbeleg eingefügt. Alternativ haben Sie auch die Möglichkeit, den Kommentar Ihres Kunden in den Kopftext eines Belegs in der Verkaufsschnellerfassung zu übernehmen.


In diesem Bereich können Sie einem aus dem Shopsystem importierten Kundenkommentar einen selbst definierten Vortext voranstellen, z.B.: "Ihre Bemerkung im Shop". Dieser wird dann zusammen mit dem eigentlichen Kommentar in den Beleg eingefügt, sofern Sie obige Checkbox gesetzt haben.


Mithilfe bestimmter Platzhalter können Sie in diesem Feld für jeden importierten Auftrag festlegen, nach welchem Muster ein dort zu hinterlegender Betreff dargestellt werden soll.

Die hierfür verfügbaren Platzhalter sind die folgenden:

$OrderNumber$: Belegnummer
$CollectionType$: Inkassoart
$OrderID$: Beleg-ID
$PaymentDesc$: Zahlungsmethode


Möchten Sie die OP-Nummer eines Kunden als Belegreferenz in einem Auftrag vermerken, dann können Sie diese hier als permanente Vorlage eintragen. Es gelten dieselben Platzhalter wie bei der Anwendung der Belegbetreff-Vorlage (siehe vorherige Option).


Damit legen Sie fest, ob bei Gastbestellungen jeweils ein eigener Kunde angelegt werden soll, oder ob diese auf einen Sammelkunden erstellt werden sollen. Beim Sammelkunden werden die Adressdaten nur im Beleg gespeichert, nicht im Kundenstamm. Der Sammelkunde kann angegeben werden.






Hier kann festgelegt werden, ob die Stammadressen von Kunden aktualisiert werden sollen oder die Adressen beim Belegimport nur in den Verkaufsbeleg geschrieben werden. Da Shopware keine IDs für Adressen liefert, kann mit dieser Option nur die Stammadresse des Kunden aktualisiert werden. Die Anlage von myfactory-Lieferadressen ist nicht möglich.


Hiermit bestimmen Sie, welcher Typ von Verkaufsbeleg angewendet werden soll, um die importierten Bestellungen zu Belegen zu verarbeiten. Um z.B. ein abweichendes Lager zu bedienen, kann eine neue Belegart angelegt werden, welche fix dieses Lager beinhaltet.


Diese Option gibt an, ob die importierten Bestellungen direkt zu Verkaufsbelegen umgewandelt werden. Im Fehlerfall wird der Auftrag in der Belegliste im Fehlerstatus dargestellt und es ist ein manuelles Eingreifen erforderlich.


Hier können Sie auch für die myfactory einen speziellen Status für einen eingelesenen Beleg festlegen, z.B. "Lieferung noch offen".


Zur besseren Filterung Ihrer aus dem Shop über die Schnittstelle eingehenden Aufträge können Sie hier - ähnlich wie in der Amazon- und Ebay-Schnittstelle -eine Belegherkunft angeben.


Ist dies aktiv, wird zwar der myfactory-Artikel in den Beleg eingefügt, welcher der Versandart zugeordnet ist, der Versandpreis wird aber aus dem Shop übernommen, und nicht aus den myfactory-Stammdaten.


Wenn Sie in Ihrer myfactory-Datenhaltung aktuellere Artikelpreise vorhalten als in Ihrem Shop, dann können Sie diese Checkbox setzen. Ist die Option aktiviert, dann werden beim Belegimport über die Shop-Schnittstelle nicht die Preise aus dem Shop übernommen. Stattdessen werden diese durch die Preise in den myfactory-Preislisten überschrieben. Dies ist beispielsweise dann sinnvoll, wenn Sie Ihren Shop-Kunden rabattierte Preise aus den myfactory-Aktionspreislisten anbieten möchten.


Der hier zu hinterlegende Dummy-Artikel wird beim Belegimport im Beleg verwendet, falls keine richtige Artikelzuordnung möglich ist. Ist hier kein Artikel eingetragen, so wird der Verkaufsbeleg bei fehlender Artikel-Zuordnung nicht verarbeitet.


Ist diese Checkbox gesetzt, dann wird die aktuelle Betriebsstättennummer in den Belegdetails eines Verkaufsbelegs bei der Belegerzeugung nach dem Belegimport eingetragen.


Mit dieser Checkbox legen Sie fest, dass der in das jeweilige Shopsystem zurückgemeldete Bestell- bzw. Belegstatus (z.B. "In Bearbeitung") bei jedem Verarbeiten oder Weiterverarbeiten eines Belegs über die ERP-Verkaufsbelegerfassung in das Shopsystem zurückgemeldet und aktualisiert wird. Voraussetzung dafür ist, dass der jeweilige myfactory-Belegstatus im Belegstatus-Register auf den jeweils passenden Shopstatus gemappt worden ist.



Ist diese Checkbox gesetzt, dann bleiben über die Bestellübersicht importierte Verkaufsbelege nach deren Anlage auf dem Status "Neu" stehen (z.B. AB*neu*) und werden nicht automatisch zu einer festen Belegnummer weiterverarbeitet. Dies kann z.B. dann gewünscht sein, wenn in Ihrem importierten Verkaufsbeleg Artikelpositionen mit Dimensionen vorhanden sind, für die zunächst noch eine Varianten-, Seriennummern- oder Chargenauswahl vorgenommen werden muss. Diese Belege müssen dann entsprechend noch manuell verarbeitet werden.


Wählen Sie hier pro eingerichteter Schnittstelle einen Mitarbeiter aus Ihren Mitarbeiter-Datensätzen aus, der für die Bearbeitung der importierten Belege verantwortlich sein soll.

Zum Anfang


Bei bestimmten Aktionen in der Myfactory meldet die Shop-Schnittstelle einen geänderten Status an den Shop zurück. Das kann z.B. die Erstellung eines Lieferscheines oder einer Rechnung in der Myfactory sein. Eine solche Änderung eines bestehenden Status wird dann direkt nach dem Import von der Myfactory an das Shopsystem zurückgemeldet. Die Rückmeldung eines geänderten Status kann übersteuert werden, indem hier ein manueller Wert gesetzt wird (Shopware-versionsabhängig entweder ID oder Name).

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 "Completed1" = True (noch nicht freigegeben)
Storniert	Initialbeleg storniert
Erledigt	Alle Positionen geliefert und verrechnet

Shopware 6:

Bei der Shopware 6-Schnittstelle ist als Shop-Wert der Name bzw. die Bezeichnung des zu mappenden Shopware-Werts einzutragen. Soll nichts übermittelt werden, so kann das Feld “Shop-Wert (ID/Name)" einfach leer gelassen werden.





Dieser Reiter erlaubt das Mapping von myfactory-Mengeneinheiten zu Shop-Mengeneinheiten. Dabei können die myfactory-Mengeneinheiten auf eine ID des Shops gemappt werden.


Zum Anfang


Pro angelegtem Shop gibt es die Möglichkeit, Vorlagekunden für B2C und B2B pro Land getrennt zu hinterlegen. Diese wirken als Template, falls beim Import von Bestellungen ein Kunde neu angelegt werden muss.



Die Standard-Shopsprache wird für den Artikelexport verwendet, wenn keine explizite Sprache ausgewählt ist.




Für Shopware 6 muss die Shopware-UUID (Universally Unique Identifier) der Shop-Sprache(n) in der myfactory auf die hier auswählbare(n) Korrespondenzsprache(n) gemappt werden.


Die jeweilige UUID kann im Shopware-Backend unter "Einstellungen / Sprachen" über die Browser-URL bei der Bearbeitung einer Sprache ermittelt werden.



(*die nachfolgenden Erläuterungen beziehen sich sowohl auf Shopware 5 als auch Shopware 6.)

Hier werden die Zahlungskonditionen des Shops auf myfactory-Zahlungskonditionen gemappt. Das Mapping erfolgt dabei über den Namen der Shopware-Zahlungsmethode. An der Zahlungskondition kann per "Auftrag ist bezahlt"-Checkbox gekennzeichnet werden, ob diese bezahlt ist oder nicht. Bei Bedarf können Sie außerdem für jede hier hinzugefügte Zahlungskondition eine abweichende Belegart in der gleichnamigen Spalte angeben.





Als Versandartikel wird beim Import der Bestellung der auf der Versandart konfigurierte Artikel verwendet. Im Register “Belegimport” kann festgelegt werden, ob die Versandkosten vom Shop oder aus der Versandart in der myfactory übernommen werden sollen.
Das Mapping erfolgt über den Namen der Versandart.



Dieser Reiter erlaubt das Mapping von myfactory-Steuerklassen zu Shop-Steuerklassen. Diese kann man in der Artikelliste in Shopware als Spalte einblenden.


Die ID muss in der myfactory auf den entsprechenden Steuersatz gemappt werden:


Für Shopware 6 muss die Shopware-UUID in der myfactory auf den entsprechenden Steuersatz gemappt werden.


Dazu können Sie die UUIDs im Shopware-Backend in den Stammdaten des Artikels ("Kataloge / Produkte") unter "Steuersatz" dem Entwicklermodus des Browsers (mit F12 erreichbar) entnehmen.



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


Währungen werden in Shopware über einen Umrechnungsfaktor gesteuert. Es ist jedoch möglich, Shopware-Kundengruppen zu verwenden, um verschiedene Währungen abzubilden. Zu diesem Zweck wurde die Shopware-Kundengruppe als Parameter in den Artikelexport aufgenommen.


Für Shopware 6 kann die UUID der Währung aus der Browser-URL in den Detail-Eigenschaften der Währung ermittelt werden.



Zum Anfang


In diesem Bereich können Sie festlegen, wie im Shopware-Backend im Kundenbereich definierte Anreden auf in der myfactory angelegte Anreden gemappt werden sollen. Das Mapping erfolgt - wie bei Shopware 6 üblich - über die UUID.




Zum Anfang