Einstellungen

Shopdaten

image.png

In den Shopdaten wird der Zugang zum Shop konfiguriert. Bestehend aus der URL des Shops, der Shopware-Zugangs-ID und dem Shopware Sicherheitsschlüssel.  

Um die Zugangs-ID und den Sicherheitsschlüssel zu erhalten, muss im Shopware-Backend eine neue Integration erstellt werden. Dies erfolgt unter Einstellungen -> System -> Integrationen.

 

image.png

Makros

image.png

An dieser Stelle können SelectLine-Makros definiert werden, welche nach bestimmten Aktionen ausgeführt werden. 

So ist es beispielsweise möglich, nach der Übertragung von Onlinebestellungen vom Shop in die SelectLine per Makro einen Beleg-Workflow anzustoßen oder bei der Anlage von neuen Kunden, die sich im Shop registriert haben, diese Daten mit weiteren Informationen zu erweitern, Kundengruppe, Erlöskontengruppe etc. So lässt sich die Funktion der Schnittstelle FINN.ghost | Shopify für SelectLine individuelle erweitern.

Details dazu finden Sie hier

Einstellungen

image.png

Maximale Bildgröße

Hier kann die maximale Bildgröße angegeben werden, der derzeitige Standard für Bilder auf Webseiten sind 1920 Pixel.

Weitere Einstellungen zum Dateityp der Bilder (PNG, JPG, WEBP) und ein Faktor zur Bildkompression lassen sich in den Einstellungen im Menüpunkt "SelectLine" vornehmen. Informationen dazu finden Sie hier.

Artikel bei Aktualisierung übertragen

Durch das setzen des Hakens, werden immer die Bilder bei Aktualisierung des Artikel neu in den Shop übertragen.

Bestehende Bilder im Shop aktualisieren

Mit dieser Einstellung kann erzwungen werden, dass bereits bestehende Bilder im Shop aktualisiert werden. Dies ist z.B. notwendig, wenn man ein Bild in der SelectLine austauscht, aber den Dateinamen nicht verändert.

Nur Daten exportieren, die mit "Export" gekennzeichnet sind

Durch das setzen des Hakens, werden z.B. nur Bilder exportiert, die in der SelectLine für den Export gekennzeichnet sind.

image.png

Maximalabnahme bei Nicht-Lagerartikel

Hier kann man eine Stückzahl eintragen, die maximal abgegeben wird, wenn in der SelectLine der entsprechende Artikel nicht lagernd ist. 

image.png

Durch das eintragen einer Stückzahl, wird das Feld "Maximalabnahmemenge auch bei Lagerartikel anwenden" anklickbar. Dadurch kann man jetzt entscheiden ob bei allen Artikeln die eingetragene Maxmalstückzahl greift. Hierfür muss dann der Haken zusätzlich gesetzt werden.


Lagerartikel ohne Bestand nicht hochladen

Durch setzten eines Hakens in diesem Feld werden keine Artikel mehr aus der SelectLine hochgeladen, welche Lagerartikel sind, aber keinen Bestand haben.

image.png

Artikel inaktiv, wenn Lagerartikel ohne Bestand

Wenn hier ein Haken gesetzt wird, dann heißt es, dass wenn ein Artikel lagernd in der SelectLine ist, der Bestand aber kleiner als 0 ist, so wird der Artikel im Shop inaktiv geschalten, also nicht mehr zum Kauf angeboten. 

Nur Bestand, Preis und Varianten aktualisieren

Durch das setzen des Hakens hier, werden nur Bestand, Preis und die Varianten aus der SelectLine aktualisiert, aber z.B. nicht neue Bilder, Artikelgruppen oder Beschreibungen.

SW Kundennummer in der SL verwenden

Wird hier der Haken gesetzt, so wird die Kundennummer aus Shopware genommen und in der SelectLine verwendet.

Bei Gastbestellung soll ein Kundenkonto angelegt werden

Setzt man hier den Haken, so wird bei einer Gastbestellung ein neues Kundenkonto in der SelectLine angelegt.

Diese Funktion sollte ausschließlich bei B2B- Systemen verwendet werden. Bei B2C-Systemen könnte die Einhaltung der Europäischen Datenschutzverordnung gefährdet sein.

Grundpreis

Wenn der Haken gesetzt ist, werden die Grundpreise, wie im unterem Bild dargestellt angezeigt. Sobald man den Haken entfernt werden diese Preise nicht mehr angezeigt.

