Marktkatalog --- CSV-Upload / -Download

Zuletzt aktualisiert: Aug 31, 2026Abschnitt: Integrationen

Verwenden Sie diesen Dashboard-Workflow, wenn Sie viele Katalogzeilen auf einmal bearbeiten möchten:

  1. Aktuellen Katalog als CSV exportieren
  2. Zeilen offline bearbeiten
  3. CSV zurück hochladen
  4. Erkannte Änderungen überprüfen
  5. Änderungen anwenden

Diese Seite beschreibt den Eigentümer-Dashboard-Ablauf (Bearer-Authentifizierung). Für die externe schreibgeschützte API-Nutzung mit X-API-Key siehe market-catalog-external-api{.interpreted-text role="doc"}.

Übersicht

Die MARKET-Integration hat einen eigenen Reiter:

  • Upload / Download in den Integrationsdetails
  • Export CSV lädt ein Roundtrip-CSV mit stabilen Headern herunter
  • Import CSV analysiert den Dateiinhalt zuerst (Vorschau) und wendet dann Erstellungs-/Aktualisierungsänderungen an

Aktueller Umfang:

  • Nur Produkte und Varianten
  • Fehlende Zeilen werden ignoriert (nicht archiviert)
  • Preislisten sind noch nicht Teil dieses CSV-Workflows

CSV-Vertrag

CSV-Header sind fest und geordnet:

row_type,product_id,variant_id,status,type_keys,tag_slugs,product_name,product_attributes_json,product_locales_json,variant_sort_order,variant_sku,variant_attributes_json,variant_locales_json

Wichtige Regeln:

  • row_type: product oder variant
  • product_id:
  • optional für neue Produktzeilen
  • erforderlich für Variantenzeilen
  • variant_id:
  • optional für neue Variantenzeilen
  • erforderlich zum Aktualisieren einer bestehenden Variantenzeile
  • type_keys verwendet | als Trennzeichen (für Produktzeilen)
  • tag_slugs verwendet | als Trennzeichen (für Produktzeilen)
  • *_attributes_json- und *_locales_json-Spalten müssen gültige JSON-Objektwerte enthalten, wenn sie gefüllt sind

Vorschau und Anwenden

Das Dashboard führt immer zuerst eine Vorschau durch:

  • validiert Zeilenstruktur und Domäneneinschränkungen
  • löst Zeilenaktion auf: created, updated, unchanged oder invalid
  • hebt geänderte Felder in der Vorschautabelle hervor
  • zeigt Zusammenfassungszähler

Standardmäßiger Vorschaufilter ist nur geänderte Zeilen. Sie können auf alle Zeilen umschalten.

Anwendungsphase:

  • erfordert ein Vorschau-Token aus der letzten Vorschauantwort
  • schlägt mit Konflikt fehl, wenn sich Daten geändert haben und das Token veraltet ist
  • wendet nur Erstellungs-/Aktualisierungsvorgänge an

Verhalten bei fehlenden Zeilen

Zeilen, die im Katalog existieren, aber in der hochgeladenen CSV fehlen, werden als missing in file gezählt und ignoriert:

  • keine automatischen ARCHIVED-Statusänderungen
  • keine Löschung

Best Practices

  • Starten Sie mit einem frischen Export vor der Bearbeitung
  • Behalten Sie IDs beim Aktualisieren bestehender Zeilen bei
  • Ändern Sie keine Spaltenreihenfolge oder -namen
  • Verwenden Sie UTF-8-CSV-Dateien
  • Pflegen Sie eine einzige Wahrheitsquelle für SKU-Werte (Variantenzeilen)

Weiterführende Lektüre

  • Externe Lese-API und API-Schlüssel-Berechtigungen: market-catalog-external-api{.interpreted-text role="doc"}
  • API-Schlüssel und Berechtigungen: OpenAPI https://api.mailoo.app/docs/v1
📚