Quelltext der Seite Connect/Magento 1.9.X

__TOC__

= Mention®Connect - Magento 1.9.X Schnittstelle =

<div style="border-left:4px solid #213c55; background:#f5f7f9; padding:12px 16px; margin:16px 0;">
'''Hinweis:''' Die '''Magento 1.9.X Schnittstelle''' wird nicht mehr unterstützt. Diese Seite dient ausschließlich als Dokumentation für bestehende bzw. ältere Installationen.
</div>

__TOC__

== Funktionen ==

Die Schnittstelle wurde mit den folgenden Magento Versionen getestet:

* magento-1.9.1.0
* magento-1.9.1.1
* magento-1.9.2.1

=== Artikel Upload ===

Derzeit können ausschließlich normale Artikel, Gruppenartikel und auch Kollektionen übertragen werden

* Upload von Kollektionsartikeln. Zu Beachten hierbei:
** dass hinterlegte Merkmale als Attribute Sets bei Kollektionen und Kollektionskomponenten ignoriert werden.
** dass der jeweils höchste Preis der Kollektionskomponenten als Kollektionspreis verwendet wird. Wenn die Preise der jeweiligen Kollektionskomponente verwendet werden sollen, muss das über ein gesondertes Plugin gelöst werden.

* Den Lagerbestand des jeweils im Account hinterlegte Lagers
** Optional können noch folgende Einstellungen berücksichtigt werden
*** Best. Online verwenden
**** Ist diese Option Aktiv, so wird der Online Bestand des jeweiligen Lagers verwenden, hierbei werden die nachfolgenden Einstellungen nicht mehr berücksichtigt.
*** Bestand zuzüglich Bestellte
**** Zu dem Lagerbestand wird die Anzahl der Bestellten Artikel hinzu addiert.
*** Bestand abzüglich in Nachbearbeitung
**** zu dem ermittelten Bestand werden die Anzahl der Artikel die sich in der Nachbearbeitung befinden agbezogen.
*** Sperrbestand Berücksichtigen
**** Sollte der Bestand unterhalb des Sperrbestandes sein, so wird der Bestand mit einer Menge NULL übertragen.
* Preis X als Std Preis.
** '''HINWEIS''' Stammdaten Rabatte werden nicht berücksichtigt,
** Nicht fixe Preise berücksichtigen. Hierbei werden folgende Konstellationen berücksichtigt:
*** Handelskalkulation / Kalkulationszuschlag
*** Errechnung der VK-Preise aus EK-Preis 2
*** Errechnung der VK-Preise aus EK-Preis 3
*** Berücksichtigung von Kategorie zuschlägen (Voreinstellungen - Mandanten - Voreinstellungen Preise - Prozentsätze zu Kategorien zur Errechnung von VK-Preisen)
*** Prozentsatz aus Voreinstellungen - Preise (Parameter je Preis)
**** Priorität:
***** 1. Stammdaten Artikel - fixierte Werte netto, brutto oder kalkulatorisch
***** 2. Stammdaten Artikel - Formel (Wenn in Voreinstellungen - Preise (Parameter je Preis) eine Formel hinterlegt wurde)
***** 3. Kalkulation aus Artikelkategorie 1 - lfd. Nr. = 0
***** 4. Kalkulation aus Voreinstellungen (Prozentsatz in Voreinstellungen - Preise (Parameter je Preis) Allgemein "Artikel")
* Steuersätze können im Vorfeld definiert werden (Magento spezifisch)
* Weitere Preise nur in Verbindung eine API Plugins innerhalb magento [http://daten.mention.de/versionen/tools/connect/MentionMagentoSoapPlugin.zip http://daten.mention.de/versionen/tools/connect/MentionMagentoSoapPlugin.zip]
** Sollte während des Uploads die Fehlermeldung 'Procedure 'mentionProductPriceGroupUpdate' not present' erscheinen, so deutet es darauf hin, dass das mention magento Plugin ([http://daten.mention.de/versionen/tools/connect/MentionMagentoSoapPlugin.zip http://daten.mention.de/versionen/tools/connect/MentionMagentoSoapPlugin.zip]) nicht ordnungsgemäß installiert wurde.
* Artikelbeschreibungen und Kurzbeschreibungen, Artikelnummer (SKU)
** Artikelbeschreibungen werden so wie hinterlegt übertragen - Es werden keine HTML Zeichen hinzugefügt
* Metabeschreibungen
** Meta Title, Meta Keywords, Meta Description (Std - Artikel - Reiter Online)
* Artikelbilder
** Artikelbild 1-3 (Std - Artikel - Reiter Katalog)
* Artikel Online-Status (Std - Artikel - Reiter Online Mandantenunabhängiges Kennzeichen)
* Nicht definierte Artikel-Merkmale (mention Std - Artikel - Reiter Katalog)
* Definierte Merkmale - In Magento wird die Zuweisungen Merkmalgruppe zu Kategorie als Set übertragen. Den jeweiligen Sets dann die enthaltenen Merkmalgruppen und den dann die Merkmale als Attribute. Es ist darauf zu achten, dass Artikel der Kategorie zugeordnet sind die auch die zuweisung beinhalten.
* Die Möglichkeit mehrere Sprachen zu übertragen. Die Voraussetzung hierfür ist, dass es ein StoreView für die Sprache angelegt ist. Der eindeutige Code des StoreViews muss das Sprachkennzeichen beinhalten.
* Behandlung Artikelname / Artikelbeschreibung (Konvention) Stammdarten - Katalog hat Vorrang zu Stammdaten Benennung / Erweitert Benennung
* Zubehör Zuordnungen übertragen.
** Magento UpSell = mention Zubehörkennzeichen 'alternativ'
** Magento CrossSell = mention Zubehörtkennzeichen alle außer 'alternativ'
* Einstellung für die Übetragung von Artikelbildern. In Magento können jeweils 3 Bilder gespeichert werden. Es kann ein Vorschaulbild, Kleines Bild und auch das Basis Bild zugeordnet werden. Wenn das Vorschaubild oder das kleine Bild nicht vorhanden ist, wird die Zuweisung auf das Basisbild vorgenommen.

'''Hinweis:''' In Magento ist die SKU Unique, sollte sich bereits ein Artikel in Magento befinden der noch nicht mit der Schnittstelle übertragen wurde, wird die Schnittstelle diesen Artikel nicht übertragen. Wird es aber dennoch immer weiter versuchen. Dieses Problem verursacht die folgende Fehlermeldung im Error Log'Artikel:buch Fehler:The value of attribute "SKU" must be unique'. Man könnte dieses Problem lösen indem die externe ID in der Tabelle MerExtStamm nachgetragen wird.

=== Kategorie Upload ===

Der Upload ist derzeit auf Kategorie 1 (Kategrorie 2 erst ab wws v2015.1) beschränkt

* Kategorie Bezeichnung
* Kategorie Beschreibung (Kategorie - Kurzbeschreibung)
* Meta Daten:
** Meta-Keywords, Meta-Title, Meta-Description
* Verwendung von Kategorie 2, Voraussetzung hierfür ist ein WWS >= v2015.1 (xsatzid muss in Kategorie2 Tabelle enthalten sein)

=== Bestellungen ===

* Import von Kunden (Rechnung) Name, Vorname (Kunde Name2 Vornname + Nachname), Straße, PLZ, Ort, Email-Adresse (Ansprechpartner), Anrede
** Kundenpreiskennzeich, Zahlungsbedingung.
* Import von Versandadressen Name, Vorname (Versandadress Name2 Vorname + Nachname), Straße, PLZ, Ort.
* Import von Belegen (Bestellungen) Versandart als Brutto Betrag.
* Berücksichtigung von GEMA-Gebühren.
* Zusatztextbeleg (bestkk.bstext) kann als Konstante übernommen werden und kann unter Account-Einstellungen hinterlegt werden.
* Rechnungsanschrift: Wenn Firma (Billing) nicht leer dann wird Vorname und Nachname im Ansprechpartner des Kunden gespeichert, Kunde Name2 ist in dem Fall der Firmenname.
* Lieferanschrift: Firma (Shipping) nicht leer, dann wird zu der Lieferadresse ein Ansprechpartner angelegt. In Name2 der Lieferadresse wird die Firma und Name2 des Ansprechpartners wird der Vor- und Nachname gespeichert.
* Speicherung der Telefonnummer beim Ansprechpartner
* Import von Bundle Artikeln die in Magento manuell erstellt wurden

=== Upload Paketnummern / Zahlungseingang ===

* Paketnummern auf Basis von Sonstigen Spediteuren werden exportiert und eine ShipmentID in Magento erzeugt.
* Tracking-Nummern werden hinterlegt zu den jeweiligen Spedituer werden hinterlegt.
* Das Mapping erfolgt über:trans-o-flex, German Parcel, UPS sowie alle anderen die in Magento als Spedituer hinterlegt und in mention entsprechend benannt wurden.
* Zahlungseingänge werden bei Rechnungsstellung und vollständiger Bezahlung des Rechnungsbetrages übertragen.

=== Kundenupload ===

Der Kunde muss wie folgt gespeichert werden, die nachfolgende Auflistung ist obligatorisch, wenn nicht als optional gekennzeichnet:

* E-Mail-Adresse des Ansprechpartners
* Onlinekennzeichen
* SD Kunde Name2 = Vor- + " " + Nachname ODER Name2 Ansprechpartner Name2 = Vor- + " " + Nachname. Gleiches gilt für die Versandanschriften
* Straße
* PLZ
* Land (in Magento muss das Land als ISO 2-Code vorhanden sein)
* Ort
* Telefonnummer
* VK Preis
* Prefix (Anrede)

Optional:

* USTID beim Kunden direkt.
* Sofern kein Passwort beim Ansprechpartner gespeichert wurde, wird eins generiert, gespeichert und nach Magento übertragen. Nachdem der Kunde das erste Mal übertragen wurde, wird das Passwort nicht mehr berücksichtigt.

Anmerkungen:

* Die USTID für die Adresse ist seitens des Magento Backends vorgesehen - kann aber nicht über die magento Soap-Schnittstelle übermittelt werden.
* Der VK Preis wird der Kundengruppe im Shop zugeordnet sofern diese existiert. Leider gibt es keine Option die Magento Kunden-Gruppe Programmatisch anzulegen.
* Änderungen werden nur aus der Bearbeitung von Stammdaten Kunden ermittelt. Sollte etwas unter Stammdaten Adressen editiert werden, wird aufgrund der fehlenden Aktualisierung des Zeitstempels im Adress datensatz keine Änderungen gefunden.
* Email Adressen müssen eindeutig sein. Sollte eine Email-Adresse unter mehreren Ansprechpartnern exitieren, so wird dieser Datensatz nicht berücksichtigt. Siehe hierzu auch [[#Kundenupload_-_Doppelte_EmailAdressen_finden|doppelte EmailAdressen finden]]
* Der Kundenupload muss innerhalb des Magento Accounts aktiviert werden.

== HOWTOs ==

=== Überverkäufe pro Artikel erlauben/verbieten ===

Damit Sie die Bestände eigenständig verwalten können um somit Überverkäufe flexibel pro Artikel zu erlauben oder zu verbieten muss in Magento die '''"Manage Stock"''' bzw. '''"Lagerverwaltung"''' Funktion aktiviert werden. Diese Funktion finden Sie in Magento unter System -> Configuration -> Reiter "Catalog" -> Menüpunkt "Inventory"

[[Datei:Vorraussetzung_Lagervewaltung_Magento.PNG|800px|thumb|center|Vorraussetzung Lagervewaltung Magento.PNG]]

Als nächstes kann man in den mention®Connect Magento-Accounteinstellungen die Lagerverwaltung für alle Artikel aktivieren bzw deaktivieren. Diese Option hat erst eine Auswirkung, wenn vorher die Einstellung im Magento-Backend "Manage-Stock/Lagerverwaltung" auf "Yes/Ja" gesetzt wurde. Mit '''"aktiver"''' Option kann kein Artikel verkauft werden der nicht über ausreichend Bestand verfügt. Ist die Option auf '''"nicht aktiv"''' gestellt können Sie Artikel auch weiter verkaufen, selbst wenn der Lagerbestand kleiner 1 ist.

[[Datei:Vorraussetzung_Lagervewaltung_Connect.PNG|800px|thumb|center|Vorraussetzung Lagervewaltung Connect.PNG]]

Wenn Sie die Einstellung '''"nicht aktiv"''' in mention®Connect und '''"Lagerverwaltung"''' im Magento-Backend ausgewählt haben, können Sie auch jeden Artikel einzeln verwalten. Hierzu können Sie im Artikel den Haken '''"Auslaufartikel"''' setzen. Diese Artikel können nun nur soweit verkauft werden, bis der Lagerbestand aufgebraucht ist. Darüber hinaus ist kein Verkauf möglich.

[[Datei:Vorraussetzung_Lagervewaltung_WaWi.PNG|800px|thumb|center|Vorraussetzung Lagervewaltung WaWi.PNG]]

=== Handling von Steuersätzen ===

Magento bietet leider keinerlei Möglichkeit, die im Shop befindlichen Steuersätze abzurufen. Sollte ein Artikel erstmalig mit einem nicht zugeordneten Steuersatz übertragen werden, wird die interne mentionID gespeichert, sodass diese dann in den Account Einstellungen eingestellt werden muss.

[[Datei:Magento_steuersatz_zuordnung.png|800px|thumb|center|Magento steuersatz zuordnung.png]]

Leider ist auf den ersten Blick das herausfinden des Steuersatzes nicht ganz so einfach, der nachfolgende Screenshot beschreibt die Vorgehensweise:

[[Datei:Magento_steuersatz_ermitteln.png|800px|thumb|center|Magento steuersatz ermitteln.png]]

=== Funktionsweise von Artikelmerkmale (nicht definierte) ===

Für die Übertragung von Artikelmerkmalen ist es erforderlich, dass das jeweilige Merkmalkennzeichen sich bereits konfiguriert im Shop befindet. Hierbei ist eine folgende besondere Namenkonvention im Artikel zu beachten:

* Der Attribute Code muss mit dem Merkmal übereinstimmen.
* Sollte eine Mehrfachauswahl gewünscht sein, so müssen die Werte Semikolon getrennt im Merkmal Wert eingetragen sein.
* Alle Merkmale und Merkmalwerte sofern es sich um keinen einfachen Freitext handelt, müssen im Magento-Shop bereits hinterlegt sein.

Siehe hierzu folgenden Screenshot:

[[Datei:Magento_merkmale.png|800px|thumb|center|Magento merkmale.png]]

=== Funktionsweise von Artikelmerkmale (definierte) ===

In Magento können Artikel bei der Anlage bestimmten Attribut Sets zugeordnet werden. In mention wird hierfür Kategorie 1 mit den zugordeneten Merkmalgruppen verwendet.

==== Einstellungen Artikelmerkmale (definierte) ====

Es werden die folgenden Attribut Datentypen in Magento (frontend_input) zugewiesen:

* multiselect (Wenn in dem Merkmal der Haken bei Mehrfachauswahl gesetzt wurde)
* select (Werte in der Merhfachauswahl sind vorhanden)
* text (Datentyp C oder N)
* date (Datentyp D)
* textarea (Datentyp M)

Wenn das Merkmal nicht vorhanden ist, wird es mit den folgenden std Werten initialisiert:

[[Datei:DefinierteMerkmale_Magento.PNG|800px|thumb|center|DefinierteMerkmale Magento.PNG]]

Im Nachhinein nicht veränderbare Attribute-Eigenschaften können mit eine bestimmten Zeichenfolge {1,1,1} überschrieben / gesetzt werden. Hierzu ist es erforderlich beim Merkmal in dem Feld Mehrfachauswahl diese Zeichenfolge zu hinterlegen. Das vorangegangene Beispiel setzt zum Beispiel folgende Attribut Eigenschaften:

* is_filterable = 1
* is_filterable_in_search = 1
* used_for_sort_by = 1

Soll nur der erste Wert (is_filterable) gesetzt werden so kann das mit {1} übertragen werden, für den darauffolgenden (is_filterable_in_search) dann {1,1}...

[[Datei:DefinierteMerkmale.png|800px|thumb|center|DefinierteMerkmale.png]]

Der nachfolgende Screenshot zeigt einen Artikel dem 2 Merkmalgruppen über die 1. Kategorie zugeordnet wurde:

[[Datei:DefinierteMerkmaleMagentoMention.png|800px|thumb|center|DefinierteMerkmaleMagentoMention.png]]

=== Attribut Editor ===

Erweiterte Attribut Einstellungen können über die Magento Einstellungen mittels des Attribut Editors geändert werden. Änderungen werden automatisch erkannt. Bitte beachten: Die Einstellungen befinden sich innerhalb des Programmverzeichnisses und können unter Umständen schreibgeschützt sein.

[[Datei:MentionConnect_magento_attribut_editor.png|800px|thumb|center|MentionConnect magento attribut editor.png]]

Einstellungen des Attributes befinden sich innerhalb einer XML Datei:

<pre>
"Programmverzeichnis\Settings\Magento\attribute_code.afl250.xml"
</pre>

=== Handling von Bestellungen ===

Es werden alle neuen Bestellungen aus dem Magento Shop importiert, hierbei ist es erstmalig nicht bekannt, welche Zahlungsbedingung und welche Versandart aus Magento zu den mention Zahlungsbedingungen und Versandarten zugeordnet werden sollen. Sollte eine nicht zugeordnete Versandart oder Zahlungsbedingung beim Bestellimport in das System einfließen, so werden die externe IDs gespeichert die dann in den Einstellungen zu einer in mention zugeordnet werden können.

siehe hierzu nachfolgenden Screenshot:

[[Datei:Magento_einstellungen_zuordnung_versand_und_zahlarten.png|800px|thumb|center|Magento einstellungen zuordnung versand und zahlarten.png]]

=== Artikelpreise VK 1-X ===

Der nachfolgende Screenshot veranschaulicht die Einstellungen innerhalb Magento und mention bzgl der Übertragung von weiteren Preisen.

[[Datei:Magento_mention_kundengruppen_preise.png|800px|thumb|center|Magento mention kundengruppen preise.png]]

== Anhang ==

=== Ein Einstellungsbeispiel ===

[[Datei:Magento_einstellungs_beispiel.png|800px|thumb|center|Magento einstellungs beispiel.png]]

=== Magento - SOAP Beispiel Einstellung ===

Nachfolgend ein Beispiel aus der Rechtevergabe eines Entwickler Shops

SOAP Einstellungen in Magento

[[Datei:Magento_einstellung_webservice_soap.png|800px|thumb|center|Magento einstellung webservice soap.png]]

==== Magento SOAP Benutzer ====

[[Datei:Magento_einstellung_webservice_users.png|800px|thumb|center|Magento einstellung webservice users.png]]

==== Magento SOAP Rollen ====

[[Datei:Magento_einstellung_webservice_roles.png|800px|thumb|center|Magento einstellung webservice roles.png]]

==== Magento SOAP Resources ====

[[Datei:Magento_einstellung_webservice_role_resources.png|800px|thumb|center|Magento einstellung webservice role resources.png]]

==== Magento SOAP Resources Benutzer-Zuordnung ====

[[Datei:Magento_einstellung_webservice_role_users.png|800px|thumb|center|Magento einstellung webservice role users.png]]

=== Gespeicherte Kollektionen im Backend ===

[[Datei:Magento_kollektion_beispiel.png|800px|thumb|center|Magento kollektion beispiel.png]]