> ## Documentation Index
> Fetch the complete documentation index at: https://help.mathership.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Sammel-Upload für Produkte
> Viele Lieferantenprodukte gleichzeitig aus einer CSV-Datei hochladen
# Sammel-Upload für Produkte
Mit dem Sammel-Upload für Produkte können Lieferanten viele Produkte gleichzeitig hinzufügen oder aktualisieren, indem sie eine CSV-Datei hochladen.
Nutzen Sie diese Funktion, wenn Sie einen größeren Produktkatalog importieren möchten, statt Produkte einzeln zu erstellen.
## Was ist der Sammel-Upload für Produkte?
Der Sammel-Upload liest Produktdaten aus einer CSV-Datei und erstellt oder aktualisiert Produkte für ein Lieferantenunternehmen.
Es können Produktinformationen importiert werden wie:
| Feld | Bedeutung |
| ------------------- | --------------------------------------- |
| Produktname | Name des Produkts |
| Produktnummer | Artikelnummer des Lieferanten |
| Verpackung | Verpackungs- oder Einheitenbeschreibung |
| Bestand | Optionale Bestandsmenge |
| Preis | Optionaler Produktpreis |
| Produktbeschreibung | Optionale Produktbeschreibung |
## Wer kann Produkte hochladen?
Der Sammel-Upload steht Lieferantenbenutzern zur Verfügung.
Ein Lieferant kann Produkte nur für sein eigenes Lieferantenunternehmen hochladen.
Lieferanten können keine Produkte in den Katalog eines anderen Lieferantenunternehmens hochladen.
## Erforderliche Upload-Datei
Der Upload muss eine CSV-Datei enthalten.
Wenn keine Datei bereitgestellt wird, wird der Upload abgelehnt.
## Feldzuordnung
Beim Upload muss Mathership wissen, welche CSV-Spalten zu welchen Produktfeldern gehören.
Dies wird Feldzuordnung genannt.
Erforderliche Zuordnungen sind:
| Zuordnungsfeld | Bedeutung |
| --------------- | ----------------------------------------- |
| product\_name | CSV-Spalte mit dem Produktnamen |
| packaging | CSV-Spalte mit der Verpackungsinformation |
| product\_number | CSV-Spalte mit der Artikelnummer |
Für Lieferanten-Uploads ist die Produktnummer erforderlich.
Optionale Zuordnungen können sein:
| Zuordnungsfeld | Bedeutung |
| -------------------- | -------------------------------------- |
| stock | CSV-Spalte mit der Bestandsmenge |
| price | CSV-Spalte mit dem Produktpreis |
| product\_description | CSV-Spalte mit der Produktbeschreibung |
## CSV-Trennzeichen
Mathership kann gängige CSV-Trennzeichen automatisch erkennen.
Unterstützte Trennzeichen sind:
* Semikolon
* Komma
* Tabulator
* Leerzeichen
Wenn das Trennzeichen nicht erkannt werden kann, verwendet Mathership ein Standard-CSV-Format.
## Produkte erstellen und aktualisieren
Der Sammel-Upload kann neue Produkte erstellen oder bestehende Produkte aktualisieren.
| Situation | Ergebnis |
| -------------------------------------------------------------- | -------------------------------------------------------- |
| Produktnummer ist neu | Ein neues Produkt wird erstellt |
| Produktnummer existiert bereits für das Lieferantenunternehmen | Das bestehende Produkt wird aktualisiert |
| Produktnummer fehlt | Produkt wird mit Platzhalter ohne Produktnummer erstellt |
So können Lieferanten einen bestehenden Katalog aktualisieren, ohne jedes Produkt manuell zu bearbeiten.
## Umgang mit Produktnummern
Die Produktnummer wird verwendet, um bestehende Produkte beim Upload zu identifizieren.
Wenn die CSV-Zeile eine gültige Produktnummer enthält, prüft Mathership, ob ein Produkt mit dieser Nummer bereits für das Lieferantenunternehmen existiert.
Wenn es existiert, wird das Produkt aktualisiert.
Wenn es nicht existiert, wird ein neues Produkt erstellt.
Halten Sie Produktnummern konsistent. Wenn Produktnummern geändert werden, können doppelte Produkte entstehen, statt bestehende Produkte zu aktualisieren.
## Umgang mit Bestand
Bestand ist optional.
Wenn keine Bestandsspalte zugeordnet ist oder der Wert leer ist, speichert Mathership den Bestand als 0.
Wenn der Bestandswert nicht als Zahl gelesen werden kann, speichert Mathership den Bestand ebenfalls als 0.
## Umgang mit Preisen
Preis ist optional.
Wenn keine Preisspalte zugeordnet ist oder der Wert leer ist, speichert Mathership den Preis als 0.
Wenn der Preiswert nicht als Zahl gelesen werden kann, speichert Mathership den Preis ebenfalls als 0.
## Produktbeschreibung
Eine Produktbeschreibung kann importiert werden, wenn eine Beschreibungsspalte zugeordnet ist.
Wenn keine Beschreibungsspalte zugeordnet ist, werden Produkte erstellt oder aktualisiert, ohne dieses optionale Beschreibungsfeld zu ändern.
## Upload-Ergebnis
Nach dem Upload gibt Mathership ein Ergebnis zurück mit:
| Ergebnisfeld | Bedeutung |
| -------------- | --------------------------------------------- |
| success\_count | Anzahl der erfolgreich verarbeiteten Zeilen |
| errors | Zeilen, die nicht verarbeitet werden konnten |
| row | CSV-Zeilennummer mit einem Problem |
| error | Grund, warum die Zeile fehlgeschlagen ist |
| data | Zeilendaten, die das Problem verursacht haben |
Dadurch wird es einfacher, die CSV-Datei zu korrigieren und erneut hochzuladen.
## Teilweiser Erfolg
Ein Sammel-Upload kann teilweise erfolgreich sein.
Das bedeutet, dass einige Zeilen erfolgreich importiert werden können, während andere Zeilen Fehler enthalten.
Wenn einige Zeilen fehlschlagen, prüfen Sie die Fehlerliste, korrigieren Sie die CSV-Datei und laden Sie die korrigierten Zeilen erneut hoch.
## Beispiel: Produktkatalog hochladen
Ein Lieferant möchte einen Katalog mit Artikelnummern, Namen, Verpackungen, Beständen und Preisen hochladen.
| CSV-Spalte | Zuordnungsfeld |
| ------------- | --------------- |
| Artikelnummer | product\_number |
| Artikelname | product\_name |
| Gebinde | packaging |
| Lagerbestand | stock |
| Preis | price |
Mathership erstellt oder aktualisiert anschließend die Produkte für dieses Lieferantenunternehmen.
## Beispiel: Preise aktualisieren
Ein Lieferant hat bereits Produkte in Mathership und möchte Preise aktualisieren.
| Schritt | Aktion |
| ------- | --------------------------------------------------------------- |
| 1 | CSV mit Produktnummern und Preisen exportieren oder vorbereiten |
| 2 | CSV hochladen |
| 3 | product\_number, product\_name, packaging und price zuordnen |
| 4 | Upload starten |
| 5 | Upload-Ergebnis prüfen |
Bestehende Produkte mit passenden Produktnummern werden aktualisiert.
## Beispiel: Bestandswerte hinzufügen
Ein Lieferant möchte Produkten Bestandsmengen hinzufügen.
| Schritt | Aktion |
| ------- | ----------------------------------------------------- |
| 1 | CSV mit Produktnummern und Bestandswerten vorbereiten |
| 2 | CSV hochladen |
| 3 | Bestandsspalte zuordnen |
| 4 | Upload starten |
| 5 | Importierte Zeilen und Fehler prüfen |
## Häufige Probleme
### Upload wird abgelehnt
Prüfen Sie, ob:
* Eine CSV-Datei ausgewählt wurde
* Eine Feldzuordnung angegeben wurde
* Erforderliche Felder zugeordnet sind
* Das Lieferantenunternehmen existiert
* Sie als richtiger Lieferant angemeldet sind
### Erforderliches Feld fehlt
Prüfen Sie, ob die CSV-Zeile Werte für alle erforderlichen zugeordneten Felder enthält.
Erforderliche Felder sind Produktname, Verpackung und Produktnummer.
### Produkt wurde doppelt erstellt
Das kann passieren, wenn die Produktnummer geändert wurde oder fehlte.
Verwenden Sie konsistente Artikelnummern, um bestehende Produkte zu aktualisieren.
### Bestand oder Preis ist 0
Das kann passieren, wenn:
* Die zugeordnete Spalte leer ist
* Der Wert nicht numerisch ist
* Die falsche CSV-Spalte zugeordnet wurde
### Einige Zeilen sind fehlgeschlagen
Der Sammel-Upload kann gültige Zeilen trotzdem importieren, auch wenn einige Zeilen fehlschlagen.
Prüfen Sie die zurückgegebenen Fehlerzeilen, korrigieren Sie die CSV-Datei und laden Sie sie erneut hoch.
## Best Practices
### Produktnummern konsistent verwenden
Produktnummern sind wichtig, um bestehende Produkte zu aktualisieren.
### CSV vor dem Upload prüfen
Stellen Sie sicher, dass erforderliche Spalten gefüllt sind und die Werte sauber sind.
### Klare Verpackungswerte verwenden
Verpackungen helfen Kunden zu verstehen, wie das Produkt bestellt werden kann.
### Mit kleinem Test-Upload beginnen
Testen Sie zuerst einige Zeilen, bevor Sie einen großen Katalog hochladen.
### Upload-Fehler prüfen
Prüfen Sie nach dem Upload immer die Fehlerliste, besonders bei größeren Dateien.
## Verwandte Seiten
Ein einzelnes Produkt manuell hinzufügen.
Produktinformationen nach dem Upload aktualisieren.
Produkte als verfügbar oder nicht verfügbar markieren.
Produktbilder nach dem Upload verwalten.
Definieren, wie Produkte verpackt und bestellt werden.
Verpackungsebenen aus Verpackungstext erzeugen.