Magento2-Schnittstelle

Aus Faktura-XP Handbuch
Zur Navigation springen Zur Suche springen

Magento 2 Schnittstelle einrichten

.

.

Anbindung Magento 2.x an Faktura-XP Warenwirtschaft

Wir bieten für Faktura-XP Warenwirtschaft eine Schnittstelle zu Magento 2.x - alternativ auch eine separate Schnittstelle zu Magento 1.x - an. So können sie wahlweise oder auch zeitgleich beide Schnittstellen verwenden. Ebenso ist die Verwendung der Magentoanbindung auch mit jeweils unterschiedlichen Mandanten in Faktura-XP realisierbar. Das ist dann sinnvoll, wenn sie zwei Onlineshops mit zwei unterschiedlichen Firmen in einer Faktura-XP Warenwirtschaft betreiben möchten. So können sie leicht und flexibel ihren Onlinehandel abwickeln.


Ein Mischbetrieb mehrerer verschiedener Shopsysteme ist über verschiedene Mandanten zu realisieren. Faktura-XP unterstützt theoretisch 999 Mandaten.

-

Magento Shopsoftware als eCommerce Lösung

Magento ist eine Onlineshop-Software die in der Version 1.0 erstmals 2008 als Open-Source-E-Commerce-Plattform veröffentlicht wurde Sie ist eines der führenden Shopsysteme auf dem Open-Source Markt und nahezu das meistverwendete Shopsystem (Stand 2016). Magento 2 ist der Nachfolger von Magento 1. Die neue Version wurde bereits im November 2015 veröffentlicht. Entwickelt wird Magento 2 unter Zuhilfenahme des Zend Framework und Symfony. Die Software steht unter der Open Software License Version 3.0.

Magento2 logo683x212.png

Magento 2 wurde im Zuge des Versionssprungs einer gründlichen Überarbeitung unterzogen. Die Shopsoftware hat ein umfassend überarbeitetes Backend und einen visuellen Layout-Editor, in dem Blöcke mit der Maus in andere Bereiche verschoben werden können. Zudem erhielt der Magento 2 eine komplett neue API Schnittstelle um Daten aus dem Magento an andere Systeme wie Faktura-XP Warenwirtschaft zu transportieren.


Technisch gesehen sind beide Shopsysteme auf Grund ihrer Konstruktion mit unterschiedlichen Schnittstellen ausgestattet. 
Daher bieten wir zu Faktura-XP auch jeweils eine eigene Magento Schnittstelle an.  

* Magento 1 Schnittstelle zu Faktura-XP Warenwirtschaft
* Magento 2 Schnittstelle zu Faktura-XP Warenwirtschaft


.

Mindestanforderungen Magento® 2 Anbindung

Mindestanforderungen zur Nutzung der Faktura-XP Magento 2® Schnittstelle in Verbindung mit einem Magento® 2 Shop:

.

Vorbereitungen für den Zugriff auf Ihren Magento 2-Shop

Um eine Kommunikation zwischen Faktura-XP und Ihrem Magento® 2 Shop herzustellen zu können, benötigen Sie nur wenige Schritte. Dabei sind keinerlei Änderungen an Ihrem bestehenden Magento® Shop notwendig. Alles was sie benötigen sind die Zugangsdaten zu ihrem Adminbereich ihres Magento® 2 Shops sowie die Internetadresse ihres Shops.

Tipp

Hinweise zur Faktura-XP® Magento 2 Schnittstelle

Die Kommunikation zwischen der Warenwirtschaft Faktura-XP® und dem Onlineshopsystem Magento® 2 wird über die im Magento Shop integrierte REST-API Schnittstelle realisiert. Diese erfordert keinerlei installierte Module oder Plug-Ins die im Shop hinterlegt oder installiert werden müssen. Anlage von Artikeln geschieht SEO-Bedingt shopseitig, Faktura-XP® ruft die notwendigen Daten des Artikels via REST-API in ihren Artikelstamm ab und ermöglicht so eine Aktualisierung in beide Richtung ohne Funktionseinschränkungen durch zukünftige Updates ihres Magento® 2 Shops.


.

Parameter und Einstellungen der Magento® 2 Schnittstelle

