Unter “Produkte” » “Artikel” lässt sich rechts über den Menüpunkt “Aktionen” der Artikel Import 2.0 öffnen, um Artikel aus der xlsx-Datei zu importieren.

Mit dem Import können neue Artikel hinzugefügt oder bestehende angepasst werden.

Open

Open

Globale Preisstaffeln

Es können Globale Preisstaffeln importiert werden.
Dazu werden die Datenblätter “globale_preisstaffel” und “global_price” benötigt.

Um eine neue Preisstaffel anzulegen wird bei “globale_preisstaffel.id” der Präfix “new-” verwendet und dann eine beliebe Zahl. Beispiel: new-1

Um die Preisstaffel mit einem Artikel zu verknüpfen, muss im Datenblatt “article” in der Spalte “article.globale_preisstaffel_id” dann auch die ausgewählte ID der Preisstaffel eingetragen werden.
In diesem Beispiel: new-1

Preise der globalen Preisstaffel werden über das Datenblatt “global_price” importiert.
Hier wird in der Spalte “article_price.price_articleid” die ausgewählte ID eingetragen.
In diesem Beispiel: new-1

Modul: Reseller Api (Dropshipping)

Wenn das Modul “Reseller API (Dropshipping)” aktiv ist, kann für einen Preis eine Reseller-Konfiguration, anhand von Shop-ID, Benutzergruppen-ID, Reseller-Dienstleister, Quantity-ID und Shipping Type, importiert werden.

Dazu werden im Datenblatt “global_price” folgende Spalten ergänzt:

Wenn die nötigen Informationen eingetragen sind und eine Konfiguration dazu ermittelt werden kann, wird die Konfiguration direkt für den Mengeneintrag hinterlegt.

Reseller-Artikel-Import

Reseller-Artikel können vollständig über den Artikel-Import angelegt werden.

Dazu müssen im Datenblatt article zusätzliche Spalten definiert werden.

Pflichtfelder für Reseller-Artikel

Optionale Felder

Wenn alle erforderlichen Reseller-Felder gesetzt sind:

• wird automatisch ein Reseller-Artikel erstellt

• alle verfügbaren Mengen werden übernommen

Überschreibbare Artikel-Felder

Die folgenden Felder können optional gesetzt werden, um den automatisch erzeugten Artikel zu überschreiben:

Open

Hinweis zum ignorieren

Hat die erste Spalte einen Kommentar in der Kopfzeile, wird diese Spalte beim Import ignoriert.

Deshalb ist es wichtig, den Kommentar aus dem Export an der Spaltenbezeichnung bei den weiteren Arbeitsmappen zu belassen, oder die ganze Spalte zu löschen.

Datensätze löschen

Beschreibung

Über den Artikel-Import 2.0 im Sitemanager können nicht nur Artikel und zugehörige Daten angelegt oder aktualisiert, sondern auch gezielt gelöscht werden. Das Löschen erfolgt direkt in derselben Excel-/CSV-/ZIP-Datei, mit der auch importiert wird -- über eine zusätzliche Spalte delete.

Typischer Einsatzzweck: Kunden möchten in einem einzigen Import-Lauf bestehende Artikel, Preise, Optionen oder Tags entfernen, ohne die Datensätze einzeln im Backend löschen zu müssen.

So wird gelöscht

Spalte delete einfügen

In dem Sheet (Tabellenblatt), aus dem Datensätze gelöscht werden sollen, muss eine zusätzliche Spalte mit dem Header delete eingefügt werden.

Pflichtfeld id

Damit eine Zeile gelöscht werden kann, muss die id des bestehenden Datensatzes in derselben Zeile gesetzt sein. Ohne id wird der delete-Flag ignoriert -- der Import behandelt die Zeile dann als Neuanlage (sofern article_desc o.ä. gefüllt ist).

Verhalten der übrigen Spalten

In einer Zeile mit delete = 1 werden alle anderen Spaltenwerte ignoriert. Es ist daher unerheblich, ob z.B. article_desc oder price gefüllt sind -- es zählt nur die id und der delete-Flag.

Beispiel: Sheet article

→ Die Artikel mit id = 123 und id = 124 werden gelöscht.
→ Die letzte Zeile (id = 125 leer) wird aktualisiert.

Unterstützte Sheets

Die delete-Konvention funktioniert in allen folgenden Sheets des Imports:

Hinweis: Auch der Benutzerimport unterstützt dieselbe Konvention (Spalte delete = 1).

Schritt-für-Schritt-Anleitung (Admin)

1. Bestehenden Export erzeugen -- Im Backend einen Export der zu bearbeitenden Daten herunterladen, damit die korrekten id-Werte vorliegen.

2. Spalte delete ergänzen -- In der Excel-Datei rechts hinten eine neue Spalte mit dem Header delete einfügen.

3. Werte setzen -- In den Zeilen, die gelöscht werden sollen, in der Spalte delete den Wert 1 eintragen. Die Spalte id muss in derselben Zeile bereits gefüllt sein.

4. Datei speichern -- Als .xlsx, .xls, .csv oder gepackt als .zip.

Schlagworte (article_tags)

Schlagworte werden über das Datenblatt {{article_tags}} importiert. Jede Zeile enthält genau ein Schlagwort -- ein Artikel mit fünf Schlagworten belegt also fünf Zeilen.

