solution25/route-plugin-shopware-6-solution25

Integrates Route package protection with Shopware 6. Adds checkout opt-in, syncs Route claim data and statuses, provides an admin claims list and webhooks, plus a storefront widget.

Maintainers

Details

github.com/solution25com/route-package-protection-shopware-6-solution25

Source

Issues

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Type:shopware-platform-plugin

pkg:composer/solution25/route-plugin-shopware-6-solution25

1.0.0 2025-12-02 15:20 UTC

Requires

Requires (Dev)

MIT 6e507e8c3fa939c3addcb97b4cceef20755d8e16

This package is auto-updated.

Last update: 2025-12-02 18:41:12 UTC

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

  1. Copy the plugin into: custom/plugins/route-package-protection-shopware-6-solution25
  2. Install & activate: bin/console plugin:refresh bin/console plugin:install --activate RoutePackageProtection
  3. 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

License

MIT

Logging

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