FINN.ghost für Shopware6

Allgemein

Allgemein

Feldzuordnung Artikel

Die Produktdaten von Shopware sind hier beschrieben: LINK

Zuordnung

cmsPageId
 Das Layout des Produkt wird in den Einstellungen der Schnittstelle definiert. (Layout für Produkte)
active
 Der Artikel muss ShopAktiv und darf nicht Inaktiv sein, um im Shop auf Aktiv geschalten zu werden.
stock
 Es wird der komplette Bestand des Artikels (Bestand - Reserviert) an das Feld Lagerbestand übermittelt. Alternativ kann dies in den Experteneinstellungen angepasst werden.
isCloseout
 Wenn die Einstellung "Lagerartikeln mit Bestand 0 bekommen den Haken Abverkauf" aktiv ist, der Artikel ein Lagerartikel ist und er keinen Bestand hat, wird der Artikel im Shop auf "Abverkauf" gesetzt.
maxPurchase
 Die Maximalabnahme-Menge des Shops entspricht im Regelfall dem Bestand des Artikels. Ein den Einstellungen kann ein fester Wert für "Nicht-Lagerartikel" definiert werden. Weiterhin kann dieser Wert auch zusätzlich für "Lagerartikel" übernommen werden. In den Experteneinstellung ist dies weiter individualisierbar.
taxId
 Es wird die taxId des Shops der entsprechenden Steuer der SelectLine zugewiesen.
markAsTopseller
 In den Einstellungen kann ein Boolean-Feld des Artikels definiert werden, welches als Kriterium für das Hervorheben im Shop herangezogen wird.
unitId
unitId, purchaseUnit und referenceUnit werden entsprechend gefüllt wenn die Funktion Grundpreis in den Einstellungen aktiviert wurde. 
purchaseUnit
 siehe unitId
referenceUnit
 siehe unitId
price

Es wird der Preis der Preisgruppe übertragen, welche in den Einstellungen definiert wurde. Hierbei werden Zukunftspreise ebenfalls berücksichtigt. Im Shop erfolgt die Umsetzung mit Preisregeln. Es kann in den Einstellungen definiert werden, dass der Listenpreis als Streichpreis verwendet wird. Anhand der letzten Preisübertragungen wird der günstigste Preis der letzten 30 Tage im Shop hinterlegt.

Weitere Funktionen, die mit Hilfe der Preisregeln umgesetzt werden:

  • Aktionspreise
  • Kundenpreise
  • Kundenpreisgruppenpreise
  • Rabattstaffeln
  • Mengenstaffeln
parentId
 Variantenartikel werden mit ihren Merkmalen und Ausprägungen zum Shop hinzugefügt. Hierbei wird die Einstellung des Auffächerns berücksichtigt.
options
 siehe parentId
configuratorSettings
 siehe parentId
variantListingConfig
 siehe parentId
name
 Die Bezeichnung des Artikels
productNumber
 Die Artikelnummer des Artikels
ean
 Die EAN des Artikels
weight
 Das Gewicht des Artikels
releaseDate
 Das AngelegtAm-Datum des Artikels
manufacturerId
 Es wird die manufacturerId des Shops der entsprechenden Hersteller der SelectLine zugewiesen.
manufacturerNumber
 Die Herstellerartikelnummer des Artikels
customFields
 Die Extrafelder des Artikels
properties
 Die Sachmerkmale des Artikels
purchaseSteps
 Die Losgröße des Artikels
minPurchase
 Die Losgröße des Artikels
crossSellings
 Zubehör- und Alternativartikel des Artikels
categories
 Die Artikelgruppen des Artikels. Dies kann in den Einstellungen konfiguriert werden.
description
 Der Langtext des Artikels
deliveryTimeId
 Die Lieferzeit des Artikels. Dies kann in den Einstellungen konfiguriert werden.
packUnit
 Die Mengeneinheit des Artikels
width
 Wenn das Extrafeld _DIMBREITE existiert. Wird er Wert als Breite übertragen.
height
 Wenn das Extrafeld _DIMHOEHE existiert. Wird er Wert als Höhe übertragen.
length
 Wenn das Extrafeld _DIMLAENGE existiert. Wird er Wert als Länge übertragen.
metaTitle
 Wenn das Extrafeld _METATITLE existiert. Wird er Wert als SEO-Metatitel übertragen.
metaDescription
 Wenn das Extrafeld _METADESCRIPTION existiert. Wird er Wert als SEO-Metabeschreibung übertragen.
keywords
 Wenn das Extrafeld _METAKEYWORD existiert. Wird er Wert als SEO-Keywords übertragen.
translations
 Die Übersetzungen des Artikels (Bezeichnung und Beschreibung). Dies kann in den Einstellungen konfiguriert werden.
media
 Bilder des Artikels
cover
 Erste Bild des Artikels
visibilities
 Der Verkaufskanel des Artikels kann ein den Einstellungen konfiguriert werden.

Einstellungen

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
Einstellungen

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

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.

Einstellungen

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.

Einstellungen

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.

Einstellungen

Lieferbedingung

image.png

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


Einstellungen

Fremdsprachen

image.png

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

Einstellungen

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

Zeitsteuerung

Zeitsteuerung

Zeitsteuerung konfigurieren

image.png

Über die Zeitsteuerung können Sie differenzierte Übertragungszeiten und Routinen für den Datenaustausch zwischen SelectLine und Shopware konfigurieren.

Grundlegende Infos zur Zeitsteuerung finden sie hier.