Die Grundpreise/Referenzmengen dienen dazu, dem Kunden einen Preisvergleich einfacher zu machen. Sie entsprechen den gesetzlichen Vorschriften zur Preisauszeichnung.

image.png

Für die Ermittlung des Grundpreises stellt die Schnittstelle 2 Möglichkeiten zur Verfügung.

Wie Grundpreise mit freien Feldern erstellt werden, können sie hier nachlesen.

Grundpreise auf Basis der Mengenumrechnung sind hier beschrieben.
Das Feld FreieZahl3 kann individuell in der config.json unter sw6.grundpreisUnitField definiert werden.
Das Feld FreierText2 kann individuell in der config.json unter sw6.grundpreisReferenceField definiert werden.

Listenpreis als Streichpreis

Der Listenpreis wird in der SelectLine angegeben unter Stammdaten, Artikel, Verkauf.

image.png

Wenn der Haken bei Streichpreise gesetzt wird, dann wird der Listenpreis durchgestrichen angezeigt mit einer Info um wie viel Prozent das Produkt jetzt günstiger ist. 

image.png

Damit alle Daten im Shopware-Shop auf dem geänderten Stand sind müssen alle Artikel neu übertragen werden.


Bestell-E-Mails versenden

Wird hier der Haken gesetzt, so bekommen alle Kunden, bei denen eine E-Mail hinterlegt ist nach auslösen einer Bestellung eine Bestellbestätigung aus Shopware per E-Mail zugesendet. 

Diese Option aktiviert die E-Mail Funktion in Shopware.


E-Rechnungs- E-Mail bei Kunden eintragen

Die E-Mail-Adresse des Kunden aus dem Shop wird bei einer Bestellung im Kunden der auch dem Feld für E-Rechnung eingetragen.

SW-Kundennummer im Beleg hinterlegen.

Wenn im Feld Feld für SW-Kd.-Nummer im Beleg etwas hinterlegt ist, wird die Kundenummer aus Shopware entsprechend im Beleg hinterlegt.

Zuordnung

image.png

Belegtyp Bestellungen

Hier wählt man den Belegtyp aus, in den der Warenkorb aus dem Shop in die SelectLine übertragen wird. Zur Auswahl stehen alle Verkaufsbelege der SelectLine.

Belegtyp Versand

Beim Belegtyp Versand steht die Auswahl des Belegtyps zur Verfügung. Zur Auswahl stehen alle Verkaufsbelege der SelectLine.

Diese Einstellung steuert, dass beim Erreichen dieses Belegtyps innerhalb der SelectLine Belegkette, z.B. "Lieferschein", an den Shopware Shop die Bestellung als "versendet" gekennzeichnet und die Paketnummern aus der Paketverwaltung übermittelt wird. 

Belegtyp Rechnung

Beim Belegtyp Rechnung steht die Auswahl des Belegtyps zur Verfügung.. Zur Auswahl stehen alle Verkaufsbelege der SelectLine.

Archiv Druckvorlagen Rechnungsversand

Hier kann aus verschiedenen Formaten eine Archiv-Druckvorlage ausgewählt werden.

Verkaufskanal

Unter diesem Punkt wird die Auswahl getroffen, auf welchem der eigenen Shopware-  Verkaufskanäle die Daten zugeordnet werden sollen

Lieferzeiten

Hier werden die regulären Lieferzeiten für die Produkte im Shop festgelegt. Man kann hier die Lieferzeiten auswählen, welche im Shop definiert wurden.

Lieferzeiten-Feld

Soll die Lieferzeit je Artikel angegeben werden können. So muss ein Extrafeld in der Tabelle ART vom Typ Text erstellt werden. Dieses Feld muss dann eine der definierten Lieferzeiten vom Shop enthalten.

Preisgruppe

Zur Auswahl der Preisgruppe stehen die verschiedenen (Preise in EUR) aus der Artikelmaske.

Die Auswahl steuert, welche Preisgruppe im Webshop standardmäßig angeboten wird. Die Schnittstelle FINN.ghost | Shopify erstellt selbstständig die erforderliche Preisregel in Shopware.

image.png

Promotion Artikel

Wenn im Shop Promo-Aktionen gefahren werden, wird der Rabatt auf diesen Artikel gebucht.

Gutschein Artikel

Die Schnittstelle unterstützt das Shopware-Plugin EasyCoupon.

Versand Artikel

Die Versandkosten werden auf diesen Artikel gebucht.


Versand Artikel (ermäßigt)

