# Produktimport

Der Import lädt Produkte aus einer Tabelle: Er erstellt neue und aktualisiert vorhandene. Öffnen Sie den Shop, wählen Sie „Produkte“ und klicken Sie auf „Import“. Der Import steht dem Eigentümer des Projekts und Teammitgliedern mit dem Recht „Produkte und Kategorien“ zur Verfügung.

Einen Export des Katalogs in eine Datei gibt es im Shop nicht.

## Die Datei vorbereiten

Geeignet sind Tabellen im Format XLSX, ODS und CSV. Die erste Zeile enthält die Spaltenüberschriften, jede weitere Zeile ein Produkt. Die Spalten können beliebig heißen: Welche Spalte was bedeutet, geben Sie im zweiten Schritt an.

| Produktfeld | Was in der Zelle stehen muss |
|---|---|
| „Name“ | Der Name des Produkts. Pflichtfeld |
| „Preis“ | Eine Zahl in der Währung des Shops, zum Beispiel `1990,50` |
| „Alter Preis“ | Eine Zahl in der Währung des Shops |
| „Artikelnummer“ | Der Code des Produkts, bis zu 64 Zeichen |
| „Bestand“ | Eine nicht negative ganze Zahl. Eine leere Zelle bei einem neuen Produkt — der Bestand wird nicht erfasst |
| „Kategorie“ | Verschachtelung mit „/“, mehrere Kategorien getrennt durch „;“: `Sträuße / Rosen; Neuheiten` |
| „Beschreibung“ | Der Text der Beschreibung |
| „Foto“ | Links zu Fotos, getrennt durch Leerzeichen oder Komma |

Beispieltabelle:

| Name | Preis | Artikelnummer | Bestand | Kategorie | Foto |
|---|---|---|---|---|---|
| Strauß „Kamille“ | 1990 | RM-001 | 12 | Sträuße / Feldblumen | `https://example.com/romashka.jpg` |
| Glasvase | 850,50 | VZ-014 | 5 | Vasen; Neuheiten | `https://example.com/vaza.jpg` |

Was Sie über die Datei wissen sollten:

- **CSV.** Das Spaltentrennzeichen — Komma, Semikolon oder Tabulator — wird automatisch erkannt. Die Kodierung ist UTF-8 oder Windows-1251, in der das russische Excel speichert.
- **Kategorien.** Kategorien, die es noch nicht gibt, legt der Import selbst an. Ebenen unterhalb der dritten werden verworfen.
- **Fotos.** Die Plattform lädt die Fotos über die Links herunter — die Links müssen ohne Anmeldung erreichbar sein und mit `http://` oder `https://` beginnen. Formate: JPG, PNG, GIF, WebP.
- **Eigenschaften.** Spalten können in die Eigenschaften der Produkte geladen werden. Legen Sie die Eigenschaft vorher an — eine Spalte mit demselben Namen wird automatisch zugeordnet. Beim Typ „Mehrere aus Liste“ trennen Sie die Werte mit „;“, bei „Ja oder nein“ schreiben Sie „ja“, „nein“, 1 oder 0.
- **Optionen und Varianten** werden nicht per Tabelle geladen — Sie fügen sie in der Produktkarte hinzu.

## Hochladen

