The Sales Agent Plugin turns Shopware 6 admin users into fully trackable sales agents. Each agent can log in to the Admin, impersonate their assigned customers, place orders on their behalf, negotiate custom product and shipping prices within configurable discount limits, and earn commission automatically calculated on every eligible order.

This version of the plugin extends the core agent functionality with a comprehensive Order Claim system, split commission support, agent-only category access control, abandoned cart email reminders, guest customer conversion, ZIP code auto-fill, and automatic unpaid order cancellation — making it a full-featured sales operations platform built directly into Shopware.

• Admin users acting as sales agents can impersonate their assigned customers directly from the Admin, placing orders on their behalf through the storefront with full customer context.

• Sales agents can override product unit prices on individual line items at checkout, within a configurable maximum discount limit.
• If the entered price exceeds the allowed discount, the cart is blocked with a clear error — preventing unauthorized discounts.
• Per-line-item approval overrides with expiry timestamps can be granted for exceptional cases.

• Agents can also override the shipping cost on an order within their allowed discount limit, giving flexibility for negotiated shipping arrangements.

• Commission is automatically calculated and saved when an order is placed by a sales agent, based on a configurable percentage of the order total.
• Commission is automatically revoked when an order is cancelled, its payment fails, it is refunded (fully or partially), or the delivery is returned.

• Agents can split commission on an order with a second agent by specifying an email address and a percentage split directly from the storefront checkout.
• The split is stored on the order custom fields and visible in the Admin order detail view.
• A dedicated Split Commission tab is available on the order detail page in the Admin.

• Sales agents can claim existing orders that were placed without an agent, assigning themselves or another agent to the order for commission purposes.
• A claim request workflow is available: agents submit a claim request with an optional reason, which a manager can then approve or reject from the Admin.
• Claiming or unclaiming an order automatically triggers a commission recalculation.
• A dedicated Claim Requests section in the Admin lists all pending, approved, and rejected requests.

• Administrators can create named commission rules with their own percentage and maximum discount percentage.
• Rules can exclude specific agents from their scope via a many-to-many agent mapping.

• Each agent can have an individual commission percentage and discount limit configured separately from the global defaults.

• Categories can be flagged as agent-only via a custom field.
• Non-agent storefront users attempting to access these categories or their products are automatically blocked and redirected.
• Agent-only category IDs are cached for 1 hour for performance.
• Orders containing products from agent-only categories are hidden from the standard order list for non-agent customers.

• A dedicated Admin dashboard (Sales King) gives each agent a real-time overview of:
  • KPI cards (linked customers, current orders)
  • Paginated orders grid with status, total, and payment method
  • Paginated customers grid with contact and group info
  • Commission chart (monthly trend)
  • All-time earnings view with year selector and CSV export

• The plugin automatically detects and tracks abandoned carts for logged-in customers.
• Abandoned carts are visible in the Admin under a dedicated Abandoned Carts section, with:
  • Line item detail view
  • Order creation directly from the cart
  • Cart deletion
  • Send Reminder — triggers an email to the customer with optional notes and cart item summary
• Three scheduled tasks run automatically: mark, update, and delete abandoned carts.

• Administrators can convert a guest checkout customer into a registered account directly from the Admin.
• A password recovery email is automatically sent to the customer after conversion.

• In address forms, entering a 5-digit US ZIP code automatically fills in the city and state using the Zippopotam.us API.

• Sales agents can attach order notes and a Do Not Ship Until date to a cart before checkout, which are carried through to the order.

• A scheduled task runs every hour to automatically cancel orders that remain unpaid beyond a configurable threshold, keeping the order backlog clean.

• A dedicated endpoint allows the Admin to validate whether an email address belongs to a configured sales agent, used for split commission and claim workflows.

• A global comma-separated excluded emails list prevents specific agent accounts from earning commissions regardless of orders placed.

• Fine-grained ACL privileges control which admin users can view the Sales King dashboard, manage commissions, access configurations, override prices, manage claim requests, and view abandoned carts.

• Admin interface available in English and German.

• ✅ Shopware 6.6.x
• ✅ PHP 8.1+

1. Clone the plugin into your Shopware plugins directory:

git clone https://github.com/solution25com/sales-agent-shopware-6-solution25.git custom/plugins/SalesAgent

1. Install the Plugin in Shopware 6

   • Log in to your Shopware 6 Administration panel.
   • Navigate to Extensions > My Extensions.
   • Locate the plugin and click Install.

2. Activate the Plugin

   • After installation, click Activate to enable the plugin.
   • Run the following commands from your Shopware root:

bin/console plugin:refresh
bin/console plugin:install --activate SalesAgent
bin/console cache:clear

1. Build Administration & Storefront Assets

bin/console bundle:dump
bin/build-administration.sh
bin/build-storefront.sh
bin/console cache:clear

1. Verify Installation

   • After activation, you will see Sales Agent Plugin for Shopware 6 in the list of installed plugins.

After installing the plugin, configure global defaults and per-agent settings through the Shopware Administration panel.

1. Go to Settings > Sales Agent
2. Select the Sales Channel you want to configure
3. Set the following fields:

A sales agent logs in to the Shopware Admin and navigates to a customer's profile. From there, they can impersonate the customer and place an order on their behalf through the storefront. The agent's identity is tracked via the impersonation context throughout the session.

While building the order, the agent can modify individual product unit prices and the shipping cost directly in the storefront checkout. Each change is validated against the agent's configured discount limit. Exceeding the limit blocks the cart and displays an error message.

If an agent shares the deal with a colleague, they can enter the second agent's email and a commission percentage split in the checkout. Both agents' commission shares are stored on the order and visible in the Admin on the Split Commission tab of the order detail.

When the order is saved, the plugin automatically calculates and records the agent's commission. If a commission was split, both shares are recorded separately. Commission is revoked automatically on cancellation, refund, or return.

For orders placed directly by customers without an agent, a sales agent can submit a claim request from the Admin order detail view. A manager reviews the request and approves or rejects it. On approval, the agent is assigned to the order and commission is recalculated. Managers can also directly claim or unclaim orders without a request workflow.

Categories flagged as agent-only are invisible and inaccessible to regular customers on the storefront. Only impersonating agents or logged-in users with the agent role can browse these categories and their products.

The plugin tracks carts left inactive by logged-in customers. From the Admin Abandoned Carts section, an agent can view the cart contents, send a personalized reminder email to the customer, convert the cart into an order, or delete it.

When a customer checked out as a guest and the agent wants to convert them to a registered account, the Admin provides a one-click Convert Guest action that creates a full customer account and sends a password recovery email.

A scheduled task runs every hour scanning for unpaid orders. Orders that remain unpaid beyond the configured threshold are automatically cancelled, keeping the order backlog clean without manual intervention.

bin/console plugin:deactivate SalesAgent
bin/console plugin:uninstall SalesAgent
bin/console cache:clear

MIT — see LICENSE for details.

For questions or issues, please open a GitHub Issue or contact Solution25.