Optional kann ein ermäßigter Versandartikel definiert werden. Ermäßigte Versandkosten werden dann auf diesen Artikel gebucht.

Shopkunde

Für Gastbestellungen wird der hier angegeben Kunde verwenden. Zusätzlich dient dieser Kunde als Vorlage für Neukunden.


Hauptartikelgruppe

Unter dieser Artikelgruppe im Shop wird der Artikelgruppenbaum aus der SelectLine angelegt.


Layout für Gruppen

Hier wird das Layout für die Artikelgruppen definiert.


Gruppen

Die Schnittstelle kann die Artikelgruppen der SelectLine auf 3 verschiedenen Möglichkeiten verarbeiten.

Standard Er werden die Gruppen wie in der SelectLine angelegt.
Alternativ Es kann in der SelectLine eine alternative Gruppenstrucktur für den Shop angelegt werden. (siehe Shopartikelgruppen)
Kombiniert Es wird im Shop eine Kombination aus Standard und Alternativ angelegt.


Default-Artikelgruppe (falls in SelectLine keine gesetzt)

Sollte dem Artikel in der SelectLine keine Artikelgruppen zugewiesen sein, so wird im Shop eine Standard-Artikelgruppen zugewiesen.

Immer Default-Artikelgruppe verwenden

Es wird immer die Standardartikelgruppe für neu hochgeladene Artikel verwendet.

Gruppen zu ignorieren

Hier können Artikelgruppen aus der SelectLine definiert werden, welche ignoriert werden sollen. Diese werden nicht zum Shop übertragen.

ImportCheck-Feld (Beleg)

Mit dem Feld für ImportCheck im Beleg kann gesteuert werden, dass am Ende der Importvorgangs einer Bestellung eine Checkbox gesetzt wird. Damit kann sichergestellt werden, dass der Beleg korrekt eingelesen wurde. Sollte das Feld nicht gesetzt sein, kann davon ausgegangen werden, dass es beim Import-Vorgang ein Problem aufgetreten ist. Beim nächsten Import wird versucht, diese Bestellung erneut zu verarbeiten.

ShopAktiv-Feld (Kunde)

Hier wird das Feld aus dem Kunden in der SelectLine ausgewählt, welches für die Entscheidung herangezogen wird, ob der Kunde zum Shop exportiert wird.

ShopAktiv-Feld (Artikel)

Hier wird das Feld aus dem Artikel in der SelectLine ausgewählt, welches für die Entscheidung herangezogen wird, ob der Artikel zum Shop exportiert wird.

Auffächern

Hier wird das Feld aus dem Artikel in der SelectLine ausgewählt, welches für die Entscheidung herangezogen wird, ob der Artikel im Shop aufgefächert wird.

Hervorheben

Hier wird das Feld aus dem Artikel in der SelectLine ausgewählt, welches für die Entscheidung herangezogen wird, ob der Artikel im Shop hervorgehoben wird.

Zahlungsbedingungen

image.png

Spalten

Shopware Der Name der Zahlungsbedingung im Shop.
SelectLine Der Name der Zahlungsbedingung in der SelectLine.
Bankbezug Der zuverwendene Bankbezug in der SelectLine.
Import Normalerweise werden nur Bestellungen importiert, welche im Shop als Bezahlt markiert sind. Mit dieser Einstellung kann erzwungen werden, dass auch unbezahlte Bestellungen importiert werden. Dies kommt z.B. bei Nachname-Bestellungen zum Einsatz.
Vorkasse Wenn diese Einstellung aktiviert ist, werden Bestellungen mit diesen Zahlungsbedingungen dem Vorkasse-Beleg zugeordnet welcher unter den Zuordnungen definiert wurde.
Referenz Ist dieser Haken aktiv, muss die Bestellung eine Zahlungsreferenz besitzen. Ist dies nicht der Fall, wird ein Fehler ausgelöst.

Lieferbedingung

image.png

Hier kann man die Lieferbedingung, wie sie im Shopware-Shop konfiguriert sind, mit der entsprechenden Lieferbedingung aus der SelectLine verknüpfen. 


Fremdsprachen

image.png

Im Konfigurationsblock "Fremdsprachen" weisen Sie den Sprachkürzeln der SelectLine die Sprachcodes von Shopware zu.

Experteneinstellungen

Neben den Einstellungen auf der Webseite der Schnittstelle, können diverse Konfigurationen in der config.json und mit Extrafeldern 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 Shopware individuell zu ermitteln, fügen Sie bitte im Object "sw6" 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: '${article.Number}'.