![Hochladen der Produktdatei](https://support.jetbot24.ru/_media/de/05-shop/_images/import-upload.webp?v=1791786050)

1. Ziehen Sie die Datei in den Bereich „Datei mit Produkten“ oder klicken Sie darauf und wählen Sie die Datei.
2. Wählen Sie im Schritt „Spalten zuordnen“ für jedes Produktfeld eine Spalte der Tabelle. Bekannte Spaltennamen ordnet die Plattform selbst zu. Ein Feld ohne Spalte — „Nicht importieren“. Unten zeigt der Block „Erste Zeilen“ zur Kontrolle den Anfang der Datei.
3. Wählen Sie darunter, im Block „Eigenschaften“, die Spalten für die Eigenschaften. Hier können Sie auch eine Eigenschaft anlegen — „Neue Eigenschaft“.
4. Wählen Sie, was geschehen soll, „Wenn das Produkt bereits existiert“:

   | Variante | Was passiert |
   |---|---|
   | „Als neu hinzufügen“ | Jede Zeile erstellt ein neues Produkt |
   | „Nach Artikelnummer aktualisieren“ | Ein Produkt mit dieser Artikelnummer wird aktualisiert, die übrigen Zeilen erstellen neue Produkte |
   | „Nach Name aktualisieren“ | Ein Produkt mit diesem Namen wird aktualisiert, die übrigen Zeilen erstellen neue Produkte |

5. Klicken Sie auf „Import starten“.

![Spaltenzuordnung beim Import](https://support.jetbot24.ru/_media/de/05-shop/_images/import-mapping.webp?v=1791786050)

Der Import läuft im Hintergrund. Auf der Seite sehen Sie die Zähler: „Zeilen verarbeitet“, „Produkte hinzugefügt“, „Produkte aktualisiert“, „Zeilen mit Fehlern“. Sie können die Seite schließen: Der Import läuft weiter. Öffnen Sie „Import“, während er läuft, sehen Sie seinen Fortschritt. Das Ergebnis wird nur auf der geöffneten Seite angezeigt — nachdem Sie sie verlassen haben, prüfen Sie das Ergebnis in der Produktliste. Ist der Import abgeschlossen, führt der Button „Zu den Produkten“ in den Katalog, „Weitere importieren“ zum Hochladen der nächsten Datei.

Unter den Zählern steht eine Tabelle mit den Spalten „Zeile“ und „Was ist falsch“: die Zeilennummern der Datei und die Gründe, aus denen eine Zeile nicht oder nicht vollständig geladen wurde.

![Ergebnis des Imports: Zähler und fehlerhafte Zeilen](https://support.jetbot24.ru/_media/de/05-shop/_images/import-result.webp?v=1791786050)

## So werden Produkte aktualisiert

- Leere Zellen löschen keine Produktdaten: Aktualisiert wird nur, was ausgefüllt ist.
- Kategorien aus der Datei kommen zu den vorhandenen Kategorien des Produkts hinzu.
- Fotos werden nur geladen, wenn das Produkt noch kein einziges Foto hat.
- Bei einem Produkt mit Varianten wird die Bestandsspalte übersprungen: Der Bestand wird pro Variante geführt.

> [!TIP]
> Um Preise und Bestände zu aktualisieren, laden Sie eine Tabelle mit den Spalten „Artikelnummer“, „Preis“ und „Bestand“ mit der Variante „Nach Artikelnummer aktualisieren“. Die Spalte für den Namen müssen Sie trotzdem angeben — ohne sie startet der Import nicht.

## Einschränkungen

- Ein Import verarbeitet höchstens 20 000 Zeilen.
- Ein Import lädt höchstens 10 000 Fotos herunter, für ein Produkt höchstens 50.
- Ein Shop hat höchstens 10 000 Produkte und 500 Kategorien: Zeilen über der Grenze landen bei den Fehlern.
- Ein Produkt hat höchstens 100 Eigenschaften.
- Die Fehlertabelle zeigt die ersten 100 Einträge.
- Es läuft immer nur ein Import gleichzeitig.

## Wenn etwas nicht funktioniert

| Meldung | Ursache |
|---|---|
| „Importiert werden können Tabellen im Format XLSX, ODS und CSV.“ | Die Datei hat ein anderes Format — zum Beispiel das alte XLS |
| „Die Datei konnte nicht gelesen werden. Speichern Sie die Tabelle als XLSX oder CSV.“ | Die Datei ist beschädigt oder fehlerhaft gespeichert |
| „Es läuft bereits ein Import. Bitte warten Sie, bis er abgeschlossen ist.“ | Der vorherige Import ist noch nicht abgeschlossen |
| „Um Produkte nach Artikelnummer zu finden, wählen Sie die Spalte mit der Artikelnummer.“ | „Nach Artikelnummer aktualisieren“ ist gewählt, aber für das Feld „Artikelnummer“ ist keine Spalte angegeben |
| „Der Produktname fehlt.“ | Der Name in der Zeile ist leer, und es wurde kein Produkt zum Aktualisieren gefunden |
| „Der Preis „…“ konnte nicht gelesen werden.“ | In der Preiszelle steht keine Zahl |
| „Der Bestand muss eine nicht negative ganze Zahl sein, nicht „…“.“ | In der Bestandszelle steht eine Dezimalzahl, eine negative Zahl oder Text |
| „Das Foto … konnte nicht hochgeladen werden.“ | Der Link öffnet sich nicht oder führt nicht zu einem Bild. Das Produkt wird trotzdem geladen — ohne dieses Foto |
| „Eigenschaft „…“: Der Wert „…“ passt nicht.“ | Der Wert passt nicht zum Typ der Eigenschaft. Das Produkt wird ohne ihn geladen |
| „Der Import wurde gestoppt: Der Autor darf den Katalog nicht mehr bearbeiten.“ | Dem Teammitglied, das den Import gestartet hat, wurde während des Imports das Recht „Produkte und Kategorien“ entzogen |
| „Der Import wurde durch einen Fehler unterbrochen. Bitte versuchen Sie es erneut.“ | Ein Fehler auf Seiten der Plattform. Starten Sie den Import neu — bereits geladene Zeilen aktualisieren Sie am besten nach Artikelnummer |