Das Plugin ermöglicht dir eine komplette Bestellabwicklung zwischen Marktplätzen, Deinem Shop sowie Preisanpassung für Deine Produkte durch Marktpreisanalyse und einen Produktexport.

Schritt 1: Installiere das Plugin

Navigiere zu www.shopware.com.
Lade das Plugin herunter und installiere es.
Nach der Erstinstallation sind nicht alle Einstellungen verfügbar (rot umrandet). Das kann behoben werden, wenn das Plugin erneut installiert wird (grüner Pfeil). Dieser Schritt ist nur bei der Erstinstallation notwendig!
Wechsel nach der Installation des Plugins zu Channel Pilot Pro und erstelle einen neuen Shop.

Schritt 2: Aktiviere das Plugin

Aktiviere des Plugin (roter Pfeil) um alle Optionen freizuschalten (grün umrandet).

Schritt 3: Plugin-Funktion und Hooks für die manuelle Synchronisation

Das Plugin läuft automatisch (standardmäßig alle 15 Minuten) und stößt die folgenden Funktionen an:

neue Bestellungen importieren
Versandmeldungen synchronisieren
Stornierungen synchronisieren
neue Preisinformationen synchronisieren (wenn Repricing verwendet wird)

Der Initiator der Kommunikation ist immer Channel Pilot Pro. Daher müssen keine zeitgesteuerten Prozesse im Plugin / Shopsystem implementiert werden. Channel Pilot Pro steuert das Plugin.

Diese Aktionen können mit Hooks manuell ausgelöst werden, es wird jedoch empfohlen, diese nur für Testfälle oder zur Fehlerbehandlung zu verwenden.

Diese Hook-URLs werden vom Shopsystem bereitgestellt und decken jeweils einen oben beschriebenen Anwendungsfall ab. Die Prozedur zum Aufrufen einer Hook-URL ist in die folgenden Abschnitte unterteilt:

Channel Pilot Pro ruft eine Hook-URL auf (https://www.shop.de/channelpilot?method=USE_CASE)
Plugin ruft die Seller API auf und sendet / empfängt neue Daten
Plugin aktualisiert Daten im Shopsystem
Plugin antwortet auf die Hook-URL

Dies sind die URLs, die verwendet werden können:

STATUS (zum prüfen ob das Plugin erfolgreich registriert ist. Bietet zusätzliche Informationen für andere Hooks) → https://SHOPDOMAIN/channelpilot?cl=cp_marketplace&method=status
ORDERS → https://SHOPDOMAIN/channelpilot?cl=cp_marketplace&method=orders&token=APITOKEN&php=PHPVERSION&shop=SHOPWAREVERSION&plugin=PLUGINVERSION&limit=10
DELIVERIES → https://SHOPDOMAIN/channelpilot?cl=cp_marketplace&method=deliveries&token=APITOKEN&php=PHPVERSION&shop=SHOPWAREVERSION&plugin=PLUGINVERSION&limit=10
CANCELLATIONS → https://SHOPDOMAIN/channelpilot?cl=cp_marketplace&method=cancellations&token=APITOKEN&php=PHPVERSION&shop=SHOPWAREVERSION&plugin=PLUGINVERSION&limit=10
REPRICING → https://SHOPDOMAIN/channelpilot?cl=cp_marketplace&method=pricing&token=APITOKEN&php=PHPVERSION&shop=SHOPWAREVERSION&plugin=PLUGINVERSION&limit=10&priceId=REPRICINGGROUPID

Schritt 4: Einen Export aus Shopware 5 erhalten

Der Produktexport wird nicht über das Plugin angeboten, sondern kann über die interne Export-Funktion von Shopware 5 erhalten werden.

Diese findet man in “Marketing → Product export”.

Damit der Export funktioniert, muss der Datei-Header definiert werden, ebenso wie die generelle Dateistruktur.

Ein mögliches Beispiel für beide Dateien ist in dem Bereich untenstehend verlinkt.

Wir empfehlen UTF-8 als Kodierung zu verwenden und .csv als Dateiformat.

Beispiel für eine Header-Template-TXT

{strip}
articleID|
name|
link|
description_short|
description_long|
shippingtime|
versand|
added|
category|
shippingfree|
releasedate|
topseller|
keywords|
minpurchase|
purchasesteps|
maxpurchase|
purchaseunit|
referenceunit|
taxID|
supplierID|
unitID|
unit_description|
changed|
active|
articledetailsID|
ordernumber|
suppliernumber|
instock|
stockmin|
esd|
weight|
ean|
position|
supplier|
unit|
tax|
image|
netprice|
price|
netpseudoprice|
pseudoprice|
baseprice|
discount|
properties|
variant_images|
variant_link|
attr1|
attr2|
attr3|
attr4|
attr5|
attr6|
attr7|
attr8|
attr9|
attr10|
attr11|
attr12|
attr13|
attr14|
attr15|
attr16|
attr17|
attr18|
attr19|
attr20
{/strip}{#L#}

Beispiel für eine Export-Template-TXT

{strip}
{$sArticle.articleID|replace:"|":""|escape}|
{$sArticle.name|replace:"|":""|escape}|
{$sArticle.articleID|link:$sArticle.name|escape}|
{$sArticle.description|strip_tags|strip|truncate:100:"...":true|replace:"|":""|escape}|
{$sArticle.description_long|strip_tags|strip|replace:"|":""|escape}|
{$sArticle.shippingtime|replace:"|":""|escape}|
{$sArticle|@shippingcost:"prepayment":"de"}|
{$sArticle.added|replace:"|":""|escape}|
{$sArticle.articleID|category:" > "|escape}|
{$sArticle.shippingfree|replace:"|":""|escape}|
{$sArticle.releasedate|replace:"|":""|escape}|
{$sArticle.topseller|replace:"|":""|escape}|
{$sArticle.keywords|replace:"|":""|escape}|
{$sArticle.minpurchase|replace:"|":""|escape}|
{$sArticle.purchasesteps|replace:"|":""|escape}|
{$sArticle.maxpurchase|replace:"|":""|escape}|
{$sArticle.purchaseunit|replace:"|":""|escape}|
{$sArticle.referenceunit|replace:"|":""|escape}|
{$sArticle.taxID|replace:"|":""|escape}|
{$sArticle.supplierID|replace:"|":""|escape}|
{$sArticle.unitID|replace:"|":""|escape}|
{$sArticle.unit_description|replace:"|":""|escape}|
{$sArticle.changed|replace:"|":""|escape}|
{$sArticle.active|replace:"|":""|escape}|
{$sArticle.articledetailsID|replace:"|":""|escape}|
{$sArticle.ordernumber|replace:"|":""|escape}|
{$sArticle.suppliernumber|replace:"|":""|escape}|
{$sArticle.instock|replace:"|":""|escape}|
{$sArticle.stockmin|replace:"|":""|escape}|
{$sArticle.esd|replace:"|":""|escape}|
{$sArticle.weight|replace:"|":""|escape}|
{$sArticle.ean|replace:"|":""|escape}|
{$sArticle.position|replace:"|":""|escape}|
{$sArticle.supplier|replace:"|":""|escape}|
{$sArticle.unit|replace:"|":""|escape}|
{$sArticle.tax|replace:"|":""|escape}|
{$sArticle.image|escape}|
{$sArticle.netprice|replace:"|":""|escape}|
{$sArticle.price|replace:"|":""|escape}|
{$sArticle.netpseudoprice|replace:"|":""|escape}|
{$sArticle.pseudoprice|replace:"|":""|escape}|
{$sArticle.baseprice|replace:"|":""|escape}|
{$sArticle.discount|replace:"|":""|escape}|
{assign var="properties" value=$sArticle.articleID|property:$sArticle.filtergroupID}
{foreach from=$properties item=property}
    {if $property}
        {$property.name|escape} {$property.value|escape}
    {/if}
{/foreach}|
{$sArticle.articleID|articleImages:$sArticle.ordernumber|replace:"|":","|escape}|
{$sArticle.articleID|link:$sArticle.name}{if $sArticle.additionaltext}?number={$sArticle.ordernumber}{/if}|
{$sArticle.attr1|replace:"|":""|escape}|
{$sArticle.attr2|replace:"|":""|escape}|
{$sArticle.attr3|replace:"|":""|escape}|
{$sArticle.attr4|replace:"|":""|escape}|
{$sArticle.attr5|replace:"|":""|escape}|
{$sArticle.attr6|replace:"|":""|escape}|
{$sArticle.attr7|replace:"|":""|escape}|
{$sArticle.attr8|replace:"|":""|escape}|
{$sArticle.attr9|replace:"|":""|escape}|
{$sArticle.attr10|replace:"|":""|escape}|
{$sArticle.attr11|replace:"|":""|escape}|
{$sArticle.attr12|replace:"|":""|escape}|
{$sArticle.attr13|replace:"|":""|escape}|
{$sArticle.attr14|replace:"|":""|escape}|
{$sArticle.attr15|replace:"|":""|escape}|
{$sArticle.attr16|replace:"|":""|escape}|
{$sArticle.attr17|replace:"|":""|escape}|
{$sArticle.attr18|replace:"|":""|escape}|
{$sArticle.attr19|replace:"|":""|escape}|
{$sArticle.attr20|replace:"|":""|escape}
{/strip}{#L#}

Nummernkreise für Bestellungen

Verfügbar ab Shopware Version 5.5

Laufen über angeschlossene Marktplätze Bestellungen ein, wird diesen automatisch eine Bestellnummer (aus einem festgelegten Nummernkreis) zugeordnet. Diese wird vom System definiert.

Aktuell definierte Nummernkreise findest Du unter "Einstellungen > Grundeinstellungen > Shopeinstellungen > Nummernkreise".

Damit spezielle Nummernkreise im Plugin verarbeitet werden können, müssen diese als Namen den Präfix "cpp_" erhalten. (rote Markierung)
(Die jew. Beschreibung kann weiterhin z.B. "amazon" lauten)

Im folgenden Abschnitt erklären wir Dir, wie du eigene Nummernkreise für Bestellungen aus Marktplätzen festlegen kannst.

Eigene Nummernkreise festlegen

Öffne "Einstellungen" -> "Plugin Manager" in Deinem Shopware.
Klicke auf den Stift, um die Einstellungen im Plugin zu ändern.
Ganz unten findest Du die neue Einstellungsmöglichkeit "Number cycle min max".
Trage die Nummernkreise ein.

Beachte das Format zur Vergabe von Nummernkreisen:
```
number-cycle-name1,min-order-id,max-order-id#number-cycle-name2, ...
```
Beispiel: cpp_amazon,500000,60000#cpp_ebay,800001,90000# ...
Klicke auf "Speichern".

FAQ und Fehlerbehebung

Ist es möglich die "return tracking ID" über das Plugin zu erhalten?

Ja, es ist möglich. Allerdings gibt es einige Bedingungen die erfüllt sein müssen, damit die Übertragung funktioniert:

das Pickware-Plugin - der offiziellen DHL Adapter für Shopware - muss installiert und aktiviert sein ("DHL Adapter powered by Pickware")
das Datenfeld “returnTrackingIdColumn” in der Plugin-Konfiguration muss leer sein
die “returnTrackingId" kann nur von DHL erhalten werden.
- Diese Funktion steht für andere Versanddienstleister nicht zur Verfügung!

Dann versucht das Plugin die "returnTrackingId" automatisch aus dem Pickware DHL-Plugin zu ziehen.

Stelle sicher, dass die "returnTrackingId" im Pickware DHL-Plugin gesetzt ist, bevor die Bestellung als "versendet" markiert wird. Ansonsten kann die "returnTrackingId" zwischen beiden Plugins nicht synchronisiert werden.

Die Kunden-E-Mailadresse wird nicht korrekt angezeigt (ohne @). Kann die E-Mailadresse in die korrekte Schreibweise geändert werden?

Aufgrund von Kundenwünschen, wurde die E-Mailadresse aus Marktplatzbestellungen angepasst, sodass diese keine automatischen Funktionen von Shopware 5 auslösen sobald Bestellungen ins System importiert werden (z.B. Willkommens-E-Mail).

Daher wurden bei E-Mailadresse das @ gegen [at] ausgetauscht.

Dies kann im Plugin-Quellcode rückgängig gemacht werden. Im Ordner "helper/special" befindet sich die Datei "CustomerFunctions.php".

Dort befindet sich eine Ersetzung von @ in [at], welche gelöscht werden kann.

Diese manuelle Anpassung muss bei zukünftigen Plugin-Updates selbst erneut durchgeführt werden.

Verwandte Artikel

PrestaShop