Einrichtung

Verbindung zum Shop, Verkaufskanal, Zuordnungen und die Reihenfolge bei der Erstinbetriebnahme.

Shopdaten

Unter Shopware 6 → Einstellungen → Shopdaten wird der Zugang zum Shop hinterlegt. Ohne diese Angaben bleiben alle weiteren Auswahllisten in den Einstellungen leer, weil sie ihre Inhalte direkt aus dem Shop laden.

Bereich Shopdaten in den Einstellungen

Zugangsdaten

URL zum Shop

Die Adresse des Shops einschließlich https:// und mit Schrägstrich am Ende.

Der Schrägstrich am Ende ist Pflicht. Fehlt er, entstehen unbrauchbare Adressen und die Verbindung schlägt fehl, obwohl Zugangs-ID und Schlüssel korrekt sind.

Zugangs-ID und Sicherheitsschlüssel

Beide Werte stammen aus einer Shopware-Integration. Im Shopware-Backend unter Einstellungen → System → Integrationen eine neue Integration anlegen; Shopware zeigt daraufhin die Zugangs-ID und den Sicherheitsschlüssel an.

Der Sicherheitsschlüssel wird nur einmal angezeigt. Wer ihn nicht notiert hat, erzeugt eine neue Integration.

Die Integration braucht Schreibrechte auf Produkte, Preise, Medien, Kategorien, Eigenschaften, Hersteller, Zusatzfelder, Kunden, Bestellungen, Regeln, Steuern und Maßeinheiten. Im Zweifel bekommt die Integration die Administratorrolle.

Verbindung prüfen

Die Verbindung ist in Ordnung, wenn sich die Auswahllisten in den Einstellungen füllen — etwa die Verkaufskanäle, die Zahlungsarten oder die Lieferzeiten. Bleiben sie leer, stimmt etwas an der URL oder an den Zugangsdaten nicht. Die konkrete Meldung steht im Protokoll unter Shopware 6 → Zeitsteuerung.

Weitere Einstellungen

Indizierung in Shopware

Nach jedem Schreibzugriff kann Shopware seinen Index neu berechnen. Dabei erneuert es auch den Cache des Shops — und daran hängt, wie schnell eine Änderung aus der SelectLine im Frontend zu sehen ist. Das Feld Indizierung in Shopware kennt drei Einstellungen:

Einstellung Wirkung
Aussetzen Shopware indiziert nicht mit. Schnellste Übertragung — aber der Shop erneuert seinen Cache nicht.
Über die Warteschlange Shopware nimmt die Indizierung in seine Warteschlange auf und arbeitet sie kurz darauf ab. Die Übertragung bleibt schnell, Index und Cache ziehen von selbst nach.
Sofort Shopware indiziert bei jedem Schreibzugriff unmittelbar mit. Änderungen sind sofort sichtbar, große Läufe dauern deutlich länger.

Voreingestellt ist Aussetzen — die schnellste, aber nicht die naheliegendste Einstellung.

Mit Aussetzen stehen geänderte Bestände und Preise im Shopware-Backend zwar korrekt, im Frontend liefert der Shop aber weiter die alte Seite — bis der Cache von Hand geleert wird. Auch Suche und Listen hinken dann hinterher.

Eine Ausnahme macht die Schnittstelle bei Aussetzen von sich aus: Hat sich an einem Artikel ein Bild geändert, lässt sie Shopware diesen Artikel sofort indizieren. Ohne Index zeigt der Shop für solche Artikel sonst Platzhalter statt der neuen Bilder.

Für die meisten Shops ist Über die Warteschlange die richtige Wahl: zügige Übertragung und ein Frontend, das ohne Zutun nachzieht.

Über die Warteschlange setzt voraus, dass im Shop ein Dienst läuft, der die Warteschlange abarbeitet (messenger:consume). Ist stattdessen nur der Admin-Worker eingerichtet, arbeitet Shopware sie lediglich ab, solange jemand im Shopware-Backend angemeldet ist.

Ältere Shopware-Version