Um einen reibungslosen Bestellabruf zu gewährleisten, müssen Sie einmalig Einstellungen vornehmen, wie die Daten übertragen werden und welche Aktionen während und nach der Übertragung im Hintergrund ausgeführt werden.

Hinweis

Hinweis:

Beim ersten Kontakt zwischen der Magento® 2 Schnittstelle und Ihren Magento® 2 Onlineshop werden die meisten Grundeinstellungen bereits vor eingestellt. Einzig Ästhetik-, Lager- und Buchhalterische Einstellungen sowie Einstellungen zum Rücktransfer in den Onlineshop müssen je nach eigenen Anforderungen eingerichtet werden. Die Grundkonfiguration der Schnittstelle meldet keine Informationen an Bestellungen und/oder Lagerdaten und verändert nichts in ihrem Onlineshop.

Klicken Sie hierzu auf die Schaltfläche „Parameter“ innerhalb der Magento® 2 Schnittstelle um in die Parameter und Einstellungen zu gelangen. Die Einstellungen sind in einzelne Thematische Karteikarten unterteilt.

Registerkarte "Allgemeines"

Auf der Registerkarte „Allgemeines“ können Sie einen Namen und den Betreiber des Shops hinterlegen, sowie die Einstellungen der Sprache sowie welche Status Sie beim Bestellabruf als Dokument anlegen möchten.

Registerkarte "Dokumenterstellung"

Die Registerkarte „Dokumenterstellung“ beinhaltet Einstellungen über das Verhalten zur Anlage von Bestellungen als Dokumente. Standardmäßig werden Bestellungen in Faktura-XP® über die Gambio® GX3 Schnittstelle als Lieferschein importiert.


Hierzu sind folgende Einstellmöglichkeiten vorhanden:


Mitarbeiterkennung des Lieferschein(Rechnung)-Erstellers

Wählen Sie hier aus, welcher Mitarbeiter als Ersteller des Lieferscheins / der Rechnung hinterlegt werden soll.


Zusätzlich Auftragsbestätigung generieren

Möchten Sie neben dem Lieferschein auch noch ein Dokument vom Typ „Auftragsbestätigung“ erzeugen, aktivieren Sie diese Option.


zum Stapeldruck markieren

Sollen erstellte Lieferscheine zur Druck-Massenverarbeitung (Stapeldruck) hinzugezogen werden, aktivieren Sie diese Option.


Bestellstatus bei Lieferschein(Rechnung) automatisch ändern auf

Wenn die Bestellung als Lieferschein angelegt / der Lieferschein in eine Rechnung umgewandelt wurde, wird in dieser Einstellung festgelegt, welcher Onlineshop-Bestellstatus für die bearbeitete Bestellung gesetzt werden soll. Ein Abgleich zum Shop geschieht mit dieser Option noch nicht.


Bestellstatusänderung an Shop übertragen

Wird diese Option aktiviert, wird der Status der Bestellung im Onlineshop auf den oben eingegebenen Bestellstatus verändert. Je nachdem wie Ihr Onlineshop auf Reaktion zu Statusänderungen eingestellt ist, kann hierdurch durch den Shop eine Benachrichtigung des Kunden ausgelöst werden


Text-Baustein oberhalb der Positionen

Möchten Sie einen individuellen Text über den Positionen ausgeben, können Sie aus den verfügbaren Textbausteinen hier den passenden auswählen. Ist dieser Eintrag Leer und ist kein ZA-Textbaustein (Zahlartabhängiger Textbaustein) für die Bestellung und dessen Zahlart aktiviert oder ebenfalls leer wird ein Standardmäßig vorgefertigter Text oberhalb der Positionen festgelegt und geschrieben:

Ihre Bestellung %BestellNr% vom %Bestelldatum%. Zahlung via %OSC_Zahlart%.

Wurde die Bestellung als Gastkundenbestellung ausgelöst, wird hinter dem Standard-Text keine Angabe der Shop-Kundennummer hinzugefügt, ansonsten wird der Text ergänzt um diese Angabe.


Text-Baustein unterhalb der Positionen

Möchten Sie einen individuellen Text unter den Positionen ausgeben, können Sie aus den verfügbaren Textbausteinen hier den passenden auswählen. Ist dieser Eintrag Leer und ist kein ZA-Textbaustein (Zahlartabhängiger Textbaustein) für die Bestellung und dessen Zahlart aktiviert oder ebenfalls leer wird ein Standardmäßig vorgefertigter Text oberhalb der Positionen festgelegt und geschrieben:

