# Shopify - Einstellungen
Die Einstellungen zur Shopify-Schnittstelle
# Shopdaten
[](https://wiki.dako-it.com/uploads/images/gallery/2023-08/bslimage.png)
|
In diesem Bereich muss der **Name des Shops** und das **Access-Token** angeben werden.
Der **Name des Shops** entspricht dem Namen der Subdomain von myshopify.com . Bitte nur den Namen xxx eintragen.
```
https://xxx.myshopify.com
```
Um das **Access-Token** zu erhalten, muss eine eigene Admin-App innerhalb des Shopify Admin-Bereichs erstellt werden.
##### Schritt 1 - Aufruf der "Einstellungen" im Shopify Back End
[](https://wiki.dako-it.com/uploads/images/gallery/2023-08/RtWimage.png)
|
##### Schritt 2 - Aufruf des Menüpunktes "APPs und Vertriebskanäle
Wählen Sie den Punkt "Apps erstellen".
[](https://wiki.dako-it.com/uploads/images/gallery/2023-08/7qpimage.png) |
##### Schritt 3 - Benutzerdefinierte APP erstellen
[](https://wiki.dako-it.com/uploads/images/gallery/2023-04/euCimage.png) |
Vergeben Sie einen beliebigen APP- Namen.
[](https://wiki.dako-it.com/uploads/images/gallery/2023-04/2U9image.png) |
Anschließen müssen Sie den Button "App erstellen" tätigen.
##### Schritt 4 - Berechtigungen der APP setzen
Anschließen sind die Berechtigungen zu setzen. Um den vollen Funktionsumfang nutzen zu können, sollten alle Haken aktiviert werden:
[](https://wiki.dako-it.com/uploads/images/gallery/2023-04/XReimage.png) |
##### Schritt 5 - Installation der APP
Nun erfolgt die Installation der App:
[](https://wiki.dako-it.com/uploads/images/gallery/2023-04/KJmimage.png) |
##### Schritt 6 - Access-Token kopieren
Das Access-Token kann nun einmalig angezeigt werden:
[](https://wiki.dako-it.com/uploads/images/gallery/2023-04/TGhimage.png) |
# Zuordnung
[](https://wiki.dako-it.com/uploads/images/gallery/2024-03/g4Eimage.png)
|
In den Zuordnungen wird eingestellt, welche Daten und Funktionen in Shopify denen in SelectLine Warenwirtschaft entsprechen. (Mapping)
##### Belegtyp Bestellungen
Tragen Sie bitte den SelectLine Verkaufs-Belegtyp ein, in den neue Bestellungen aus dem Onlineshop eingelesene werden. Es werden alle Verkaufsbelegtypen der SelectLine unterstützt, auch Extrabelege. Der Kassenbeleg kann nicht genutzt werden.
##### Belegtyp Versand
Wir eine Bestellung innerhalb der SelectLine an diesen Belegtyp übergeben (z.B. Auftrag in Lieferschein), so wird dem Shop übermittelt, dass die Bestellung versendet wurde, wenn dieser Belegtyp "erreicht" ist.
Ist dem Beleg ein Paket zugeordnet, wird auch die Paketnummer als Trackingnummer an Shopify übertragen.
##### Promotion Artikel
Sollten im Shop Gutscheine oder Rabatte zum Einsatz kommen, so wird er entsprechende Betrag auf diesen Artikel gebucht. Verwendete Gutscheincodes sind im Memo-Feld der Position zu finden.
##### Preisgruppe
Hier wird die Verkaufs-Preisgruppe aus der SelectLine ausgewählt, welche die Preise für den Shop bereitstellt (z.B. Preisgruppe 1)
##### Versand Artikel
Damit die Versandkosten beim Import der Shopify-Bestellungen einer Versandzeile in den SlectLine Positionsdaten zugeordnet werden können, muss hier die Artikelnummer eines Versand-Artikels aus der SelectLine angegeben werden.
##### Shopkunde
In der SelectLine muss ein Kunde angelegt werden, welcher als Grundlage für die die Funktionen des Shopify- Shops dient, solange kein Kunde eingeloggt ist. Bei Gastbestellungen im Onlineshop werden die Erlöse in der SelectLine Warenwirtschaft auf diesen Kunden/ Debitor gebucht. Der so genannte "Shopkunde" dient auch als Grundlage für Neukunden, die sich im Onlineshop neu registrieren. Von seinen Stammdaten werden Konstanten wie Kostenstelle, Lager, Standort, Kontogruppe u.v.a.m. abgleitet.
**Hinweis:** Wenn es sich im eine Gastbestellung handelt werden die Rechnungs- und Lieferanschrift nur im Beleg angepasst. Der Shopkunde bleibt in den Stammdaten unverändert.
##### Standort
Bei Shopify musste bei der Einrichtung ein Standort definiert werden. Damit Bestände von Artikel diesem Standort zugeordnet werden können, muss dieser hier ausgewählt sein. Ist in Shopify nur ein Standort vorhanden, so wird dieser automatisch zugewiesen.
##### Shopaktiv-Feld Kunde
Gibt an, welches Feld in den SelectLine Kundenstammdaten für die Steuerung genutzt wird, ob ein Kundendatensatz an den Shopify Shop übertragen werden soll oder nicht. Der Standard ist das Standard-Feld der SelectLine "Shopakltiv".
> Erläuterung: Werden aus einem SelectLine Mandanten mehrere Onlineshops "bedient" kann es notwendig sein, dass je Shop gesteuert werden soll, welcher Kunde in dem jeweiligen Shop "einkaufen darf".
##### Shopaktiv-Wert Kunde
Gibt an, welchen Wert das Feld in den SelectLine Kundenstammdaten enthalten muss, damit der Datensatz in den Shopify Shop übertragen werden soll oder nicht. Der Standard ist das Standard-Feld der SelectLine "true".
##### Shopaktiv-Feld Artikel
Gibt an, welches Feld in den SelectLine Artikelstammdaten für die Steuerung genutzt wird, ob ein Artikeldatensatz an den Shopify Shop übertragen werden soll oder nicht. Der Standard ist das Standard-Feld der SelectLine "Shopaktiv".
> Erläuterung: Werden aus einem SelectLine Mandanten mehrere Onlineshops "bedient" kann es notwendig sein, dass je Shop gesteuert werden soll, welcher Artikel in den jeweiligen Shop übertragen werden soll. (Sortimentssteuerung je Shop)
##### Shopaktiv-Wert Artikel
Gibt an, welchen Wert das Feld in den SelectLine Kundenstammdaten enthalten muss, damit der Datensatz in den Shopify Shop übertragen werden soll oder nicht. Der Standard ist das Standard-Feld der SelectLine "true".
# Einstellungen
[](https://wiki.dako-it.com/uploads/images/gallery/2024-03/4lhimage.png)
|
##### Maximale Bildgröße
An dieser Stelle kann festgelegt werden, wie groß die zu übertragenen Bilder sein sollen. Die Zahl gibt an, wie viele Pixel die längste Seite des Bildes haben soll. Bei kleineren Bildern wird die Größe belassen. Größere Bilder werden entsprechen verkleinert.
##### Alternative Artikelgruppen
Im SelectLine Standardsystem ist eine einmalige Artikelgruppenzuordnung je Artikel möglich. In Onlineshops sind zum Teil abweichende Artikelgruppen/ Kategorien üblich und zum Teil auch eine mehrfache Zuordnung einzelner Artikel zu Artikelgruppen.
Ist diese Option aktiviert, werden die alternativen Artikelgruppen verwendet. Die Umsetzung erfolgt in der SelectLine mittels überschaubarer Toolbox-Konfigurationen. Siehe hierzu: [LINK](https://wiki.dako-it.com/books/selectline-wawi-individuelle-anpassungen/page/shop-artikelgruppen)
##### Bestand verwenden
Ist diese Option aktiviert, werden die verfügbaren Selectline Bestände zum Shop übertragen. Bei Stückliste gilt der Bestand des am geringsten verfügbaren Artikels der Stückliste.
[](https://wiki.dako-it.com/uploads/images/gallery/2023-04/nzWimage.png) |
> Spezielle Bestandsoptionen: Ein Einschränkung der verwendeten Lager oder sogar die mandanten- übergreifende Bestandsanzeige sind möglich. dazu ist im [Expertenmodus](https://wiki.dako-it.com/books/selectline-shopify-anbindung/page/experteneinstellungen) eine separate Konfiguration in einer JSON-Datei vorgesehen.
Andernfalls wird im Artikel in Shopify unter dem Punkt Inventar die Option "Anzahl verfolgen" deaktiviert.
[](https://wiki.dako-it.com/uploads/images/gallery/2023-04/y6nimage.png) |
##### Trackingnummern importieren
Bei Aktivierung dieser Option wird der Versandstatus nicht nicht zum Shop exportiert. Es besteht nun die Möglichkeit, die Trackingnummern und den Versandstatus direkt im Shop zu verwalten. Beim Bestellimport werden dann die Trackingnummern in die Bestellung hinzugefügt und der Beleg wird wird in den Lieferbeleg übergeben.
##### Nur Lieferstatus senden, wenn Paketnummer vorhanden
Ist diese Option aktiviert, so wird er Lieferstatus erst zum Shop übermittelt, wenn der Beleg (Belegtyp Versand) eine Paketnummer enthält. Beispiel: Der SelectLine Lieferschein entspricht dem "Belegtyp Versand", wenn über SelectLine Versand (oder manuell) in den Lieferschein eine Paketnummer eingetragen wurde, wird der Lieferstatus in Shopify auf "erledigt" gesetzt und die Paketnummer steht in Shopify zur Verfügung. Generell gilt aber: Der Beleg muss auf "Gedruckt" stehen.
##### Kunde über Versand informieren
Bei Aktivierung erhält der Kunde eine E-Mail **von Shopify**, dass der Versandstatus sich geändert hat.
##### Zusatz hinter Titel
Wird diese Option aktiviert, so wird die "Artikelbezeichnung" und das Feld "Zusatz" gemeinsam in das Shopify-Artikelfeld "Bezeichnung" exportiert.
##### Versandposition immer anlegen
Wenn aktiv, wird auch bei Versandkosten von 0,00 EUR eine Versandkostenzeile in den SelectLine- Beleg eingetragen.
##### Nur Bestellungen von bekannten Kunden importieren
Es werden nur Bestellungen importiert, wenn ein zugehöriger Kunde in der SelectLine gefunden werden konnte. Andernfalls wird ein Fehler erzeugt.
##### Kunden immer anlegen (auch bei Gastbestellung)
Ist es gewünscht, dass Kunden auch bei einer Gastbestellung angelegt werden sollen, so muss diese Option gewählt sein.
##### Kein Kundenkonto anlegen
Bei dieser Einstellung werden alle Bestellungen als Gastbestellung behandelt. Hierfür wird immer der Shopkunde zugeordnet.
##### Kunden in SL nicht aktualisieren
Hier werden die bestehenden Kundendaten in der SelectLine nicht aktualisiert. Er erfolgt lediglich eine Zuordnung des Kunden zur Bestellung.
##### Nettopreise
Hierbei werden die Preise zum Shop als Netto-Preise hochgeladen.
##### Versandsteuer nachberechnen
Wenn im Shop Artikel mit voller Umsatzsteuer und ermäßigter Steuer vorhanden sind, kann hier die Nachberechnung der Versandkostensteuer aktiviert werden. Hierbei wird den Versandkosten die Steuer zugewiesen, welche den Artikeln mit den höchsten Warenwert im Warenkorb entspricht.
Beispiel:
4x 5,00€ zu 7% = 20€
2x 9,00€ zu 19% = 18€
Dem Versandartikel würden nun 7% MwSt. zugewiesen werden.
Abweichend vom normalen Versandartikel kann optional auch ein Versandartikel für ermäßigte Steuer konfiguriert werden.
##### Nicht auf Gutschriften prüfen
Wenn im Shop bereits erfüllte Bestellungen reklamiert werden, prüft die Schnittstelle, ob aus der Rechnung Gutschriften erzeugt werden müssen. Dieses Verhalten kann mit dieser Option unterbunden werden.
# Zahlungsbedingungen
[](https://wiki.dako-it.com/uploads/images/gallery/2023-08/hamimage.png)
|
Hier erfolgt das Mapping der Zahlungsbedingungen der SelectLine und der Zahlungsmethoden aus Shopify.
In Shopify können in den Einstellungen, unter dem Punkt Zahlungen, Zahlungsmethoden definiert werden. Damit diese in der SelectLine bei einer Bestellung richtig zugeordnet werden können, muss ein Mapping stattfinden.
> Leider stellt Shopify (noch) keine Übersicht der Zahlungsmethoden per API bereit. Daher werden alle Zahlungsmethoden, die bei einer importierten Bestellung auftauchen, gespeichert. Diese sind dann in der Spalte Shopify aufgelistet und müssen einer entsprechenden Zahlungsbedingung der SelectLine zugeordnet werden, damit diese bei der nächsten Bestellung automatisiert zugewiesen werden kann.
# Lieferbedingungen
[](https://wiki.dako-it.com/uploads/images/gallery/2023-08/AHoimage.png)
|
Hier erfolgt das Mapping der Lieferbedingen der SelectLine und den Shopify-Lieferbedingungen.
> In Shopify können in den Einstellungen, unter dem Punkt *Versand und Zustellung*, Versandtarife für die einzelnen Länder definiert werden. Diese werden in der Spalte *Shopify* aufgelistet und können den existierenden Versandbedingung der SelectLine zugeordnet werden.
# Sprachzuordnung
[](https://wiki.dako-it.com/uploads/images/gallery/2024-10/BODimage.png)
|
Wenn der Shopify-Shop mit mehreren Sprachen betrieben wird, kann hier das Mapping vorgenommen werden, damit die korrekte Sprache dem Beleg zugewiesen wird.
# Makros
An dieser Stelle können SelectLine-Makros definiert werden, welche nach bestimmten Aktionen ausgeführt werden.
##### Details dazu finden Sie [hier](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/makros "Makros")
# Experteneinstellungen
Neben den Einstellungen auf der Webseite der Schnittstelle, können diverse Konfigurationen in der `config.json` getätigt werden.
### Voraussetzung
Die Datei `config.json` befindet sich im Installations-Ordner der Schnittstelle. Um Änderungen daran vorzunehmen, sollte zunächst der Dienst des FINN.ghosts gestoppt und nach der Anpassung wieder gestartet werden.
#### Die Webseite ist nicht erreichbar
Sollte die Webseite der Schnittstelle nicht erreichbar sein, beenden Sie bitte den Dienst bitte über die Eingabeaufforderung (CMD oder Powershell). Sollten Ihnen die angezeigten Fehlermeldungen nicht weiterhelfen, wenden Sie sich bitte an den Support.
### config.json
#### Lagerbestand individuell ermitteln
Um den Lagerbestand für Shopify individuell zu ermitteln, fügen Sie bitte im Object `"shopify"` den Wert `"customStock"` hinzu. Dieser muss eine SQL-Abfrage enthalten, die den Bestand ermittelt. Dabei ist darauf zu achten, dass das Ergebnis eine Zeile mit der Spalte `"Bestand"` zurück liefert. Der Platzhalte für die Artikelnummer muss wie folgt aussehen: `'${nummer}'`.
Beispiel:
```json
{
...
"shopify":{
...
"customStock": "SELECT Bestand-Reserviert AS Bestand FROM dbo.SL_vGetFreierArtikelBestandMitLager WHERE Artikelnummer = '${nummer}'",
...
},
...
}
```
#### Bestand für bestimmte Artikel auf 0 setzen
Um den Bestand für bestimmte Artikel zu deaktivieren, muss in der `config.json` ein `Boolean-Feld` des Artikels angegeben werden. Dies kann auch ein Extrafeld sein.
```json
{
...
"shopify":{
...
"zeroStockField": "FreiesKennzeichen1",
...
},
...
}
```
Bei Variantenartikeln reicht es, den Hauptartikel mit diesem Flag zu versehen. Alles Untervarianten erhalten dann auch den Bestand 0. Stücklistenartikel wirken sich ebenfalls auf die gesamte Stückliste aus.
#### Verkauf fortsetzen, auch wenn Produkte nicht vorrätig sind
Um Produkte ohne Bestand zu verkaufen, kann in der `config.json` ein `Boolean-Feld` des Artikels angegeben werden. Dies kann auch ein Extrafeld sein.
```json
{
...
"shopify":{
...
"continueSelling": "FreiesKennzeichen1",
...
},
...
}
```
#### Artikel ohne Preise exportieren
Aus Sicherheitsgründen werden Artikel ohne Preise nicht exportiert. Möchte man für bestimmte Artikel dafür eine Ausnahme schaffen, so kann ein `Extrafeld (Boolean)` in der Tabelle `ART` angelegt werden. Hat dieses Extrafeld den Wert `True`, so wird der Artikel trotz fehlenden Preises exportiert.
```json
{
...
"shopify":{
...
"disableSafeguardPriceField": "_EXTRAFELDNAME",
...
},
...
}
```
#### Prefix bei IhrAuftrag anpassen
Sollten mehrere Shops am gleichen Mandanten angebunden sind, so muss das Prefix für `IhrAuftrag` angepasst werden.
```json
"shopify": {
...
"orderTag": "sfy_",
...
}
```
#### Feld für Shop-Kundennummer anpassen
Die Schnittstelle schreibt die Kundennummer aus den Shop in das Feld Shopummer. Dies kann in der `config.json` bei `kdfeld` angepasst werden.
```json
"shopify": {
...
"kdfeld": "Shopnummer",
...
}
```
#### B2B-Funktion für ShopifyPlus
Um die B2B Funktionen von ShopifyPlus nutzen zu können, muss diese aktiviert werden. Hierzu ist `status` auf `true` zu setzen.
```json
"shopify": {
...
"plus": {
"status": true,
"checkoutToDraft": false,
"editableShippingAddress": false,
"paymentTermsTemplateId": undefined
}
...
},
```
Weiterhin können Einstellungen für die Unternehmen getroffen werden. Diese werden nur bei der Erstanlage berücksichtigt und können später im Shop für jedes Unternehmen individuell angepasst werden.
| Bestellungen werden als Entwurf gespeichert und müssen freigeben werden. |
| Die Versandadresse kann bei der Bestellung angepasst werden. |
| Die Zahlungsbedingung des Unternehmes. |
##### Mögliche Zahlungsbedingungen:
| Keine Zahlungsbedingung |
1 | Bei Empfang der Ware |
2 | 7 Tage netto |
3 | 15 Tage netto |
4 | 30 Tage netto |
5 | 60 Tage netto |
6 | 90 Tage netto |
7 | Fester Termin |
8 | 45 Tage netto |
9 | Fällig bei Erfüllung |
#### Erstes Artikelbild an des Ende
Manche Templates in Shopify zeigen in der Detailansicht das letzte Bild als erstes an. Um dem entgegen zu wirken, kann das erste Bild in der SelectLine als letztes hochgeladen werden. Hier ist folgender Eintrag in der `config.json` notwendig:
```json
"shopify": {
...
"firstImgToEnd": true,
...
}
```
### Spezielle Extrafelder
#### Artikel-TAGs exportieren
Um Artikel-Tags im Shop zu setzen, müssen in der SelectLine in der Tabelle `ART` logische (Boolean) Extrafelder angelegt werden. Diese müssen mit `_SFYTAG` beginnen. Ist der Wert des Feldes auf `True` gesetzt, so wird das TAG im jeweiligen Artikel aktiviert. Beim setzen auf `False`, wird dieses wieder entfernt.
#### SEO Meta Felder
Damit die SEO-Relevanten-Daten im Shop gefüllte werden, müssen 3 spezielle Extrafelder in der Tabelle `ART` erstellt und mit entsprechenden Daten befüllte werden:
`_METATITLE (Text 70)`
`_METADESCRIPTION (Text 160)`
`_METAKEYWORD (Text 255)`
#### Marktplatz-Bestellnummer
Die Bestellnummer von externen Marktplätzen (z.B. Amazon ist im Kopftext des Beleges zu finden. Darüber hinaus, ist es möglich, diese in ein Extrafeld des Beleges zu importieren. Somit ist eine bessere Suche möglich. Das Extrafeld muss wie folgt aussehen:
`_SFYMARKETORDERID (Text 255)`
#### Zu lange Adressfelder
In Shopify können die einzelnen Adressfelder mit längeren Texten befüllt werden, als die SelectLine zulässt. In einen solchen Fall wird ein Fehler erzeugt und die Bestellung wird nicht importiert.
Alternativ kann man ein Extrafeld in der Tabelle `BELEG` vom Typ `Memo` anlegen und dies in der `config.json` definieren.
```json
"shopify": {
...
"tooLongAdrField": "_EXTRAFELDNAME",
...
}
```
Nun wird die Adresse in gekürzter Form dem Beleg hinzugefügt. Die ungekürzte Form ist dann im Extrafeld zu finden.
# Zuordnung Versanddienstleister
Beim Senden der Trackinginformationen zum Shopify kann eine Trackingnummer, eine Tracking-URL und ein Versanddienstleister übermittelt werden.
Shopify bietet verschiedene Versanddienstleister an:
[](https://wiki.dako-it.com/uploads/images/gallery/2024-03/e4Himage.png)
|
Diese müssen nicht mit denen aus der SelectLine übereinstimmen:
[](https://wiki.dako-it.com/uploads/images/gallery/2024-03/Z47image.png)
|
Damit `DHL Express` zu `DHL` zugeordnet werden kann, muss eine Verknüpfung hergestellt werden:
[](https://wiki.dako-it.com/uploads/images/gallery/2024-03/2Xwimage.png)
|