Preisregeln mit einem Gültigkeitszeitraum — Aktionspreise, Kundenpreise und Preisgruppenpreise — bekommen Beginn und Ende je nach Shopware-Version in einem anderen Format. Ab Shopware 6.7.6 ist es ein reines Datum, also von 00:00:00 bis 23:59:59 und ohne Zeitzone. Ältere Versionen erwarten einen vollständigen Zeitstempel samt Zeitzone. Das jeweils falsche Format lehnt Shopware mit This value is not a valid datetime. ab. Die Schnittstelle fragt die Version vor jedem Artikelexport beim Shop ab und wählt das Format selbst, auch nach einem Shopware-Update.

Nur wenn der Shop seine Version nicht meldet, entscheidet der Schalter oldSWVersion: an für Shopware bis 6.7.5, aus ab 6.7.6. Er hat kein Feld in der Maske und wird in der config.json im Abschnitt sw6 gesetzt. Das Systemhandbuch führt ihn unter Einstellungen ohne Maske → Shopware 6.

Medienordner im Shop

Die Schnittstelle legt Artikelbilder im Shopware-Medienordner Product Media ab, Herstellerbilder in Product Manufacturer Media.

Fehlt der Ordner Product Media oder wurde er umbenannt, bricht die gesamte Artikelübertragung ab. In deutschsprachig eingerichteten Shops heißt der Ordner gelegentlich anders — dann muss er umbenannt oder zusätzlich angelegt werden.

Nächster Schritt

Verkaufskanal einrichten

Verkaufskanal

Ein Shopware-Shop kann mehrere Verkaufskanäle haben, zum Beispiel einen für Endkunden und einen für Händler. FINN.ghost kann mehrere davon gleichzeitig versorgen. Alles, was sich von Kanal zu Kanal unterscheiden kann, wird deshalb pro Verkaufskanal eingestellt.

Der Bereich liegt unter Shopware 6 → Einstellungen → Verkaufskanäle. Oben wählt man den Kanal aus, darunter erscheinen dessen Einstellungen.

Bereich Verkaufskanal in den Einstellungen

Artikelfreigabe

Zuweisung

Das wichtigste Feld der ganzen Einrichtung. Hier wird ein Kennzeichen aus der Artikelmaske ausgewählt, das bestimmt, ob ein Artikel in diesem Verkaufskanal angeboten wird. In der Praxis ist das ein Extrafeld vom Typ Kennzeichen in der Tabelle ART, etwa ShopAktiv.

Nur Artikel mit gesetztem Kennzeichen werden übertragen. Das Feld steuert außerdem, welche Artikelgruppen als Kategorien angelegt werden und welche Zubehör- und Alternativartikel als Cross-Selling erscheinen.

Ist bei keinem Verkaufskanal eine Zuweisung eingetragen, brechen Artikel-, Bestands- und Kategorieübertragung sofort ab. Das ist die häufigste Ursache dafür, dass „überhaupt nichts läuft".

Standardsichtbarkeit

Legt fest, wo ein freigegebener Artikel im Shop auftaucht:

Sichtbarkeit Bedeutung
Überall in Listen, in der Suche und über den direkten Link erreichbar
Suche nur über die Suche und den direkten Link
Link nur über den direkten Link

Voreingestellt ist Überall.

Sichtbarkeit

Soll die Sichtbarkeit je Artikel abweichen können, wird hier ein Extrafeld aus der Artikelmaske ausgewählt, das den gewünschten Wert enthält.

Das Feld muss genau einen der drei zulässigen Werte enthalten. Ist es leer oder enthält es etwas anderes, gilt die Standardsichtbarkeit.

Belegtypen

Diese vier Einstellungen verbinden den Shop mit der SelectLine-Belegkette. Zur Auswahl stehen jeweils alle Verkaufsbelege der SelectLine.

Belegtyp Bestellungen

In diesen Belegtyp wird der Warenkorb aus dem Shop übertragen.

Belegtyp Vorkasse

Bestellungen mit einer Vorkasse-Zahlungsart landen stattdessen in diesem Belegtyp. Welche Zahlungsarten als Vorkasse gelten, wird unter Zahlungs- und Versandarten festgelegt.

