GitHub

Route Package Protection Shopware 6

Protect your customers’ orders with Route Package Protection. This plugin adds an opt-in line item to the checkout and syncs orders, shipments, refunds and claims with Route. A sensible add-on for UK merchants shipping with Royal Mail, Evri or DPD UK who want to offer customers extra peace of mind.

Inhaltsverzeichnis

Kostenlose 15-minütige Erstberatung direkt mit unseren Experten.

Kostenlose Beratung +49 421 438 1919-0

Introduction

The Route Package Protection plugin for Shopware 6 lets merchants offer their customers reliable order protection. Because an optional protection line item is integrated directly into checkout, shoppers can insure their packages against loss, damage, or theft with just one click. All relevant information on orders, shipments, refunds, and claims is automatically synced with Route and processed efficiently. Easy installation and seamless integration with Shopware make this plugin an ideal solution to make the shopping experience safer, take pressure off customer service, and build lasting customer trust.

Features

  • Auto-add the “Route Package Protection” line item by default (customer can remove and re-add)

  • Sync orders to Route (v2)

  • Create/update/cancel shipments (v1)

  • Partial refunds via v2 order update; full refunds via cancel endpoint

  • Claims webhook endpoint with signature validation

  • Per-sales-channel configuration and dedicated plugin logger

Compatibility

  • Shopware 6.6.x

  • PHP 8.2+

Installation

1. Copy the plugin to the folder custom/plugins/route-package-protection-shopware-6-solution25.

2. Install and activate the plugin via the Shopware console with plugin:refresh and plugin:install activate RoutePackageProtection.

3. Rebuild the storefront assets if required.

Configuration

  • Set your Route API token(s) per Sales Channel.

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

Webhooks

  • Claims webhook (Storefront + API scopes):

  • POST /route/webhook/claims

  • POST /api/route/webhook/claims

  • Supports Bearer token or HMAC (route-signature / x-route-signatur

Developer Notes

  • Storefront JS plugin is registered async and uses window.PluginBaseClass

  • Dedicated log channel to avoid polluting core logs.

  • Run quality tools: composer phpstan composer phpcs shopware-cli extension validate custom/plugins/route-package-protection-shopware-6-solution25

Support

  • Manufacturer: https://solution25.com

  • Email: support@solution25.com

Licence

MIT

Logging

Log file: var/log/Route-log–YYYY-MM-DD.log (rotated, 14-day retention)
After changes or if issues occur, clear the cache with the cache:clear command.

Need help setting up Route Package Protection for your Shopware shop in the UK? solution25 supports UK merchants remotely from Bremen and Prishtina.

Related topics