# FINN.ghost für Shopware6

# Allgemein



# Feldzuordnung Artikel

Die Produktdaten von Shopware sind hier beschrieben: [<span style="color: rgb(0, 0, 0);">**LINK**</span>](https://developer.shopware.com/docs/v6.3/guides/integrations-api/admin-api/writing-entities/product-data.html)

#### <span style="color: rgb(0, 0, 0);">Zuordnung</span>

<table border="1" id="bkmrk-cmspageid-das-layout" style="font-family: var(--font-body); font-size: 14px; width: 100%; height: 1589.74px;"><colgroup><col style="width: 18.2371%;"></col><col style="width: 81.7761%;"></col></colgroup><tbody><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div>cmsPageId</div></div></td><td style="height: 29.8785px;">Das Layout des Produkt wird in den Einstellungen der Schnittstelle definiert. (Layout für Produkte)</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div>active</div></div></td><td style="height: 29.8785px;">Der Artikel muss ShopAktiv und darf nicht Inaktiv sein, um im Shop auf Aktiv geschalten zu werden.</td></tr><tr style="height: 52.2569px;"><td style="height: 52.2569px;"><div><div>stock</div></div></td><td style="height: 52.2569px;">Es wird der komplette Bestand des Artikels (Bestand - Reserviert) an das Feld Lagerbestand übermittelt. Alternativ kann dies in den <span style="text-decoration: underline;">[**Experteneinstellungen**](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/experteneinstellungen#bkmrk-lagerbestand-individ)</span> angepasst werden.</td></tr><tr style="height: 46.6667px;"><td style="height: 46.6667px;"><div><div>isCloseout</div></div></td><td style="height: 46.6667px;">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.</td></tr><tr style="height: 85.8333px;"><td style="height: 85.8333px;"><div><div>maxPurchase</div></div></td><td style="height: 85.8333px;">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 <span style="text-decoration: underline;">[**Experteneinstellung**](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/experteneinstellungen#bkmrk-maximalabnahme)</span> ist dies weiter individualisierbar.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div>taxId</div></div></td><td style="height: 29.8785px;">Es wird die taxId des Shops der entsprechenden Steuer der SelectLine zugewiesen.</td></tr><tr style="height: 46.6667px;"><td style="height: 46.6667px;"><div><div>markAsTopseller</div></div></td><td style="height: 46.6667px;">In den Einstellungen kann ein Boolean-Feld des Artikels definiert werden, welches als Kriterium für das Hervorheben im Shop herangezogen wird.</td></tr><tr style="height: 52.2569px;"><td style="height: 52.2569px;"><div><div>unitId</div></div></td><td style="height: 52.2569px;"><div><div>unitId, purchaseUnit und referenceUnit werden entsprechend gefüllt wenn die Funktion Grundpreis in den [<span style="text-decoration: underline;">**Einstellungen**</span>](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/einstellungen#bkmrk-grundpreis%3A-%3F%3F%3F) aktiviert wurde. </div></div></td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div>purchaseUnit</div></div></td><td style="height: 29.8785px;">siehe unitId</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div>referenceUnit</div></div></td><td style="height: 29.8785px;">siehe unitId</td></tr><tr style="height: 232.344px;"><td style="height: 232.344px;"><div><div><div><div>price</div></div></div></div></td><td style="height: 232.344px;">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

</td></tr><tr style="height: 46.6667px;"><td style="height: 46.6667px;"><div><div><div><div>parentId</div></div></div></div></td><td style="height: 46.6667px;">Variantenartikel werden mit ihren Merkmalen und Ausprägungen zum Shop hinzugefügt. Hierbei wird die Einstellung des Auffächerns berücksichtigt.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>options</div></div></div></div></td><td style="height: 29.8785px;">siehe parentId</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>configuratorSettings</div></div></div></div></td><td style="height: 29.8785px;">siehe parentId</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>variantListingConfig</div></div></div></div></td><td style="height: 29.8785px;">siehe parentId</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>name</div></div></div></div></td><td style="height: 29.8785px;">Die Bezeichnung des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>productNumber</div></div></div></div></td><td style="height: 29.8785px;">Die Artikelnummer des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>ean</div></div></div></div></td><td style="height: 29.8785px;">Die EAN des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>weight</div></div></div></div></td><td style="height: 29.8785px;">Das Gewicht des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>releaseDate</div></div></div></div></td><td style="height: 29.8785px;">Das AngelegtAm-Datum des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>manufacturerId</div></div></div></div></td><td style="height: 29.8785px;">Es wird die manufacturerId des Shops der entsprechenden Hersteller der SelectLine zugewiesen.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>manufacturerNumber</div></div></div></div></td><td style="height: 29.8785px;">Die Herstellerartikelnummer des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>customFields</div></div></div></div></td><td style="height: 29.8785px;">Die Extrafelder des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>properties</div></div></div></div></td><td style="height: 29.8785px;">Die Sachmerkmale des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>purchaseSteps</div></div></div></div></td><td style="height: 29.8785px;">Die Losgröße des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>minPurchase</div></div></div></div></td><td style="height: 29.8785px;">Die Losgröße des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>crossSellings</div></div></div></div></td><td style="height: 29.8785px;">Zubehör- und Alternativartikel des Artikels</td></tr><tr style="height: 35.4688px;"><td style="height: 35.4688px;"><div><div><div><div>categories</div></div></div></div></td><td style="height: 35.4688px;">Die Artikelgruppen des Artikels. Dies kann in den [<span style="text-decoration: underline;">**Einstellungen**</span>](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/zuordnung#bkmrk-gruppen%3A) konfiguriert werden.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>description</div></div></div></div></td><td style="height: 29.8785px;">Der Langtext des Artikels</td></tr><tr style="height: 35.4688px;"><td style="height: 35.4688px;"><div><div><div><div>deliveryTimeId</div></div></div></div></td><td style="height: 35.4688px;">Die Lieferzeit des Artikels. Dies kann in den [<span style="text-decoration: underline;">**Einstellungen**</span>](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/zuordnung#bkmrk-lieferzeiten%3A) konfiguriert werden.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>packUnit</div></div></div></div></td><td style="height: 29.8785px;">Die Mengeneinheit des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>width</div></div></div></div></td><td style="height: 29.8785px;">Wenn das Extrafeld \_DIMBREITE existiert. Wird er Wert als Breite übertragen.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>height</div></div></div></div></td><td style="height: 29.8785px;">Wenn das Extrafeld \_DIMHOEHE existiert. Wird er Wert als Höhe übertragen.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>length</div></div></div></div></td><td style="height: 29.8785px;">Wenn das Extrafeld \_DIMLAENGE existiert. Wird er Wert als Länge übertragen.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>metaTitle</div></div></div></div></td><td style="height: 29.8785px;">Wenn das Extrafeld \_METATITLE existiert. Wird er Wert als SEO-Metatitel übertragen.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>metaDescription</div></div></div></div></td><td style="height: 29.8785px;">Wenn das Extrafeld \_METADESCRIPTION existiert. Wird er Wert als SEO-Metabeschreibung übertragen.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div>keywords</div></div></div></div></td><td style="height: 29.8785px;">Wenn das Extrafeld \_METAKEYWORD existiert. Wird er Wert als SEO-Keywords übertragen.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div><div><div>translations</div></div></div></div></div></div></td><td style="height: 29.8785px;">Die Übersetzungen des Artikels (Bezeichnung und Beschreibung). Dies kann in den [<span style="text-decoration: underline;">**Einstellungen**</span>](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/fremdsprachen) konfiguriert werden.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div><div><div>media</div></div></div></div></div></div></td><td style="height: 29.8785px;">Bilder des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div><div><div><div><div>cover</div></div></div></div></div></div></div></div></td><td style="height: 29.8785px;">Erste Bild des Artikels</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;"><div><div><div><div><div><div><div><div><div><div>visibilities</div></div></div></div></div></div></div></div></div></div></td><td style="height: 29.8785px;">Der Verkaufskanel des Artikels kann ein den [<span style="text-decoration: underline;">**Einstellungen**</span>](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/zuordnung#bkmrk-verkaufskanal%3A) konfiguriert werden.</td></tr></tbody></table>

# Einstellungen



# Shopdaten

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/image.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/image.png)

</td></tr></tbody></table>

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 -&gt; System -&gt; Integrationen.**

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-08/scaled-1680-/image.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-08/image.png)

</td></tr></tbody></table>

# Makros

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/tiHimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/tiHimage.png)

