Shopify Schnittstelle

Die Shopify Schnittstelle ermöglicht es, einen Shopify Webshop mit dem TaskCenter zu synchronisieren.

Inhalt

Schnittstellen-Features

• Lagerstandsabgleich vom mx.ERP zu Shopify
• Bestellungsimport von Shopify in das mx.ERP
• Kundenimport von Shopify zum mx.ERP
• Artikelabgleich von mx.ERP zu Shopify

Konfiguration

Shopify

Als erstes muss auf der Shopify Admin Website beim Kunden eine neue App erstellt werden. Die App kann beliebig benannt werden, z.B.: “PLX-TaskCenter”. Dieser App müssen folgende Berechtigungen gegeben werden:

• read_orders
• write_inventory
• read_inventory
• read_customers
• read_products
• write_products
• read_locations.
• write_orders
• write_fulfillments
• read_fulfillments
• read_merchant_managed_fulfillment_orders
• read_assigned_fulfillment_orders
• write_merchant_managed_fulfillment_orders
• write_third_party_fulfillment_orders
• read_third_party_fulfillment_orders
• write_assigned_fulfillment_orders

Dann muss der Admin-API-Zugriffstoken generiert werden, diesen benötigen wir beim Einstellen der Schnittstelle (Achtung dieser Token kann nur einmal nach dem Generieren eingesehen werden!)

Sind diese Schritte erledigt so ist seitens Shopify alles eingestellt.

POLLEX-LC LC.WpfInterfaces

Um die Schnittstelle seitens Pollex einzurichten benötigt man das LC.WpfInterfaces ab Version 4.108.0.7 sowie das Shopify-Modul (Lizenzschlüssel).

Wenn die richtige Version beim Kunden ist und die Lizenz vergeben wurde so sollte beim starten des WPF-Interfaces wie unten im Screnshot markiert die Shopify Schaltfläche zu sehen sein:

Einstellungen

Sämtliche Einstellungen für die Shopify-Schnittstelle können übergreifend oder für jede organisatorische Einheit (OE) einzeln eingestellt werden. Möchte man die Konfiguration je OE durchführen, kann über den "+"-Butten neben der OE-Auswahl eine neue OE eingefügt werden.

Durch den Klick öffnet sich ein neues Fenster indem man die OE für welche die Schnittstelle eingerichtet werden soll auswählt.

Beschreibung der Einstellungen

Webservice-URL

Die URL über die auf den Service zugegriffen werden kann Bsp.: https://{Shopname}.myshopify.com/admin/api/2022-10/

API-Key

Der generierte API-Key der oben erwähnt wurde.

Schnittstellenrelevant

Gibt an ob Artikel über die Kombi Web-Haken im Artikelstamm + Artikelstamm OE oder über das Fenster “Webshopartikel und Preise je OE” als Schnittstellenrelevant gekennzeichnet werden

Mit erweiterten Kundendaten nach vorhanden Kunden suchen

Wenn aktiviert, wird, sollte der Kunde nicht über die ID ermittelt werden können zusätzlich über Name, Adresse und E-mail der Kunde gesucht.
Die genaue Logik hierzu ist, sowohl Vorname wie auch Nachname muss im Name1 im mx.ERP vorkommen sowie entweder die E-Mail Adresse oder Straße, PLZ und Land müssen übereinstimmen.

Beim Artikelexport Ust-Satz (für VKINKL) aus dem Mandanten nehmen

Ist dieser Schalter nicht gesetzt, so werden beim Artikelexport die Ust-Sätze aus den Grundlagen genommen, ist er gesetzt so wird mit der OE für die die Schnittstelle ausgeführt wird der Mandant ermittelt und der Ust-Satz aus den Mandanteneinstellungen genommen.

Basis für Bestandsermittlung

Gibt an ob der Bestand oder der verfügbare Bestand exportiert werden soll.

Reduktionsmenge

Gibt an um wie viel der ermittelte Bestand noch vermindert werden soll beim Bestandsimport