Spalten

Die erste Spalte des Datenblatts ("Artikel - Artikelname") stammt aus dem Export und wird beim Import ignoriert, siehe [#Hinweis zum ignorieren]. Sie dient nur der Orientierung, damit zu jeder Zeile erkennbar ist, zu welchem Artikel sie gehört.

Anlegen, Ändern, Löschen

• Neues Schlagwort: {{article_tags.id}} leer lassen, {{article_tags.article_id}} und {{article_tags.tag}} füllen.

• Schlagwort ändern: {{article_tags.id}} des bestehenden Eintrags setzen und das gewünschte Schlagwort in {{article_tags.tag}} eintragen.

• Schlagwort löschen: Spalte {{delete}} mit dem Wert {{1}} ergänzen, {{article_tags.id}} muss gefüllt sein -- siehe [#Datensätze löschen].

Mehrere Schlagworte in einer Zelle

Das Komma ist das Trennzeichen für Schlagworte. Enthält eine Zelle eine Liste, etwa {{Sommer, Aktion, 2026}}, wird sie beim Import in einzelne Einträge zerlegt: Leerzeichen am Rand werden entfernt, leere Einträge verworfen und bereits vorhandene Schlagworte des Artikels nicht doppelt angelegt. Die ursprüngliche Zeile wird dabei ersetzt, ihre {{article_tags.id}} ändert sich also.

Bleibt {{article_tags.tag}} leer, während {{article_tags.id}} gesetzt ist, wird der Eintrag entfernt. Zum Löschen ist die Spalte {{delete}} trotzdem der vorgesehene Weg, weil sie im Import-Protokoll erscheint und schon in der Analyse als Warnung angekündigt wird.

Umfang des Datenblatts

Da jede Zeile ein Schlagwort abbildet, wächst das Datenblatt mit der Zahl der Artikel deutlich an. Für gezielte Änderungen empfiehlt es sich, in Excel über die Spalte "Artikel - Artikelname" oder {{article_tags.article_id}} zu filtern und nur die benötigten Zeilen zu bearbeiten. Nicht benötigte Zeilen können aus der Datei gelöscht werden -- der Import verarbeitet ausschließlich die enthaltenen Zeilen und lässt alle übrigen Schlagworte unverändert.

Wichtige Hinweise

• Die Spalte delete ist nicht Teil des Standard-Exports und muss manuell in der Datei ergänzt werden.

• Wert muss 1 sein (nicht x, ja, true o.ä.). Andere Werte werden ignoriert.

• Ohne id wirkt delete = 1 nicht. Das ist Absicht, damit nicht versehentlich neue, leere Datensätze ein Lösch-Verhalten triggern.

• Das Löschen ist endgültig -- es erfolgt direkt auf der Datenbank, es gibt keinen Papierkorb.

• Reihenfolge der Sheets: Beim Import werden zuerst globale_preisstaffel, dann global_price, dann article verarbeitet. Wenn ein Artikel gelöscht wird, sollten zugehörige Preise nicht zusätzlich in einem article_price-Sheet referenziert werden.

• Mehrsprachigkeit: Wird der Import mit Sprachfilter ausgeführt, gilt das Löschen trotzdem für den gesamten Datensatz, nicht nur für die ausgewählte Sprachvariante.

Häufige Fehler & Troubleshooting (FAQ)

F: Ich habe delete = 1 gesetzt, aber der Datensatz wurde nicht gelöscht.
A: Prüfen, ob die Spalte id in derselben Zeile mit der korrekten Datensatz-ID gefüllt ist. Ohne id wird die Zeile als Neuanlage interpretiert.

F: In meiner Excel-Datei steht 1, aber es passiert nichts.
A: Sicherstellen, dass die Header-Zeile exakt delete heißt (Leerzeichen davor/danach vermeiden). Der Vergleich ist case-insensitive, aber Leerzeichen werden nicht ignoriert.

F: Kann ich true oder x statt 1 verwenden?
A: Nein. Der Import vergleicht strikt auf den Wert '1'. Andere Werte werden als "nicht löschen" gewertet.

F: Wie sehe ich vorher, was gelöscht wird?
A: Beim Hochladen läuft zunächst eine Analyse. Diese gibt für jede Zeile mit id und delete = 1 eine Warnung mit Code 224 aus ("Item with id "X" will deleted after import").

F: Wo finde ich nach dem Import, was gelöscht wurde?
A: Im Import-Ergebnis-Log erscheinen Einträge mit Code 103 der Form "Delete Article: <article_desc>". Zusätzlich wird der Lauf in den Monolog-Channel ArticleImport geschrieben.

F: Funktioniert das Löschen auch für Artikel-Optionen, Preise, Tags?
A: Ja, in allen unter Unterstützte Sheets aufgeführten Sheets funktioniert die Spalte delete identisch.

F: Werden auch verknüpfte Daten (z.B. Kategorie-Zuordnungen, Vorschaubilder) gelöscht?
A: Ja, beim Löschen eines Artikels werden auch die Einträge in category_product_index und die zugehörigen Vorschaubilder mitentfernt.

Technische Referenz (für Entwickler / KI-Chatbot)