README

Bindet einen Shopware-6-Shop an den everysize-Direktkauf an: Bestellungen, die Kundinnen auf everysize.com aufgeben, landen als Bestellung im Shop; Bestellnummer, Versand, Sendungsnummer, Storno und Retoure gehen zurück an everysize. Erstattungen laufen über everysize.

Composer-Paket everysize/checkout-shopware6, technischer Name EverysizeCheckout.

Voraussetzungen

Shopware 6.6 (ab 6.6.8) oder 6.7, PHP wie die jeweilige Shopware-Version
laufende geplante Aufgaben (Scheduled Tasks) — der Abgleich hängt daran
ein everysize-Shop mit Checkout und Zugang zu everysize Business (business.everysize.com)

Kein PayPal-Plugin nötig: bezahlt wird bei everysize, erstattet über everysize.

Installation

Es gibt zwei Wege. Wähle einen davon — beide installieren dasselbe Plugin, du brauchst nicht beide.

Weg A: ZIP im Admin hochladen

Für Shops ohne Kommandozeile oder ohne Composer-Deployment.

In everysize Business unter Shop-Integration → Shopware das Plugin als ZIP herunterladen.
Im Shopware-Admin unter Erweiterungen → Meine Erweiterungen → „Erweiterung hochladen“ das ZIP hochladen (nicht entpacken).
„everysize Checkout“ installieren und aktivieren.

Update: das neue ZIP genauso hochladen, dann bei „everysize Checkout“ auf „Aktualisieren“.

Weg B: Composer

Für Shops, die per Composer und Deployment gepflegt werden. Im Verzeichnis des Shops:

composer require everysize/checkout-shopware6
bin/console plugin:refresh
bin/console plugin:install --activate EverysizeCheckout
bin/console cache:clear

Das Paket landet unter vendor/everysize/checkout-shopware6; ein ZIP wird dafür nicht gebraucht. Ein per Composer installiertes Plugin lässt sich im Admin nicht aktualisieren oder löschen, das geht dann nur per Composer.

Update:

composer update everysize/checkout-shopware6
bin/console plugin:update EverysizeCheckout
bin/console cache:clear

Von ZIP zu Composer wechseln: Plugin installiert lassen (nicht deinstallieren, sonst gehen Einstellungen und Bestellzuordnungen verloren), den Ordner custom/plugins/EverysizeCheckout löschen, dann composer require wie oben und bin/console plugin:refresh.

Einrichten

In everysize Business unter Shop-Integration → Shopware einen Token erzeugen. Das Client Secret wird nur einmal angezeigt.
Im Shopware-Admin Erweiterungen → Meine Erweiterungen → everysize Checkout → Konfigurieren: Client-ID und Client Secret eintragen (Felder „Everysize Checkout API ClientId“ und „… ClientSecret“), mit „API Test“ die Verbindung prüfen.
Unter „Bestellungen - Import Zuweisungen“ festlegen, mit welchem Status, welcher Zahlungsart und welcher Versandart everysize-Bestellungen angelegt werden.
Unter „Bestellungen - Export Zuweisungen“ festlegen, welcher Bestellstatus als versandt (abgeschlossen) und welcher als storniert gilt, welcher Versandstatus als retourniert, und den Versanddienstleister wählen. Speichern. Ohne diese Angaben meldet das Plugin Versand, Storno und Retoure nicht an everysize.

Die Einstellungen gelten je Verkaufskanal und erben von „Alle Verkaufskanäle“. Teilen sich mehrere Kanäle dieselben Zugangsdaten, legt „Verkaufskanal für importierte Bestellungen“ fest, welcher Kanal die Bestellungen importiert.

Bestellungen werden über die Artikelnummer zugeordnet: Die SKU im everysize-Produktfeed muss der Produktnummer der Variante in Shopware entsprechen.

Ablauf