Belegtyp Versand

Erreicht ein Beleg diesen Belegtyp in der Belegkette — üblicherweise der Lieferschein —, meldet die Schnittstelle die Bestellung im Shop als versendet und überträgt die Paketnummern aus der Paketverwaltung.

Belegtyp Rechnung

Erreicht ein Beleg diesen Belegtyp, wird die Bestellung im Shop abgeschlossen.

Kunden

Shopkunde

Ein bestehender SelectLine-Kunde, der als Vorlage für neu angelegte Shop-Kunden dient. Legt der Shop eine Bestellung eines unbekannten Kunden vor, übernimmt FINN.ghost die Vorbelegungen dieses Musterkunden — Preisgruppe, Kontengruppe, Zahlungsbedingung und ähnliches — und füllt die Adressdaten aus der Bestellung.

Es lohnt sich, hier einen sauber gepflegten Musterkunden zu hinterlegen. Alles, was dort steht, erbt später jeder Shop-Kunde.

Ohne Shopkunden werden Bestellungen dieses Verkaufskanals nicht importiert. Im Protokoll erscheint dann ein Hinweis, dass der Shopkunde nicht definiert ist.

Der Shopkunde wird außerdem direkt als Bestellkunde verwendet, wenn gar kein Kundenkonto angelegt werden soll — siehe Kunden.

ShopAktiv-Feld (Kunde)

Das Gegenstück zur Zuweisung, nur für Kunden: Ein Kennzeichen im Kundenstamm, das bestimmt, ob der Kunde in diesen Verkaufskanal übertragen wird.

Kunden an Verkaufskanal binden

Ist der Haken gesetzt, bindet FINN.ghost jeden Kunden, den es in diesen Kanal überträgt, fest an den Verkaufskanal (in Shopware die Verkaufskanalbindung am Kunden). Der Kunde kann sich dann nur noch in diesem Kanal anmelden.

Voreingestellt ist der Haken gesetzt. Wird er entfernt, lässt die Schnittstelle die Verkaufskanalbindung unangetastet: Was im Shop eingetragen ist — oder eben keine Bindung —, bleibt auch nach weiteren Übertragungen erhalten. Eine bereits gesetzte Bindung löst sie dabei nicht; das geschieht im Shop.

Ein gebundener Kunde, der sich in einem anderen Kanal anmelden will, scheitert und registriert sich dort meist neu. Shopware lässt das zu, weil die E-Mail-Adresse nur innerhalb eines Kanals eindeutig sein muss. So entstehen doppelte Kundenkonten mit derselben E-Mail-Adresse. Sollen sich Kunden in mehreren Kanälen anmelden können, den Haken entfernen.

Rechnungen

Für den Rechnungsversand im Shop gibt es zwei Wege, die sich gegenseitig ausschließen.

Archiv Druckvorlage Rechnungsversand

Wird hier eine Druckvorlage ausgewählt, lädt FINN.ghost das archivierte PDF aus der SelectLine in den Shop. Der Kunde findet in seinem Konto damit genau das Dokument aus der SelectLine — gleiche Nummer, gleiches Layout.

Dafür muss der FINN.ghost-Dienst den Archivpfad lesen können. Liegt das Archiv auf einem Netzlaufwerk, darf der Dienst nicht unter dem lokalen Systemkonto laufen.

Rechnungen in SW erstellen

Alternativ erzeugt Shopware die Rechnung selbst und übernimmt lediglich die Belegnummer aus der SelectLine. Diese Option ist gesperrt, sobald eine Archiv-Druckvorlage ausgewählt ist.

Makros

Zwei Stellen, an denen ein SelectLine-Makro angestoßen werden kann.

Bestellung angelegt

Läuft, nachdem der Beleg vollständig aufgebaut ist. Der übliche Platz für alles, was mit einem fertigen Shop-Beleg passieren soll — Kommission anstoßen, Felder füllen, Beleg drucken. Übergeben werden Belegtyp und Belegnummer.

