Overview
The hosted UCP Scanner & Simulator uses the official stable
UCP for Shopware — Documentation
Current scanner baseline — 14 October 2026
The hosted UCP Scanner & Simulator uses the official stable UCP 2026-08-25 specification. The storefront readiness entry links to the Agentic Commerce Alliance and its readiness scanner.
Current profile checks use the published profile schema, canonical keys,
required service/payment registries, schema authority binding, exact component
versions and version-pinned leaf profiles. Catalog pagination uses
pagination.limit, pagination.cursor and has_next_page; MCP requests use
arguments.meta and capability payload objects. AP2 is now named
dev.ucp.common.payment.ap2_mandate; loyalty is dev.ucp.common.loyalty.
The existing 2026-01-23 compatibility path remains available. New optional capabilities and dynamic composition of all request/response schemas are not certified by these checks. Historical Shopware adapter results and videos below were not rerun for this release and should not be read as current conformance evidence.
This folder is the single landing page for everything around Shopware's Universal Commerce Protocol (UCP) integration: the admin UI for shop owners, the simulator for QA and partners, and the developer extension points for plugin authors.
Audiences
| You are… | Start here |
|---|---|
| A shop owner / merchant / admin enabling UCP on your store | end-user/README.md |
| A plugin / app developer adding new capabilities or payment-handler support | developer/README.md |
| A QA engineer / partner integrator testing your shop's UCP compliance | end-user/06-simulator.md and developer/05-simulator-api.md |
What is UCP?
The Universal Commerce Protocol is an open standard for agentic commerce.
It lets AI commerce platforms — ChatGPT, Perplexity, Gemini, Claude, custom
agents — autonomously discover, browse, build carts, and check out at any
UCP-compliant business through a uniform interface. The protocol is
deliberately decoupled from any specific shop platform; Shopware ships a
first-class implementation in its core (gated behind the UCP_SERVER
feature flag during incubation) plus a separate shop-agnostic UCP
Simulator that can test any UCP-compliant business.
The full specification lives at ucp.dev.
Current local verification: the Shopware adapter passes the full simulator matrix against Dockware, covering all published scenarios once via REST and once via MCP.
Detailed verification evidence is tracked in
test-results.md, including PHPUnit, direct REST/MCP
smokes, simulator scenarios, and the official upstream UCP conformance suite.
Runtime protocol handshakes are described in flows.md, and the
Shopware-to-UCP field mapping is documented in mappings.md.
Walk-through videos
Four polished MP4 walkthroughs (1920×1080, 30 fps) sit in
videos/:
| What it shows | Length | |
|---|---|---|
| 🎬 The full 2-minute tour | Everything in one go: problem → architecture → all 10 capabilities → admin walkthrough → simulator end-to-end → developer extension points → outro. The canonical introduction. | 2:00 |
| 📺 What is UCP? | 30-second elevator pitch, with the architecture diagram | 0:30 |
| 📺 Configure UCP in the Shopware admin | Walk through the new sw-settings-ucp module — list view, capabilities, signing keys | 0:30 |
| 📺 Watch an AI agent shop your store | The UCP Simulator running a real checkout against a Dockware shop, end-to-end | 0:40 |
Repository map
documentation/ ← you are here
├── end-user/ ← shop-owner / admin docs
├── developer/ ← plugin / capability author docs
├── images/ ← all screenshots used in the docs
│ ├── admin/
│ ├── simulator/
│ ├── storefront/
│ └── diagrams/
└── videos/ ← polished walk-through videos
shopware/src/Core/Framework/Ucp/ ← Shopware core UCP foundation
shopware/src/Administration/.../sw-settings-ucp/← Admin UI module
simulator/ ← shop-agnostic UCP simulator
ucp/docs/specification/ ← UCP protocol spec (upstream)