GitHub

Routen-Paket-Schutz für Shopware 6

Schützen Sie die Bestellungen Ihrer Kunden mit Route Package Protection. Dieses Plugin fügt dem Checkout eine optionale Zusatzposition hinzu und synchronisiert Bestellungen, Sendungen, Rückerstattungen und Schadensmeldungen mit Route.

Table of content

Free 15 min initial consultation directly with our experts.

Free consultation +49 421 438 1919–0

Einleitung

Das Route Package Protection Plugin für Shopware 6 ermöglicht es Händlern, ihren Kunden zuverlässigen Schutz für Bestellungen anzubieten. Durch die Integration einer optionalen Schutzposition direkt im Checkout können Käufer ihre Pakete mit nur einem Klick gegen Verlust, Beschädigung oder Diebstahl absichern. Alle relevanten Informationen zu Bestellungen, Sendungen, Rückerstattungen und Schadensmeldungen werden automatisch mit Route synchronisiert und effizient verarbeitet. Die einfache Installation und nahtlose Einbindung in Shopware machen dieses Plugin zu einer idealen Lösung, um das Einkaufserlebnis sicherer zu gestalten, den Kundenservice zu entlasten und das Vertrauen der Kunden nachhaltig zu stärken.

Funktionen

  • Auto-Hinzufügen der Position „Route Package Protection“ standardmäßig (Kunde kann sie entfernen und erneut hinzufügen)

  • Synchronisierung von Bestellungen mit Route (v2)

  • Erstellen/Aktualisieren/Stornieren von Sendungen (v1)

  • Teilrückerstattungen über das v2-Bestell-Update; vollständige Rückerstattungen über den Cancel-Endpoint

  • Webhook-Endpoint für Schadensfälle mit Signaturvalidierung

  • Konfiguration pro Sales-Channel und eigener Plugin-Logger

Kompatibilität

  • Shopware 6.6.x

  • PHP 8.2+

Installation

1.Kopieren Sie das Plugin in den Ordner custom/plugins/route-package-protection-shopware-6-solution25.

2.Installieren und aktivieren Sie das Plugin über die Shopware-Konsole mit plugin:refresh und plugin:install activate RoutePackageProtection.

3.Falls erforderlich, bauen Sie die Storefront-Assets neu.

Konfiguration

  • Hinterlegen Sie Ihre Route-API-Tokens pro Sales Channel.

  • (Optional) Enable debug logging in the plugin config for verbose logs.

Webhooks

  • Claims-Webhook (Storefront- und API-Scopes):

  • POST /route/webhook/claims

  • POST /api/route/webhook/claims

  • Unterstützt Bearer-Token oder HMAC (route-signature / x-route-signature)

Entwicklerhinweise

  • Das Storefront-JS-Plugin wird asynchron registriert und verwendet window.PluginBaseClass.

  • Eigener Log-Channel, damit die Core-Logs nicht überladen werden.

  • Qualitätstools ausführen: composer phpstan, composer phpcs, shopware-cli extension validate sowie die Plugin-Validierung im Plugin-Verzeichnis.

Support

  • Manufacturer: https://solution25.com

  • Email: support@solution25.com

Lizenz

MIT

Logging

Logdatei: var/log/Route-log–YYYY-MM-DD.log (Rotation, 14 Tage Aufbewahrung)
Nach Änderungen oder bei Problemen kann der Cache mit dem Befehl cache:clear geleert werden.