Läuft das Makro auf einen Fehler, wird der gerade angelegte Beleg wieder gelöscht. Die Bestellung gilt im Shop aber bereits als in Bearbeitung und wird nicht erneut abgeholt — sie muss dann von Hand nachgetragen werden. Makros an dieser Stelle sollten ihre Fehler daher selbst abfangen.

Kunde angelegt

Läuft, nachdem ein neuer Kunde aus einer Bestellung entstanden ist. Übergeben wird die Kundennummer. Bei reinen Aktualisierungen bestehender Kunden läuft kein Makro.

Mehrere Verkaufskanäle

Wird ein zweiter Kanal eingerichtet, bekommt er sein eigenes Freigabekennzeichen, seine eigenen Belegtypen und seinen eigenen Shopkunden. Ein Artikel kann in beiden Kanälen erscheinen, wenn beide Kennzeichen gesetzt sind.

Bei Kunden ist das anders: Ein Kunde wird dem ersten Kanal zugeordnet, dessen Kundenkennzeichen gesetzt ist, und standardmäßig fest an ihn gebunden. Soll er sich in allen Kanälen anmelden können, wird dort der Haken Kunden an Verkaufskanal binden entfernt.

Gelöschter oder neu angelegter Kanal

Wird ein eingerichteter Verkaufskanal in Shopware gelöscht oder neu angelegt, bleiben seine Einstellungen in FINN.ghost unter der alten Kennung stehen. Oberhalb der Kanalauswahl steht dann ein Hinweis Den Verkaufskanal … gibt es im Shop nicht mehr mit seinen bisherigen Werten — Zuweisung, Sichtbarkeit, Belegtypen, Shopkunde und Makros. Der Abschnitt trägt dazu ein Warnzeichen.

So wird der Kanal umgezogen:

  1. Den neuen Kanal in der Auswahl wählen und mit den bisherigen Werten einrichten.
  2. Den alten Eintrag mit Entfernen löschen.
  3. Einmal alle Artikel exportieren — erst dann sind sie im neuen Kanal sichtbar.

Bis dahin überträgt der Artikelexport die Artikel ohne Sichtbarkeit im fehlenden Kanal und nennt im Protokoll, was zu tun ist. Fehlen alle eingerichteten Kanäle, bricht er ab und setzt beim nächsten Lauf fort.

Nächster Schritt

Zahlungs- und Versandarten zuordnen

Zahlungs- und Versandarten

Damit eine Bestellung als Beleg entstehen kann, muss FINN.ghost wissen, welche Zahlungsbedingung und welche Lieferbedingung der SelectLine zu einer Zahlungsart und Versandart im Shop gehört. Beide Bereiche listen dazu die im Shop eingerichteten Möglichkeiten auf und stellen jeder Zeile die SelectLine-Auswahl gegenüber.

Bereich Zahlungsbedingungen in den Einstellungen

Zahlungsbedingungen

Zu jeder Shopware-Zahlungsart gibt es fünf Spalten.

SelectLine

Die Zahlungsbedingung, die in den Beleg geschrieben wird.

Bankbezug

Die Kasse oder Bank, die als Bankbezug im Beleg gesetzt wird. Erleichtert später den Zahlungsabgleich in der Buchhaltung.

Import

Normalerweise werden nur Bestellungen übernommen, deren Zahlung im Shop bestätigt ist. Zahlungsarten wie Rechnung oder Nachnahme erreichen diesen Zustand nie — für sie wird dieser Haken gesetzt, damit die Bestellung trotzdem importiert wird.

Ohne diesen Haken bleiben Rechnungs- und Nachnahmebestellungen unbemerkt im Shop liegen. Nach dem Einrichten neuer Zahlungsarten im Shop sollte man diese Spalte deshalb immer prüfen.

Vorkasse

Bestellungen dieser Zahlungsart gehen in den Belegtyp Vorkasse statt in den Bestell-Belegtyp. Sobald die Zahlung in der SelectLine als eingegangen verbucht ist, meldet FINN.ghost die Bestellung im Shop als bezahlt.

Eine Vorkasse-Bestellung, die vollständig mit einem Gutschein bezahlt wurde und damit einen Gesamtbetrag von 0,00 hat, wandert automatisch in den normalen Bestell-Belegtyp.