Beispiel:

{
  ...
  "sw6":{
    ...
    "customStock": "SELECT Bestand-Reserviert AS Bestand FROM dbo.SL_vGetFreierArtikelBestandMitLager WHERE Artikelnummer = '${article.Number}'",
    ...
  },
  ...
}

Maximalabnahme

In der Regel wird der verfügbare Bestand als Maximalabnahme verwendet. Soll dies für jeden Artikel individuell konfiguriert werden, kann ein Extrafeld in der Tabelle ART angelegt werden, welches die Maximalabnahmemenge enthält.
Dieses muss dann in der config.json zugewiesen werden:

{
  ...
  "sw6":{
    ...
    "maxPurchaseField": "_EXTRAFELDNAME",
    ...
  },
  ...
}

Enthält dieses Feld einen Wert, wird er als Maximalabnahme zugewiesen, ansonsten wird, wie üblich, der Bestand verwendet.

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.

{
  ...
  "sw6":{
    ...
    "disableSafeguardPriceField": "_EXTRAFELDNAME",
    ...
  },
  ...
}

Grundpreise mit Mengenumrechnung

Damit die Grundpreise mit der Mengenumrechnung verwendet werden können, muss ein Extrafeld in der Tabelle MENGUM angelegt werden.

image.png

Das Feld muss vom Typ Boolean sein. Der Name muss in der config.json angegeben werden:

{
  ...
  "sw6":{
    ...
    "grundpreisMengumField": "_GRUNDPREIS",
    ...
  },
  ...
}

In der SelectLine kann dann der Grundpreis in der Mengenumrechnung dann folgendermaßen definiert werden:

image.png

 

Darstellung im Shop:

image.png

Mapping von Feldern bei Artikeln

{
  ...
  "sw6":{
    ...
      "extrafeldMapping": [
        { "new": "<neuer Feldname in SW>", "old": "custom_sl_artikel_FreiesDatum2" },
        { "new": "<neuer Feldname in SW>", "old": "custom_sl_artikel_EXTRAFELD" }
      ],
      "extrafeldMappingDelete": true,
    ...
  },
  ...
}

Folgende Felder können bei Artikeln gemappt werden:

Der Schalter extrafeldMappingDelete bewirkt, dass das alte Zusatzfeld nicht mehr befüllt wird.

Extrafelder

SEO Meta-Daten

Um die SEO-Metadaten im Shop automatisch zu befüllen, müssen folgende Extrafelder in der Tabelle ART angelegt werden:

_METATITLE (Text 70)
_METADESCRIPTION (Text 160)
_METAKEYWORD (Text 255)

Email-Adresse im Beleg

Bei Gastbestellungen wird kein Kundenkonto angelegt. Daher ist es möglich, die E-Mailadresse des Kunden zusätzlich im Beleg zu hinterlegen. Sofern das Extrafeld _EMAIL im Beleg vorhanden ist, wird dieses befüllt.

Abverkauf

Um den Status des Abverkaufs vom Artikel per Extrafeld steuern zu können, muss folgendes Extrafeld in der Tabelle ART angelegt werden:

_SW6ABVERKAUF (logisch)

SEO Meta-Daten Übersetzung

Um die SEO-Meta-Daten auch in anderen Sprachen in der SL pflegen zu können, muss am Ende des entsprechenden Extrafeldes ein Sprachkürzel angehangen werden.

Beispiel für Englisch:
_METATITLE_E
_METADESCRIPTION_E
_METAKEYWORD_E

Zusätzlich muss die SL-Sprache noch der ISO-Sprache aus Shopware zugeordnet werden. Siehe: Fremdsprachen

Langtexte bei Hersteller nicht übertragen

Um die Texte der Hersteller manuell pflegen zu können, kann dessen Übertragung deaktivier werden:

{
  ...
  "sw6":{
    ...
      "disableManufacturerDescription": true,
    ...
  },
  ...
}

Extrafeld für den Beschreibungstext verwenden

Ein Extrafeld als Beschreibungstext kann hier in der config.json definiert werden:

{
  ...
  "sw6":{
    ...
      "descriptionField": "_EXTRAFELD",
    ...
  },
  ...
}

Extrafeld für den Titel verwenden

Ein Extrafeld als Titel kann hier in der config.json definiert werden:

{
  ...
  "sw6":{
    ...
      "titleField": "_EXTRAFELD",
    ...
  },
  ...
}