> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/verkaufskanaele/channelpilot.md).

# ChannelPilot

Verbinde ChannelPilot mit VARIO Cloud, ordne Produktfeeds zu, übertrage Artikeldaten und übernimm Bestellungen. Prüfe Warteschlange und Bestellspeicher.

Mit der **ChannelPilot-App** überträgst Du Artikeldaten aus VARIO Cloud in Produktfeeds von ChannelPilot und übernimmst neue Marktplatzbestellungen nach VARIO Cloud. Die Anbindung wird je Verkaufskanal eingerichtet.

Die Übertragung der Artikeldaten erfolgt **aktiv aus VARIO zu ChannelPilot**. Welche Marktplätze und weiteren Ausgabekanäle ChannelPilot anschließend beliefert, richtest Du dort ein. Eine erfolgreiche Feedübertragung bestätigt noch keine Veröffentlichung auf einem Marktplatz.

## Voraussetzungen

* Die ChannelPilot-App ist in Deiner VARIO Cloud installiert. Hinweise dazu findest Du unter [Apps installieren und verwalten](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md).
* Du hast einen passenden ChannelPilot-Zugang mit **API Merchant-ID** und **API-Token** für den gewünschten Shop. Die Werte findest Du in ChannelPilot unter **Shop Einstellungen**.
* In ChannelPilot ist ein Produktfeed für die API-Übertragung eingerichtet. Lege dort einen **eindeutigen Artikelbezeichner** fest und stimme die Datenfelder mit der VARIO-Selektion ab. Die Einrichtung beschreibt [ChannelPilot zur Produkt-API](https://support.channelpilot.com/de/articles/13751071-api-s-in-channel-pilot-pro).
* Die benötigten Artikel sind in VARIO Cloud vorhanden. Ihre Kennungen müssen zu den von ChannelPilot gelieferten Bestellpositionen passen.
* Für die Einrichtung benötigst Du das App-Recht **„Darf die App administrieren“**. Zum Öffnen und Bearbeiten der Warteschlange benötigst Du **„Darf die Warteschlange abarbeiten“** sowie die jeweiligen ERP-Rechte.

## Verkaufskanal und Verbindung einrichten

Bei der Installation legt die App einen ersten Verkaufskanal **Channelpilot** an, sofern noch kein Verkaufskanal dieser App vorhanden ist.

1. Öffne **Verkaufskanäle** und wähle den ChannelPilot-Kanal.
2. Für einen weiteren Kanal klickst Du auf **»+«**, vergibst eine **Bezeichnung**, wählst **Online-Shop** und die App **Channelpilot** und legst ihn an.
3. Öffne am gewünschten Kanal **Stammdaten → Einstellungen** und klicke auf **»Einrichtung«**.
4. Starte den Assistenten und wechsle zu **Zugangsdaten**.
5. Trage **API Merchant-ID** und **API-Token** des richtigen ChannelPilot-Shops ein. Klicke auf **»Speichern und weiter«**.
6. Prüfe das Ergebnis im Schritt **Verbindungstest** und schließe die Einrichtung ab.

Die Zugangsdaten werden für diesen Verkaufskanal gespeichert. Beim erneuten Öffnen bleibt der gespeicherte Token verborgen. Über **»Weiter«** kannst Du mit den bereits gespeicherten Zugangsdaten fortfahren; zum Ersetzen gibst Du Merchant-ID und Token ein und speicherst erneut.

**Der Verbindungstest prüft die Anmeldung an der Produktdaten-Schnittstelle.** Er bestätigt noch nicht den Bestellabruf, die passenden Importvorlagen oder die Annahme einzelner Artikeldaten. Prüfe diese Abläufe bei der ersten Nutzung jeweils gesondert.

## Produktfeeds zuordnen

### Artikeldaten und Selektion vorbereiten

Die App verwendet eine **Tabellenselektion der Artikellistings** als Datenquelle. Die ausgewählten Spalten und ihre Ausgabebezeichnungen bestimmen, welche Felder ChannelPilot erhält. Verwende eine zum Ziel-Feed passende Selektion mit dem vereinbarten eindeutigen Artikelkennzeichen sowie den benötigten Produkt-, Preis- und Bestandsangaben.

Eine beliebige Artikelselektion ist nicht automatisch passend: Die Vorgabe muss zur Tabelle der **Artikellistings** gehören. Allgemeine Hinweise findest Du unter [Selektionen konfigurieren](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md).

Ordne die gewünschten Artikel dem ChannelPilot-Verkaufskanal zu und prüfe deren Listingstatus. Die allgemeinen Schritte erklärt [Artikel einem Verkaufskanal zuordnen](https://help.vario-software.de/vario-cloud-handbuch/artikel/weitere-reiter-in-artikel.md#reiter-verkaufskanale). Welche Lager und Bestände für einen Kanal verfügbar sind, legst Du unter [Lagerzuordnung](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-verkaufskanaele/lagerzuordnung.md) fest.

### Feed-Zuordnung und erster Upload

1. Öffne am Kanal **Stammdaten → Einstellungen**.
2. Klicke auf **»Feed-Zuordnung«**.
3. Wähle für jeden gewünschten ChannelPilot-Feed die passende Tabellenselektion aus.
4. Die Auswahl wird **sofort gespeichert**. Es gibt dafür keinen zusätzlichen Speichern-Schritt.
5. Klicke beim gewünschten Feed auf **»In Feed hochladen«**.
6. Prüfe das Ergebnis und kontrolliere die angekommenen Artikel in ChannelPilot einschließlich Kennung, Preis, Verfügbarkeit und Feldzuordnung.

Der Upload verwendet die gelisteten Artikel des gewählten VARIO-Verkaufskanals. Für weitere Feeds führst Du den Upload jeweils an der entsprechenden Feed-Zeile aus.

## Standard-Feed und Artikeländerungen

Öffne **Stammdaten → Einstellungen**, aktiviere **»Bearbeiten«**, wähle den **Standard-Feed** und speichere. Auch dieser Feed benötigt eine passende Feed-Zuordnung.

Automatisch vorgemerkte Artikeländerungen werden über die **Warteschlange** an diesen Standard-Feed übertragen. Weitere zugeordnete Feeds werden dadurch nicht gleichzeitig aktualisiert; lade sie bei Bedarf gezielt über **»In Feed hochladen«** hoch.

### Beispiel: Eine Preisänderung in zwei Produktfeeds übernehmen

Ein Energieriegel ist dem ChannelPilot-Verkaufskanal zugeordnet und bereits in zwei Produktfeeds enthalten. Beide Feeds haben eine passende Zuordnung mit Artikelkennung und Preis; einer ist als **Standard-Feed** eingestellt. Nun änderst Du den Preis in VARIO Cloud.

Die vorgemerkte Änderung überträgst Du über die **Warteschlange** an den Standard-Feed. Für den zusätzlichen Feed öffnest Du die **Feed-Zuordnung** und wählst an dessen Zeile **»In Feed hochladen«**. Danach prüfst Du den Artikelpreis in beiden ChannelPilot-Feeds.

So kannst Du nachvollziehen, welche Feeds die Änderung erhalten haben und wo ein zusätzlicher Upload nötig ist. Die anschließende Verarbeitung für Deine Marktplätze verfolgst Du in ChannelPilot.

Wird ein Listing deaktiviert oder gelöscht, stößt die App über die Warteschlange die Entfernung des Artikels aus dem Standard-Feed an. Die weitere Verarbeitung und Veröffentlichung auf den angebundenen Marktplätzen erfolgt nach den Einstellungen in ChannelPilot.

Listingstatus und Warteschlangenstatus sind getrennte Anzeigen. Kontrolliere nach der Abarbeitung die Daten im ChannelPilot-Feed; **Erfolgreich** in der Warteschlange bestätigt keine Marktplatzveröffentlichung.

Die **Warteschlangen-Blockgröße** bestimmt, wie viele Warteschlangeneinträge ein Verarbeitungsschritt bearbeitet. Sie ist keine Obergrenze für die Gesamtzahl Deiner Artikel.

## Bestellabruf vorbereiten

Öffne am Verkaufskanal **Stammdaten → Bestellabruf**, aktiviere **»Bearbeiten«** und prüfe die Einstellungen:

| Bedienelement                     | Wirkung                                                                                                                                              |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **„Import-Vorlage“**              | Legt fest, wie die abgefragten Daten in VARIO verarbeitet werden. Die App liefert **Channelpilot-Account-And-Order-Import** als Standardvorlage mit. |
| **„Adressvorlage“**               | Vorgabe für neu anzulegende Adressen.                                                                                                                |
| **»Automatisch importieren«**     | Aktiv: Der vorbereitete Datenimport wird anschließend ausgeführt. Inaktiv: Der Import bleibt vorbereitet und muss manuell gestartet werden.          |
| **»Auftrag speichern«**           | Steuert, ob die angelegten Aufträge direkt gespeichert werden.                                                                                       |
| **„Letzter erfolgreicher Abruf“** | Information zum letzten Abruf. Das Feld ist kein frei wählbarer Zeitraumfilter.                                                                      |

Prüfe außerdem die Lagerzuordnung des Verkaufskanals. Für den Bestellimport wird ein **Standardverkaufslager** benötigt.

Speichere die Einstellungen, bevor Du den Bestellabruf startest.

**»Automatisch importieren« richtet keinen regelmäßigen Bestellabruf ein.** Der Schalter bestimmt nur, was nach einem gestarteten Abruf mit dem vorbereiteten Datenimport geschieht.

Für den ersten Lauf kannst Du den automatischen Import ausschalten und die vorbereiteten Daten vor ihrer Ausführung kontrollieren. Die Funktionsweise der Vorlage erklärt [Mehrstufige Verarbeitung](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/mehrstufige-verarbeitung.md).

## Bestellungen abrufen und übernehmen

1. Klicke im Bereich **Bestellabruf** auf **»Bestellungen importieren«**.
2. Warte auf die Rückmeldung des Abrufs und prüfe die Meldungen.
3. Wurden Daten vorbereitet, öffne den Datenimport über die Importanzeige beziehungsweise über **System → Importe**.
4. Bei ausgeschaltetem **»Automatisch importieren«** prüfst Du den vorbereiteten Import und startest ihn anschließend manuell. Bei eingeschaltetem Schalter verfolgst Du dort die laufende Verarbeitung.
5. Prüfe die angelegten Adressen und Aufträge: Artikel, Mengen, Einzelpreise, Steuerangaben, Versandkosten und Gesamtbeträge.

Eine Meldung zum erfolgreichen Abruf oder vorbereiteten Import bestätigt noch keinen vollständig angelegten ERP-Auftrag. Im **Bestellspeicher** findest Du gespeicherte Rohbestellungen und gegebenenfalls Hinweise auf fehlende Voraussetzungen.

**Die Standardvorlage legt keine fehlenden Artikel neu an.** Positionen mit unbekannter Artikelkennung werden nicht übernommen. Die mitgelieferte Vorlage übernimmt außerdem keine Versandkosten. Prüfe und ergänze die Aufträge entsprechend, bevor Du sie weiterverarbeitest. Summenabweichungen können protokolliert werden, ohne die Auftragsanlage zu verhindern.

Prüfe vor einem erneuten Abruf zunächst den vorhandenen vorbereiteten oder laufenden Datenimport. Starte beziehungsweise setze diesen bei Bedarf fort. Ein weiterer Abruf kann für dieselben gespeicherten Bestellungen einen weiteren Import vorbereiten; führe solche Importe nicht ungeprüft mehrfach aus.

Die App bestätigt verarbeitbare Bestellungen bei ChannelPilot bereits vor der fertigen ERP-Auftragsanlage. Das gilt auch, wenn ein Datenimport zunächst nur vorbereitet wird. Verfolge deshalb den jeweiligen VARIO-Import bis zum Ergebnis; der externe Importstatus allein reicht dafür nicht aus. Bereits bestätigte Bestellungen werden nicht fortlaufend auf spätere Änderungen oder Stornos abgefragt.

## Bestellspeicher prüfen

Im Reiter **»Bestellspeicher«** siehst Du gespeicherte Bestelldaten, bis ein passender ERP-Beleg vorhanden ist und der Speicher beim nächsten Abruf bereinigt wird. Dazu können auch Bestellungen aus vorbereiteten oder noch laufenden Importen gehören. Lies die angezeigte Ursache und klappe bei Bedarf die Originaldaten über die Zeile oder den Pfeil auf.

| Ursache                                   | Vorgehen                                                                                                                                    |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kein Standardverkaufslager zugeordnet** | Ergänze die Lagerzuordnung des Verkaufskanals und starte danach erneut den Bestellabruf.                                                    |
| **Bestelldaten nicht lesbar**             | Prüfe die Originaldaten und den Abruf beziehungsweise lasse die Ursache klären. Ein erneuter Abruf allein korrigiert unlesbare Daten nicht. |

Nach Behebung der Ursache versucht der nächste Bestellabruf auch die gespeicherten Bestellungen erneut zu verarbeiten. Es gibt hier keinen separaten Einzelimport-Knopf. Einträge zu inzwischen angelegten ERP-Belegen werden beim nächsten Abruf bereinigt.

**Entfernen im Bestellspeicher löscht nur die lokale Kopie.** Es storniert keine Bestellung bei ChannelPilot und legt keine dauerhafte Sperrliste an. Noch nicht bei ChannelPilot bestätigte Bestellungen können beim nächsten Abruf erneut erscheinen.

## Warteschlange bearbeiten

Öffne den Reiter **»Warteschlange«**, um vorgemerkte Übertragungen und Fehler zu prüfen. Nutze den Statusfilter und die Textsuche und öffne den zugehörigen Artikel oder Beleg, wenn Du die Ausgangsdaten kontrollieren musst.

* **»Abarbeiten«** verarbeitet wartende Einträge des Kanals. Suchtext und ein artikelbezogener Aufruf können die Verarbeitung eingrenzen; **Checkboxen und Statusfilter begrenzen diesen Befehl nicht** auf die angezeigte oder markierte Auswahl.
* Über **»Auswahl wiederholen«** stellst Du markierte Einträge erneut auf wartend. Behebe zuvor die Ursache und starte anschließend erneut **»Abarbeiten«**.
* **»Auswahl löschen«** entfernt markierte Warteschlangeneinträge. Bereits übertragene Daten werden dadurch weder bei ChannelPilot noch im ERP zurückgenommen.

Prüfe nach einem Fehler zuerst Zugangsdaten, Standard-Feed, Feed-Zuordnung und die Ausgangsdaten. Wiederhole gezielt den betroffenen Vorgang und kontrolliere anschließend auch das Ergebnis in ChannelPilot.

## Umfang der Rückmeldungen

Der Bestellabruf und der Artikelupload sind getrennte Abläufe. Eine erfolgreiche Artikelübertragung oder ein ERP-Belegstatus bestätigt keine Versand-, Zahlungs- oder Erstattungsmeldung bei ChannelPilot.

Über diese Anbindung steht keine allgemeine automatische Zahlungs- oder Erstattungsrückmeldung zur Verfügung. Auch Versand- und Rechnungsrückmeldungen werden nicht durchgängig automatisch abgedeckt. Verwalte und kontrolliere die erforderlichen Meldungen im ChannelPilot-Auftragsbereich nach Deinem eingerichteten Ablauf.

## Häufige Fragen und Fehler

| Situation                                                       | Vorgehen                                                                                                                                                             |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Schnittstelle wurde noch nicht eingerichtet**                 | Führe den Einrichtungsassistenten am richtigen Verkaufskanal aus.                                                                                                    |
| Verbindungstest schlägt fehl                                    | Prüfe API Merchant-ID, Token, Shop und die API-Freigabe in ChannelPilot. Nach einer Änderung speichere die Zugangsdaten und teste erneut.                            |
| Ein Feed wird nicht angeboten                                   | Prüfe die Feedanlage und den Shop, zu dem die Zugangsdaten gehören.                                                                                                  |
| **»In Feed hochladen«** ist gesperrt                            | Ordne diesem Feed zuerst eine Tabellenselektion zu.                                                                                                                  |
| Artikel fehlen im Feed                                          | Prüfe Listingstatus, Verkaufskanal und Selektion. Bei automatischen Änderungen zusätzlich Standard-Feed und Warteschlange prüfen.                                    |
| Keine neuen Bestellungen                                        | Prüfe ChannelPilot und den Bestellspeicher. Der letzte Abrufzeitpunkt ist kein Rücksetzdatum für einen erneuten vollständigen Abruf.                                 |
| **Die Import-Vorlage ordnet die Importdatei keinem Schritt zu** | Prüfe die Dateizuordnung der Vorlage. Die Standardvorlage erwartet **channelpilot-orders.json**. Wähle bei Bedarf die passende mitgelieferte Vorlage.                |
| Auftrag oder Position fehlt nach dem Import                     | Prüfe Importprotokoll, Artikelkennungen, Lagerzuordnung und den angelegten Beleg. Starte nicht ohne Prüfung mehrere vorbereitete Importe für dieselben Bestellungen. |

## Weiterführende Informationen

* [Verkaufskanäle allgemein](https://help.vario-software.de/vario-cloud-handbuch/verkaufskanaele/grundlagen.md)
* [Artikel einem Verkaufskanal zuordnen](https://help.vario-software.de/vario-cloud-handbuch/artikel/weitere-reiter-in-artikel.md#reiter-verkaufskanale)
* [Selektionen konfigurieren](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md)
* [Mehrstufige Verarbeitung](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/mehrstufige-verarbeitung.md)
* [ChannelPilot Shop-Einstellungen](https://support.channelpilot.com/de/articles/9649923-shop-einstellungen)
* [ChannelPilot Produkt-API](https://support.channelpilot.com/de/articles/13751071-api-s-in-channel-pilot-pro)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.vario-software.de/vario-cloud-handbuch/verkaufskanaele/channelpilot.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