Referenz

Ist dieser Haken gesetzt, wird eine Bestellung nicht importiert, wenn sich keine Zahlungsreferenz des Zahlungsdienstleisters ermitteln lässt. Sinnvoll dort, wo die Referenz für den Zahlungsabgleich zwingend gebraucht wird.

Bleibt die Referenz dauerhaft aus, wiederholt sich der Fehler bei jedem Lauf und die Bestellung kommt nicht in die SelectLine. Den Haken deshalb nur bei Zahlungsarten setzen, die verlässlich eine Referenz liefern.

Erkannt werden die Referenzen der üblichen Zahlungsdienstleister — unter anderem Mollie, PayPal, Klarna, Adyen und Stripe. Bei PayPal Rechnungskauf werden zusätzlich die Bankdaten für die Überweisung in den Kopftext des Belegs geschrieben, sodass sie auf dem SelectLine-Dokument erscheinen.

Lieferbedingungen

Hier wird jeder Versandart des Shops eine Lieferbedingung der SelectLine zugeordnet. Diese Zuordnung wird an zwei Stellen verwendet: im Beleg und beim Anlegen neuer Kunden.

Diese Zuordnung ist Pflicht. Ist sie nicht gepflegt, wird gar keine Bestellung importiert.

Versand- und Rabattartikel

Nicht jede Position einer Bestellung entspricht einem Artikel aus der SelectLine. Versandkosten, Rabatte und Gutscheine brauchen deshalb Platzhalterartikel, die unter Shopware 6 → Einstellungen → Zuordnung hinterlegt werden.

Versandartikel

Auf diesen Artikel werden die Versandkosten gebucht.

Versandartikel (ermäßigt)

Wird verwendet, wenn der überwiegende Warenwert der Bestellung dem ermäßigten Steuersatz unterliegt. Bleibt das Feld leer, gilt in beiden Fällen der normale Versandartikel.

Promotion Artikel

Auf diesen Artikel werden Rabatte und Promotion-Positionen aus dem Shop gebucht.

Ist kein Promotion-Artikel hinterlegt, werden Rabattpositionen stillschweigend übersprungen — der Beleg in der SelectLine ist dann teurer als die Bestellung im Shop. Das ist die häufigste Ursache für Betragsabweichungen zwischen Shop und SelectLine.

Gutschein Artikel

Über diesen Artikel werden Gutscheine verbucht. Näheres unter Gutscheine.

Nächster Schritt

Weitere Sprachen

Weitere Sprachen

Betreibt der Shop mehr als eine Sprache, überträgt FINN.ghost die Fremdbezeichnungen aus der SelectLine mit. Dazu muss unter Shopware 6 → Einstellungen → Fremdsprachen festgelegt werden, welche SelectLine-Sprache zu welcher Shop-Sprache gehört.

Bereich Fremdsprachen in den Einstellungen

Die Sprachkennung links ist die, die in der SelectLine an den Fremdbezeichnungen hängt. Rechts stehen die im Shop eingerichteten Sprachen.

Was übersetzt wird

Objekt Quelle in der SelectLine Im Shop
Artikel Fremdbezeichnungen zum Artikel Bezeichnung, Beschreibung, Bestelltext
Artikel (SEO) Extrafelder je Sprache Seitentitel, Meta-Beschreibung, Suchbegriffe
Kategorien Fremdbezeichnungen zur Artikelgruppe Name und Beschreibung
Sachmerkmale Fremdbezeichnungen zum Sachmerkmal Bezeichnung der Eigenschaft

Für die SEO-Felder je Sprache werden Extrafelder mit der Sprachkennung am Ende verwendet. Heißt das Feld für den Seitentitel _METATITLE, so gilt _METATITLE_EN für die englische Fassung.

Fehlt zu einem Zusatzfeld die Übersetzung, wird der deutsche Wert in die Fremdsprache übernommen. Im Shop stehen dadurch nie leere Felder, nur weil eine Sprache nicht vollständig gepflegt ist.

Was nicht übersetzt wird