</td></tr></tbody></table>

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 <span style="text-decoration: underline; background-color: rgb(255, 255, 255); color: rgb(53, 152, 219);">[hier](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/makros "Makros")</span>

# Einstellungen

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/iSJimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/iSJimage.png)

</td></tr></tbody></table>


#### Maximale Bildgröße

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

<p class="callout info">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](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/selectline-einstellungen#bkmrk-finn.ghost-1).</p>


#### 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.

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2022-09/scaled-1680-/CXtimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2022-09/CXtimage.png)</td></tr></tbody></table>



#### 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.

<table border="1" id="bkmrk--3" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/Cegimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/Cegimage.png)

</td></tr></tbody></table>

<p class="callout info">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.</p>

#### 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.

<table border="1" id="bkmrk--4" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2022-09/scaled-1680-/qzUimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2022-09/qzUimage.png)</td></tr></tbody></table>


#### 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.

<p class="callout danger">Diese Funktion sollte ausschließlich bei B2B- Systemen verwendet werden. Bei B2C-Systemen könnte die Einhaltung der Europäischen Datenschutzverordnung gefährdet sein.</p>



#### <span style="background-color: rgb(255, 255, 255);">Grundpreis</span>

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.

<table border="1" id="bkmrk--9" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2022-09/scaled-1680-/nGvimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2022-09/nGvimage.png)

