# Varianten

Variantenartikel der SelectLine werden auf das Variantensystem von Shopify abgebildet:
Der Variantenartikel wird das Produkt, die einzelnen Varianten werden dessen Varianten.
Die Merkmale werden zu Shopify-Optionen.

<!-- TODO Screenshot: images/artikel-varianten-storefront.png -->

## Voraussetzungen

| Voraussetzung                    | Hinweis                                                    |
| -------------------------------- | ---------------------------------------------------------- |
| höchstens 3 Merkmale              | Grenze von Shopify                                           |
| Merkmale an der Variante gepflegt | eine Variante ohne Merkmale wird übersprungen                 |
| Variante freigegeben und aktiv    | nur freigegebene, nicht inaktive Varianten kommen mit           |
| Preis je Variante                 | eine Variante ohne Preis wird übersprungen                     |

<p class="callout danger">Bei mehr als drei Merkmalen wird der gesamte Variantenartikel abgewiesen und gar nicht angelegt. Im Protokoll steht der Hinweis, dass der Artikel mehr als 3 Merkmale hat.</p>

## Immer über den Hauptartikel

Einzelne Varianten lassen sich nicht für sich übertragen. Ändert man eine Variante,
überträgt die Schnittstelle automatisch den Hauptartikel mit **allen** Varianten neu.

<p class="callout info">Das ist eine Eigenschaft der Shopify-Schnittstelle: Ein Produkt wird mit seiner vollständigen Variantenliste geschrieben. Deshalb dauert die Übertragung eines Variantenartikels mit vielen Varianten deutlich länger als die eines Einzelartikels.</p>

## Was je Variante übertragen wird

| Im Shop                    | Aus der SelectLine                               |
| -------------------------- | ------------------------------------------------ |
| SKU                        | Artikelnummer der Variante                         |
| Barcode                    | EAN-Nummer                                        |
| Optionswerte               | Merkmalsausprägungen, nach Merkmal sortiert          |
| Preis und Streichpreis      | Preis bzw. Aktionspreis der Variante                 |
| Gewicht                    | Gewicht der Variante                                |
| Bild                       | erstes Bild der Variantenartikelnummer                |
| Metafelder                 | Extrafelder und Sachmerkmale der Variante             |
| Bestand                    | je Standort, siehe [Bestand](https://wiki.dako-it.com/books/finnghost-fur-shopify/page/bestand-und-verfugbarkeit)      |

<p class="callout info">Die Reihenfolge der Optionswerte ergibt sich aus der alphabetischen Sortierung der Merkmalsbezeichnungen. Größen erscheinen dadurch als <code>L, M, S, XL</code> statt <code>S, M, L, XL</code>. Die gewünschte Reihenfolge lässt sich im Shopify-Adminbereich am Produkt einstellen; sie wird von der Schnittstelle nicht überschrieben.</p>

## Entfallene Varianten

Wird eine Variante in der SelectLine inaktiv gesetzt oder die Freigabe entfernt, kommt
sie beim nächsten Lauf des Hauptartikels nicht mehr mit.

<p class="callout warning">Shopify entfernt die Variante dadurch nicht automatisch aus dem Produkt. Entfallene Varianten müssen im Shopify-Adminbereich gelöscht werden — solange sie dort stehen, bleiben sie mit ihrem letzten Bestand sichtbar.</p>

## Weiter

[Sachmerkmale und Extrafelder](https://wiki.dako-it.com/books/finnghost-fur-shopify/page/sachmerkmale-und-extrafelder)