Preise werden nicht je Sprache unterschieden, sondern über Preisgruppen und Preisregeln abgebildet — siehe Preise. Auch Bilder, Kategorienzuordnung und Merkmalsstruktur sind sprachunabhängig.

Nächster Schritt

Erstinbetriebnahme

Erstinbetriebnahme

Die einzelnen Übertragungen bauen aufeinander auf. Ein Artikel braucht seine Kategorie, seine Merkmale und seine Zusatzfelder, bevor er sauber im Shop landen kann. Bei einem leeren Shop lohnt es sich daher, die Läufe einmal in dieser Reihenfolge von Hand anzustoßen, unter Shopware 6 → Zeitsteuerung.

Diese Reihenfolge gilt für die Erstbefüllung. Im laufenden Betrieb spielt sie keine Rolle mehr — dann zieht die Schnittstelle fehlende Merkmale, Hersteller und Preisregeln selbst nach.

Reihenfolge bei der Erstinbetriebnahme

Reihenfolge

1. Extrafelder exportieren

Legt im Shop die Zusatzfeld-Gruppen an, in denen später die SelectLine-Felder landen. Dieser Schritt muss zuerst laufen: An diesen Feldern hängt die Wiedererkennung von Kategorien und Herstellern, und die Preisregeln für Preis- und Rabattgruppen brauchen die Kundenfelder.

Läuft dieser Schritt nicht zuerst, bricht die Artikelübertragung mit einer Meldung über fehlende Zusatzfelder ab, und Kategorien werden bei jedem Lauf doppelt angelegt.

2. Steuerschlüssel exportieren

Nur nötig, wenn die Steuern je Land über die Erfolgskontengruppen abgebildet werden sollen — etwa beim OSS-Verfahren. Andernfalls überspringen; dann genügen die Standard-Steuersätze des Shops.

3. Merkmale exportieren und Sachmerkmale exportieren

Legt die Eigenschaften und ihre Ausprägungen im Shop an. Varianten brauchen sie, bevor der Hauptartikel übertragen werden kann.

4. Hersteller exportieren

Überträgt die Lieferanten, die an Artikeln als Hersteller eingetragen sind.

5. Artikelgruppen exportieren

Baut die Kategoriestruktur unter der eingestellten Hauptkategorie auf.

Dieser Schritt lässt sich nicht überspringen: Artikel brauchen eine Kategorie. Fehlt sie, wird der Artikel mit einer Meldung abgewiesen — es sei denn, es ist eine Default-Artikelgruppe hinterlegt.

6. Alle Artikel exportieren

Der große Lauf. Je nach Artikelanzahl und Bildmenge dauert er Stunden.

Für einen ersten Eindruck kann man stattdessen alle Artikel exportieren (ohne Bilder) starten — das ist deutlich schneller. Die Bilder holt der nächste Vollauf nach.

7. Alle Kunden exportieren

Überträgt die Kunden, bei denen das Kundenkennzeichen gesetzt ist.

8. Bestellungen importieren

Erst zum Schluss einschalten. Vorher fehlen im Shop die Artikel, auf die sich Bestellungen beziehen würden.

Danach

Wenn die Erstbefüllung durchgelaufen ist, werden die Aufgaben mit einem Zeitplan versehen. Empfehlungen dazu stehen unter Zeitplan der Übertragungen.

Kontrolle

Nach der Erstbefüllung lohnt ein Blick auf:

Prüfpunkt Wo
Anzahl der Artikel im Shop Shopware-Backend, verglichen mit den freigegebenen Artikeln
Kategoriebaum Shopware-Backend unter der Hauptkategorie
Preise an Stichproben Artikel im Shop aufrufen, Preis mit der SelectLine vergleichen
Meldungen im Protokoll Shopware 6 → Zeitsteuerung

Das Protokoll enthält auch Hinweise auf übersprungene Artikel. Diese Meldungen sind keine Fehler, sondern zeigen fehlende Angaben — die Liste ist eine gute Arbeitsgrundlage für die Datenpflege. Näheres unter Wenn etwas nicht im Shop ankommt.