Vielen Dank für ihre Bestellung
Tipp

Tipp:

Ist die Zahlart unbekannt wird bei Zahlung via die Begrifflichkeit "Rechnung*" hinterlegt. Fügen Sie unter ZA-Textbausteine ein Zahlart-Modul mit der Bezeichnung aus dem Shop und einer Übersetzung manuell hinzu um für künftige Bestellungen die korrekte Zahlweise ausgeben zu können.

Hinweis

Hinweis:

Anhand der Sprachkennung des Kunden aus dem Shopsystem wird der Standardtext in den jeweiligen Sprachen Deutsch, Englisch oder Französisch ausgegeben. Texte, welche für eine Zahlart hinterlegt wurden sind nur in einer Sprache erfassbar und werden unabhängig der Sprachkennung des Kunden aus dem Shopsystem ausgegeben. Es werden also die selbst hinterlegten Texte 1:1 auf den Dokumenten ausgegeben, unabhängig der Sprache.


Zu jeder Bestellung ein eigenes Projekt erstellen

Möchten Sie, dass neben dem Lieferschein auch ein Projekt für die Projektverwaltung erstellt wird, aktivieren Sie diese Option. Die Positionen und Einstellungen des Lieferscheins werden dem Projekt zu Grunde gelegt, der Lieferschein dem Projekt als Dokument verknüpft.

Hinweis

Hinweis:

Diese Option ist nur sichtbar, wenn das Modul Projektverwaltung erworben und lizensiert wurde.

.

Registerkarte "Shopeinstellungen"

Auf der Registerkarte „Shopeinstellungen“ können sie die vorab ermittelten Einstellungen ihres Magento® 2 Shops einsehen und ggf. Anpassen. Die meisten Einstellungen werden bereits vorab aus der Konfiguration des verbundenen Shops gelesen, können aber hier jederzeit überstimmt werden.


Standort ISO-3166 (2 Stellen)

Geben Sie die nach das Landeskürzel für das Land in dem ihr Shop hinterlegt ist nach ISO-3166 mit zwei Buchstaben an. Für Deutschland wäre dies „DE“, für England z.B. „GB“


Standardwährung

Hier wird die Währung hinterlegt welche beim Abruf von Bestellungen verwendet wird. Standardmäßig wird hier die dreistellige Norm, für Euro z.B. „EUR“ für US-Dollar z.B. „USD“ verwendet, es ist aber auch möglich, das Währungskennzeichen (z.B. € für Euro, bzw. $ für US-Dollar) anzugeben.


Artikelpreise in VK übertragen

Geben Sie hier an, wie die Preise innerhalb des Shops hinterlegt sind. Die Preislichen Angaben beziehen sich auf die Anlage des Artikels im Artikelstamm. Der Shop speichert in seinen Grundeinstellungen die Preise in Netto ab, weshalb „1:1 übernehmen“ eingestellt bleiben sollte. Sollte ihr Shop modifiziert worden sein und die Preise abweichend abspeichern oder sollten die Preise durch Anpassungen im Shop falsch übertragen werden, z.B. wenn der Netto-Preis um die MwSt-Summe zu niedrig oder zu hoch ist, wählen Sie den jeweiligen Menüpunkt „MwSt zuschlagen“ bzw. „MwSt abziehen“ aus.


Artikelpreise in EK übertragen

Analog zu „Artikelpreise in VK übertragen“ jedoch für EK-Preise. Die Preislichen Angaben beziehen sich auf die Anlage des Artikels im Artikelstamm.


Gegenkonten, Versandkosten

Tragen Sie hier das Gegenkonto für Versandkosten ein. Dieses wird für die Position der Versandkosten im Dokument hinterlegt.


Gegenkonten, Auslandskunde

Tragen Sie hier das Gegenkonto für Auslandskunden ein. Dieses wird im Kundenstamm des Kunden hinterlegt, sofern dieser beim Bestellabruf noch nicht im Kundenstamm existiert und eindeutig erkannt wurde, dass das hinterlegte Land vom eigenen Herkunftsland abweicht.


Gegenkonten, Inlandskunde

