README

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.

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

Copy the plugin into: custom/plugins/route-package-protection-shopware-6-solution25
Install & activate: bin/console plugin:refresh bin/console plugin:install --activate RoutePackageProtection
Build storefront assets (if needed): bin/build-storefront.sh

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-signature).

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

License

MIT

Logging

File: var/log/Route-log--YYYY-MM-DD.log (rotates, 14 days retained) bin/console cache:clear

solution25/route-plugin-shopware-6-solution25

包简介

README 文档