</td></tr></tbody></table>

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

<p class="callout info">Wie Grundpreise mit freien Feldern erstellt werden, können sie **<span style="text-decoration: underline;">[hier](https://wiki.dako-it.com/books/selectline-wawi-individuelle-anpassungen/page/referenzmengengrundpreise-in-webshops-abbilden)</span>** nachlesen.</p>

<p class="callout info">Grundpreise auf Basis der Mengenumrechnung sind **[hier](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/experteneinstellungen#bkmrk-%C2%A0-3)** 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.</p>



#### Listenpreis als Streichpreis

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

<table border="1" id="bkmrk--11" style="border-collapse: collapse; width: 68.8889%;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2022-09/scaled-1680-/XD9image.png)](https://wiki.dako-it.com/uploads/images/gallery/2022-09/XD9image.png)</td></tr></tbody></table>

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.

<table border="1" id="bkmrk--12" style="border-collapse: collapse; width: 83.4568%;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2022-09/scaled-1680-/ryWimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2022-09/ryWimage.png)</td></tr></tbody></table>

<p class="callout success">Damit alle Daten im Shopware-Shop auf dem geänderten Stand sind müssen alle Artikel neu übertragen werden.</p>

#### <span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Bestell-E-Mails versenden</span>

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.

<p class="callout info">Diese Option aktiviert die E-Mail Funktion in Shopware.</p>

#### 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

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/n4iimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/n4iimage.png)

</td></tr></tbody></table>

#### 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.

<p class="callout info">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. </p>


#### Belegtyp Rechnung

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

#### <span style="background-color: rgb(255, 255, 255);">Archiv Druckvorlagen Rechnungsversand</span>

<span style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">Hier kann aus verschiedenen Formaten eine Archiv-Druckvorlage ausgewählt werden.</span>

#### <span style="background-color: rgb(255, 255, 255);">Verkaufskanal</span>

<span style="background-color: rgb(255, 255, 255);">Unter diesem Punkt wird die Auswahl getroffen, auf welchem der eigenen Shopware- Verkaufskanäle die Daten zugeordnet werden sollen</span>

#### 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.

<p class="callout info">Die Auswahl steuert, welche Preisgruppe im Webshop standardmäßig angeboten wird. Die Schnittstelle FINN.ghost | Shopify erstellt selbstständig die erforderliche Preisregel in Shopware.</p>

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2022-09/scaled-1680-/MLAimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2022-09/MLAimage.png)</td></tr></tbody></table>

#### <span style="background-color: rgb(255, 255, 255);">Promotion Artikel</span>

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

#### <span style="background-color: rgb(255, 255, 255);">Gutschein Artikel</span>