Preisfaktor

Standardwert 1. Mit diesem Faktor werden die VK-Preise beim Artikelexport multipliziert

Artikelnummer für Versandkosten

Gibt den Versandkostenartikel an der verwendet werden soll wenn von Shopify Versandkosten bei der Bestellung übermittelt werden.

Artikelnummer für Gutscheine

Gibt die Artikelnummer an die verwendet werden soll, wenn von Shopify die Zahlungsart Gutschein übermittelt wird bei dem Bestellimport

Auftragnsnummer als Bestellnummer verwenden

Wenn gesetzt so wird der Bestellname aus Shopify in das Feld Bestellnummer im mx.ERP übernommen, wenn nicht gesetzt dann wird die Bestellnummer aus Shopify in das Feld Bestellnummer im mx.ERP übernommen.

Fallback auf UST-Satz aus ERP

Wenn gesetzt, dann wird beim Bestellimport der Ust-Satz aus dem ERP genommen wenn Shopify keine Ust Daten übermittelt. Ist der Schalter nicht gesetzt so wird der Ust-Satz 0 für diesen Fall hergenommen. 

Sammel-Kundennummern für Aufträge je Land

Hier wird Länderkürzel vom mx:ERP und Kundennummer angegeben, diese dienen als Vorlage wenn ein neuer Kunde angelegt wird (über die OE die dem Kunden zugeordnet ist wird auch der USt-Satz gezogen!)

Sammel-Kundennummern immer verwenden

Ist diese Einstellung aktiviert so wird durch den Bestellungsimport nie ein neuer Kunden angelegt sondern immer direkt mit der Kundennummer aus Sammel-Kundennummer der Auftrag angelegt

Zahlungsmethoden Mapping

Hier kann die Zahlungsbedingung aus dem mx.ERP mit der Zahlungsmethode aus Shopify gemappt werden, damit man im TC sieht wie der Auftrag bezahlt wird.

Shopify LocationID

In Shopify gibt es Locations, eine Location ist im TC das Lager welches bei der OE als Std. Lager hinterlegt ist. Die LocaionID aus Shopify muss hier eingetragen werden damit der Lagerstandsexport funktioniert.

Mailing Einstellungen

Alle folgenden Einstellungen sind dazu da um beim Auftragsimport ein Mail pro Import an den Kunden zu senden, wenn dieser sehen möchte welche Aufträge und Kunden angelegt wurde.

Bedienung

Über die Reiter “Auftrags-Import” und “Lagerstand-Export” kann die Schnittstelle ausgeführt werden.

Vor dem ersten Lagerbestandsexport muss auf den Button “Artikelmapping aktualisieren” geklickt werden.

Automatisierung

Um die Schnittstelle automatisiert laufen zu lassen, kann man in der Windows Aufgabenplanung Tasks einrichten die dann .bat Dateien ausführen.

Beispiele für einen automatisierten Aufruf:

...\LC.WpfInterfaces_Shopify\LC.WpfInterfaces.exe DB=POLLEX USER=SYSADM PASSWORD=4711 INTERFACE=Shopify OE=10 ExecuteExportStocks=true ExportChangedStocks=true LogLevel=Full]] ></ac:plain-text-body></ac:structured-macro><p class="auto-cursor-target"><br /></p><ac:structured-macro ac:name="code" ac:schema-version="1" ac:macro-id="35e6a605-e613-44d2-96ef-c0091fb86cf2"><ac:parameter ac:name="language">powershell</ac:parameter><ac:parameter ac:name="title">Auftragsimport</ac:parameter><ac:plain-text-body><![CDATA[...\LC.WpfInterfaces_Shopify\LC.WpfInterfaces.exe DB=POLLEX USER=SYSADM PASSWORD=4711 INTERFACE=Shopify OE=10 ExecuteImportOrders=true LogLevel=Full]] ></ac:plain-text-body></ac:structured-macro><p><br /></p><p><br /></p><p><br /></p>