Magento2-Schnittstelle: Unterschied zwischen den Versionen

Aus Faktura-XP Handbuch
Zur Navigation springen Zur Suche springen
(Der Seiteninhalt wurde durch einen anderen Text ersetzt: „==Magento® 2 Onlineshopsystem== Magento 2 Nutzen Sie die Möglichkeiten ihres Magento® 2 Onli…“)
Markierung: Ersetzt
Zeile 1: Zeile 1:
__NOTITLE__
+
==Magento® 2 Onlineshopsystem==
=Magento 2 Schnittstelle einrichten=
 
  
.
+
[[File:Magento2_logo683x212.png|Magento 2]]
__TOC__
 
 
 
.
 
 
 
==Anbindung Magento 2.x an Faktura-XP Warenwirtschaft==
 
 
 
Wir bieten für Faktura-XP Warenwirtschaft eine [[Magento2-Schnittstelle|Schnittstelle zu Magento 2.x]] - alternativ auch eine separate [[Magento-Schnittstelle|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.
 
 
 
[[File:Magento2_logo683x212.png|400px]]
 
 
 
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. 
 
 
* [https://www.faktura-xp.de/shop/ecommerce-schnittstellen/magento-schnittstelle Magento 1 Schnittstelle zu Faktura-XP Warenwirtschaft]
 
* [https://www.faktura-xp.de/shop/ecommerce-schnittstellen/magento-2-schnittstelle 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:
 
 
 
* Magento Shop mit installierter Version 2.2 oder neuer
 
* Shop darf nicht im Wartungsmodus sein
 
* '''[https://www.faktura-xp.de/produkt/faktura-xp-select-edition/ Faktura-XP SELECT Edition]''' oder '''[https://www.faktura-xp.de/produkt/faktura-xp-select-pro-edition/ Faktura-XP SELECT PRO Edition]''' in Version 5.0.0520 oder neuer
 
* Gültige Lizenz der '''[https://www.faktura-xp.de/shop/ecommerce-schnittstellen/magento-2-schnittstelle Magento® 2 Schnittstelle]'''
 
* Administrativen Zugang zu Ihrem 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.
 
 
 
<box type="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.
 
 
 
 
 
</box>
 
.
 
 
 
==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.
 
 
 
<box type="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.
 
</box>
 
 
 
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 Magento® 2 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
 
 
 
<box type="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.
 
</box>
 
 
 
<box type="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.
 
</box>
 
 
 
 
 
'''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.
+
Nutzen Sie die Möglichkeiten ihres Magento® 2 Onlineshopsystems mit Faktura-XP® Warenwirtschaft optimal aus. Das durch die Firma Adobe und der eifrigen Community stetig weiterentwickelte beliebte Shopsystem Magento® bekommt in Version 2 eine Verjüngungskur der Extravaganz. An moderne System und aktuelle Bedürfnisse angepasst lässt dieses Shopsystem kaum Wünsche offen. Magento® 2 baut ebenso wie sein Vorgänger auf das API-First-Prinzip auf, was es Faktura-XP® Warenwirtschaft ermöglicht nahtlos mit dem Onlineshop zu kommunizieren und kompatibel zu sein.
  
<box type="hinweis">
 
'''Hinweis:'''
 
 
Diese Option ist nur sichtbar, wenn das Modul Projektverwaltung erworben und lizensiert wurde.
 
</box>
 
  
 
.
 
.
  
===Registerkarte "Shopeinstellungen"===
+
====Magento® 2 Schnittstelle einrichten====
 
 
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.
 
  
 +
[[Magento2-Schnittstelle_einrichten|Magento® 2 Schnittstelle einrichten]]
  
  
 
.
 
.
===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.
 
 
<box type="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'''.
 
 
</box>
 
 
'''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.
 
 
<box type="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.
 
 
</box>
 
 
'''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.
 
 
<box type="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.
 
 
</box>
 
 
 
'''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.
 
 
 
 
.
 
===Registerkarte "Lagereinstellungen"===
 
 
Auf der Registerkarte „Lagereinstellungen“ können Sie das Verhalten für die Lagerbuchung Shop-seitig sowie Faktura-XP-seitig festlegen.
 
 
 
'''Lagerbestand an Shop zurückmelden'''
 
 
Ist diese Option aktiviert, wird nach einem Bestellabruf die Lagerbestandsübermittlung angestoßen. Hierbei werden alle Artikel, die aus dem gleichen Shop-Profil stammen, welche sich seit dem letzten Bestellabruf verändert haben an den Shop übermittelt. Diese Option ist Standardmäßig deaktiviert um ein "Nur-Lesend-Abruf" ermöglichen zu können.
 
 
 
'''Lagerbestände aus Artikel-Stamm Informationen übertragen (Empfohlen)'''
 
 
Dies ist die Standardoption, wie die aktuell in Faktura-XP verfügbaren Lagerbestände an den Shop übertragen werden. Hierbei wird der Wert des Lagerbestandes, welcher im Artikel hinterlegt wird 1:1 an den Shopartikel übertragen.
 
 
 
'''Lagerbestände aus Lagerzu- und abgänge übertragen'''
 
 
Unterstützt der Shop eine Lagerhistorie wird mittels der API in dieser ein Eintrag hinzugefügt welcher die Differzenz zwischen dem Artikel im Shop und Faktura-XP abbildet und trägt diesen dort ein. Unterstützt der Shop diese Form der Übermittlung nicht, lässt sich dieser Menüpunkt nicht auswählen.
 
 
 
'''Eindeutige Kennung für Lagerbuchung bei Shopabruf'''
 
 
Hier wird festgelegt, in welchem Informationsfeld des Faktura-XP Artikels der Artikel der Bestellposition zugeordnet werden kann. Wird über die Auswahl dann der Artikel eindeutig gefunden, wird der Lagerbestand des Faktura-XP Artikels um die Verkaufte Menge der Bestellposition vermindert. Wird „keine Lagerbuchung vornehmen“ (Standard) ausgewählt, werden die Lagerbestände in Faktura-XP nicht durch die Mengen welche in den Bestellpositionen vorhanden sind verändert.
 
 
<box type="tipp">
 
'''Tipp:'''
 
 
Für eine eindeutige Erkennung empfiehlt es sich, die Option "Stock-Keeping-Unit (SKU) / Hersteller-Artikelnummer (Shop-Artikelnummer)" zu verwenden. Bei der Übernahme der Artikel über die Funktion Artikelabruf wird die Artikelnummer immer in das SKU-Feld im Artikelstamm geschrieben. Dies, zusammen mit der '''products_id''' welche Shop-Intern den Artikel eindeutig macht, ermöglicht eine saubere Erkennung der Artikel bei Übertragung der Bestellungen als Lieferscheine und Rechnungen um so dem Lager korrekt die Mengen zu entnehmen.
 
 
</box>
 
 
<box type="hinweis">
 
'''Hinweis:'''
 
 
Bei der Artikelübertragung mittels Funktion '''Artikelabruf''' und aktivierter Einstellung "Lagerbestand in Faktura-XP mitführen" wird immer der aktuelle IST-Zustand des Lagers aus dem Shop übermittelt. Dieser Wert entspricht dem aktuellen Lagerbestand nach den bis dahin eingegangenen Bestellungen. Wird ein Bestellabruf getätigt mit Bestellungen die vor diesem Abruf getätigt wurden, werden die Lagermengen nochmals abgezogen. Es empfiehlt sich, vor der Übernahme der Artikel durch '''Artikelabruf''' sämtliche Bestellungen abzurufen, und danach erst den Artikelabruf zu starten um mögliche Fehlbestände auszuschließen bzw. so gering wie möglich zu halten.
 
 
</box>
 
 
.
 
===Registerkarte "Buchungseinstellungen"===
 
 
Auf der Karteikarte „Buchungseinstellungen“ können Gegenkonto und Buchungskonto für in Rechnung umgewandelte Bestellungen hinterlegt werden.
 
 
 
.
 
===Registerkarte "Service-Funktionen"===
 
 
Auf der Karteikarte „Service-Funktionen“ befinden sich Funktionen, welche den Bestellabruf begrenzen. Dies ist bei einer Technischen Wartung durch einen Administrator notwendig, wenn Funktionen geprüft und Daten ausgewertet werden müssen. Diese Optionen sollten nur von einem Administrator aktiviert werden, und müssen nach Verwendung vom Administrator wieder deaktiviert werden.
 
 
 
 
.
 
==ZA-Textbausteine==
 
 
Möchten Sie für jede Zahlart einen individuellen Text hinterlegen, so können Sie über die Schaltfläche die Verwaltung der Zahlartabhängigen Textbausteine öffnen. In diesem können Sie für jede im Onlineshop hinterlegte Zahlart individuell die Texte oberhalb und unterhalb der Positionen festlegen. Ist ein Zahlartabhängiger Textbaustein aktiviert und sind Textbausteine hinterlegt werden diese bevorzugt verwendet. Unbekannte  Zahlarten verwenden die Einstellungen aus den Einstellungen „Text-Baustein oberhalb / unterhalb der Positionen“. Ist der Zahlartabhängige Textbaustein aktiviert und kein Textbaustein hinterlegt werden keine Texte ausgegeben.
 
 
 
<box type="hinweis">
 
'''Hinweis:'''
 
 
Bevor Sie Zahlartabhängige Textbausteine für Zahlungsweisen des Shops hinterlegen können, müssen in den Stammdaten unter Texte > Textbausteine diese Vorlagen angelegt werden. Lesen Sie dazu den Abschnitt [[Texte#Textbausteine|Textbausteine]]
 
 
</box>
 
 
.
 
===Navigation innerhalb der ZA-Textbaustein-Verwaltung===
 
 
Die ZA-Textbaustein-Verwaltung zeigt beim öffnen immer die erste vorhandene Zahlart an. Um die Zahlarten zu wechseln, können die blauen Schaltflächen (1) verwendet werden. Um eine neue Zahlart hinzufügen zu können, genügt ein Klick auf die Plus-Schaltfläche (2) bei '''Funktion / Modulname'''.
 
 
.
 
===Hinzufügen eines neuen Zahlart-Moduls===
 
 
Wird auf die Plus-Schaltfläche bei '''Funktion / Modulname''' geklickt, öffnet sich eine Eingabemaske zum hinzufügen einer neuen Zahlart. Geben Sie hier die im Shop ersichtliche Modulbezeichnung bei '''Funktion / Modulname''' ein. Sollte die Zahlart eine zweite Bezeichnung besitzen, z.B. zur Unterscheidung verschiedener Vorgänge (Vorkasse, auf Rechnung, Lastschrift etc.) kann bei '''Alias''' hier diese Bezeichnung hinterlegt werden, sofern diese im Shop eindeutig ist. Geben Sie abschließend bei '''Bezeichnung''' den Text ein, welcher auf der Rechnung später für die Zahlart erscheinen soll.
 
 
'''Beispiel:'''
 
 
Funktion / Modulname: '''paypal3'''
 
Alias: '''paypal3_preinstallments'''
 
Bezeichnung: '''PayPal Kauf auf Rechnung'''
 
 
Bestätigen Sie ihre Eingaben durch Klick auf die '''OK''' Schaltfläche. Die von ihnen angelegte Zahlart wird nun angezeigt und Sie können für jede Dokumentart nun die passenden Textbausteine festlegen.
 
 
.
 
===Bearbeitung und Anpassen eines Zahlart-Moduls===
 
 
Bereits vorhandene Zahlarten können aktiviert oder deaktiviert werden. Wird eine Zahlart in der ZA-Textbaustein-Verwaltung deaktiviert, so werden bei Zahlung mittels dieser Zahlungsweise keine spezifischen Textbausteine verwendet. Es gelten die Textbaustein-Einstellungen aus den Parametern der Registerkarte '''Dokumenterstellung'''. Sind diese leer werden die Standardtexte verwendet.
 
 
Je Zahlart können für die Dokumentarten '''Auftragsbestätigung''', '''Lieferschein''', '''Rechnung''' und '''Proforma-Rechnung''' je ein Textbaustein oberhalb der Position als auch ein Textbaustein unterhalb der Positionen ausgewählt werden.
 
 
Jedes Zahlart-Modul kann auf der Registerkarte "Einstellungen" noch weiter individualisiert werden. Hier kann die Zahlart selbst definiert werden, Kommentare hinterlegt werden und auch angegeben werden, ob zum Lieferdatum eine bestimmte Anzahl an Tage hinzuaddiert werden Aufgrund der Bearbeitungszeit.
 
 
.
 
==Magento 2 Spezifische Shopeinstellungen==
 
 
Einstellungen die speziell das Shopsystem Magento 2 betreffen und Auswirkungen auf den Bestell- und Artikelabruf haben finden sich in der Registerkarte "Magento 2" wieder.
 
Hier drin sind die jeweiligen Einstellungen nochmals in verschiedene Registerkarten unterteilt.
 
 
.
 
===Registerkarte "API-Zugriff"===
 
 
Auf der Registerkarte „API-Zugriff“ ist es möglich, den Zugang zu einem oder mehreren Magento 2 Shops einzurichten oder zu verwalten. Die auf dieser Registerkarte hinterlegten Zugänge werden lokal auf jedem Arbeitsplatz separat hinterlegt und angelegt. Dadurch ist eine Differenzierung innerhalb der Arbeitsplätze bei Verwendung von mehr wie einem Shop möglich. Wenn mehrere Arbeitsplätze denselben Zugriff zu einem Shop eingerichtet bekommen soll, ist darauf zu achten, dass die '''Bezeichnung''' des Profils auf jedem Arbeitsplatz in der Schreibweise identisch ist um Fehler und Duplikate zu vermeiden.
 
 
<box type="tipp">
 
'''Sicherung sowie Import/Export von Einstellungen und Profilen'''
 
 
Eingerichtete Shop-Profile und dessen Einstellungen finden sich im Unterverzeichnis '''\Plugins\Webshop\Settings''' jeder Faktura-XP Installation wieder. Wurde auf einem Arbeitsplatz die Schnittstelle zum Onlineshop eingerichtet, so kann der Inhalt dieses Ordners auf einen weiteren Arbeitsplatz kopiert werden. Dadurch werden sämtliche Einstellungen sowie das Profil übertragen und Fehlkonfigurationen können vermieden werden.
 
 
</box>
 
 
 
 
.
 
 
===Registerkarte "Übertragungseinstellungen"===
 
 
Auf der Registerkarte „Übertragungseinstellungen“ können Sie das Verhalten des Artikel- bzw. Bestellabrufs mit speziellen Optionen beeinflussen. Diese Einstellungen sollten nur von Erfahrenen Benutzern verwendet werden da sich diese bei falscher Verwendung auch Negativ auswirken können.
 
 
 
Für die Magento® 2-Schnittstelle existieren folgende Optionen:
 
 
'''Artikelbilder automatisch herunterladen'''
 
 
Ist der Pfad der Bilder via HTTP verfügbar, so werden Artikelbilder beim Artikelabruf in dem hier angegebenen Verzeichnis abgelegt und dem Artikel verknüpft.
 
 
 
 
.
 
===Registerkarte "Abrufeinstellungen"===
 
 
In den „Abrufeinstellungen“ wird festgelegt, ab welcher Artikel- bzw. Bestellnummer der jeweilige Abruf passieren soll. Hierbei können Einstellungen wie „Von – Bis“ hinterlegt und somit der Abruf der Daten verkleinert werden. Wird der Haken „Autom. fortfahren“ hinter den Werten gesetzt, wird der Wert im „Bis“-Feld entfernt und es wird „Ab“ der angegebenen Nummer / Datumsangabe ein Abruf getätigt.
 
Ein kleinerer "Bis"- als "Ab"-Wert oder "0" im "Bis"-Wert führt dazu, dass bis zur letzten vorhandenen Bestellung / zum letzten vorhandenen Artikel abgerufen wird.
 
 
 
<box type="tipp">
 
'''Zwischenabrufe und Zurückstellen'''
 
 
Standardmäßig ruft eine neueingerichtete Shopschnittstelle ab der ersten Bestellung / dem ersten Artikel ab. Es ist daher Sinnvoll, die "Ab"- und "Bis"-Werte entweder vor zugeben oder in mehreren Schritten (z.B. hunderter Schritte "Ab 0 bis 100, ab 100 bis 200 usw.) Bestellungen oder Artikel abzurufen. Dadurch können Probleme in den Einstellungen schneller lokalisiert und behoben werden und es kommt seltener bis gar kein Verbindungsabbruch zum Shop vor. Jeder Shop kann nur eine bestimmte Menge an Ergebnisse liefern. Ist die Menge der Ergebnisse zu groß kann ein Abbruch seitens des Servers ausgelöst werden. Durch die gezielte Angabe von "Ab"- und "Bis" lassen sich Abrufe dennoch durchführen.
 
 
Wenn ältere Bestellungen oder Artikel nochmals abgerufen werden sollen (z.B. nachdem der Lieferschein oder der Artikel entfernt wurde) kann durch eine Anpassung der "Ab"- und "Bis"-Werte dieser Vorgang wiederholt werden.
 
Stellen Sie Abschließend der "Ab"-Wert auf den maximal Wert (durch händische Eingabe soweit bekannt) und den "Bis"-Wert auf 0 um beim nächsten Abruf fortfahren zu können.
 
 
</box>
 
 
.
 
===Registerkarte "Erweiterungsfunktionen"===
 
 
Die Registerkarte "Erweiterungsfunktionen" beinhaltet eine Reihe an Hilfsmittel, welche die Wartung, Aktualisierung und Pflege von Daten die mit dem Shop in Verbindung stehen vereinfacht.
 
 
 
'''Verknüpfungen'''
 
 
Unter Verknüpfungen kann man Artikel, welche Händisch angelegt wurden mit dem aktiven Shopprofil verknüpfen. Hierbei wird der Shop kontaktiert und es wird je nach Auswahl nach der internen Products-ID oder der SKU gesucht. Wird ein Artikel hierzu gefunden, werden die notwendigen Informationen (SKU bei Auswahl „Artikel über ID verknüpfen, products_id bei Auswahl „Artikel über SKU verknüpfen“) sowie die Shopprofil-Kennung (Die selbstgewählte Bezeichnung des Profils) und der Shoptyp "MAG" dem Artikel hinterlegt. Auch ist es möglich händisch angelegte Kunden zu verknüpfen, hier werden Kunden deren Emailadresse im Shop vorhanden sind, bei einem Treffer die Shopprofil-Kennung (Die selbstgewählte Bezeichnung des Profils), die Shop-KundenID (sofern vorhanden) und der Shoptyp "GX3" hinterlegt.
 
 
<box type="tipp">
 
'''Wechsel von Magento 1.x auf Magento 2.x'''
 
 
Sollten Sie vor der Nutzung von Magento 2 einen Magento 1 Shop in dem aktuell verwendeten Mandanten genutzt haben so kann - sofern die Stammdaten der Datenbank des Magento 1 unverändert in Magento 2 übernommen wurden sofort weiter in der Magento 2-Schnittstelle verwendet werden. Durch die Verknüpfung wird lediglich die Shop-Profilkennung zusätzlich in die Artikel übernommen, sofern die products_id und sku mit denen des Magento 2-Shops übereinstimmen. Ist eine Abweichung vorhanden, z.B. die products_id im Artikelstamm entspricht nicht der products_id im Shop wird der betroffene Artikel nicht "konvertiert".
 
</box>
 
 
 
 
.
 
 
=Magento 2 Schnittstelle anwenden=
 
 
 
==Vorbereitungen==
 
 
Damit ein Bestell- oder Artikelabruf durchgeführt werden kann, muss die Verbindung zum Magento® 2 Shop zunächst eingerichtet werden. Eine Anleitung hierzu finden Sie unter [[Magento2-Schnittstelle#https://handbuch.faktura-xp.de/index.php?title=Magento2-Schnittstelle&action=submit#Vorbereitungen_f.C3.BCr_den_Zugriff_auf_Ihren_Magento_2-Shop|Magento® 2 einrichten]]
 
 
==Bestellabruf==
 
 
Unter einem '''Bestellabruf''' versteht sich, Vorgänge welche im Shop ausgelöst wurden (ein Kunde hat etwas bestellt) weiter zu verarbeiten. Die Grundsätzliche Auslegung des Angebots (ihr Shop) und der Auftragsbestätigung (Warenkorb bestätigen) ist zu diesem Zeitpunkt bereits seitens ihres Shops getätigt. Der Bestellabruf-Prozess ruft die im Onlineshop vorhandenen Bestellungen Listenweise auf und übertragt diese, je nach Filterung (Ab einer bestimmten Bestellnummer, nur Bestellungen mit bestimmten Status) zur Verarbeitung aus dem Internet in das laufende Faktura-XP System. Von dort aus werden die für die Erstellung des nächsten Schrittes (Lieferschein erstellen) notwendigen Schritte eingeleitet:
 
 
- Existiert für diese Bestellung bereits ein Lieferschein?
 
- Welcher Kunde hat bestellt?
 
  - gibt es den Kunden bereits im Kunden-Stamm?
 
  - An wen geht die Lieferung?
 
- Welche Positionen beinhaltet die Bestellung?
 
 
Aus diesen gesammelten Daten entsteht der Lieferschein, das erste Dokument aus einem Bestellabruf. Aus diesem kann optional eine "Auftragsbestätigung (AB)", durch Erweiterungen wie der [https://www.faktura-xp.de/shop/erweiterungen/zusatzmodule/projektverwaltung Projektverwaltung] auch ein umspannender Container, welcher alle Dokumente dieser Bestellung auf einem Blick zusammenfasst angelegt werden oder gleich aus dem Lieferschein bereits eine Rechnung oder eine Proforma-Rechnung erstellt werden.
 
 
.
 
===Bestellabruf manuell starten===
 
 
Um einen Bestellabruf zu starten, muss die Shopschnittstelle zunächst aufgerufen werden. Klicken Sie hierzu in der Navigation auf "Verkauf > Onlinehandel > Webshop" und wählen Sie "Magento 2" aus der Liste der verfügbaren und lizensierten Shopschnittstellen aus. Sollte Magento 2 nicht in der Liste erscheinen, fehlt die dazu entsprechende [https://www.faktura-xp.de/shop/ecommerce-schnittstellen/magento-2-schnittstelle Lizensierung] oder es wird eine Lizenz-Datei verwendet, in welcher die Aktivierung der Lizenz nicht vorhanden ist welche [[Lizenzeingabe#So_gehen_Sie_nach_Erhalt_der_Lizenzdatei_vor|ausgetauscht]] werden muss.
 
 
 
Navigieren sie zu '''Verkauf -> Onlinehandel -> Webshop'''
 
 
[[Bild:00.Navigation_Verkauf_Onlinehandel.png|Web Shop Synchronisieren]]
 
 
 
 
Um den Verbindungsassistenten aufzurufen, navigieren sie zum Punkt '''Webshop'''. 
 
 
 
 
Wählen Sie anschließend aus der Liste der verfügbaren Schnittstellen die Shopschnittstelle zu '''Magento® 2''' aus in dem Sie das Dropdown-Menü anklicken (1) und anschließend den Menüpunkt '''Magento® 2''' auswählen (2).
 
 
 
Bestätigen Sie die Auswahl mit Weiter (3) um die Shopschnittstelle zu starten.
 
 
 
 
Ist die Shop-Schnittstelle zum Magento® 2 Onlineshop gestartet, befinden Sie sich auf der Hauptansicht, auf welcher die notwendigen Einstellungen zum Bestellabruf nochmals zusammengefasst angezeigt und angepasst werden können.
 
 
Auf der zum Start der Schnittstelle sichtbaren Registerkarte '''Grundeinstellungen''' beinhaltet die wichtigsten Einstellungen, welche festlegen Bestellungen abgerufen werden sollen. Diese Registerkarte ist in drei Bereiche aufgeteilt.
 
 
 
Unter dem Bereich '''Shop-Auswahl''' (4) kann ausgewählt werden, welche Unterstores ihres Magento® 2 Shops abgerufen werden sollen. Mit einem Klick auf die Taste '''Auswahl''' öffnet sich hier die Liste aller verfügbaren Stores.
 
 
Unter dem Bereich '''Einstellungen''' (5) auf der Registerkarte '''Grundeinstellungen''' wird festgelegt, welche Sprache als "Grundsprache" der Artikeltexte in Rechnungen und Lieferscheinen verwendet werden soll. Dies ist gleichzusetzen mit der Standardsprache im Shop. Sofern innerhalb des Artikels in Faktura-XP eine Sprachübersetzung vorhanden ist, wird bei Bestellungen mit abweichender Sprache die jeweilige abweichende Sprache z.B. Englisch oder Französisch verwendet.
 
 
Ebenso kann hier festgelegt werden, welche Bestellungen abgerufen werden sollen, z.B. alle Bestellungen, die den Status "in Bearbeitung" derzeit haben. Es ist möglich, mehr als einen Status gleichzeitig auszuwählen. Alle ausgewählten Status werden abgerufen. Mit Klick auf die Taste '''Auswahl''' in diesem Bereich wird die Liste aller verfügbaren Status des Shops angezeigt. Ein Klick auf die textliche Beschreibung ''Alle ... Status auflisten'' öffnet eine Dialogbox welche alle ausgewählten Status zur Kontrolle auflistet.
 
 
 
 
Im letzten Bereich (6) der Registerkarte '''Grundeinstellungen''' finden sich Einstellungen, wie mit der Bestellung umgegangen werden soll. Grundsätzlich wird eine Bestellung aus dem Shop mindestens als Lieferschein erstellt, diese Option lässt sich nicht deaktivieren. Optional kann man die Option '''Rechnungen''' aktivieren, um sofort nach Anlage des Lieferscheins daraus eine Rechnung zu generieren.
 
 
 
Beide Dokumenttypen können den Status im Shop wieder zurückmelden und bei Bedarf den Kunden benachrichtigen. Innerhalb von Faktura-XP wird die Bestellung nach Verarbeitung für einen festgelegten Status markiert, in dem man die Option '''Bestellstatus bei Lieferschein/Rechnung autom. ändern auf''' aktiviert und einen Status festlegt. Damit der Status auch im Shop zurückgemeldet wird, muss zusätzlich der Haken '''Bestellstatusänderung an den Shop übertragen''' aktiviert werden. Ist diese Option deaktiviert, wird der Status im Shop nicht aktualisiert, lässt sich aber über die Schaltfläche '''Bestellstatus aktualisieren''' innerhalb des Lieferscheins bzw. der Rechnung auf Registerkarte '''Onlineshop''' nachträglich ausführen.
 
 
Ebenso kann beim Abruf festgelegt werden, welcher Mitarbeiter die Dokumente Lieferschein / Rechnung abgerufen bzw. erstellt haben. Somit können z.B. Onlineshopabrufe über einen eigenen Mitarbeiter verarbeitet werden, welcher nicht [[Mitarbeiterauswertung#Provision_f.C3.BCr_Mitarbeiter_einrichten|als Provisionsberechtigt markiert ist]] um diese Rechnungen nicht in die Auswertungen auszuweisen.
 
 
Bei der Verarbeitung der Bestellung als Lieferschein kann optional darauf auch ein Projekt erstellt werden, sofern eine Lizenz für die Erweiterung [https://www.faktura-xp.de/shop/erweiterungen/zusatzmodule/projektverwaltung Projektverwaltung] vorhanden ist.
 
 
 
Zum Starten des Bestellabrufs genügt ein Klick auf die Schaltfläche "Bestellabruf" (7) im unteren linken Bereich des Dialogs. Bevor der Bestellabruf startet, erfolgt nach dem Klick der Schaltfläche noch die Frage, ob dieser nun gestartet werden soll oder nicht, welche mit "Ja" beantwortet werden kann, um den Vorgang fortzusetzen oder mit "Nein", um die Anforderung nochmal zu unterbrechen.
 
 
 
 
Der Bestellabruf läuft ab dort vollautomatisch, Statuseinblendungen zeigen den aktuellen Stand sowie eine ungefähre Restzeit an. Ist der Bestellabruf fertig ertönt ein akustisches Signal und im Abrufprotokoll wird vermerkt, wie viel Zeit der Abruf beansprucht hat.
 
 
.
 
 
===Bestellabruf automatisieren===
 
 
Die in Faktura-XP verfügbare Magento® 2 Schnittstelle bietet die Möglichkeit, den Bestellabruf automatisch durchführen zu lassen. Dadurch ist es möglich, den Bestellabruf ohne Interaktion in Intervallen zu tätigen, während Sie Faktura-XP normal weiterverwenden können.
 
 
<box type="hinweis">
 
'''Hinweise zum automatischen Bestellabruf'''
 
 
Bitte beachten Sie zum automatischen Bestellabruf folgendes:
 
 
 
* Nach dem Start von Faktura-XP muss die Shopschnittstelle zu Magento® 2 zunächst manuell gestartet werden. Tätigen Sie die in diesem Abschnitt beschriebenen Schritte um den automatischen Bestellabruf zu starten
 
 
* Die Shopschnittstelle zu Magento® 2 wird während des automatischen Bestellabrufs in der Taskleiste minimiert. Wird die Shopschnittstelle zu Magento® 2 über das Symbol in der Taskleiste und ausführen der Option '''"in den Vordergrund"''' des Symbol-Kontextmenüs wiederhergestellt, ist der automatische Bestellabruf beendet und muss erneut wie in diesem Abschnitt beschrieben gestartet werden.
 
 
* Der automatische Bestellabruf ruft alle Bestellungen nach den eingestellten Optionen und Parametern ab und überträgt, wenn eingeschaltet, nach dem Abruf die Lagerbestände zurück an den Shop melden und dann die Zeit warten, welche in den Optionen des automatischen Bestellabrufs eingestellt ist.
 
 
* Wird Faktura-XP beendet, beendet sich auch die Shopschnittstelle zu Magento® 2.
 
 
</box>
 
 
.
 
 
 
Navigieren sie zu '''Verkauf -> Onlinehandel -> Webshop'''
 
 
[[Bild:00.Navigation_Verkauf_Onlinehandel.png|Web Shop Synchronisieren]]
 
 
 
 
Um den Verbindungsassistenten aufzurufen, navigieren sie zum Punkt '''Webshop'''. 
 
 
 
 
Wählen Sie anschließend aus der Liste der verfügbaren Schnittstellen die Shopschnittstelle zu '''Magento® 2''' aus in dem Sie das Dropdown-Menü anklicken (1) und anschließend den Menüpunkt '''Magento® 2''' auswählen (2).
 
 
 
Bestätigen Sie die Auswahl mit Weiter (3) um die Shopschnittstelle zu starten.
 
 
 
.
 
 
 
 
Ist die Shopschnittstelle zu Magento® 2 gestartet, befinden Sie sich auf der Registerkarte '''Grundeinstellungen'''. Wechseln Sie zunächst auf die Registerkarte '''"Benachrichtigungen"''' (1). Hier können Sie einstellen, ob Sie bei Eingang neuer Bestellungen über die Windows-Benachrichtigungsanzeige eine Information bekommen möchten oder nicht. Um den automatischen Bestellabruf starten zu können, muss zunächst die Option '''"Benachrichtigen, wenn neue Bestellungen im Shop vorhanden sind"''' (2) aktiviert werden.
 
 
Ist diese Option aktiviert, können weitere Einstellungen getätigt werden. Die Einstellung '''"Alle x Minuten auf neue Bestellungen prüfen"''' bewirkt, wenn der automatische Bestellabruf deaktiviert ist, dass alle x-Minuten im Shop geprüft wird, ob neue Bestellungen vorhanden sind.
 
 
Im Fall des automatischen Bestellabrufs hat dieser eingestellte Optionswert eine andere Bedeutung: Der eingestellte Optionswert bei '''"Alle x Minuten auf neue Bestellungen prüfen"''' ist die Zeit, die zwischen einem erfolgten Bestellabruf und dem nächsten Bestellabruf gewartet wird.
 
 
Aktivieren Sie die Option '''"Automatischer Bestellabruf aktivieren"''' (4) und es folgt eine Benachrichtigungsmitteilung.
 
 
 
Mit einem Klick auf '''Ja''' (5) wird die Shopschnittstelle zu Magento® 2 in die Taskleiste minimiert und kann dort nur über das Einkaufswagen-Symbol (Tray-Icon) wiederhergestellt oder beendet werden.
 
 
 
 
Um die Shopschnittstelle wieder in den Vordergrund zu holen oder zu beenden, wenn der automatische Bestellabruf aktiviert ist, klicken Sie in der Taskleiste auf das Einkaufswagen-Symbol (Tray-Icon) (6) mit der rechten Maustaste und klicken Sie auf den Menüpunkt '''In den Vordergrund''' (7). Die Shopschnittstelle öffnet sich und wechselt auf die Registerkarte '''Grundeinstellungen''', der automatische Bestellabruf ist somit beendet.
 
 
 
 
.
 
 
===Bestellungen erneut abrufen===
 
 
Möchten Sie nur bestimmte Bestellungen (von einer Bestellnummer, bis zu einer Bestellnummer), bis zu einer gewissen Bestellnummer oder bereits abgerufene Bestellungen noch einmal abrufen können Sie dies über die Parameter der Shopschnittstelle individuell festlegen und einstellen.
 
 
 
 
<box type="hinweis">
 
'''Wichtige Hinweise beim erneuten Abrufen von Bestellungen'''
 
 
Damit Bestellungen noch einmal abgerufen werden können, müssen die folgenden Grundvoraussetzungen erfüllt sein:
 
 
 
* Zu jeder Bestellung, die erneut abgerufen werden soll, darf maximal der dazugehörige Lieferschein als Dokument in Faktura-XP vorhanden sein. Wurde der Lieferschein bereits in eine Rechnung oder eine Proforma-Rechnung umgewandelt, kann der Lieferschein nicht mehr gelöscht werden und die Bestellung wird als bereits verarbeitet übersprungen.
 
 
* Der Lieferschein muss vor dem Bestellabruf gelöscht werden, damit beim Bestellabruf die Bestellung nicht als bereits verarbeitet übersprungen wird.
 
 
* Wurde im Shop der Status beim Bestellabruf verändert, muss der in der Bestellung hinterlegte Status unter dem Bereich '''Einstellungen''' der Registerkarte '''Grundeinstellungen''' zuvor ausgewählt sein. Andernfalls wird die Bestellung während des Abrufs aussortiert und nicht erneut angelegt.
 
 
</box>
 
 
Gehen Sie hierzu wie folgt vor:
 
 
Navigieren sie zu '''Verkauf -> Onlinehandel -> Webshop'''
 
 
[[Bild:00.Navigation_Verkauf_Onlinehandel.png|Web Shop Synchronisieren]]
 
 
 
 
Um den Verbindungsassistenten aufzurufen, navigieren sie zum Punkt '''Webshop'''. 
 
 
 
Wählen Sie anschließend aus der Liste der verfügbaren Schnittstellen die Shopschnittstelle zu '''Magento® 2''' aus in dem Sie das Dropdown-Menü anklicken (1) und anschließend den Menüpunkt '''Magento® 2''' auswählen (2).
 
 
 
Bestätigen Sie die Auswahl mit Weiter (3) um die Shopschnittstelle zu starten.
 
.
 
 
 
Klicken Sie zunächst auf die Schaltfläche '''Parameter''' (1) um die Einstellungen zu öffnen.
 
 
 
 
Wechseln Sie auf die Registerkarte '''Magento 2''' (2) und dort auf die Unter-Registerkarte '''Abrufeinstellungen''' (3) um die Abrufgrenzen einzustellen.
 
Im Feld '''"Ab"''' (4) tragen Sie die Bestellnummer ein, ab welcher Sie den Bestellabruf beginnen möchten. Im Feld '''"Bis"''' tragen Sie ein, bis zur welcher Bestellung der Bestellabruf durchgeführt werden soll. Mit einem Klick auf die Schaltfläche '''Online-Check''' (5) wird im Shop geprüft, welche Bestellnummer aktuell die höchste verfügbare ist, unabhängig vom Status der Bestellung. Wird die Option '''"Autom. fortfahren"''' aktiviert wird der '''"Bis"'''-Wert automatisch auf 0 gestellt, bedeutet, dass bis zur höchsten verfügbaren Bestellung abgerufen wird.
 
 
Sind alle Einstellungen getätigt worden, klicken Sie auf die Schaltfläche '''Übernehmen''' (6) um die Einstellungen zu speichern. Der Parameter-Dialog schließt sich automatisch und Sie befinden sich wieder im Hauptmenü auf der Registerkarte '''Grundeinstellungen'''.
 
 
 
 
Um den soeben eingestellten Bestellabruf zu starten, genügt nun ein Klick auf die Schaltfläche '''Bestellabruf''' (7) und die Bestätigung, dass der Bestellabruf durchgeführt werden soll.
 
 
===Lagerbestandabgleich beim Bestellabruf===
 
 
Der Lagerbestandsabgleich beim Bestellabruf geschieht immer nach einem erfolgtem Bestellabruf. Der Lagerabgleich geschieht auch dann, wenn keine neuen Bestellungen zum Abruf vorhanden sind. Sind alle Bestellungen aus dem verbundenen Magento® 2 Onlineshop abgerufen, werden alle Artikel, welche diesem Shopprofil zugeordnet sind (mittels Artikelabruf in Faktura-XP® Warenwirtschaft angelegt) ermittelt, dessen Lagerbestände sich seit dem vorherigen Bestellabruf geändert haben. Der Zeitpunkt des Bestellabrufs wird nach Durchführung gespeichert.
 
 
 
<box type="hinweis">
 
'''Ablauf der Lagerbestandsaktualisierung'''
 
 
Bestellungen werden zunächst aus dem Onlineshop abgerufen und die darin befindlichen Lagermengen werden in den zugehörigen Artikeln seitens der Faktura-XP® Warenwirtschaft abgezogen. Verkäufe innerhalb des Onlineshops haben den Lagerbestand im Shop bereits nach Auslösung verringert, Faktura-XP® Warenwirtschaft kennt diese Änderungen aber erst, wenn die dazugehörigen Dokumente im System angelegt wurden. Faktura-XP® Warenwirtschaft kennt aber Lagerzugänge durch [[Artikelzugänge#Zugang_Einzelartikel|Anlieferung Ware]] oder durch [[Artikelzugänge#Zugang_Bestellung|Bestellungen]], sowie [[Lagerwesen#Artikel-.2F_Lagerentnahme|Lagerentnahmen]], Änderungen direkt im [[Artikelstamm#Register_-_.22Artikeldaten.22|Artikel (händisch)]] oder durch Abverkäufe durch das Kassensystem [[POS-Kasse|Faktura.Cash®]] welche der Onlineshop nicht kennt. Durch Verarbeitung in der von Faktura-XP® verwendeten Reihenfolge ist gewährleistet, dass alle Änderungen korrekt hintereinander verarbeitet werden und der korrekte Lagerbestand zurück an den Shop gemeldet werden kann.
 
 
</box>
 
 
 
In Grundeinstellung ist der Abgleich zum Onlineshop zunächst deaktiviert. Um diesen zu aktivieren, gehen Sie wie folgt vor:
 
 
 
Nach dem Sie die Shopschnittstelle gestartet haben, klicken Sie auf die Schaltfläche '''"Parameter"''' (1) um die Parameter-Einstellungen der Shopschnittstelle anzupassen.
 
 
 
Klicken Sie hier auf die Registerkarte '''Lagereinstellungen''' (1), um das Verhalten der Lagerbuchung einzustellen.
 
 
.
 
 
'''Lagerbuchung'''
 
 
Im Bereich '''Lagerbuchung''' können Sie mittels Aktivieren der Option '''Lagerbestand an Shop zurückmelden''' (2) die Übertragung der in Faktura-XP® Warenwirtschaft verfügbaren Lagerbestände zurück an den Shop aktivieren. Die Übertragung geschieht immer nach einem erfolgten Bestellabruf, ein Bestellabruf auslösen ist also Pflicht, um die Lagerbestände an den Shop zurückmelden zu können.
 
 
 
.
 
 
'''Eindeutige Kennung für Lagerbuchung bei Shopabruf'''
 
 
Im Bereich '''Eindeutige Kennung für Lagerbuchung bei Shopabruf''' (3) kann eingestellt werden, ob Bestellungen, die abgerufen werden, den Lagerbestand in Faktura-XP abziehen sollen und wo die Verbindung zwischen dem im Shop verwendeten Artikel und dem Artikel der Faktura-XP® Warenwirtschaft zu finden ist. Stellen Sie z.B. '''Faktura-XP Artikelnummer''' als Option ein, so wird die Artikelnummer des Shopartikels in der Artikelnummer von Faktura-XP erwartet. Wird diese dort gefunden, wird der Artikel um die in der Bestellung angegeben Menge abgezogen. Bei '''Stock-Keeping-Unit (SKU) / Hersteller-Artikelnummer (Shop-Artikelnummer)''' wird die Artikelnummer des Shops im Feld '''SKU''' des Artikels erwartet. Dies ist in der Regel auch die Standardeinstellung und sollte, wenn nicht abweichend verwendet werden. Sonderfälle wie '''EAN / Barcode''' oder '''PharmaZentralNummer (PZN)''' als eindeutige Kennung können ebenfalls angegeben werden, hierbei muss aber darauf geachtet werden, dass der EAN / Barcode bzw. die PZN nur einmal im Artikelstamm der Faktura-XP® Warenwirtschaft geführt werden sollte da sonst die Buchung des Artikels fehlschlagen wird - der Artikel kann nicht eindeutig erkannt werden.
 
 
 
.
 
 
==Artikelabruf==
 
 
Damit Faktura-XP® Warenwirtschaft die Lagerbestände aus Shopbestellungen korrekt verwerten und verarbeiten kann, müssen Artikel, welche im Shop angelegt wurden zunächst in den Artikel-Stamm des Mandanten übernommen werden. Gehen sie dazu wie folgt vor:
 
 
Navigieren sie zu '''Verkauf -> Onlinehandel -> Webshop'''
 
 
[[Bild:00.Navigation_Verkauf_Onlinehandel.png|Web Shop Synchronisieren]]
 
 
 
 
Um den Verbindungsassistenten aufzurufen, navigieren sie zum Punkt '''Webshop'''. 
 
 
 
Wählen Sie anschließend aus der Liste der verfügbaren Schnittstellen die Shopschnittstelle zu '''Magento® 2''' aus in dem Sie das Dropdown-Menü anklicken (1) und anschließend den Menüpunkt '''Magento® 2''' auswählen (2).
 
 
Bestätigen Sie die Auswahl mit Weiter (3) um die Shopschnittstelle zu starten.
 
 
 
.
 
 
 
Klicken Sie zunächst auf die Schaltfläche '''"Parameter"''' (1) um die Parameter-Einstellungen der Shopschnittstelle anzupassen.
 
 
 
 
Navigieren Sie hier auf den Register '''"Shopeinstellungen"''' (1) um das Verhalten der Preisermittlung der Shopartikel anzupassen. In der Regel werden diese Einstellungen bereits korrekt beim Start der Shopschnittstelle aus dem Shop ausgelesen. In seltenen Fällen muss aber hier sowohl für VK-Artikelpreise im Bereich '''Artikelpreise in VK übertragen''' (2) sowie für EK-Preise im Bereich '''Artikelpreise in EK übertragen''' (3) den Bedürfnissen des Shops entsprechend angepasst werden. Hierbei gilt:
 
 
 
{| class="wikitable"
 
|-
 
| '''Einstellung''' || '''Beschreibung'''
 
|-
 
| 1:1 Übernehmen || der im Shop über die API des Onlineshops übertragende Preis wird 1:1 ohne Anpassungen übernommen
 
|-
 
| MwSt zuschlagen || der im Shop über die API des Onlineshops übertragende Preis ist fehlinterpretiert und es wurde doppelt die MwSt abgezogen. Beim Artikelabruf wird der MwSt-Satz einmalig aufgeschlagen, um einen korrekten Netto-Betrag zu erhalten.
 
|-
 
| MwSt abziehen || Der im Shop über die API des Onlineshops übertragende Preis ist Brutto hinterlegt (obwohl dieser in der API als Netto hinterlegt seien sollte). Beim Artikelabruf wird der MwSt-Satz abgezogen, um einen korrekten Netto-Betrag zu erhalten.
 
|}
 
 
Die Einstellungen '''MwSt zuschlagen''' sowie '''MwSt abziehen''' sind Sonderfälle bedingt Anpassungen im Shop und kommen im seltensten Fall vor, existieren aber, damit die Shopschnittstelle Sonderfälle und modifizierte Shops korrekt verarbeiten und interpretieren kann. Der Fall '''1:1 Übernehmen''' ist in 99,9% der Fälle korrekt und sollte auch voreingestellt sein. Überprüfen Sie unbedingt die Einstellungen, ob diese für ihre Bedürfnisse korrekt hinterlegt sind.
 
 
 
.
 
 
 
Wechseln Sie anschließend auf die Registerkarte '''Übertragungseinstellungen''' (1) und stellen Sie hier ein, wie Artikel des Shops bei Übertragung in Faktura-XP dargestellt werden sollen.
 
 
.
 
 
'''Einstellungen der Artikelbeschreibung'''
 
 
Im Bereich '''Artikelübertragung''' können Sie im oberen Abschnitt einstellen, welche textlichen Inhalte in der Artikelbeschreibung übernommen werden sollen (2):
 
 
{| class="wikitable"
 
|-
 
| '''Einstellung''' || '''Beschreibung'''
 
|-
 
| Herstellername in Artikeltext setzen || der Name des Herstellers wird in der Artikelbeschreibung mit übernommen
 
|-
 
| Herstellername vor Artikeltext setzen || ist diese Option aktiviert beginnt die Artikelbeschreibung mit dem Herstellernamen, andernfalls wird der Name des Herstellers hinter der Artikelbeschreibung hinterlegt
 
|-
 
| Shop-ArtikelID dem Artikeltext hinzufügen || ist diese Option aktiviert steht die Artikelnummer des Shopartikels in der Artikelbeschreibung
 
|-
 
| Artikelname statt Artikelkurzbeschreibung übertragen || ist diese Option aktiviert wird der Artikelname als Artikelbeschreibung verwendet, andernfalls wird die Kurzbeschreibung des Artikels als Artikelbeschreibung übernommen
 
|}
 
 
.
 
 
'''Verhalten innerhalb Faktura-XP®'''
 
 
in den nächsten Einstellungen im Bereich '''Artikelübertragung''' kann das Verhalten innerhalb Faktura-XP eingestellt werden (3):
 
 
{| class="wikitable"
 
|-
 
| '''Einstellung''' || '''Beschreibung'''
 
|-
 
| Lagerbestand in Faktura-XP mitführen || ist diese Option aktiviert werden alle Artikel als '''Lagerfähig''' markiert und der aktuell vorhandene Lagerbestand welcher sich im Shop befindet wird in Faktura-XP übertragen. Hinweis: Bevor Sie neue Artikel in Faktura-XP übernehmen, übertragen Sie alle noch nicht abgeholten Bestellungen ab, andernfalls kann es passieren dass Artikel beim Artikelabruf mit dem bereits abgezogenen Lagerbestand übertragen werden und durch Bestellabruf die Lagermenge noch einmal abgezogen wird.
 
|-
 
| Shopartikelnummern in Faktura-XP verwenden (Shop-SKU als Artikel-ID) || ist diese Option aktiviert wird statt der fortlaufenden Artikelnummer aus Faktura-XP die Shopartikelnummer des Shopartikels auch als Faktura-XP Artikel-ID verwendet. Diese Option wird automatisch ausser Kraft gesetzt, wenn es doppler gibt oder die Artikel-ID bereits verwendet wird, nicht jedoch aus diesem Shopprofil stammt (Händisch angelegt oder aus einem anderen Shopsystem oder Shopprofil bereits angelegt)
 
|}
 
 
.
 
 
'''Formatierung und Sachkontenzuordnunginnerhalb Faktura-XP®'''
 
 
die nächsten Einstellungen im Bereich '''Artikelübertragung''' bestimmen die Formatierungen und Zuordnung zur Weiterverarbeitung innerhalb Faktura-XP (4):
 
 
{| class="wikitable"
 
|-
 
| '''Einstellung''' || '''Beschreibung'''
 
|-
 
| HTML-Notation von Sonderzeichen wandeln || ist diese Option aktiviert werden alle HTML-Tags entfernt, es bleibt ein sogenannter '''Plain-Text'''. Unformatiert. Gilt nur wenn Artikelkurzbeschreibung als verwendet wird. Ist die Option Artikelname verwenden aktiviert wird diese Option weitesgehend ignoriert da im Artikelname keine HTML-Tags möglich sind.
 
|-
 
| Trennzeichen in erzeugter Artikel-Nr || Diese Option gilt für Shopversionen bis Gambio GX4 4.4.x.x und definiert wird der Varianten-Teil der SKU vom Hauptartikel-Teil der SKU getrennt ist. Wird kein Symbol hinterlegt, wird das Standardsymbol "Bindestrich" verwendet
 
|-
 
| Standard Artikeleinheit || Diese Option gibt an welche Artikeleinheit ein Artikel bekommen soll, sollte die Einheit nicht ausgelesen werden können (Varianten / Optionen bis Gambio GX4 4.4.x.x) oder keine Artikeleinheit eingstellt wurde (Shopstandard ausgewählt) - der dort eingegeben Text wird als Artikeleinheit verwendet.
 
|-
 
| Standarderlösart || Diese Option gibt an welches Erlöskonto den Artikeln zugeordnet werden soll. Es ist derzeit nicht möglich für jede Steuerklasse und/oder Landesdefinition ein Erlöskonto festzulegen.
 
|-
 
| '''Eigenschaften / Varianten / Attribute als eigene Artikel anlegen''' || Ist diese Option aktiviert werden Varianten aus dem Shop abgerufen und als Artikel angelegt. Ist diese Option deaktiviert wird nur der Hauptartikel angelegt, keine Varianten. Kann nachträglich aktiviert werden und mittels Artikel erneut abrufen nachträglich abgerufen werden.
 
|}
 
 
.
 
 
'''Artikelverhalten in Faktura-XP®'''
 
 
die letzten Einstellungen auf der Registerkarte '''Übertragungseinstellungen''' welche den Artikelabruf beeinflussen bestimmen wie mit deaktivierten Artikeln umgegangen werden soll und wie man nach Artikeln innerhalb Faktura-XP suchen kann (5):
 
 
{| class="wikitable"
 
|-
 
| '''Einstellung''' || '''Beschreibung'''
 
|-
 
| Shopartikelnummern in Faktura-XP verwenden (bei Positionsauswahl in Dokumenten) || ist diese Option aktiviert muss beim Hinzufügen einer Position in einem Dokument (z.B. Angebot, Lieferschein oder Rechnung) die Artikelnummer aus dem Shop eingegeben werden um die Position hinzuzufügen. Dier interne Faktura-XP Artikelnummer wird dann hierzu nicht verwendet. Diese Option hat keinen Einfluss auf den Ausdruck, ob die Faktura-XP Artikelnummer gedruckt wird oder die Artikelnummer des Shops (SKU).
 
|-
 
| Inaktive Artikel bei Übertragung berücksichtigen || Ist diese Option aktiviert werden auch im Shop deaktivierte Artikel (inaktive Artikel) in Faktura-XP mit übertragen, diese sind dann ebenfalls als Inaktiv markiert und in der Liste der Artikel nur dann sichtbar, wenn bei der Suche innerhalb der Artikelliste die Option "auch inaktive anzeigen" aktiviert ist.
 
|}
 
 
.
 
 
 
 
 
Zum Abschluss wechseln Sie auf die Registerkarte '''"Magento 2"''' (1) und dort auf die Registerkarte '''Abrufeinstellungen''' (2).
 
 
Im Bereich '''Artikel-ID''' (3) können Sie festlegen, ab welcher Artikelnummer Sie ihre Shopartikel abrufen möchten und bis zu welcher Shopartikelnummer. Tragen Sie bei '''Bis''' 0 ein oder aktivieren Sie die Option '''autom. fortsetzen''' wird bis zu höchsten verfügbaren Artikelnummer der Artikelabruf durchgeführt. Mit Klick auf die Schaltfläche '''Online-Check''' kann geprüft werden wie derzeit die höchste Artikelnummer im Shop lautet.
 
 
Klicken Sie auf '''Übernehmen''' (4) wenn Sie eine Anpassung auf dieser Registerkarte getätigt haben sollten (z.B. die '''Ab''' oder '''Bis''' Artikel-ID verändert) oder auf die Schaltfläche '''EXIT''' (5) um alle getätigten Einstellungen zu übernehmen und die Parameter zu schließen.
 
 
.
 
 
Klicken Sie nun auf die Schaltfläche '''"Artikelabruf"''' (1), um den Artikelabruf mit den zuvor getätigten Einstellungen zu starten.
 
 
 
.
 
 
==Artikelaktualisierung==
 
 
 
 
.
 
 
<h3>Diese Seite ist noch in Arbeit.</h3>
 
 
[[Datei:Baustelle 640.png|180px|link=mailto:support@faktura-xp.de|Klicken sie hier um uns eine Frage per Email zu stellen.]]
 
  
 +
====Magento® 2 Schnittstelle anwenden====
  
Wir geben Ihnen dennoch gern Auskunft zu diesem Menüpunkt. Nehmen sie dazu direkt [https://www.faktura-xp.de/kontakt.html Kontakt] zu uns auf oder senden sie uns eine [mailto:support@faktura-xp.de Email].
+
[[Magento2-Schnittstelle_anwenden|Magento® 2 Schnittstelle anwenden]]
  
  
 
.
 
.

Version vom 5. Mai 2022, 14:55 Uhr

Magento® 2 Onlineshopsystem

Magento 2

Nutzen Sie die Möglichkeiten ihres Magento® 2 Onlineshopsystems mit Faktura-XP® Warenwirtschaft optimal aus. Das durch die Firma Adobe und der eifrigen Community stetig weiterentwickelte beliebte Shopsystem Magento® bekommt in Version 2 eine Verjüngungskur der Extravaganz. An moderne System und aktuelle Bedürfnisse angepasst lässt dieses Shopsystem kaum Wünsche offen. Magento® 2 baut ebenso wie sein Vorgänger auf das API-First-Prinzip auf, was es Faktura-XP® Warenwirtschaft ermöglicht nahtlos mit dem Onlineshop zu kommunizieren und kompatibel zu sein.


.

Magento® 2 Schnittstelle einrichten

Magento® 2 Schnittstelle einrichten


.

Magento® 2 Schnittstelle anwenden

Magento® 2 Schnittstelle anwenden


.