<span style="background-color: rgb(255, 255, 255);">Die Schnittstelle unterstützt das Shopware-Plugin [<span style="color: rgb(0, 0, 0);">EasyCoupon.</span>](https://store.shopware.com/de/neti592129685981m/gutscheine-kaufgutscheine-coupons-easycoupon.html)  
</span>


#### <span style="background-color: rgb(255, 255, 255);">Versand Artikel</span>

<span style="background-color: rgb(255, 255, 255);">Die Versandkosten werden auf diesen Artikel gebucht.</span>

#### <span style="background-color: rgb(255, 255, 255);">Versand Artikel (ermäßigt)</span>

<span style="background-color: rgb(255, 255, 255);">Optional kann ein ermäßigter Versandartikel definiert werden. Ermäßigte Versandkosten werden dann auf diesen Artikel gebucht.</span>


#### <span style="background-color: rgb(255, 255, 255);">Shopkunde</span>

<span style="background-color: rgb(255, 255, 255);">Für Gastbestellungen wird der hier angegeben Kunde verwenden. Zusätzlich dient dieser Kunde als Vorlage für Neukunden.</span>

#### <span style="background-color: rgb(255, 255, 255);">Hauptartikelgruppe</span>

<span style="background-color: rgb(255, 255, 255);">Unter dieser Artikelgruppe im Shop wird der Artikelgruppenbaum aus der SelectLine angelegt.</span>

#### <span style="background-color: rgb(255, 255, 255);">Layout für Gruppen</span>

<span style="background-color: rgb(255, 255, 255);">Hier wird das Layout für die Artikelgruppen definiert.</span>

#### <span style="background-color: rgb(255, 255, 255);">Gruppen</span>

<span style="background-color: rgb(255, 255, 255);">Die Schnittstelle kann die Artikelgruppen der SelectLine auf 3 verschiedenen Möglichkeiten verarbeiten.</span>

<table border="1" id="bkmrk-standard-er-werden-d" style="border-collapse: collapse; width: 100%; height: 112.014px;"><colgroup><col style="width: 11.09%;"></col><col style="width: 88.9253%;"></col></colgroup><tbody><tr style="height: 29.8785px;"><td style="height: 29.8785px;">Standard</td><td style="height: 29.8785px;">Er werden die Gruppen wie in der SelectLine angelegt.</td></tr><tr style="height: 52.2569px;"><td style="height: 52.2569px;">Alternativ</td><td style="height: 52.2569px;">Es kann in der SelectLine eine alternative Gruppenstrucktur für den Shop angelegt werden. (siehe [<span style="color: rgb(0, 0, 0);">**Shopartikelgruppen**</span>](https://wiki.dako-it.com/books/selectline-wawi-individuelle-anpassungen/page/shop-artikelgruppen))</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;">Kombiniert</td><td style="height: 29.8785px;">Es wird im Shop eine Kombination aus Standard und Alternativ angelegt.</td></tr></tbody></table>

#### <span style="background-color: rgb(255, 255, 255);">Default-Artikelgruppe (falls in SelectLine keine gesetzt)</span>

<span style="background-color: rgb(255, 255, 255);">Sollte dem Artikel in der SelectLine keine Artikelgruppen zugewiesen sein, so wird im Shop eine Standard-Artikelgruppen zugewiesen.</span>


#### <span style="background-color: rgb(255, 255, 255);">Immer Default-Artikelgruppe verwenden</span>

<span style="background-color: rgb(255, 255, 255);">Es wird immer die Standardartikelgruppe für neu hochgeladene Artikel verwendet.</span>

#### <span style="background-color: rgb(255, 255, 255);">Gruppen zu ignorieren</span>

<span style="background-color: rgb(255, 255, 255);">Hier können Artikelgruppen aus der SelectLine definiert werden, welche ignoriert werden sollen. Diese werden nicht zum Shop übertragen.</span>

#### 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 [<span style="text-decoration: underline;">**aufgefächert**</span>](https://docs.shopware.com/de/shopware-6-de/kataloge/produkte#varianten) 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 [<span style="text-decoration: underline;">**hervorgehoben**</span>](https://docs.shopware.com/de/shopware-6-de/kataloge/produkte#informationen) wird.

# Zahlungsbedingungen

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/3j7image.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/3j7image.png)

</td></tr></tbody></table>

#### Spalten

<table border="1" id="bkmrk-shopware-der-name-de" style="border-collapse: collapse; width: 100%; height: 229.636px;"><colgroup><col style="width: 11.3259%;"></col><col style="width: 88.6873%;"></col></colgroup><tbody><tr style="height: 29.8785px;"><td style="height: 29.8785px;">Shopware</td><td style="height: 29.8785px;">Der Name der Zahlungsbedingung im Shop.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;">SelectLine</td><td style="height: 29.8785px;">Der Name der Zahlungsbedingung in der SelectLine.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;">Bankbezug</td><td style="height: 29.8785px;">Der zuverwendene Bankbezug in der SelectLine.</td></tr><tr style="height: 63.4549px;"><td style="height: 63.4549px;">Import</td><td style="height: 63.4549px;">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.</td></tr><tr style="height: 46.6667px;"><td style="height: 46.6667px;">Vorkasse</td><td style="height: 46.6667px;">Wenn diese Einstellung aktiviert ist, werden Bestellungen mit diesen Zahlungsbedingungen dem Vorkasse-Beleg zugeordnet welcher unter den [<span style="color: rgb(0, 0, 0);">**Zuordnungen**</span>](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/zuordnung) definiert wurde.</td></tr><tr style="height: 29.8785px;"><td style="height: 29.8785px;">Referenz</td><td style="height: 29.8785px;">Ist dieser Haken aktiv, muss die Bestellung eine Zahlungsreferenz besitzen. Ist dies nicht der Fall, wird ein Fehler ausgelöst.</td></tr></tbody></table>

# Lieferbedingung

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/vO8image.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/vO8image.png)

</td></tr></tbody></table>

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

# Fremdsprachen

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/FEBimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/FEBimage.png)