Richtung	Was	Wann
everysize → Shop	neue Bestellungen	alle 5 Minuten (Scheduled Task)
Shop → everysize	Shopware-Bestellnummer	direkt nach dem Import
Shop → everysize	Preis und Bestand des Artikels im Shop	direkt nach dem Import
Shop → everysize	Versand mit Sendungsnummer	Bestellung im Status „abgeschlossen“ laut Export-Zuweisung
Shop → everysize	Sendungsnummer nachgetragen oder korrigiert	bis 14 Tage nach dem Versand
Shop → everysize	Storno, Retoure	Bestell- bzw. Versandstatus laut Export-Zuweisung
everysize → Shop	Hinweis auf Bestellungen, die bei everysize storniert wurden	nach jedem Export-Lauf, Bestellungen der letzten 30 Tage

Erstattung: in der Bestellung im Reiter „everysize“, ganz oder teilweise. Das Geld geht über everysize an das PayPal-Konto zurück, mit dem die Kundin bezahlt hat. Der Reiter zeigt auch die everysize-Bestellnummer, die bisherigen Erstattungen und alle Rückmeldungen an everysize. Nur eine bekannte Ablehnung durch PayPal oder everysize zählt als „nicht erstattet“. Bei allem anderen (keine Antwort, Zeitüberschreitung, Serverfehler) zeigt das Plugin „Ergebnis unklar“: Das Geld kann geflossen sein, bitte in PayPal prüfen. Die Erstattung bleibt dann offen: Es geht kein anderer Betrag raus, und frühestens nach 150 Sekunden lässt sie sich mit „Erneut senden“ wiederholen. Das Plugin liest vorher die PayPal-Liste und schließt den Fall ab, wenn die Erstattung dort steht; sonst sendet es denselben Betrag mit demselben Schlüssel (ging die erste Anfrage nicht durch, wird der Betrag jetzt ausgezahlt). Mit „Als geklärt markieren“ geben Sie den Fall frei, ohne dass etwas gesendet wird.

Storno und Retoure erstatten nicht. Das Plugin erstattet nie automatisch, auch nicht bei einem Storno vor dem Versand: Es meldet den Storno an everysize (vor dem Versand als Ablehnung durch den Händler, nach dem Versand als Retoure) und das Geld geht erst zurück, wenn Sie im Reiter „everysize“ erstatten. Eine bei everysize schon stornierte Bestellung meldet das Plugin nicht noch einmal.

Storno bei everysize: Wird eine schon importierte Bestellung bei everysize storniert, zeigt der Reiter „everysize“ der Bestellung einen Hinweis („Bitte nicht versenden und im Shop stornieren“), und das Protokoll bekommt einen Eintrag. Ist die Bestellung im Shop schon als versendet markiert, lautet der Hinweis „Bitte prüfen“. Das Plugin ändert dabei nichts: kein Status, kein Bestand, keine Erstattung; Sie entscheiden. Der Hinweis erscheint einmal je Bestellung und nur für Bestellungen der letzten 30 Tage. Eine Erstattung, die Sie direkt in PayPal machen, ohne die Bestellung bei everysize zu stornieren, kennt everysize nicht als Storno; dafür gibt es keinen Hinweis.

Mails: Die E-Mail-Adresse der Kundin ist eine Weiterleitungsadresse von everysize; Mails des Shops kommen darüber bei ihr an. Die Bestellbestätigung schickt der Shop nur, wenn „Bestellbestätigungs Mail senden“ an ist.

Umstieg vom bisherigen Plugin

Wer noch das bisherige Plugin „everysize checkout“ (technischer Name ITSEverysizeCheckout, Version 2.x) hat: das neue installieren, das bisherige deaktivieren (nicht deinstallieren) und dann das neue aktivieren. Es übernimmt Zugangsdaten, Einstellungen und Bestellzuordnungen; danach nur mit „API Test“ die Verbindung prüfen. Beide gleichzeitig aktiv geht bewusst nicht, sonst kämen Bestellungen doppelt an. Das bisherige Plugin kann später deinstalliert werden.

Support

everysize Business → Shop-Integration: https://business.everysize.com/shop-integration

Lizenz

MIT, siehe LICENSE.

everysize / checkout-shopware6

Package info

Security

Statistics