Commerce Quality Incident

Commerce Quality Incident brings structured quality incident tracking to Commerce. Track product defects, quality issues and customer complaints as first-class entities linked to orders, order items and product variations, with configurable categories, severity levels and a workflow built for quality assurance teams.

Features

• Quality incident entity linked to Commerce orders, order items and product variations
• state_machine workflow (Open, Investigating, Resolved, Closed) with reopen support and one-click transition buttons
• Incident numbers via Commerce Number Pattern (e.g. QI-2026-00001)
• Plugin-based incident categories using PHP 8 Attributes: a generic default plugin plus a footwear/bags vertical example, each with dynamic subcategories
• Severity levels (low, medium, high, critical)
• Resolution notes enforced when closing an incident
• Activity log timeline using Commerce Log
• Incidents displayed on Commerce order admin pages, with cascading Order, Order item and Product variation selection

Post-Installation

Configure incident types at /admin/commerce/config/quality-incident-types: pick the workflow, the number pattern, the incident category plugin and the default severity. The team then works from the listing at /admin/commerce/quality-incidents.

Additional Requirements

• Commerce 2.x or 3.x (the Order, Number Pattern and Log submodules)
• State Machine

Recommended modules/libraries

• Commerce Make-to-Order: with the bundled QI-MTO integration submodule, create replacement or repair production orders directly from quality incidents, with resolution type tracking on both sides.
• Commerce Order Amend: amend placed orders when a resolution changes what has to be delivered.