Tragen Sie hier das Gegenkonto für Inlandskunden ein. Dieses wird im Kundenstamm des Kunden hinterlegt, sofern dieser beim Bestellabruf noch nicht im Kundenstamm existiert und eindeutig erkannt wurde, dass das hinterlegte Land identisch ist mit dem eigenen Herkunftsland.


Bestellte Artikel im Shop sind Brutto

Setzen Sie diesen Haken, wenn die Artikel in der Bestellung in Brutto dargestellt werden und auch so im Shopsystem hinterlegt sind. Diese Angabe bezieht sich auf die Ermittlung der Positionen in Lieferscheinen und Rechnungen. Sollte beim Bestellabruf die Preisliche Angabe inkorrekt übermittelt werden, passen Sie für künftige Bestellabrufe diese Option an. Die Voreinstellung wird durch die Konfiguration des Shops bereits ermittelt und bedarf in der Regel keine Anpassung.


Skonto / Nachlass im Shop ist Brutto

Setzen Sie diesen Haken, wenn Skonto oder Nachlässe in der Bestellung in Brutto dargestellt werden und auch so im Shopsystem hinterlegt sind. Diese Angabe bezieht sich auf die Ermittlung der Positionen in Lieferscheinen und Rechnungen. Sollte beim Bestellabruf die Preisliche Angabe inkorrekt übermittelt werden, passen Sie für künftige Bestellabrufe diese Option an. Die Voreinstellung wird durch die Konfiguration des Shops bereits ermittelt und bedarf in der Regel keine Anpassung.


Gutscheine im Shop sind Brutto

Setzen Sie diesen Haken, wenn Gutscheine in der Bestellung in Brutto dargestellt werden und auch so im Shopsystem hinterlegt sind. Diese Angabe bezieht sich auf die Ermittlung der Positionen in Lieferscheinen und Rechnungen. Sollte beim Bestellabruf die Preisliche Angabe inkorrekt übermittelt werden, passen Sie für künftige Bestellabrufe diese Option an. Die Voreinstellung wird durch die Konfiguration des Shops bereits ermittelt und bedarf in der Regel keine Anpassung.


Mengenrabatt im Shop ist Brutto

Setzen Sie diesen Haken, wenn Mengenrabatte in der Bestellung in Brutto dargestellt werden und auch so im Shopsystem hinterlegt sind. Diese Angabe bezieht sich auf die Ermittlung der Positionen in Lieferscheinen und Rechnungen. Sollte beim Bestellabruf die Preisliche Angabe inkorrekt übermittelt werden, passen Sie für künftige Bestellabrufe diese Option an. Die Voreinstellung wird durch die Konfiguration des Shops bereits ermittelt und bedarf in der Regel keine Anpassung.


Mindestmengenzuschlag ist Brutto

Setzen Sie diesen Haken, wenn hinterlegte Mindestmengenzuschläge in der Bestellung in Brutto dargestellt werden und auch so im Shopsystem hinterlegt sind. Diese Angabe bezieht sich auf die Ermittlung der Positionen in Lieferscheinen und Rechnungen. Sollte beim Bestellabruf die Preisliche Angabe inkorrekt übermittelt werden, passen Sie für künftige Bestellabrufe diese Option an. Die Voreinstellung wird durch die Konfiguration des Shops bereits ermittelt und bedarf in der Regel keine Anpassung.


Optionspreise dem Einzelpreis zuschlagen

Wenn Optionspreise im Shop verwendet werden, jedoch nicht in Form einer Kombination bereits aktiv hinterlegt sind, kann über diesen Haken der jeweilige Optionspreis dem Einzelpreis zugeschlagen werden. Hierbei gibt es die Möglichkeit die Optionspreise immer Fix (Einzelpreis + Summe des Optionspreises), immer Prozentual (Einzelpreis + Prozentualer Wert des Einzelpreises aus Option) oder Automatisch (Angabe in Bestellung vorrangig) zu übernehmen. Ist diese Option ausgeschaltet, werden jedoch in einer Bestellung Optionspreise verwendet, berechnet die Magento® 2-Schnittstelle dies anhand der Vorgaben der Bestellung automatisch.


Optionspreise im Artikeltext auflisten

Ist dieser Haken aktiviert, werden hinter jeder Option der jeweilige Preis in Klammern hinzugefügt.


