---
title: Produkt-Verkaufskanäle ersetzen
description: So importieren Sie Produktzuweisungen zu Verkaufskanälen mit Sichtbarkeitssteuerung in Shopware 6, inklusive Ersetzungsmodus und Aktualisierungsmodus.
---

![](/images/image.png)

Mit dieser Funktion steuern Sie **vollständig, welchen Shopware Verkaufskanälen jedes Produkt zugewiesen ist** und wie sichtbar das Produkt in jedem Kanal beim Datenimport sein soll.

## Unterstützte Felder

**Verkaufskanal-Spalten**

- **salesChannel** - Liste von Verkaufskanal-UUIDs, optional jeweils mit Sichtbarkeitswert
- **salesChannelNames** - Liste von Verkaufskanalnamen, optional jeweils mit Sichtbarkeitswert

**Sichtbarkeitswerte**

- **10** - In Listings und Suche ausgeblendet, nur über direkten Link erreichbar
- **20** - In Listings ausgeblendet, in Suchergebnissen sichtbar
- **30** - In Listings und Suche sichtbar, Standardwert

## Beispiele für Datenformate

**CSV-Beispiel mit Kanalnamen**

```csv
productNumber, salesChannelNames
SW10001, Storefront:30
SW10002, Headless:20|Storefront:30
SW10003, Storefront
```

**CSV-Beispiel mit Kanal-IDs**

```csv
productNumber, salesChannel
SW10001, 019527ca391372d5a256adf8a79152a0:30
SW10002, 98432def39fc4624b33213a56b8c944d:20|019527ca391372d5a256adf8a79152a0:30
SW10003, 019527ca391372d5a256adf8a79152a0
```

**Mehrere Verkaufskanäle**

Verwenden Sie `|` (Pipe), um Einträge zu trennen:

```text
salesChannelNames
Headless:20|Storefront:30|API-Channel:10
```

## Importverhalten

**Replace Mode (aktiviert)**

![](/images/image%201.png)

- **Vollständiges Ersetzen** - Alle bestehenden Verkaufskanalzuweisungen für das Produkt werden entfernt.
- **Neue Zuweisung** - Nur die in der Importdatei angegebenen Kanäle werden zugewiesen.
- **Sichtbarkeit aktualisieren** - Wenn derselbe Kanal enthalten ist, wird seine Sichtbarkeit aktualisiert.

**Update Mode (deaktiviert)**

![](/images/image%202.png)

- **Bestehende beibehalten** - Bestehende Verkaufskanalzuweisungen bleiben unverändert.
- **Nur hinzufügen/aktualisieren** - Neue Kanäle werden hinzugefügt, bestehende werden aber nicht aktualisiert.
- **Keine Entfernung** - Kanäle, die nicht im Import aufgeführt sind, bleiben erhalten.

## Behandlung der Sichtbarkeit

- **Explizite Werte** - Verwenden Sie die Doppelpunkt-Schreibweise, zum Beispiel `Storefront:20`.
- **Standardsichtbarkeit** - Wenn kein Wert angegeben ist, wird die Sichtbarkeit auf **30** gesetzt, also voll sichtbar.
- **Gültiger Bereich** - Nur **10**, **20** und **30** werden akzeptiert.

## Regeln für das Datenformat

- **Priorität bei der Kanalidentifikation:** Wenn sowohl IDs als auch Namen angegeben sind, haben **IDs Vorrang**.
- **Format:** `channelIdentifier:visibilityValue`
- **Mehrere Kanäle:** Einträge mit Pipe (`|`) trennen.

## Anwendungsbeispiele

**Einfache Zuweisung**

```csv
productNumber, salesChannelNames
SW10001, Storefront
```

*Ergebnis:* Produkt wird Storefront mit Standardsichtbarkeit (30) zugewiesen.

**Bestimmte Sichtbarkeit**

```csv
productNumber, salesChannelNames
SW10001, Storefront:20
```

*Ergebnis:* Produkt ist nur in der Suche sichtbar.

**Mehrere Kanäle**

```csv
productNumber, salesChannelNames
SW10001, Storefront:30|Headless:20|B2B-Portal:10
```

*Ergebnis:* Unterschiedliche Sichtbarkeitsstufen je Kanal.

**Kanalentfernung (Replace Mode)**

```csv
productNumber, salesChannelNames
SW10001, Storefront:30
```

*Ergebnis:* Alle vorherigen Kanalzuweisungen werden entfernt. Nur Storefront bleibt erhalten.

## Wichtige Hinweise

- **Kanalvalidierung:**
    - Alle Verkaufskanäle müssen vor dem Import in Shopware existieren.
    - Kanalnamen sind **groß-/kleinschreibungssensitiv**.
    - Ungültige Namen oder IDs lösen Importfehler aus.
- **Leistung:**
    - Replace Mode führt Löschoperationen aus. Große Importe können länger dauern.
    - Bestehende Sichtbarkeits-IDs bleiben erhalten, um referenzielle Integrität sicherzustellen.
- **Kompatibilität:**
    - Funktioniert mit CSV- und XML-Importdateien.
    - Unterstützt neue Produkte und Aktualisierungen bestehender Produkte.
- **Fehlerbehandlung:**
    - Ungültige Sichtbarkeitswerte, also alles außer 10, 20 oder 30, verursachen Fehler.
    - Nicht vorhandene Kanäle stoppen den Import.
    - Falsches Format, zum Beispiel fehlender `:` oder `|`, wird abgelehnt.