Aktionen

Mention®Connect - Shopware 5 Schnittstelle: Unterschied zwischen den Versionen

Aus mention Software GmbH WIKI

(Entfernt: Konfiguration "altes" Plugin)
 
(54 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
==Neuerungen==
 
  
 +
==Systemvoraussetzungen==
 +
*Shopware-Version Minimum 5.5.7, Maximum 5.7.12
 +
*mention®Warenwirtschaft Minimum v2017
  
 +
Alle auf dieser Seite mit einem Stern[[Datei:Star-icon.png]] gekennzeichneten Einstellungen sind zwingend einzurichten, bevor eine Kommunikation mit dem Shop erfolgen kann.
  
==Einleitung==
+
==Installation des Plugins[[Datei:Star-icon.png]]==
'''Die mention®Connect Shopware5-Schnittstelle ist Kompatibel ab der Shopware Version 5.3.4, außerdem benötigen Sie eine Warenwirtschaft ab der Version v2017'''
+
[[Datei:Plugin 01.png]]
  
==Funktionen==
+
Den Plugin Manager erreichen Sie über das Menü ''Einstellungen''. Dort nach Auswahl des Menüpunkts ''Installiert'' den Button ''Plugin hochladen'' betätigen.
* Upload von Artikel, Gruppen und Kollektionen
 
** Aktualisierung von
 
*** Artikelnummer, Artikelname, Artikelbeschreibung, Artikel MetaTitel, Artikel Kurzbeschreibung (als meta Shopware Meta - Kurzbeschreibung), MetaKeywords
 
*** Preise und Bestände
 
*** Artikelbilder aktualisieren (je nach Einstellung Bild 1 - 10) wobei hierbei nur die geänderten Bilder exportiert werden.
 
*** Breite, Höhe, Tiefe und Gewicht
 
*** Hersteller Name (Hersteller wird angelegt wenn dieser nicht exisitiert)
 
*** Artikel-Status (Online Kennzeichen)
 
*** Artikel Bezeichnung, Beschreibung, Kurzbeschreibung, Meta Tile, Keywords.
 
*** Mengeneinheiten (Maßeinheit, Inhalt, Grundeinheit)
 
*** Herstellernummer
 
*** Lieferzeit (mention Stammdaten Artikel Online Lieferzeit)
 
*** EAN
 
*** Artikel hervorheben (Stammdaten - Artikel - Online "Kennzeichen Sonderangebot"
 
*** Zuordnung Zubehörartikel
 
*** Zuordnung Kategorien
 
*** nicht definierte Merkmale über das FSK Feld
 
**** Multilingual möglich mit speziellen plugin
 
*** Onlinedaten je Account
 
*** Staffelpreise
 
*** Weitere Felder über ein benutzerdefiniertes xslt
 
* Upload Kategorien
 
** Aktualisierung von
 
*** Meta Description
 
*** Meta Keyowords
 
* Download von Bestellungen
 
** Liefer- und Rechnungsanschrift
 
** Artikel Positionen
 
* Upload Bestellstatus
 
** Bezahlt
 
** Versendet
 
* Upload Kunden
 
** Kunden nach spezifischen eMail-Adressen
 
  
==Einstellungen==
+
[[Datei:Plugin 02.png]]
Für den Betrieb der Shopware Schnittstelle ist ein separater Shopware5 Account sowie eine Lizenz hierfür erforderlich.
 
  
* Url - Geben Sie hier die vollständigen http Pfad zum Shopware Backend an
+
Nun das gezippte Plugin lokalisieren und auswählen.
* API Benutzername und Passwort - Sollte noch kein API Benutzer freigeschaltet sein, so können sie dieses in der Shopware Benutzerverwaltung (Einstellungen - Benutzerverwaltung) tun. Achten Sie hierbei auf die Einstellung "API-Zugang" Aktiviert. Hinterlegen Sie den API-Schlüssel und auch den API Benutzernamen in ihrem Shopware5 Account.
 
* Für den Betrieb ist eine webseitige Schnittstelle erforderlich. Im mentionConnect Shopware5 Account befindet sich eine Schaltfläche "webseitige Schnittstelle Download". Hiermit können Sie sich die jeweils aktuellste Version herunterladen.
 
* Wählen Sie die Bilder aus die Sie nach Shopware exportieren möchten
 
* Weitere obligatorische Einstellungen sind: Mandant, Lager, mention Benutzer und VK-Preis.
 
  
==Installation der <span style="color:blue">neuen</span> webseitigen Schnittstelle==
+
[[Datei:Plugin 03.png]]
  
'''Das neue webseitige-Plugin für Shopware benötigt <span style="color:red">mindestens die Shopware - Version 5.5.7 </span> und eine Warenwirtschaft <span style="color:red">ab der Version v2018</span>. Derzeit unterstützen wir <span style="color:red">bis zur Shopware - Version 5.6.2</span>
+
Danach befindet es sich in der Liste ''Deinstalliert''. Mit Klick auf das Plus-Zeichen wird das Plugin installiert.
  
'''Bitte beachten Sie, dass der <span style="color:red">Ion-Cube Loader</span> auf Ihrem Server installiert sein <span style="color:red">muss und eine Version ab 10.2.1 haben sollte</span>.'''
+
[[Datei:Plugin 04.png]]
  
 +
Zum Bearbeiten des Plugins nun den Stift anklicken.
  
Das Plugin erhalten Sie wie zuvor über mention®Connect selbst unter "Einstellungen" -> "Download" in Ihren Shopware-Account. Hier können Sie die Zip-Datei runterladen. Nach dem Download ist es nun möglich das Plugin über das Shopware-Backend hochzuladen unter "Einstellungen" -> "Plugin-Manager" -> "Installiert" -> Button "Plugin hochladen". '''<span style="color:red">Wichtig: Deaktivieren Sie das "Alte Plugin" sofern dieses noch installiert ist.</span>''' Sobald das neue Plugin eingebunden ist, sollten Sie es im Plugin-Manager finden. Nun müssen Sie das Plugin "installieren" und anschließend "aktivieren". Diese Menüpunkte erreichen Sie über den "bearbeiten Button" neben dem Plugin in Ihren Plugin-Manager. '''Die URL für dieses Plugin ist "http//:IhrShop.de/backend/MentionConnectXML"'''
+
[[Datei:Plugin 05.png]]
  
Mit der Neuen Version ist es nun auch möglich Plugin-Einstellungen direkt über mention®Connect zu ändern ohne in das Shopware-Backend zu müssen. Die derzeitige Ansicht der Einstellungen befindet sich noch im Beta-Status und wird mit den nächsten Updates noch Änderungen erhalten.
+
Durch Klick auf den Button ''Aktivieren'' wird das Plugin aktiviert. Fragen nach Leeren des Chaches sowie Kompilieren der Themes sind mit ''Ja'' und ''Kompilieren'' zu bestätigen.
  
[[Datei:Plugin Download und Konfiguration.PNG]]
+
==Anlegen eines API-Benutzers für mention®Connect[[Datei:Star-icon.png]]==
  
Die Plugin-Einstellungen erreichen Sie über den Konfigurieren-Button in Ihrem Shopware-Account in mention®Connect. Über den Button '''abrufen''' werden die Einstellungen runtergeladen. Anders als bisher werden die Eintellungen nun in der Datenbank gespeichert und müssen nicht mehr komplett neu vorgenommen werden, wenn Sie das Plugin löschen und ein neues Plugin einbinden. Auch nach einem Umzug bleiben die Plugin-Einstellungen zu Ihrem Account in der mention-Datenbank gespeichert.
+
Die das Plugin betreffenden Fenster können nun geschlossen werden. Einen API-Benutzer können Sie über ''Einstellungen'' => ''Benutzerverwaltung'' über den Button ''Benutzer hinzufügen'' anlegen.
  
[[Datei:Plugin konfiguration.PNG]]
+
[[Datei:Api-user 01.png]]
  
Das Neue Plugin finden Sie in Ihrer Ordnerstruktur des Shops unter "Shoproot/custom/Plugins".
+
Dieser Benutzer übernimmt die Datenübertragung zwischen mention®Connect und dem Shop. Wichtig bei der Anlage des Benutzers ist der Haken bei API-Zugang. Dieser muss aktiviert sein, damit Sie ein API-Token erhalten, das Sie in den Einstellungen der Shopware5-Schnittstelle angeben. Am besten, Sie kopieren ihn in die Zwischenablage. Das hier zu vergebene Passwort wird an keiner anderen Stelle abgefragt werden, es dient einzig Ihrer Sicherheit.
  
Wir versuchen mit der unterstützten Shopware-Version so aktuell wie möglich zu bleiben. Bitte haben Sie Verständnis dafür, wenn wir eine neue Version nicht 1-2 Tage nach dem Erscheinen freigeben können. Einige Updates erfordern ausgiebiges testen der Version weshalb es mitunter auch etwas länger dauern könnte diese freizugeben. Bitte bedenken Sie, das wir keine Gewähr für Versionen übernehmen die wir nicht freigegeben haben. Die aktuell freigegebene Version können Sie am Anfang dieses Guides erfahren.
+
Außerdem fragt Shopware noch andere Daten ab, die für mention®Connect zwar nicht von Belang, aber Pflichtangaben sind. Im nachfolgenden Screenshot sehen Sie gelb hinterlegt, welche Daten Shopware verlangt.
Prinzipiell unterstützen wir nur Hauptversionen wie z.B. 5.2, 5.3, 5.4 . Allerdings haben wir in der 5.2 und 5.3 auch einige minor-Versionen freigegeben, '''dies ist aber nicht der Standard'''.
 
  
==Anlegen eines API-Benutzers für mention®Connect==
+
[[Datei:Api-user 02.png]]
  
Einen Api-Benutzer können Sie im Backend Ihres Shopware-Shops anlegen. Dieser Benutzer übernimmt die Datenübertragung zwischen mention®Connect und dem Shop. Sie erreichen die Benutzerverwaltung im Backend über "Einstellungen" -> "Benutzerverwaltung".
+
==Allgemeine Einstellungen mention®Connect[[Datei:Star-icon.png]]==
Hier können Sie über den Button "Benutzer hinzufügen" einen neuen Benutzer für mention®Connect anlegen. Wichtig bei der Anlage des Benutzers ist der Haken unter API-Zugang. Dieser muss aktiviert sein damit Sie ein Api-Token erhalten den Sie in mention®Connect als Login benutzen müssen.
 
  
Außerdem verlangt Shopware noch einige andere Daten die aber für mention®Connect nicht weiter wichtig sind. Im nachfolgenden Screenshot sehen Sie gelb hinterlegt, welche Daten Sie im Shopware-Backend noch befüllen müssen.
+
Die allgemeinen Einstellungen erreichen Sie über den Karteikartenreiter mit der Aufschrift Einstellungen. Pflichtangaben:
  
[[Datei:Api-Benutzer anlegen.PNG]]
+
*Nach Aktivieren des Änderungsmodus (Schaltfläche Ändern unten) Klick auf ''Datenbankeinstellungen…'', dort Verbindungsdaten eingeben, testen und speichern.
 +
*Klick auf den Button bei ''Neue Lizenzdatei auswählen'', Auswahl der Lizenz im Explorer.
  
==Einstellungen mention®Connect für Shopware==
+
[[Datei:Connect - Einstellungen.png]]
  
Wie bei allen Accounts müssen Sie zu aller erst einen Mandanten und das oder die dazugehörigen Läger wählen. Anschließend müssen Sie noch einen mention-Benutzer auswählen und einen VK-Preis sowie einen Kategoriebaum auswählen, den Sie mit diesem Shop verwenden möchten.
+
==Einstellungen Shopware5-Schnittstelle==
Als nächsten müssen Sie noch die URL zu Ihrem Shop-Backend angeben und einen API-Benutzer samt API-Schlüssel hinterlegen. Die letzte Einstellungen die nötig sind, befinden sich bei dem Up- und Downloadreiter. Hier stellen Sie noch den Upload-Intervall sowie den Intervall für Bestellungen und Paketnummern ein. Nach diesen Einstellungen könnte die Schnittstelle theoretisch schon in einem Automatikbetrieb laufen.
 
  
Bitte schauen Sie sich aber auch die anderen Einstellungen und Erklärungen dazu an, damit Sie die Schnittstelle für Ihre Bedürfnisse richtig Einstellen können.
+
===Allgemeine Einstellungen===
 +
[[Datei:Connect - Allgemeine Einstellungen.png]]
  
'''Die nachfolgenden Screenshots dienen als Hilfe und Beispiel. Die dort vorgenommenen Einstellungen können für Sie unter Umständen nicht praktikabel sein.'''
+
'''Logo'''
  
[[Datei:Einstellungen1.PNG]]
+
Hier können Sie ein eigenes Logo für die Schnittstelle in Connect hinterlegen. Für das bestmögliche Ergebnis sollte das Bild quadratisch sein (Breite = Höhe).
[[Datei:Einstellungen2.PNG]]
 
[[Datei:Einstellungen3.PNG]]
 
  
===Einstellmöglichkeiten Shopware-Account in mention®Connect===
+
'''Titel der Schnittstelle'''[[Datei:Star-icon.png]]
  
'''Logo (optional)'''
+
Wählen Sie hier einen Titel für die Schnittstelle. Dieser wird Ihnen wie auch das Logo ausschließlich in mention®Connect angezeigt.
* Hier können Sie ein eigenes Logo für die Schnittstelle hinterlegen. Das Bild sollte die selbe Breite und Höhe besitzen. (z.b. 480px * 480px)
 
  
'''Titel der Schnittstelle'''
+
'''Mandant'''[[Datei:Star-icon.png]]
* Hier können Sie einen Namen für die Schnittstelle festlegen
 
  
'''Mandant'''
+
Legen Sie hier fest, welchen Mandanten die Schnittstelle nutzen soll.
* Legen Sie hier fest welchen Mandat die Schnittstelle benutzen soll
 
** Danach können Sie die Läger auswählen, die die Schnittstelle benutzen darf
 
  
'''Mention Benutzer'''
+
'''Lager (für Artikel)'''[[Datei:Star-icon.png]]
* Legen Sie hier den Benutzer fest mit dem sich die Schnittstelle bei der mentionWAWI anmelden soll
 
  
'''VK-Preis'''
+
Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die der Shop zugreifen soll.
* Hier können Sie den primären VK-Preis den Sie verwenden wollen festlegen. (weitere VK-Preis-Einstellungen sind über das Plugin einzustellen)
+
 
 +
'''Benutzer'''[[Datei:Star-icon.png]]
 +
 
 +
Legen Sie hier den Benutzer fest, mit dem sich die Schnittstelle bei der mention®Warenwirtschaft anmelden soll.
 +
 
 +
'''VK-Preis'''[[Datei:Star-icon.png]]
 +
 
 +
Hier legen Sie den primären VK-Preis, den Sie verwenden wollen, fest. Weitere VK-Preis-Einstellungen sind über das Plugin zu konfigurieren.
  
 
'''Artikel KZ. Archiv ignorieren'''
 
'''Artikel KZ. Archiv ignorieren'''
* Mit aktiver Option können auch archivierte Artikel berücksichtigt und hochgeladen werden
 
  
'''Kategorie'''
+
Mit aktiver Option werden auch archivierte Artikel berücksichtigt und hochgeladen.
* Hier legen Sie fest, welche Kategorie-Baum aus Ihrer Warenwirtschaft für den Shop benutzt werden soll
+
 
 +
'''Kategorie'''[[Datei:Star-icon.png]]
 +
 
 +
Hier legen Sie fest, welcher Kategorie-Baum aus Ihrer Warenwirtschaft für den Shop genutzt werden soll.
  
 
'''Mandantenabh. Kz. Onl verwenden'''
 
'''Mandantenabh. Kz. Onl verwenden'''
* Mit aktiver Option werden nur Artikel berücksichtigt, die unter dem Reiter Online im Feld Mandantenabhängig den Online-Hacken gesetzt haben
+
 
 +
Mit aktiver Option werden nur Artikel berücksichtigt, bei denen auf der Registerkarte Online im Feld Mandantenabhängig den Online-Haken gesetzt haben.
  
 
'''Pfad zu XML-Logdateien'''
 
'''Pfad zu XML-Logdateien'''
* Hier können Sie einen Ordner angeben, in dem Sie die XML-Logs speichern möchten
 
  
'''URL'''
+
Hier können Sie einen Ordner angeben, in den die XML-Logs gespeichert werden.
* Tragen Sie hier die Shop-URL ein wie folgt: "http://IhrShop.de/backend"
+
 
 +
----
 +
 
 +
===Shopware===
 +
[[Datei:Connect - Shopware.png]]
 +
 
 +
'''URL'''[[Datei:Star-icon.png]]
 +
 
 +
Tragen Sie hier die Adresse Ihres Shop-Backends ein, gefolgt vom Namen des Plugins (siehe Screenshot).
 +
 
 +
'''API-Benutzername'''[[Datei:Star-icon.png]]
 +
 
 +
Hier ist der Name des Benutzers gefordert, den Sie im Shopware-Backend für Connect angelegt haben.
 +
 
 +
'''API-Schlüssel'''[[Datei:Star-icon.png]]
 +
 
 +
Geben Sie hier den Schlüssel ein, den Shopware für den API-Benutzer generiert hat.
 +
 
 +
'''Webseitige Schnittstelle'''[[Datei:Star-icon.png]]
 +
 
 +
* Download: Dieser Button hat aktuell keine Funktion.
 +
* Test: Mit diesem Button können Sie die Einträge der Felder URL, API-Benutzername und API-Schlüssel auf Richtigkeit prüfen, indem versucht wird, eine Verbindung mit Ihrem Shopware-Backend herzustellen.
 +
* Konfigurieren: Hiermit rufen Sie die Konfiguration des Plugins ab.
 +
 
 +
Nach dem Klick auf ''Konfigurieren'' ist es erforderlich mit einem weiteren Klick auf ''Abrufen'' die Einstellungen des Plugins aus dem Shop zu übertragen. Für die Ersteinrichtung reicht es, den in mention hinterlegten VK-Gruppen eine Kundengruppe aus Shopware zuzuordnen. Anschließend wird diese Einstellung mit Klick auf ''Speichern'' gesichert.
  
'''API-Benutzername'''
+
[[Datei:Plugin 06.png]]
* Tragen Sie hier den API-Benutzer ein, den Sie für mention®Connect im Shopware-Backend angelegt haben
 
  
'''API-Schlüssel'''
+
----
* Hier tragen Sie den API-Schlüssel Ihres API-Benutzers ein
 
  
'''Webseitige Schnittstelle'''
+
===Up- und Download===
* Mit dem Downloadbutton können Sie das aktuelle Plugin beziehen. Benutzen Sie den Testbutton um zu prüfen ob mention®Connect eine Verbindung zu Ihren Shop herstellen kann
+
 
 +
[[Datei:Connect - Up und Download.png]]
 +
 
 +
Wenn ein Intervall mit: 0 eingestellt ist, wird diese Routine nicht ausgeführt, erst wenn ein Wert höher eingetragen ist. Die Angabe erfolgt auch in Minuten.
  
 
'''Upload-Intervall'''
 
'''Upload-Intervall'''
* Stellen Sie hier ein in welchem Intervall Ihre Artikel updaten soll (mindestens 15 Minuten empfohlen)
 
  
'''Interv. Bestellungen/Paketnummern'''
+
Geben Sie hier ein Intervall in Minuten für den Artikel-Upload an.
* Stellen Sie hier den Intervall ein in welchen Sie Bestellungen abholen, Versand- und Bezahlstadien im Shop, sowie Paketnummern übertragen wollen (mindestens 20 Minuten empfohlen)
+
 
 +
'''Intervall Bestellungen/Paketnummern'''
 +
 
 +
Geben Sie hier ein Intervall in Minuten an für den Download und Import von Bestellungen sowie den Upload von Bestellstatus sowie Paketnummern.
  
 
'''Intervall-Pause'''
 
'''Intervall-Pause'''
* Hier können Sie einstellen in welchen Zeitraum mention®Connect Up- und Download Aktivitäten einstellen soll. mention®Connect schreibt in dieser Zeit nicht in die Datenbank. (meist für Wartungsarbeiten und DB-Sicherungen verwendet)
+
 
 +
Legen Sie hier optional einen Zeitraum fest, in dem keine Up- oder Downloadvorgänge stattfinden sollen.  
  
 
'''DSXML-Account'''
 
'''DSXML-Account'''
* Hier können Sie einen Account aus der DSXML auswählen. Mit dem eingetragenen Account können Sie über Zuordnung Accounts bestimmte Artikel oder Kategorien ggf. Offline schalten, sowie spezifische Daten über onlinedaten je Account verwalten
+
 
 +
Optional kann ein DSXML-Account angegeben werden, um z.B. mehrere Shops bzw. mehrere Vertriebskanäle eines Mandanten zu trennen. Die Zuordnung der Artikel erfolgt in den Artikelstammdaten (Registerkarte Online).  
  
 
'''Max. Artikel/Upload'''
 
'''Max. Artikel/Upload'''
* Hier können Sie mention®Connect dazu zwingen bei einem Uploadintervall nur eine bestimmte Menge von Artikeln zu berücksichtigen. (Standard 0, wir meist bei Artikelstammdaten > 20.000 verwendet)
 
  
'''Zuordnungen'''
+
Die maximale Anzahl zu übertragender Artikel pro Uploadvorgang.
* Hier treffen Sie unter Zahlarten und Versandarten die Zuordnung zwischen Zahl- und Versandarten zwischen mention und Shopware.
+
 
 +
----
 +
 
 +
===Zuordnungen===
 +
[[Datei:Connect - Zuordnungen.png]]
 +
 
 +
'''Zahlarten'''[[Datei:Star-icon.png]]
 +
 
 +
Über den Button Abrufen rufen Sie die in Shopware 5 hinterlegten Zahlarten ab.
 +
Bitte ordnen Sie diese den entsprechenden Zahlarten von Mention zu.
 +
 
 +
'''Versandarten'''
 +
 
 +
Der Abruf aller im Shop vorhandenen Versandarten lässt die Shopware-API aktuell nicht zu. Beim Bestellimport wird diese Liste automatisch mit den in den Bestellungen vorhandenen Versandarten gefüllt.
 +
Bitte ordnen Sie diese den entsprechenden Versandarten von Mention zu.
 +
 
 +
'''VK-Preise zu Kundengruppen'''[[Datei:Star-icon.png]]
 +
 
 +
Über den Button Abrufen werden die in Shopware hinterlegten Kundengruppen übertragen.
 +
Hier können Sie hinterlegen, welche Kundengruppe aus dem WWS welchen VK-Preis in Shopware angezeigt bekommt.
 +
 
 +
'''Fremdsprachenzuordnung'''
 +
 
 +
Über den Button Abrufen rufen Sie die in Ihrem Shop angelegten Sprachshops ab.
 +
Hier können Sie den Sprachshops die jeweiligen Sprachen aus mention zuordnen.
 +
 
 +
----
 +
 
 +
===Behandlung Bestand===
 +
[[Datei:Connect - Behandlung Bestand.png]]
  
 
'''Best. Online verwenden'''
 
'''Best. Online verwenden'''
* Mit aktiver Option verwendet mention®Connect nur den Online-Bestand aus der Warenwirtschaft
+
 
 +
Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.
  
 
'''Best. zzgl. Bestellte'''
 
'''Best. zzgl. Bestellte'''
* Mit aktiver Option berücksichtigt mention®Connect auch Einkäufe aus mention heraus zu Ihren Lieferanten und überträgt Bestand zuzüglicher der bestellten Menge bei Ihrem Liferanten
 
  
'''Best. abzgl. in Nachbearbeitung'''
+
Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.
* Mit aktiver Option berücksichtigt mention®Connect Bestandsbuchungen aus Bestellungen die noch einer Überarbeitung bedürfen (z.B. Zuordnung einer Zahl- oder Versandart)
+
 
 +
'''Bestand abzgl. in Nachbearbeitung'''
 +
 
 +
Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.
 +
 
 +
'''Bestand abzgl. Dsxml in Nachbearbeitung'''
 +
 
 +
Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung  in der DSXML-Schnittstelle vom Bestand abgezogen.
 +
 
 +
'''Sperrbest abziehen'''
  
'''Sperrbestand abziehen'''
+
Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.
* Mit aktiver Option zieht mention®Connect den Sperrbestand in mention von Ihrem Bestand ab und überträgt die Differenz
 
  
 
'''Vorbestellte abziehen'''
 
'''Vorbestellte abziehen'''
* Mit aktiver Option zieht mention®Connect Bestände aus Bestellungen ab, die noch nicht abgeschlossen sind und überträgt die Differenz (wenn z.B. der Kunde noch nicht bezahlt hat)
+
 
 +
Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.
 +
 
 +
'''Änderungsdatum Lager deaktiviert'''
 +
 
 +
Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.
 +
 
 +
'''Bestände von Gruppenmitgliedern abschneiden'''
 +
 
 +
Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.
 +
 
 +
----
 +
 
 +
===Neue Kunden===
 +
[[Datei:Connect - Neue Kunden 200713.png]]
 +
 
 +
'''Manuelle Kundenzuordnung'''
 +
 
 +
obsolet/ohne Funktion
 +
 
 +
'''Kennz. Online n. Kunden''' (Kennzeichen Online neue Kunden)
 +
 
 +
Wenn diese Einstellung aktiv ist, wird beim Anlegen eines Ansprechpartners das ''Online'' Feld aktiviert.
 +
 
 +
'''Behandlung Name'''
 +
 
 +
Wenn ''Standard Behandlung'' aktiviert ist, werden Vorname und Nachname zusammen in ''Name2'' gespeichert. Wenn ''Privat Person: Vorname = Name1, Nachname = Name2'' ausgewählt ist, wird der Vorname in das Feld ''Name1'' gespeichert und das Feld ''Name2'' mit dem Nachnamen befüllt.
 +
 
 +
'''Kunden in mention akt.''' (Kunden in mention aktualisieren)
 +
 
 +
Sofern aktiv, werden Kundendaten in mention aktualisiert, wenn eine Kundennummer oder eine Email übergeben wird und der Kunde identifiziert werden kann.
 +
 
 +
'''Weitere Adresszeilen'''
 +
 
 +
Wenn aktiv, wird der Firmenname aus dem Shop in das Feld ''Name3'' eingetragen.
 +
 
 +
'''KD Kennz. Endkunde'''
 +
 
 +
Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im Kundenstamm als Endkunde gekennzeichnet.
 +
 
 +
'''Druckoptionen Email'''
 +
 
 +
Wenn aktiv, wird im Kundenstamm unter Druckoptionen ''E-Mail'' auf aktiv gesetzt.
 +
 
 +
'''Druckoptionen nicht drucken'''
 +
 
 +
Bei aktiv wird im Kundenstamm unter Druckoptionen ''nicht drucken'' aktiviert.
 +
 
 +
'''Weitere SA: Nur Lieferschein'''
 +
 
 +
Wenn aktiv, wird im Kundenstamm unter ''Weitere'' die Einstellung ''SA: Nur Lieferschein'' auf aktiv gesetzt.
 +
 
 +
'''Vorlage Kundennummer'''
 +
 
 +
Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen Datensatz folgende Werte als Standard bei der Neuanlage verwendet:
 +
 
 +
* Versicherung (Weitere)
 +
* Endkunde (Weitere)
 +
* SA: nur Lieferschein (Weitere)
 +
* Versandart (Weitere)
 +
* Währung (Weitere)
 +
* Transportweg (Weitere)
 +
* Kennwort (Weitere)
 +
* Adresse (Weitere)
 +
* VK-Preis akzeptieren (Weitere)
 +
* Format (Weitere)
 +
* Mahnung (Weitere)
 +
* Zahlart (Weitere)
 +
* Frachtfrei (Weitere)
 +
* Frachtfrei ab Wert (Weitere)
 +
* Werkstatt (Weitere)
 +
* Mindestfrachtkosten (Weitere)
 +
* nicht Drucken (Druckoptionen)
 +
* E-Mail (Druckoptionen)
 +
* LFS, Leih-/Teststellung (Weitere)
 +
* Proforma-Rechnung (Weitere)
 +
* Keine Automatik (Weitere)
 +
* Liefersperre (Weitere)
 +
* Preis (Weitere)
 +
* Keine Staffelpreise (Weitere)
 +
* Kalkulation (Weitere)
 +
* Konditionen (Weitere)
 +
* Rabatt (Weitere)
 +
* Limit (Weitere)
 +
* Limit intern (Weitere)
 +
* Gültigkeit von Limit (Weitere)
 +
* Gültigkeit von Limit intern (Weitere)
 +
* Rückscheck/RLS (Weitere)
 +
* Factor-Nr. (Weitere)
 +
* Gilt für Anschriften (Weitere)
 +
* Rabatt drucken (Weitere)
 +
* Sprachschlüssel (Weitere)
 +
* Neue Nummer (Stammdaten)
 +
* Gebiet (Stammdaten)
 +
* Kennzeichen (Stammdaten)
 +
* Keine Werbung (Stammdaten)
 +
* Keine Fax-Werbung (Stammdaten)
 +
* Keine E-Mail-Werbung (Stammdaten)
 +
* Keine Post-Werbung (Stammdaten)
 +
* Seriennummer extra drucken (Stammdaten)
 +
* Belegdruck mit Seriennummern (Stammdaten)
 +
* Warenausgangsetiketten nicht drucken (Stammdaten)
 +
* Nicht Aktiv (Stammdaten)
 +
* Techniker (Stammdaten)
 +
* Außendienst (Stammdaten)
 +
 
 +
Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen geprüft.
 +
 
 +
'''Kd.-Name1 prüfen Anzahl Zeichen'''
 +
 
 +
Anzahl der Stellen, die im Feld ''Name1'' überprüft werden sollen
 +
 
 +
'''Kd.-Name2 prüfen Anzahl Zeichen'''
 +
 
 +
Anzahl der Stellen, die im Feld ''Name2'' überprüft werden sollen
 +
 
 +
'''Kd.-Name3 prüfen Anzahl Zeichen'''
 +
 
 +
Anzahl der Stellen, die im Feld ''Name3'' überprüft werden sollen
 +
 
 +
'''Kd.-Straße prüfen Anzahl Zeichen'''
 +
 
 +
Anzahl der Stellen, die im Feld ''Straße'' überprüft werden sollen
 +
 
 +
'''Kd.-PLZ prüfen Anzahl Zeichen'''
 +
 
 +
Anzahl der Stellen, die im Feld ''PLZ'' überprüft werden sollen
 +
 
 +
'''Kd.-Ort prüfen Anzahl Zeichen'''
 +
 
 +
Anzahl der Stellen, die im Feld ''Ort'' überprüft werden sollen
 +
 
 +
'''Abteilung in Name3 speichern'''
 +
 
 +
Speichert das Feld 'Abteilung' in Name 3 der Kundenadresse
 +
 
 +
'''Adressen mit Knz. Direktlieferung berücksichtigen'''
 +
 
 +
Bei der Kundensuche werden bei aktivierter Einstellung Adressen mit dem Kennzeichen Direktlieferung nicht berücksichtigt.
 +
 
 +
----
 +
 
 +
===Belegdaten===
 +
[[Datei:Connect - Belegdaten200713.png]]
  
 
'''Bezug1 Beleg'''
 
'''Bezug1 Beleg'''
* Der eingetragene Text erscheint im Beleg im Feld Bezug1
+
 
 +
Text, der im Beleg unter ''Bezugnahme'' eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.
 +
 
 +
'''Hinweis Beleg'''
 +
 
 +
Text, der im Beleg unter ''Hinweise'' eingesetzt wird
  
 
'''Sperrkennzeichen'''
 
'''Sperrkennzeichen'''
* Hier können Sie ein Sperrkennzeichen für diesen Shop festlegen der in Ihren Belegen auftaucht und als Info für Ihre Bearbeiter in der Buchhaltung dient
 
  
'''Kennz. Online n. Kunden'''
+
Hier kann man ein Sperrkennzeichen für Belege zuweisen.
* Mit aktiver Option wird bei der Neuanlage eines Kunden der Online-Haken unter Ansprechpartner gesetzt
 
  
'''Kennz. Direktliferung'''
+
'''Kennz. Direktlieferung''' (Kennzeichen Direktlieferung)
* Mit aktiver Option wird bei Anlage eines neuen Kunden das Kennzeichen Direktlieferung gesetzt
 
  
'''Kennz. Automatik'''
+
Falls aktiv, wird in mention das Feld ''Direktlieferung'' aktiviert.
* Mit aktiver Option wird bei Anlage eines neuen Kunden das Kennzeichen Automatik gesetzt
+
 
 +
'''Kennz. Automatik''' (Kennzeichen Automatik)
 +
 
 +
Falls aktiv, wird in mention das Feld ''Automatik'' auf aktiv gesetzt.
  
 
'''TransaktionsID Bezahlsystem'''
 
'''TransaktionsID Bezahlsystem'''
* Hier können Sie auswählen ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll
 
  
'''Behandlung Name'''
+
Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.
* Hier haben Sie die Auswahl nach welcher Konvention die Namensbehandlung für das Erkennen von Kunden eingestellt werden soll (Bitte Standard Einstellungen verwenden. Sonderprogrammierung für einen bestimmten Kunden)
+
 
 +
'''Debitoren nicht berücksichtigen'''
 +
 
 +
Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.
 +
 
 +
'''Bestellkommentare nach'''
 +
 
 +
Hier kann ausgewählt werden, wo Bestellkommentare in einer Bestellung gespeichert werden sollen: Als Hinweistext im Belegs oder Zusatztext Beleg.
 +
 
 +
'''Belegsperre bei Bestellkommentar'''
 +
 
 +
Enthält eine Bestellung einen Bestellkommentar, kann hier eine Belegsperre für diese Bestellung gesetzt werden.
 +
 
 +
'''Konstanter Wert – Externe Referenz 1 bis 3'''
 +
 
 +
Hier können konstante Werte für die mention-Felder ''Externe Referenz 1 bis 3'' definiert werden.
 +
 
 +
'''Zahlungsbedingung Stammdaten/Kunden'''
 +
 
 +
Wenn aktiv, soll nicht die zugewiesene Zahlungsbedingung verwendet werden, sondern die aus dem Kundenstamm.
 +
 
 +
'''Rabatt aus SD/Kd berücksichtigen'''
 +
 
 +
Wenn aktiv, soll beim Bestellimport der Rabatt aus dem Kundenstamm (Registerkarte ''Weitere'') angewendet werden.
 +
 
 +
----
 +
 
 +
===Artikel===
 +
[[Datei:Connect - Artikel.png]]
 +
 
 +
'''Upload-Intervall Bestand'''
 +
 
 +
Intervall in Minuten zur Aktualisierung des Bestands, unabhängig vom Artikelupload (0 = inaktiv).
 +
 
 +
'''Upload-Intervall Preise'''
 +
 
 +
Intervall in Minuten zur Preisaktualisierung (0 = inaktiv). Um den Preisupload nutzen zu können, ist es erforderlich, unter '''Zuordnungen''' die Zuweisung der Kundengruppen zu Verkaufspreisen zu tätigen. Gibt es zu einer Kundengruppe kein Mapping, wird sie beim Preisupload ignoriert.
 +
----
 +
 
 +
===Benutzerdefinierte Artikelfelder zu Shopware-Attribute===
 +
[[Datei:Connect - Bendef Felder.png]]
 +
 
 +
'''Attribut 1 – 10'''
  
'''Kunden in mention akt.'''
+
In Shopware sind 10 Freitextfelder verfügbar (im Backend unter Einstellungen => Freitextfeld-Verwaltung konfigurierbar), die mit beliebigen benutzerdefinierten Feldern aus mention gefüllt und hier gemappt werden können.
* Mit aktiver Option wird Ihr Kunde bei Adressänderungen im Shop auch in Ihrer Warenwirtschaft aktualisiert
 
  
'''Weitere Adresszeile'''
+
----
* Mit aktiver Option wird die Adresszeile1 aus dem Shop in Name3 in mention gespeichert sofern der Firmenname nicht zu lang ist. (Bitte Verwendung vermeiden. Sonderprogrammierung für einen bestimmten Kunden)
 
  
'''Offline abgleich'''
+
===Shopware Belegfelder zu mention Belegfelder===
* Mit aktiver Option können Sie Artikel durch entfernen des Online-Hakens in mention für den Shop inaktiv schalten sofern dieser bereits im Shop war. (hat nur einen Einfluss auf bereits übertragende Artikel- Option aktiv stellen wird empfohlen)
+
[[Datei:Connect - Shopware Belegfelder.png]]
  
'''Anzahl Artikel / Upload'''
+
'''Partner-ID-Code'''
* Hier können Sie festlegen wie groß die XML-Dateien werden indem Sie die Artikel pro XML begrenzen (mit 0 berechnet mention®Connect es automatisch)
 
  
'''Kategorien exportieren'''
+
Hier kann man dem Feld ''PartnerID'' von Shopware ein Belegfeld in mention zuweisen.
* Mit aktiver Option können Sie Ihren Kategoriebaum aus der Warenwirtschaft in Ihren Shop exportieren
 
  
'''Zu exportierende Bilder'''
+
'''Geräte-ID'''
* Hier können Sie festlegen welche Bilder mention®Connect berücksichtigen soll
 
  
== Anbindung Geschäftskundenmodul mit mention®Connect und Shopware 5 ==
+
Hier kann man dem Feld ''GeräteID'' von Shopware ein Belegfeld in mention zuweisen.
  
Zur Hilfe des Geschäftskundenmoduls gelangen Sie über [http://hilfe.mention.de/index.php?title=DHL_Geschaeftskundenversand]
+
'''Attribut 1 – 6'''
  
Möchten Sie die Versandmöglichkeiten die Sie von DHL bekommen haben mit mention®Connect in Verbindung mit Shopware nutzen finden Sie in dem folgenden Artikel alle Informationen die Sie benötigen. Wir zeigen Ihnen an einem konkreten Beispiel was Sie tun müssen um auch die "richtigen" Versandarten in Ihren Belegen zu haben.  
+
Shopware bietet 6 Attributfelder, hier kann eins ausgewählt und einem Feld im mention Beleg zugewiesen werden.
Wir beleuchten hier folgendes Szenario:
 
  
 +
----
  
Wir als Kunde von DHL haben folgende Abrechnungsnummern für den Versand von DHL bekommen:
+
===Kategorien===
<ul>
+
[[Datei:Connect - Kategorien 200708.png]]
<li>
 
Abrechnungsnummer DHL Paket Austria: 12345678901234 – Österreich </li>
 
<li>
 
Abrechnungsnummer DHL Paket Connect bis 13kg: 12345678901234 – Belgien, Deutschland, Luxemburg, Niederlande, Polen, Slowakei, Tschechien </li>
 
<li>
 
Abrechnungsnummer DHL Paket Connect ab 14 kg: 12345678901234 - Belgien, Deutschland, Luxemburg, Niederlande, Polen, Slowakei, Tschechien </li>
 
<li>
 
Abrechnungsnummer DHL Paket International: 12345678901234 – Frankreich, Spanien, Italien, Griechenland, Großbritannien, Norwegen, Schweden, Finnland </li>
 
</ul>
 
  
 +
'''Kategorien exportieren'''
  
'''In der mention Warenwirtschaft '''
+
Wenn diese Einstellung aktiv ist, werden Kategorien in den Shop übertragen.
  
Diese Versandarten zu den Berechnungsnummern von DHL müssen wir zuerst einmal in der Warenwirtschaft unter "Voreinstellungen" > "Mandanten" > "Verkauf" > "Versandarten..." anlegen.
 
  
[[Datei:Versandarten Warenwirtschaft.PNG]]
+
'''Sprache als Kategoriebaum anlegen''' (ab Version vom 08.07.2020)
  
 +
Wenn aktiv, werden die in Mention hinterlegten Sprachen als Kategoriebaum angelegt.
  
'''Im Shopware Backend'''
+
Die Voraussetzungen sind:
  
Damit auch unser Shopware-Backend über diese Versandarten verfügt müssen wir diese hier ebenfalls manuell anlegen. Wichtig ist, dass wir hier nun auch die Länder und Gewichte sowie etwaige andere Einstellungen vornehmen können.
+
1) Im Shopware-Backend muss eine Hauptkategorie, unter "Artikel/Kategorien/Hinzufügen" angelegt werden, die genau so heißt wie das Kennzeichen oder die Bezeichnung(in Mention das Feld "Sprache") der Mention Sprache.
Um neue Versandarten in Shopware anzulegen gehen Sie auf "Einstellungen" > "Versandkosten"
 
  
[[Datei:Einstellungen versandarten.PNG]]
+
2) Danach muss man unter "Einstellungen/Grundeinstellungen/Shopeinstellungen/Shops" ein Sprach-Shop anlegen, hierbei muss man die zuvor angelegte Hauptkategorie in dem Feld Kategorie angeben.
  
Shopware stellt uns eine Vielzahl von Möglichkeiten zur Einrichtung von Versandarten zur Verfügung. Über bestimmte Länder, Kundengruppen, Preisgrenzen, Zeitgrenzen, Gewichtsgrenzen, Zahlarten, Shop-Kategorien können die Versandarten komplett individuell angepasst werden. In unseren Beispiel benötigen wir aber nur Gewichte und Länder die wir den Versandarten zuordnen müssen. Bei dem Erstellen eine neuen Versandart sind erst einmal folgende Pflichtfelder auszufüllen:
+
3) Nachdem Sie den Sprach-Shop erstellt haben müssen Sie nachträglich nochmal das Feld "Übersetzungen übernehmen" mit dem selben Sprach Shop füllen.
  
<ul>
 
<li>
 
Name:                        Name der Versandart</li>
 
<li>
 
Beschreibung:                Beschreibungstext zu der Versandart</li>
 
<li>
 
Versandkostenberechnung:      wonach die Versandkosten berechnet werden (in unserem Fall Berechnung nach Gewicht)</li>
 
<li>
 
Versandart-Typ:              z.B. Standardversand, Ausweichversand (in unseren Fall Standardversand)</li>
 
<li>
 
Aktiv:                        ob diese Versandart aktiv ist heisst ob Sie dem Kunden zur Verfügung steht </li>
 
</ul>
 
Uns interessieren in unserem Beispiel hauptsächlich der Reiter "Länder-Auswahl" und "Erweiterte Einstellungen". Bei der Länderauswahl tragen wir nun die Länder ein die uns DHL für diese Berechnungsnummer vorgibt. Bei den "Erweiterten Einstellungen" können wir nun auch das Gewicht eintragen, welches für diese Versandart gelten soll. Übersteigt oder unterschreitet das Gewicht die angegebenen Werte die hier eingestellt sind, so ist die Versandart für den Kunden nicht verfügbar.
 
  
[[Datei:Länder Auswahl Versandkosten.PNG]]
+
'''Sprach-Shop Konfiguration'''
[[Datei:Erweiterte Eintstellungen Versand.PNG]]
+
<br><br>
 +
[[Datei:SprachShopKorrekt.png]]
  
 +
----
  
''' In mention®Connect '''
+
===Zu exportierende Bilder===
 +
[[Datei:Zu exportierende Bilder Connect 01.png]]
  
In mention®Connect muss als erstes solch eine Bestellung eintreffen. Wenn wir eine Bestellung mit dieser Versandart haben können wir diese im Shopware-Account unter "Einstellungen" > Menüpunkt "Zuordnungen" > Tabelle "Versandarten" mit der jeweiligen Versandart aus der mention Warenwirtschaft zuordnen. Diesen Vorgang müssen wir auch für die Zahlarten durchführen. Dort müssen wir aber nichts besonderes beachten und ordnen "prepayment" z.B. Vorkasse zu.
+
'''Bilder'''
  
[[Datei:Zuordnung mentionConnect.PNG]]
+
Wenn aktiv, werden Artikelbilder in den Shop übertragen.
  
Wichtig ist, dass für jede der vier Versandarten eine Bestellung vorhanden sein muss um diese auch zuordnen zu können. Sie können für diesen Fall natürlich 4 Fake-Bestellungen auslösen damit Sie die Zuordnung bei der ersten "richtigen Bestellung" direkt verfügbar haben.
+
'''Bild-Hash-Wert prüfen'''
  
==Übertragung weiterer Daten==
+
Wenn aktiv, wird mittels eines Hash-Werts bei Änderung eines Artikels überprüft, ob das in mention hinterlegte Bild dem in Shopware entspricht. Ist dem nicht so, wird das Bild aus mention hochgeladen.
===Grundpreise===
 
  
Bei manchen Artikeln ist es notwendig Grundpreisangaben zu hinterlegen und diese dem Endkunden direkt im Frontend anzuzeigen. Letztendlich basiert der Grundpreis auf einen errechneten Wert vom Verkaufspreis und einem Faktor der mittels Mengeneinheit dargestellt wird. Um dies in Ihren Shops abzubilden sind folgende Daten in Ihrer Warenwirtschaft zu füllen:
+
'''Bild Übertragung erzwingen'''
  
* Eingabe eines Grundpreiskoeffizienten unter "Stammdaten -> Artikel -> Preise"
+
Wenn aktiv, wird beim manuellen Artikelupload über Stammdaten die Bildübertragung erzwungen. Das bedeutet, dass alle dem Artikel zugeordneten Bilder hochgeladen werden, unabhängig davon, ob sie bereits im Shop vorhanden sind. Wenn inaktiv, werden nur die Bilder hochgeladen, welche neu sind oder geändert wurden.
* Eine Mengeneinheitsangabe z.B. pro Liter oder pro Kilogramm unter "Stammdaten -> Artikel -> Stammdaten"
 
  
 +
'''Bild1 – Bild10'''
  
====Ansicht im Frontend:====
+
Hier kann man wählen, welche Bilder aus mention übertragen werden sollen.
  
[[Datei:Frontend grundpreis.PNG]]
+
'''XSLT Einstellung'''
  
====Einstellungen in mention für den Grundpreis:====
+
Der Button öffnet nach Klick ein Fenster, in welchem man das Standard XSLT anpassen kann. Dies ist nur zu empfehlen, sofern man ein angepasstes Plugin von Drittanbietern nutzt oder spezielle Daten benötigt.
  
[[Datei:Artikel stammdaten grundpreis.PNG]]
+
'''Abbildungspfadteil von und zu'''
[[Datei:Artikel preise grundpreis.PNG]]
 
  
'''Der Grundpreis-Koeffzient ergibt sich aus der Vergleichsmenge (100ml) geteilt durch die Mengeneinheit des Artikel (50ml). 100ml / 50ml = 2 (diese Ziffer tragen wir unter Grundpreis-Koeffzient ein)'''
+
"Abbildungspfadteil von": Definiert den Bildpfad-Abschnitt der überschrieben werden soll.
  
 +
"Abbildungspfadteil zu": Legt den Abbildungspfad fest, der beim Überschreiben hinterlegt wird.
  
 
----
 
----
  
===Merkmale===
+
===Bilder-Upload ohne Zuweisung===
 +
[[Datei:Connect - Bilder ohne Zuweisung.png]]
 +
 
 +
'''Freitextf.: Bild-Upload ohne Zuweis.'''
  
Merkmale auf Attribute genannt, beschreiben bestimmte Eigenschaften eines Produktes. Bei einem Monitor zum Beispiel könnte man Attribute wie Bildschirmdiagonale, Reaktionszeit, Auflösung, Paneltypen, Bildformat, Technologie etc. angeben. Diese Merkmale oder auch Attribute dienen dem Endkunden dazu alle relevanten Daten zu einem Artikel auf einem Blick sortiert zu sehen. Für die Übertragung Ihrer Merkmale müssen Sie folgende Daten in den Artikelstammdaten, im Plugin und im Backend hinterlegen:
+
Hier kann man ein Freitextfeld definieren, in welches die MediaIDs der Bilder geschrieben werden sollen, beispielsweise zur Weiterverarbeitung mit entsprechenden Plugins. Sobald Bilder übertragen worden sind, wird eine MediaID für jedes Bild erstellt. Diese wird dann in das definierte Freitextfeld geschrieben, in der Reihenfolge: Bild 10 – 1.
  
* Erstellen Sie ein Merkmalset im Backend unter "Artikel -> Eigenschaften -> Set hinzufügen"
+
'''Bild 1 Upload – Bild 10 Upload'''
* Tragen Sie in den Artikelstammdaten eine FSK-ID unter "Stammdaten -> Artikel -> Online -> FSK" ein
 
* Machen Sie im Plugin das Matching wie folgt: "FSK-ID=Mermalset-Name"
 
  
====Ansicht im Frontend====
+
Hier können die Bildpositionen ausgewählt werden, die auf den Media Server hochgeladen werden sollen.
  
[[Datei:Ansicht frontend merkmale.PNG]]
+
----
  
====FSK-ID in mention hinterlegen:====
+
===Kundenupload===
 +
[[Datei:KundenUpload_Einstellung.png]]
  
[[Datei:Fskid mention.PNG]]
+
'''Kundennummer im Shop überschreiben'''
  
====Merkmalset im Backend====
+
Wenn aktiv, wird die Kundennummer im Shop mit der Kundennummer aus der Mention überschrieben.
  
[[Datei:Merkmalset im backend.PNG]]
+
'''Bestehende Kunden beim Upload überschreiben'''
  
====Matching im <span style="color:blue">alten</span> Plugin====
+
Diese Einstellung gibt an, ob bereits übertragene Kunden im Shop nochmal übertragen werden sollen. Bei der Auswahl ''Übertragen'' werden beim erneuten Hochladen eines Kunden folgende Daten im Shop überschrieben:
  
[[Datei:Plugin einstellungen.PNG]]
+
* E-Mail-Adresse
 +
* Vorname
 +
* Nachname
 +
* Anrede
 +
* Kundengruppe
 +
* Zahlungsart
 +
* Kundennummer
 +
* Sprache
 +
* Rechnungsadresse
  
Wie Sie sehen können dient das Plugin als Schnittstelle zwischen Ihrer Warenwirtschaft und dem Shop. Weshalb Sie hier FSK-ID in mention auf eine Merkmalset im Shop matchen müssen.
+
'''Neue Kunden automatisch hochladen'''
  
====Matching im <span style="color:blue">neuen</span> Plugin====
+
Mit dieser Einstellung kann man einstellen, ob ein neuer Kunde in der Automatik übertragen werden soll. Mit neuer Kunde ist ein Kunde gemeint, welcher noch nicht von Connect an den Shop übermittelt wurde.
  
[[Datei:Plugineinstellungen neu.PNG]]
+
'''geänderte Kunden automatisch hochladen'''
  
Die Plugin-Einstellungen des neuen Plugin erreichen Sie in Ihrem mention®Connect-Shopwareaccount. Klicken Sie dazu auf den "Konfigurieren-Button" und danach auf "Abrufen-Button". Die Einstellungen werden hier dann wie im alten Plugin in dem MENTION_PRODUCTS_FILTER_MAPPING hinterlegt. Bitte trennen Sie die einzelnen Merkmalsets durch ein "''','''".
+
Hier kann man einstellen, ob ein bereits hochgeladener Kunde in der Automatik übertragen werden soll. Hier sind ausschlie&szlig;lich Kunden gemeint, welche bereits von Connect an den Shop übermittelt wurden.
  
 
----
 
----
  
===Mehrsprachigkeit===
+
===Upload Kundenbelege===
 +
[[Datei:Connect - Upload Kundenbelege neu.png]]
  
Shopware unterstützt das Modell der Multilingualität in Ihrem Shop. Allerdings ist nur Englisch als einzige Fremdsprache mit Texten vordefiniert weshalb Sie für alle anderen Sprachen dann die Feldbezeichnungen des Hauptshops erhalten. (bzw in der Sprache des Hauptshops) Für weitere Sprachen müssen Sie die jeweiligen Sprachpakete für Shopware erwerben. In der mention Warenwirtschaft können Sie allerdings Sprache anlegen und mit jeweiligen Texten befüllen.
+
Die hochgeladenen Belege sind für Kunden nicht automatisch ersichtlich. Hierfür ist der Einsatz von Drittanbieter-Plugins erforderlich.
  
* Hinterlegen Sie die gewünschte Sprache in der dsmain unter "Voreinstellungen -> Global -> Sprachen"
+
'''Belege übertragen'''
* Sie können nun Kategorien und Artikeln weitere Texte für andere Sprachen hinterlegen dazu klicken Sie auf den Button mit den drei Punkten neben Textfelder
 
* Erstellen Sie im Shopware-Backend eine Hauptkategorie mit der/den Sprache/n unter "Artikel -> Kategorien -> Hinzufügen"
 
* Fügen Sie die Sprache dem Shop hinzu und achten Sie bei Kategorie darauf die richtige Sprache zu wählen unter "Einstellungen -> Grundeinstellungen -> Shopeinstellungen -> Shops"
 
* Rufen Sie als nächstes die angelegte Sprache nochmals auf und aktivieren Sie durch Auswahl "Übersetzung annehmen" die gewünschte Übersetzung
 
  
====Ansicht im Frontend====
+
Wenn aktiv werden Belege, welche von Mention als PDF erstellt wurden, übertragen. Es werden hier nur PDF-Dateien übertragen.
 +
Das Verzeichnis, in dem nach Belegen gesucht wird, muss im Mention WWS eingestellt werden: ''Voreinstellungen/Mandant/Voreinstellungen Verkauf/Drucken 2/Alle Belege als PDF in Verzeichnis ablegen''.
  
[[Datei:Artikel frontend multi.PNG|1500px]]
+
'''Belege ab'''
  
====Mehrsprachigkeit in der dsmain====
+
Jüngstes Datum hochzuladender Kundenbelege. Alle Belege, welche vor diesem Datum liegen werden nicht berücksichtigt.
  
Die Sprachtabelle in der mention Warenwirtschaft erreichen Sie über '''Voreinstellungen -> Global -> Sprachen'''. Für die hier angelegten Sprachen können Sie z.B. in den Artikelstammdaten multilinguale Texte hinterlegen. Wichtig für Shopware ist, dass Sie die Kategorien ebenfalls in weiteren Sprachen hinterlegen.
+
'''PDF nach Upload löschen'''
  
[[Datei:Laendertabelle mention.PNG]] [[Datei:Multilingualitaet kategorien.PNG]]
+
Wenn aktiv, werden die hochgeladenen Dateien aus dem Quellverzeichnis gelöscht.
[[Datei:Multilingualitaet artikel.PNG]][[Datei:Multilingualitaet artikel erweitert.PNG]]
 
  
====Mehrsprachigkeit im Shopware Backend====
+
----
  
Als erstes müssen Sie in Shopware eine Hauptkategorie für die zusätzlichen Sprache anlegen. Gehen Sie dazu im Backend auf: Artikel -> Kategorien, markieren Sie nun die Hauptkategorie, in unserem Beispiel ist das '''Shopware''' und fügen Sie eine oder mehrere Hauptkategorien für die jeweilige/n Sprache/n hinzu.
+
===Bestellungen===
 +
[[Datei:Connect_-_Bestellungen_neu.png]]
  
[[Datei:Multi backend kategorien.PNG]]
+
'''Bestellabfrage Limit'''
  
 +
Maximale Anzahl Bestellungen pro Abfrage
  
==externe Kategoriezuweisungen im Shop beibehalten==
+
'''Bestellstatus'''
  
Falls Sie im Shop-Backend Kategoriezuweisungen zu einem oder mehreren Produkten getroffen haben, so werden diese bei einem Upload des jeweiligen Produkts immer wieder überschrieben. Dieses können Sie umgehen, in dem Sie den entsprechenden XSLT-Block entfernen.
+
Festlegen der Bestellstatus der Bestellungen, die abgerufen werden sollen (kommagetrennt ohne Leerzeichen).
  
===Eintrag im XSLT===
+
'''Zahlstatus'''
  
<categories>
+
Festlegen der Zahlstatus der Bestellungen, die abgerufen werden sollen (kommagetrennt ohne Leerzeichen).
<xsl:for-each select=""/Product/ArrayOfProductToCategory/ProductToCategory"">
 
<array_item categories_id=""{categories_id}"" kkkat=""{categories_code}"" katnr=""{katnr}"" />
 
</xsl:for-each>
 
</categories>
 
  
Öffnen Sie zum entferne des Blocks mention®Connect. Begeben Sie sich in die Einstellungen der jeweilige Schnittstelle und scrollen Sie ganz nach unten. Durch betätigen des Button "Ändern" haben Sie die Möglichkeit, den Button "XSLT-Einstellungen" zu betätigen und die gesuchten Einstellungen aufzurufen.
+
'''Setze Shopware Versandstatus'''
  
 +
Festlegen des Versandstatus, der im Shop bei Bestellungen gesetzt werden soll, sobald sie versandt wurden.
  
[[Datei:Xslt Einstellungen.JPG]]
+
'''Setze Shopware Bezahlstatus'''
  
 +
Festlegen des Bezahlstatus, der im Shop bei Bestellungen gesetzt werden soll, wenn sie bezahlt wurden.
  
Geben Sie nun im Suchfenster einen Artikel oder eine Artikelnummer ein und klicken Sie auf den Button "suchen". Es wird Ihnen der gesuchte Artikel angezeigt und durch selektieren des Suchergebnisses, sehen Sie drei Textboxen. Hier interessiert uns die Textbox "xslt-Vorlage" in der Mitte. Suchen Sie den oben genannten Eintrag und entfernen Sie diesen. Im Anschluss speichern Sie Ihre Änderung mit dem Button "XSLT-Übernehmen".
+
Hier eine Übersicht der Standard-Status (Bestell-, Zahl-, Versand- und Bezahlstatus) in Shopware:
  
===Allgemeiner Hinweis zu XSLT's===
+
{| class="wikitable"
<span style="color:red">'''Achtung:'''</span> Bitte sichern Sie sich vor einer Änderung das hinterlegte XSLT (kopieren). Teilen Sie im Falle eines Problemes unseren Support-Team mit, dass es sich um ein angepasstes XSLT handelt und haben Sie Ihr XSLT für den Mitarbeiter griffbereit.  
+
|-
 +
!|Status
 +
!|Bedeutung
 +
|-
 +
||-1
 +
||Abgebrochen
 +
|-
 +
||0
 +
||Offen
 +
|-
 +
||1
 +
||In Bearbeitung (Wartet)
 +
|-
 +
||2
 +
||Komplett abgeschlossen
 +
|-
 +
||3
 +
||Teilweise abgeschlossen
 +
|-
 +
||4
 +
||Storniert / abgelehnt
 +
|-
 +
||5
 +
||Zur Lieferung bereit
 +
|-
 +
||6
 +
||Teilweise ausgeliefert
 +
|-
 +
||7
 +
||Komplett ausgeliefert
 +
|-
 +
||8
 +
||Klärung notwendig
 +
|-
 +
||9
 +
||Teilweise in Rechnung gestellt
 +
|-
 +
||10
 +
||Komplett in Rechnung gestellt
 +
|-
 +
||11
 +
||Teilweise bezahlt
 +
|-
 +
||12
 +
||Komplett bezahlt
 +
|-
 +
||13
 +
||1. Mahnung
 +
|-
 +
||14
 +
||2. Mahnung
 +
|-
 +
||15
 +
||3. Mahnung
 +
|-
 +
||16
 +
||Inkasso
 +
|-
 +
||17
 +
||Offen
 +
|-
 +
||18
 +
||Reserviert
 +
|-
 +
||19
 +
||Verzögert
 +
|-
 +
||20
 +
||Wiedergutschrift
 +
|-
 +
||21
 +
||Überprüfung notwendig
 +
|-
 +
||30
 +
||Es wurde kein Kredit genehmigt.
 +
|-
 +
||31
 +
||Der Kredit wurde vorläufig akzeptiert.
 +
|-
 +
||32
 +
||Der Kredit wurde genehmigt.
 +
|-
 +
||33
 +
||Die Zahlung wurde angewiesen.
 +
|-
 +
||34
 +
||Es wurde eine Zeitverlängerung eingetragen.
 +
|-
 +
||35
 +
||Vorgang wurde abgebrochen.
 +
|-
 +
|}
  
[[Datei:Xslt vorlage.JPG]]
+
Sofern Sie eigene Status im Shop hinterlegt haben, ist es erforderlich, sich die dazugehörige Nummer aus der Tabelle ''s_core_states'' (Spalte ''Id'') herauszusuchen.
  
==Nutzung des Gruppen-Attributs==
+
===Magnalister===
  
Falls Sie Informationen zu den Komponenten der Gruppenartikel in der Shop-Datenbank mitübertragen wollen, tun Sie folgendes:
+
[[Datei:Magnalister01.png]]
  
* Gehen Sie im Shop-Backend auf Einstellungen -> Freitextfeld-Verwaltung
+
Mithilfe dieser Einstellung lassen sich mention-Referenztexte zu Magnalister-Quellen zuweisen, welche beim Bestellimport in bestimmten Auftragsfeldern übernommen werden. Als Quelle sind hierbei Zeichenfolgen gemeint, die im Bestellkommentar, XML-Feld "customerComment", gesucht werden.
* Wählen Sie die Tabelle "Artikel(s_articles_attributes) aus
+
Connect kann die Verarbeitung nur durchführen, wenn spezifische Abschnitte in der Bemerkung enthalten sind. So validiert die Anwendung über den Text "magnalister-Verarbeitung", ob es sich um eine Magnalister-Bestellung handelt. Für die Auftragsnummer sucht Connect nach dem Textabschnitt "Bestellnummer:", diesem muss direkt die Auftragsnummer folgen.
  
 +
Ein Kommentar könnte z.B. wie folgt aufgebaut sein:
 +
"magnalister-Verarbeitung {Quelle} Bestellnummer: {Bestellnummer}"
  
[[Datei:SW_Einstellung.jpg]]
+
Wird über Connect ein Auftrag importiert, der ein gültigen Kommentar enthält, so beginnt sie mit der Suche nach dem Referenztext. Hierzu zieht sie die Nummer hinzu, welche der Quelle zugewiesen ist. Existiert ein entsprechender Eintrag in der "Kotbez"-Tabelle, dann schreibt Connect den Wert aus Spalte "Kotbez.kotext" in die Spalte "Bestkk.bstext" des Auftrags. Die vorher ermittelte Bestellnummer wird zudem in "Bestkk.bsbestnr" übernommen.
  
 +
==''How-To''s==
  
* Fügen  Sie ein neues Freitextfeld hinzu (, das nur für Gruppenartikeln genutzt werden soll)
+
===Grundpreise===
[[Datei:SW_Freitextfeld.jpg]]
+
 
* definieren Sie in 'Spaltenname' auf der rechten Seite den Namen des gewünschten Attributs
+
Bei manchen Artikeln ist es notwendig, Grundpreisangaben zu hinterlegen und diese dem Endkunden direkt im Frontend anzuzeigen. Der Grundpreis basiert auf einem errechneten Wert vom Verkaufspreis und einem Faktor der mittels Mengeneinheit dargestellt wird. Um dies in Ihren Shops abzubilden sind folgende Daten in Ihrer Warenwirtschaft zu füllen:
 +
 
 +
* Eingabe eines Grundpreiskoeffizienten unter "Stammdaten => Artikel => Preise"
 +
* Eine Mengeneinheitsangabe z.B. pro Liter oder pro Kilogramm unter "Stammdaten => Artikel => Stammdaten"
 +
 
 +
'''Einstellung im mention®WWS:'''
 +
 
 +
[[Datei:Grundpreis02.png]]
 +
 
 +
'''Ansicht im Shopware-Frontend''':
 +
 
 +
[[Datei:Grundpreis01.png]]
  
* Es dürfen nur Zahlen, Kleinbuchstaben und _ verwendet werden. Des Weiteren muss das Feld mit einem Buchstaben beginnen.
+
===Merkmale===
(
 
- steht das '_' am Ende oder vor einer Zahl bleibt es bestehen
 
- steht das '_' vor einem Buchstaben wird der Unterstrich entfernt und der danach folgende Buchstabe großgeschrieben
 
(Bsp.: aus „gruppen_attribut“ entsteht das JSON-Attribut „gruppenAttribut“ )
 
)
 
  
* Wählen Sie als Spaltentyp "Einfacher Text - TEXT" und drücken Sie auf "Speichern"
+
Merkmale, auch Attribute genannt, beschreiben bestimmte Eigenschaften eines Produktes. Bei einem Monitor zum Beispiel könnte man Attribute wie Bildschirmdiagonale, Reaktionszeit, Auflösung, Paneltyp, Bildformat, Technologie etc. angeben. So sieht der Endkunde alle relevanten Daten zu einem Artikel auf einem Blick. Für die Übertragung Ihrer Merkmale müssen Sie die folgenden Daten in den Artikelstammdaten und im Plugin hinterlegen:
* Fügen Sie den Spaltennamen in MentionConnect -> ShopWare -> Einstellungen -> Artikeln in das Feld neben "Freitextfeld für Gruppenkomp.:" ein
 
  
 +
* Weisen Sie der Artikelkategorie eine Merkmalgruppe zu.
 +
* Tragen Sie in den Artikelstammdaten eine FSK-ID unter "Stammdaten => Artikel => Online => FSK" ein.
  
[[Datei:Connect_Einstellung.jpg]]
+
Die Plugin-Einstellungen erreichen Sie über die Einstellungen Ihrer Shopware-Schnittstelle in mention®Connect. Klicken Sie dazu auf "Konfigurieren" und danach auf "Abrufen".
  
 +
* Hinterlegen Sie im Plugin das Matching wie folgt: "FSK-ID=Name der Merkmalgruppe". Z.B.: "1=MON, 2=PC"
  
Beim Hochladen der Artikel (nach ShopWare), werden (falls es sich um Gruppenartikel handelt) folgende Daten der Gruppenkomponenten dem neuen Artikel-Freitextfeld übergeben:
+
'''FSK in mention hinterlegen'''
* Artikelnummer
 
* Benennung
 
* Menge
 
* Bestand
 
* erster Eintrag Kategorie 1
 
* erster Eintrag Kategorie 3
 
* Herstellerkennzeichen
 
* Herstellername
 
* Herstellernummer
 
  
<b>Beispiel:</b><br>
+
[[Datei:Merkmale02.png]]
"[{\"aranummer\":\"10390\",\"benennung\":\"item12\",\"menge\":\"3,00\",\"bestand\":\"111,000\",\"kat1\":\"DRU\",\"kat3\":\"\",\"herstellerKennzeichen\":\"008\",\"herstellerName\":\"Compaq\",\"herstellerNr\":\"272546362\"},
 
{\"aranummer\":\"10389\",\"benennung\":\"item11\",\"menge\":\"3,00\",\"bestand\":\"1256,000\",\"kat1\":\"GEH\",\"kat3\":\"KAT3TEST2\",\"herstellerKennzeichen\":\"SAM\",\"herstellerName\":\"Samsung\",\"herstellerNr\":\"4574736356\"},
 
{\"aranummer\":\"10388\",\"benennung\":\"item10\",\"menge\":\"3,00\",\"bestand\":\"5234,000\",\"kat1\":\"NEUKAT\",\"kat3\":\"KAT3TEST1\",\"herstellerKennzeichen\":\"013\",\"herstellerName\":\"Sonstige\",\"herstellerNr\":\"32323232323232\"}]"
 
  
 +
'''Matching im Plugin'''
  
[[Datei:JSON-Attribut.jpg]]
+
[[Datei:Merkmale03.png]]
  
 +
'''Ansicht im Frontend'''
  
<span style="color:red">'''Achtung:'''</span>
+
[[Datei:Merkmale01.png]]
Es muss mindestens ein Artikel schon mal zum Shop hochgeladen worden sein, damit Connect durch den API-Abruf dieses Artikels feststellen kann, ob sich das neue Freitextfeld im Artikel-JSON vorhanden ist.
 
Falls in der Connect-ShopWare-Einstellung der eingetragene Feldname nicht mit dem Namen, der im Shop-Backend gespeichert wurde, übereinstimmt, wird der Artikel-Upload unterbrochen, bis die Namen übereinstimmen oder das Feld in der Connect-Einstellung geleert wird.
 

Aktuelle Version vom 27. November 2023, 10:50 Uhr

Systemvoraussetzungen

  • Shopware-Version Minimum 5.5.7, Maximum 5.7.12
  • mention®Warenwirtschaft Minimum v2017

Alle auf dieser Seite mit einem SternStar-icon.png gekennzeichneten Einstellungen sind zwingend einzurichten, bevor eine Kommunikation mit dem Shop erfolgen kann.

Installation des PluginsStar-icon.png

Plugin 01.png

Den Plugin Manager erreichen Sie über das Menü Einstellungen. Dort nach Auswahl des Menüpunkts Installiert den Button Plugin hochladen betätigen.

Plugin 02.png

Nun das gezippte Plugin lokalisieren und auswählen.

Plugin 03.png

Danach befindet es sich in der Liste Deinstalliert. Mit Klick auf das Plus-Zeichen wird das Plugin installiert.

Plugin 04.png

Zum Bearbeiten des Plugins nun den Stift anklicken.

Plugin 05.png

Durch Klick auf den Button Aktivieren wird das Plugin aktiviert. Fragen nach Leeren des Chaches sowie Kompilieren der Themes sind mit Ja und Kompilieren zu bestätigen.

Anlegen eines API-Benutzers für mention®ConnectStar-icon.png

Die das Plugin betreffenden Fenster können nun geschlossen werden. Einen API-Benutzer können Sie über Einstellungen => Benutzerverwaltung über den Button Benutzer hinzufügen anlegen.

Api-user 01.png

Dieser Benutzer übernimmt die Datenübertragung zwischen mention®Connect und dem Shop. Wichtig bei der Anlage des Benutzers ist der Haken bei API-Zugang. Dieser muss aktiviert sein, damit Sie ein API-Token erhalten, das Sie in den Einstellungen der Shopware5-Schnittstelle angeben. Am besten, Sie kopieren ihn in die Zwischenablage. Das hier zu vergebene Passwort wird an keiner anderen Stelle abgefragt werden, es dient einzig Ihrer Sicherheit.

Außerdem fragt Shopware noch andere Daten ab, die für mention®Connect zwar nicht von Belang, aber Pflichtangaben sind. Im nachfolgenden Screenshot sehen Sie gelb hinterlegt, welche Daten Shopware verlangt.

Api-user 02.png

Allgemeine Einstellungen mention®ConnectStar-icon.png

Die allgemeinen Einstellungen erreichen Sie über den Karteikartenreiter mit der Aufschrift Einstellungen. Pflichtangaben:

  • Nach Aktivieren des Änderungsmodus (Schaltfläche Ändern unten) Klick auf Datenbankeinstellungen…, dort Verbindungsdaten eingeben, testen und speichern.
  • Klick auf den Button bei Neue Lizenzdatei auswählen, Auswahl der Lizenz im Explorer.

Connect - Einstellungen.png

Einstellungen Shopware5-Schnittstelle

Allgemeine Einstellungen

Connect - Allgemeine Einstellungen.png

Logo

Hier können Sie ein eigenes Logo für die Schnittstelle in Connect hinterlegen. Für das bestmögliche Ergebnis sollte das Bild quadratisch sein (Breite = Höhe).

Titel der SchnittstelleStar-icon.png

Wählen Sie hier einen Titel für die Schnittstelle. Dieser wird Ihnen wie auch das Logo ausschließlich in mention®Connect angezeigt.

MandantStar-icon.png

Legen Sie hier fest, welchen Mandanten die Schnittstelle nutzen soll.

Lager (für Artikel)Star-icon.png

Diese Option erscheint, sobald Sie einen Mandanten gewählt haben. Setzen Sie Haken bei den Lägern und Beständen, auf die der Shop zugreifen soll.

BenutzerStar-icon.png

Legen Sie hier den Benutzer fest, mit dem sich die Schnittstelle bei der mention®Warenwirtschaft anmelden soll.

VK-PreisStar-icon.png

Hier legen Sie den primären VK-Preis, den Sie verwenden wollen, fest. Weitere VK-Preis-Einstellungen sind über das Plugin zu konfigurieren.

Artikel KZ. Archiv ignorieren

Mit aktiver Option werden auch archivierte Artikel berücksichtigt und hochgeladen.

KategorieStar-icon.png

Hier legen Sie fest, welcher Kategorie-Baum aus Ihrer Warenwirtschaft für den Shop genutzt werden soll.

Mandantenabh. Kz. Onl verwenden

Mit aktiver Option werden nur Artikel berücksichtigt, bei denen auf der Registerkarte Online im Feld Mandantenabhängig den Online-Haken gesetzt haben.

Pfad zu XML-Logdateien

Hier können Sie einen Ordner angeben, in den die XML-Logs gespeichert werden.


Shopware

Connect - Shopware.png

URLStar-icon.png

Tragen Sie hier die Adresse Ihres Shop-Backends ein, gefolgt vom Namen des Plugins (siehe Screenshot).

API-BenutzernameStar-icon.png

Hier ist der Name des Benutzers gefordert, den Sie im Shopware-Backend für Connect angelegt haben.

API-SchlüsselStar-icon.png

Geben Sie hier den Schlüssel ein, den Shopware für den API-Benutzer generiert hat.

Webseitige SchnittstelleStar-icon.png

  • Download: Dieser Button hat aktuell keine Funktion.
  • Test: Mit diesem Button können Sie die Einträge der Felder URL, API-Benutzername und API-Schlüssel auf Richtigkeit prüfen, indem versucht wird, eine Verbindung mit Ihrem Shopware-Backend herzustellen.
  • Konfigurieren: Hiermit rufen Sie die Konfiguration des Plugins ab.

Nach dem Klick auf Konfigurieren ist es erforderlich mit einem weiteren Klick auf Abrufen die Einstellungen des Plugins aus dem Shop zu übertragen. Für die Ersteinrichtung reicht es, den in mention hinterlegten VK-Gruppen eine Kundengruppe aus Shopware zuzuordnen. Anschließend wird diese Einstellung mit Klick auf Speichern gesichert.

Plugin 06.png


Up- und Download

Connect - Up und Download.png

Wenn ein Intervall mit: 0 eingestellt ist, wird diese Routine nicht ausgeführt, erst wenn ein Wert höher eingetragen ist. Die Angabe erfolgt auch in Minuten.

Upload-Intervall

Geben Sie hier ein Intervall in Minuten für den Artikel-Upload an.

Intervall Bestellungen/Paketnummern

Geben Sie hier ein Intervall in Minuten an für den Download und Import von Bestellungen sowie den Upload von Bestellstatus sowie Paketnummern.

Intervall-Pause

Legen Sie hier optional einen Zeitraum fest, in dem keine Up- oder Downloadvorgänge stattfinden sollen.

DSXML-Account

Optional kann ein DSXML-Account angegeben werden, um z.B. mehrere Shops bzw. mehrere Vertriebskanäle eines Mandanten zu trennen. Die Zuordnung der Artikel erfolgt in den Artikelstammdaten (Registerkarte Online).

Max. Artikel/Upload

Die maximale Anzahl zu übertragender Artikel pro Uploadvorgang.


Zuordnungen

Connect - Zuordnungen.png

ZahlartenStar-icon.png

Über den Button Abrufen rufen Sie die in Shopware 5 hinterlegten Zahlarten ab. Bitte ordnen Sie diese den entsprechenden Zahlarten von Mention zu.

Versandarten

Der Abruf aller im Shop vorhandenen Versandarten lässt die Shopware-API aktuell nicht zu. Beim Bestellimport wird diese Liste automatisch mit den in den Bestellungen vorhandenen Versandarten gefüllt. Bitte ordnen Sie diese den entsprechenden Versandarten von Mention zu.

VK-Preise zu KundengruppenStar-icon.png

Über den Button Abrufen werden die in Shopware hinterlegten Kundengruppen übertragen. Hier können Sie hinterlegen, welche Kundengruppe aus dem WWS welchen VK-Preis in Shopware angezeigt bekommt.

Fremdsprachenzuordnung

Über den Button Abrufen rufen Sie die in Ihrem Shop angelegten Sprachshops ab. Hier können Sie den Sprachshops die jeweiligen Sprachen aus mention zuordnen.


Behandlung Bestand

Connect - Behandlung Bestand.png

Best. Online verwenden

Bei aktiv wird der Wert aus SD/Artikel/Bestände/Lager/Bestand Online für die Bestandberechnung genutzt.

Best. zzgl. Bestellte

Bei aktiv wird die Summe der bei Lieferanten bestellten Menge für die Bestandberechnung genutzt.

Bestand abzgl. in Nachbearbeitung

Bei aktiv werden die Mengen aus den Bestellungen in Nachbearbeitung (Bestellung abgerufen aber mit Fehlern) berücksichtigt.

Bestand abzgl. Dsxml in Nachbearbeitung

Bei aktiv und Benutzung der DSXML-Schnittstelle werden die Mengen aus den Bestellungen in Nachbearbeitung in der DSXML-Schnittstelle vom Bestand abgezogen.

Sperrbest abziehen

Bei aktiv wird der Sperrbestand aus SD/Artikel/Bestände/Lager/Sperrbestand vom Bestand abgezogen.

Vorbestellte abziehen

Bei aktiv wird die Summe an Vorbestellungen vom Bestand abgezogen.

Änderungsdatum Lager deaktiviert

Bei inaktiv wird das Änderungsdatum der Lagertabelle berücksichtigt.

Bestände von Gruppenmitgliedern abschneiden

Falls der berechnete Bestand der Gruppenmitglieder Nachkommastellen aufweist, wird hier gerundet.


Neue Kunden

Connect - Neue Kunden 200713.png

Manuelle Kundenzuordnung

obsolet/ohne Funktion

Kennz. Online n. Kunden (Kennzeichen Online neue Kunden)

Wenn diese Einstellung aktiv ist, wird beim Anlegen eines Ansprechpartners das Online Feld aktiviert.

Behandlung Name

Wenn Standard Behandlung aktiviert ist, werden Vorname und Nachname zusammen in Name2 gespeichert. Wenn Privat Person: Vorname = Name1, Nachname = Name2 ausgewählt ist, wird der Vorname in das Feld Name1 gespeichert und das Feld Name2 mit dem Nachnamen befüllt.

Kunden in mention akt. (Kunden in mention aktualisieren)

Sofern aktiv, werden Kundendaten in mention aktualisiert, wenn eine Kundennummer oder eine Email übergeben wird und der Kunde identifiziert werden kann.

Weitere Adresszeilen

Wenn aktiv, wird der Firmenname aus dem Shop in das Feld Name3 eingetragen.

KD Kennz. Endkunde

Wenn diese Einstellung auf aktiv ist, werden neue Kunden, sofern für diese keine Umsatzsteuer-Identifikationsnummer hinterlegt ist, im Kundenstamm als Endkunde gekennzeichnet.

Druckoptionen Email

Wenn aktiv, wird im Kundenstamm unter Druckoptionen E-Mail auf aktiv gesetzt.

Druckoptionen nicht drucken

Bei aktiv wird im Kundenstamm unter Druckoptionen nicht drucken aktiviert.

Weitere SA: Nur Lieferschein

Wenn aktiv, wird im Kundenstamm unter Weitere die Einstellung SA: Nur Lieferschein auf aktiv gesetzt.

Vorlage Kundennummer

Wenn hier eine Kundennummer hinterlegt wurde, werden vom zugehörigen Datensatz folgende Werte als Standard bei der Neuanlage verwendet:

  • Versicherung (Weitere)
  • Endkunde (Weitere)
  • SA: nur Lieferschein (Weitere)
  • Versandart (Weitere)
  • Währung (Weitere)
  • Transportweg (Weitere)
  • Kennwort (Weitere)
  • Adresse (Weitere)
  • VK-Preis akzeptieren (Weitere)
  • Format (Weitere)
  • Mahnung (Weitere)
  • Zahlart (Weitere)
  • Frachtfrei (Weitere)
  • Frachtfrei ab Wert (Weitere)
  • Werkstatt (Weitere)
  • Mindestfrachtkosten (Weitere)
  • nicht Drucken (Druckoptionen)
  • E-Mail (Druckoptionen)
  • LFS, Leih-/Teststellung (Weitere)
  • Proforma-Rechnung (Weitere)
  • Keine Automatik (Weitere)
  • Liefersperre (Weitere)
  • Preis (Weitere)
  • Keine Staffelpreise (Weitere)
  • Kalkulation (Weitere)
  • Konditionen (Weitere)
  • Rabatt (Weitere)
  • Limit (Weitere)
  • Limit intern (Weitere)
  • Gültigkeit von Limit (Weitere)
  • Gültigkeit von Limit intern (Weitere)
  • Rückscheck/RLS (Weitere)
  • Factor-Nr. (Weitere)
  • Gilt für Anschriften (Weitere)
  • Rabatt drucken (Weitere)
  • Sprachschlüssel (Weitere)
  • Neue Nummer (Stammdaten)
  • Gebiet (Stammdaten)
  • Kennzeichen (Stammdaten)
  • Keine Werbung (Stammdaten)
  • Keine Fax-Werbung (Stammdaten)
  • Keine E-Mail-Werbung (Stammdaten)
  • Keine Post-Werbung (Stammdaten)
  • Seriennummer extra drucken (Stammdaten)
  • Belegdruck mit Seriennummern (Stammdaten)
  • Warenausgangsetiketten nicht drucken (Stammdaten)
  • Nicht Aktiv (Stammdaten)
  • Techniker (Stammdaten)
  • Außendienst (Stammdaten)

Die folgenden Einstellungen werden verwendet, um zu prüfen, ob eine Adresse für einen Kunden existiert. Bei Eingabe 0 werden alle Zeichen geprüft.

Kd.-Name1 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name1 überprüft werden sollen

Kd.-Name2 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name2 überprüft werden sollen

Kd.-Name3 prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Name3 überprüft werden sollen

Kd.-Straße prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Straße überprüft werden sollen

Kd.-PLZ prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld PLZ überprüft werden sollen

Kd.-Ort prüfen Anzahl Zeichen

Anzahl der Stellen, die im Feld Ort überprüft werden sollen

Abteilung in Name3 speichern

Speichert das Feld 'Abteilung' in Name 3 der Kundenadresse

Adressen mit Knz. Direktlieferung berücksichtigen

Bei der Kundensuche werden bei aktivierter Einstellung Adressen mit dem Kennzeichen Direktlieferung nicht berücksichtigt.


Belegdaten

Connect - Belegdaten200713.png

Bezug1 Beleg

Text, der im Beleg unter Bezugnahme eingetragen werden soll. Beispielsweise zum Identifizieren von Shop-Bestellungen.

Hinweis Beleg

Text, der im Beleg unter Hinweise eingesetzt wird

Sperrkennzeichen

Hier kann man ein Sperrkennzeichen für Belege zuweisen.

Kennz. Direktlieferung (Kennzeichen Direktlieferung)

Falls aktiv, wird in mention das Feld Direktlieferung aktiviert.

Kennz. Automatik (Kennzeichen Automatik)

Falls aktiv, wird in mention das Feld Automatik auf aktiv gesetzt.

TransaktionsID Bezahlsystem

Hier können Sie auswählen, ob und wo z.B. eine Paypal-Transaktionsnummer gespeichert werden soll.

Debitoren nicht berücksichtigen

Sofern mention®Finance benutzt wird, muss diese Einstellung auf aktiv sein.

Bestellkommentare nach

Hier kann ausgewählt werden, wo Bestellkommentare in einer Bestellung gespeichert werden sollen: Als Hinweistext im Belegs oder Zusatztext Beleg.

Belegsperre bei Bestellkommentar

Enthält eine Bestellung einen Bestellkommentar, kann hier eine Belegsperre für diese Bestellung gesetzt werden.

Konstanter Wert – Externe Referenz 1 bis 3

Hier können konstante Werte für die mention-Felder Externe Referenz 1 bis 3 definiert werden.

Zahlungsbedingung Stammdaten/Kunden

Wenn aktiv, soll nicht die zugewiesene Zahlungsbedingung verwendet werden, sondern die aus dem Kundenstamm.

Rabatt aus SD/Kd berücksichtigen

Wenn aktiv, soll beim Bestellimport der Rabatt aus dem Kundenstamm (Registerkarte Weitere) angewendet werden.


Artikel

Connect - Artikel.png

Upload-Intervall Bestand

Intervall in Minuten zur Aktualisierung des Bestands, unabhängig vom Artikelupload (0 = inaktiv).

Upload-Intervall Preise

Intervall in Minuten zur Preisaktualisierung (0 = inaktiv). Um den Preisupload nutzen zu können, ist es erforderlich, unter Zuordnungen die Zuweisung der Kundengruppen zu Verkaufspreisen zu tätigen. Gibt es zu einer Kundengruppe kein Mapping, wird sie beim Preisupload ignoriert.


Benutzerdefinierte Artikelfelder zu Shopware-Attribute

Connect - Bendef Felder.png

Attribut 1 – 10

In Shopware sind 10 Freitextfelder verfügbar (im Backend unter Einstellungen => Freitextfeld-Verwaltung konfigurierbar), die mit beliebigen benutzerdefinierten Feldern aus mention gefüllt und hier gemappt werden können.


Shopware Belegfelder zu mention Belegfelder

Connect - Shopware Belegfelder.png

Partner-ID-Code

Hier kann man dem Feld PartnerID von Shopware ein Belegfeld in mention zuweisen.

Geräte-ID

Hier kann man dem Feld GeräteID von Shopware ein Belegfeld in mention zuweisen.

Attribut 1 – 6

Shopware bietet 6 Attributfelder, hier kann eins ausgewählt und einem Feld im mention Beleg zugewiesen werden.


Kategorien

Connect - Kategorien 200708.png

Kategorien exportieren

Wenn diese Einstellung aktiv ist, werden Kategorien in den Shop übertragen.


Sprache als Kategoriebaum anlegen (ab Version vom 08.07.2020)

Wenn aktiv, werden die in Mention hinterlegten Sprachen als Kategoriebaum angelegt.

Die Voraussetzungen sind:

1) Im Shopware-Backend muss eine Hauptkategorie, unter "Artikel/Kategorien/Hinzufügen" angelegt werden, die genau so heißt wie das Kennzeichen oder die Bezeichnung(in Mention das Feld "Sprache") der Mention Sprache.

2) Danach muss man unter "Einstellungen/Grundeinstellungen/Shopeinstellungen/Shops" ein Sprach-Shop anlegen, hierbei muss man die zuvor angelegte Hauptkategorie in dem Feld Kategorie angeben.

3) Nachdem Sie den Sprach-Shop erstellt haben müssen Sie nachträglich nochmal das Feld "Übersetzungen übernehmen" mit dem selben Sprach Shop füllen.


Sprach-Shop Konfiguration

SprachShopKorrekt.png


Zu exportierende Bilder

Zu exportierende Bilder Connect 01.png

Bilder

Wenn aktiv, werden Artikelbilder in den Shop übertragen.

Bild-Hash-Wert prüfen

Wenn aktiv, wird mittels eines Hash-Werts bei Änderung eines Artikels überprüft, ob das in mention hinterlegte Bild dem in Shopware entspricht. Ist dem nicht so, wird das Bild aus mention hochgeladen.

Bild Übertragung erzwingen

Wenn aktiv, wird beim manuellen Artikelupload über Stammdaten die Bildübertragung erzwungen. Das bedeutet, dass alle dem Artikel zugeordneten Bilder hochgeladen werden, unabhängig davon, ob sie bereits im Shop vorhanden sind. Wenn inaktiv, werden nur die Bilder hochgeladen, welche neu sind oder geändert wurden.

Bild1 – Bild10

Hier kann man wählen, welche Bilder aus mention übertragen werden sollen.

XSLT Einstellung

Der Button öffnet nach Klick ein Fenster, in welchem man das Standard XSLT anpassen kann. Dies ist nur zu empfehlen, sofern man ein angepasstes Plugin von Drittanbietern nutzt oder spezielle Daten benötigt.

Abbildungspfadteil von und zu

"Abbildungspfadteil von": Definiert den Bildpfad-Abschnitt der überschrieben werden soll.

"Abbildungspfadteil zu": Legt den Abbildungspfad fest, der beim Überschreiben hinterlegt wird.


Bilder-Upload ohne Zuweisung

Connect - Bilder ohne Zuweisung.png

Freitextf.: Bild-Upload ohne Zuweis.

Hier kann man ein Freitextfeld definieren, in welches die MediaIDs der Bilder geschrieben werden sollen, beispielsweise zur Weiterverarbeitung mit entsprechenden Plugins. Sobald Bilder übertragen worden sind, wird eine MediaID für jedes Bild erstellt. Diese wird dann in das definierte Freitextfeld geschrieben, in der Reihenfolge: Bild 10 – 1.

Bild 1 Upload – Bild 10 Upload

Hier können die Bildpositionen ausgewählt werden, die auf den Media Server hochgeladen werden sollen.


Kundenupload

KundenUpload Einstellung.png

Kundennummer im Shop überschreiben

Wenn aktiv, wird die Kundennummer im Shop mit der Kundennummer aus der Mention überschrieben.

Bestehende Kunden beim Upload überschreiben

Diese Einstellung gibt an, ob bereits übertragene Kunden im Shop nochmal übertragen werden sollen. Bei der Auswahl Übertragen werden beim erneuten Hochladen eines Kunden folgende Daten im Shop überschrieben:

  • E-Mail-Adresse
  • Vorname
  • Nachname
  • Anrede
  • Kundengruppe
  • Zahlungsart
  • Kundennummer
  • Sprache
  • Rechnungsadresse

Neue Kunden automatisch hochladen

Mit dieser Einstellung kann man einstellen, ob ein neuer Kunde in der Automatik übertragen werden soll. Mit neuer Kunde ist ein Kunde gemeint, welcher noch nicht von Connect an den Shop übermittelt wurde.

geänderte Kunden automatisch hochladen

Hier kann man einstellen, ob ein bereits hochgeladener Kunde in der Automatik übertragen werden soll. Hier sind ausschließlich Kunden gemeint, welche bereits von Connect an den Shop übermittelt wurden.


Upload Kundenbelege

Connect - Upload Kundenbelege neu.png

Die hochgeladenen Belege sind für Kunden nicht automatisch ersichtlich. Hierfür ist der Einsatz von Drittanbieter-Plugins erforderlich.

Belege übertragen

Wenn aktiv werden Belege, welche von Mention als PDF erstellt wurden, übertragen. Es werden hier nur PDF-Dateien übertragen. Das Verzeichnis, in dem nach Belegen gesucht wird, muss im Mention WWS eingestellt werden: Voreinstellungen/Mandant/Voreinstellungen Verkauf/Drucken 2/Alle Belege als PDF in Verzeichnis ablegen.

Belege ab

Jüngstes Datum hochzuladender Kundenbelege. Alle Belege, welche vor diesem Datum liegen werden nicht berücksichtigt.

PDF nach Upload löschen

Wenn aktiv, werden die hochgeladenen Dateien aus dem Quellverzeichnis gelöscht.


Bestellungen

Connect - Bestellungen neu.png

Bestellabfrage Limit

Maximale Anzahl Bestellungen pro Abfrage

Bestellstatus

Festlegen der Bestellstatus der Bestellungen, die abgerufen werden sollen (kommagetrennt ohne Leerzeichen).

Zahlstatus

Festlegen der Zahlstatus der Bestellungen, die abgerufen werden sollen (kommagetrennt ohne Leerzeichen).

Setze Shopware Versandstatus

Festlegen des Versandstatus, der im Shop bei Bestellungen gesetzt werden soll, sobald sie versandt wurden.

Setze Shopware Bezahlstatus

Festlegen des Bezahlstatus, der im Shop bei Bestellungen gesetzt werden soll, wenn sie bezahlt wurden.

Hier eine Übersicht der Standard-Status (Bestell-, Zahl-, Versand- und Bezahlstatus) in Shopware:

Status Bedeutung
-1 Abgebrochen
0 Offen
1 In Bearbeitung (Wartet)
2 Komplett abgeschlossen
3 Teilweise abgeschlossen
4 Storniert / abgelehnt
5 Zur Lieferung bereit
6 Teilweise ausgeliefert
7 Komplett ausgeliefert
8 Klärung notwendig
9 Teilweise in Rechnung gestellt
10 Komplett in Rechnung gestellt
11 Teilweise bezahlt
12 Komplett bezahlt
13 1. Mahnung
14 2. Mahnung
15 3. Mahnung
16 Inkasso
17 Offen
18 Reserviert
19 Verzögert
20 Wiedergutschrift
21 Überprüfung notwendig
30 Es wurde kein Kredit genehmigt.
31 Der Kredit wurde vorläufig akzeptiert.
32 Der Kredit wurde genehmigt.
33 Die Zahlung wurde angewiesen.
34 Es wurde eine Zeitverlängerung eingetragen.
35 Vorgang wurde abgebrochen.

Sofern Sie eigene Status im Shop hinterlegt haben, ist es erforderlich, sich die dazugehörige Nummer aus der Tabelle s_core_states (Spalte Id) herauszusuchen.

Magnalister

Magnalister01.png

Mithilfe dieser Einstellung lassen sich mention-Referenztexte zu Magnalister-Quellen zuweisen, welche beim Bestellimport in bestimmten Auftragsfeldern übernommen werden. Als Quelle sind hierbei Zeichenfolgen gemeint, die im Bestellkommentar, XML-Feld "customerComment", gesucht werden. Connect kann die Verarbeitung nur durchführen, wenn spezifische Abschnitte in der Bemerkung enthalten sind. So validiert die Anwendung über den Text "magnalister-Verarbeitung", ob es sich um eine Magnalister-Bestellung handelt. Für die Auftragsnummer sucht Connect nach dem Textabschnitt "Bestellnummer:", diesem muss direkt die Auftragsnummer folgen.

Ein Kommentar könnte z.B. wie folgt aufgebaut sein: "magnalister-Verarbeitung {Quelle} Bestellnummer: {Bestellnummer}"

Wird über Connect ein Auftrag importiert, der ein gültigen Kommentar enthält, so beginnt sie mit der Suche nach dem Referenztext. Hierzu zieht sie die Nummer hinzu, welche der Quelle zugewiesen ist. Existiert ein entsprechender Eintrag in der "Kotbez"-Tabelle, dann schreibt Connect den Wert aus Spalte "Kotbez.kotext" in die Spalte "Bestkk.bstext" des Auftrags. Die vorher ermittelte Bestellnummer wird zudem in "Bestkk.bsbestnr" übernommen.

How-Tos

Grundpreise

Bei manchen Artikeln ist es notwendig, Grundpreisangaben zu hinterlegen und diese dem Endkunden direkt im Frontend anzuzeigen. Der Grundpreis basiert auf einem errechneten Wert vom Verkaufspreis und einem Faktor der mittels Mengeneinheit dargestellt wird. Um dies in Ihren Shops abzubilden sind folgende Daten in Ihrer Warenwirtschaft zu füllen:

  • Eingabe eines Grundpreiskoeffizienten unter "Stammdaten => Artikel => Preise"
  • Eine Mengeneinheitsangabe z.B. pro Liter oder pro Kilogramm unter "Stammdaten => Artikel => Stammdaten"

Einstellung im mention®WWS:

Grundpreis02.png

Ansicht im Shopware-Frontend:

Grundpreis01.png

Merkmale

Merkmale, auch Attribute genannt, beschreiben bestimmte Eigenschaften eines Produktes. Bei einem Monitor zum Beispiel könnte man Attribute wie Bildschirmdiagonale, Reaktionszeit, Auflösung, Paneltyp, Bildformat, Technologie etc. angeben. So sieht der Endkunde alle relevanten Daten zu einem Artikel auf einem Blick. Für die Übertragung Ihrer Merkmale müssen Sie die folgenden Daten in den Artikelstammdaten und im Plugin hinterlegen:

  • Weisen Sie der Artikelkategorie eine Merkmalgruppe zu.
  • Tragen Sie in den Artikelstammdaten eine FSK-ID unter "Stammdaten => Artikel => Online => FSK" ein.

Die Plugin-Einstellungen erreichen Sie über die Einstellungen Ihrer Shopware-Schnittstelle in mention®Connect. Klicken Sie dazu auf "Konfigurieren" und danach auf "Abrufen".

  • Hinterlegen Sie im Plugin das Matching wie folgt: "FSK-ID=Name der Merkmalgruppe". Z.B.: "1=MON, 2=PC"

FSK in mention hinterlegen

Merkmale02.png

Matching im Plugin

Merkmale03.png

Ansicht im Frontend

Merkmale01.png