Auslandskunden automatisch auf Steuerfrei setzen

Kunden, die nicht aus dem EU Land kommen, wenn Standort ISO-3166 ein EU-Land ist, werden automatisch auf Steuerfrei gesetzt, alle Positionen haben dann 0% MwSt. Hat der Kunde im Shop die Steuerbefreiung aktiv, werden ebenfalls alle Positionen auf 0% MwSt gesetzt. Bei Anlage eines Neukunden wird der Haken Steuerfrei gesetzt und gilt somit für jede weitere Bestellung / jeden Lieferschein / jede Rechnung solange im Kundenstamm dies nicht wieder entfernt wird.


MwSt-Satz für Gebühren und Optionen

Hier wird der MwSt-Satz für Gebühren und Optionen festgelegt, sofern eine Ermittlung über die Position der Bestellung nicht eindeutig ist.


Versandkosten im Shop sind Brutto

Hier wird der MwSt-Satz für Versandkosten festgelegt, sofern eine Ermittlung über die Bestellung nicht eindeutig ist.


.

Registerkarte "Übertragungseinstellungen"

Auf der Registerkarte „Übertragungseinstellungen“ können sie festlegen, wie Kunden oder Artikel angelegt werden und welche zusätzlichen Informationen bei einem Bestellabruf verarbeitet werden sollen.


Kundenstamm, Schreibweise bei Adressübernahme

Geben Sie hier an, ob Kunden immer in der Schreibweise Vorname Nachname oder Nachname, Vorname im Kundenstamm hinterlegt werden sollen. Diese Option gilt immer nur für eine Kundenneuanlage, bereits vorhandene Kunden werden nicht verändert. Die Ermittlung des Kunden geschieht über das Eindeutigkeitsmerkmal E-Mailadresse.


Anfangsbuchstaben in Adresse groß schreiben

Hiermit werden Eingaben, welche am Wortanfang kleingeschrieben wurden automatisch korrigiert.


Nur Kunden anlegen, für die Bestellungen vorhanden Beim Bestellabruf werden nur Kunden angelegt, dessen Bestellung abgerufen wird. Über diese Option, können auch registrierte Kunden mit Warenkorbabrüche angelegt werden. Hierbei wird nur der Kunde erstellt, eine Verarbeitung des Warenkorbabbruchs wird unterbunden.

Hinweis

Hinweis:

Diese Option kann nur angewendet werden, wenn dies im Shop auch explizit erlaubt wurde. Grundsätzlich werden Konform der DSGVO nur die Kunden in den Kundenstamm übertragen, welche aktiv eine Bestellung im Onlineshop durchgeführt haben. Kunden welche sich nur im Shop registriert haben, werden nicht in den Kundenstamm übernommen. Ist diese Option deaktiviert und lässt der Shop eine Übermittlung der Kundendaten zu, welche keine Bestellung getätigt haben werden diese Kunden ebenfalls im Kundenstamm angelegt, sofern noch nicht vorhanden. Das verwendete Eindeutigkeitsmerkmal ist die E-Mailadresse.

Bank- und Kreditkartendaten im Kunden speichern wenn verfügbar

Wenn in der Bestellung Bank-Informationen für Lastschriftverfahren oder Kreditkarte hinterlegt sind, werden diese Informationen mit abgerufen und in den internen Informationen des Dokuments hinterlegt.

Hinweis

Hinweis:

Konform der DSGVO werden nur dann Bank-Informationen übertragen, wenn dies im Shop zugelassen ist. Ist eine Verarbeitung von Bank-Informationen für Dritte im Shop nicht zugelassen, werden keine Bank-Informationen zur Bestellung in die verarbeiteten Dokumente übernommen und es werden auch keine Bank-Informationen dem Kundenstamm hinzugefügt.

Nur im Kundenstamm eintragen, falls noch nicht angegeben

Wenn im Kundenstamm keine Bankdaten hinterlegt sind, werden die in der Bestellung befindlichen Daten darin abgespeichert. Existieren bereits Bank-Informationen im Kunden, werden diese nicht überschrieben. Die Bank-Informationen der jeweiligen Bestellung werden in den internen Informationen des Dokuments hinterlegt.


Lastschrift / DTA automatisch erzeugen für