</td></tr></tbody></table>

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:

```json
{
  ...
  "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:

```json
{
  ...
  "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.

```json
{
  ...
  "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.

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-06/scaled-1680-/nT0image.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-06/nT0image.png)

</td></tr></tbody></table>

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

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

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

<table border="1" id="bkmrk-%C2%A0-darstellung-im-sho" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-06/scaled-1680-/ayJimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-06/ayJimage.png)

Darstellung im Shop:

[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-06/scaled-1680-/d5Qimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-06/d5Qimage.png)

</td></tr></tbody></table>

#### Mapping von Feldern bei Artikeln

```json
{
  ...
  "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:

- alle Extrafelder
- ArtikelId
- Zusatz
- Matchcode
- <div>FreierText1</div>
- <div>FreierText2</div>
- <div>FreieZahl1</div>
- <div>FreieZahl2</div>
- <div>FreieZahl3</div>
- <div>FreieZahl4</div>
- <div>FreiesDatum1</div>
- <div>FreiesDatum2</div>
- <div>FreiesKennzeichen1</div>
- <div>FreiesKennzeichen2</div>
- <div>FreiesKennzeichen3</div>
- <div>DimensionsText</div>
- <div>InfoText</div>
- <div>BestellText</div>

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:

<p class="callout info">*\_METATITLE (Text 70)*  
*\_METADESCRIPTION (Text 160)*  
*\_METAKEYWORD (Text 255)*</p>

#### 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:

<p class="callout info">*\_SW6ABVERKAUF (logisch)*</p>

<div id="bkmrk--1"></div>
#### 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.

<span style="text-decoration: underline;">Beispiel für Englisch:</span>  
\_METATITLE\_E  
\_METADESCRIPTION\_E  
\_METAKEYWORD\_E

Zusätzlich muss die SL-Sprache noch der ISO-Sprache aus Shopware zugeordnet werden. Siehe: <span style="text-decoration: underline;">**[Fremdsprachen](https://wiki.dako-it.com/books/finnghost-fur-shopware6-EQO/page/fremdsprachen)**</span>

# Zeitsteuerung



# Zeitsteuerung konfigurieren

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2024-02/scaled-1680-/mtrimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2024-02/mtrimage.png)

</td></tr></tbody></table>

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

<p class="callout info">Grundlegende Infos zur Zeitsteuerung finden sie[ hier](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/grundlegende-infos-zur-zeitsteuerung).</p>