Wenn Lastschrift-Informationen der Bestellung bei liegen und diese Erkannt werden, können automatisch SEPA bzw. DTA-Datensätze erzeugt werden, die jeweilige Basis auf welchem Dokument diese Daten erstellt werden sollen kann hier angegeben werden.


Zahlungsbedingungen aus Kundenstamm in Rechnung einfügen

Wenn Zahlungsbedingungen für Neukunden aktiviert, werden diese dem Kunden hinterlegt.


Zahlungsbedingungen aus Kundenstamm in Proforma-Rechnung einfügen

Wenn Zahlungsbedingungen für Neukunden aktiviert, werden diese dem Kunden hinterlegt.  


Artikelstamm, Herstellername in Artikeltext setzen

Wenn beim Abruf eines Artikels oder einer Position der Hersteller am Ende des Artikeltextes hinterlegt werden sollen kann dies mit diesem Haken aktiviert werden.


Herstellername vor Artikeltext setzen

Soll der Herstellername vor den Artikeltext kann dies hiermit aktiviert werden, ansonsten wird dieser am Ende des Textes hinterlegt sofern die Option aktiviert wurde.


Shop-ArtikelID dem Artikeltext anfügen

Wenn beim Abruf eines Artikels oder einer Position die Artikelnummer des Shops angefügt werden soll, kann dies mit dieser Option aktiviert werden.


Artikelname statt Artikelkurzbeschreibung übertragen

Ist diese Option aktiviert, wird der Artikelname verwendet statt die Artikelkurzbeschreibung.

Hinweis

Hinweis:

Diese Option lässt sich nur dann verändern, wenn in jedem Artikel eine Kurzbeschreibung hinterlegt wurde. Wenn Artikel existieren in denen keine Kurzbeschreibung hinterlegt wurde, ist die Option automatisch aktiv und lässt sich nicht deaktivieren.


Lagerbestand in Faktura-XP mitführen

Wenn der Lagerbestand bei Artikelabruf übernommen werden soll, kann man dies mit dieser Option aktivieren.


Shopartikelnummern in Faktura-XP verwenden

Ist diese Option aktiviert und besitzt kein Artikel welcher im Artikelabruf bearbeitet werden soll Daten die zu einer Inkonsistenz oder einem Fehlverhalten durch z.B. Doppler oder zu lange Artikelnummern führen, übernimmt diese Option statt der internen eigenen Artikel-ID von Faktura-XP die Artikelnummer des Shops. Wird eine Inkonsistenz oder ein Fehlverhalten ermittelt wird für den anstehenden Artikelabruf diese Option ignoriert.


HTML-Notation von Sonderzeichen wandeln

Wenn Umlaute nicht korrekt dargestellt werden, kann diese Option diese korrigieren. Hierbei werden alle HTML-Notationen (z.B. HTML-Befehle für Umbrüche, Umlaute, Aufzählungen usw.) umgewandelt oder entfernt.


Standard Artikeleinheit

Hier kann die Standardeinheit angegeben werden, wenn in einem Artikel oder in einer Bestellposition keine Einheit hinterlegt ist.


Standarderlösart

Hier kann das Standard Erlöskonto für Artikel hinterlegt werden.


Eigenschaften / Varianten / Attribute als eigene Artikel anlegen

Besitzt ein Artikel Varianten, so werden aus diesen eigene Artikel erzeugt. Ist die Option ausgeschaltet werden nur die Hauptartikel abgerufen und alle Varianten-Artikel werden ignoriert.

Shopartikelnummern in Faktura-XP verwenden (bei Positionsauswahl in Dokumenten)

Ist diese Option aktiviert, kann man in Faktura-XP im Artikel-ID-Feld nach der SKU statt der internen Faktura-XP Artikelnummer suchen.


Inaktive Artikel bei Übertragung berücksichtigen

Ist diese Option aktiviert, werden auch inaktive Artikel abgerufen. Diese Artikel werden im Artikelstamm von Faktura-XP ebenfalls auf inaktiv gestellt und dementsprechend farblich kenntlich gemacht.


.




Diese Seite ist noch in Arbeit.

Klicken sie hier um uns eine Frage per Email zu stellen.


Wir geben Ihnen dennoch gern Auskunft zu diesem Menüpunkt. Nehmen sie dazu direkt Kontakt zu uns auf oder senden sie uns eine Email.


.