Shopware UCP integration

Universal Commerce Protocol — full documentation

Everything you need to enable, extend, and verify the Universal Commerce Protocol on Shopware: shop-owner walkthroughs, plugin-author extension points, polished video tours, and every screenshot used across the guides.

Start with the end-user guideWatch the 2-minute tour
8 pages
End-user guide

Written for shop owners and administrators enabling UCP on their Shopware store.

Open
6 pages
Developer guide

Written for plugin authors, app developers, and core contributors extending Shopware's UCP integration.

Open
Browse videos
Walk-through videos

Polished MP4 walk-throughs (1920×1080, 30 fps) of the Shopware UCP integration.

Open
Browse screenshots
Screenshot gallery

Every screenshot used across the documentation, grouped by surface.

Open
Reference
Runtime flows

This document explains how Shopware's UCP adapter talks to platform agents:

Open
Reference
Shopware field mappings

This document maps UCP response/request fields to the Shopware data that

Open
Reference
Security notes

This document explains the security architecture of Shopware's UCP

Open
Reference
Verification & test results

Last verified locally against the Dockware container shopware-ucp and the

Open
Reference

Overview

This folder is the single landing page for everything around Shopware's

UCP for Shopware — Documentation

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 storeend-user/README.md
A plugin / app developer adding new capabilities or payment-handler supportdeveloper/README.md
A QA engineer / partner integrator testing your shop's UCP complianceend-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 showsLength
🎬 The full 2-minute tourEverything 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 diagram0:30
📺 Configure UCP in the Shopware adminWalk through the new sw-settings-ucp module — list view, capabilities, signing keys0:30
📺 Watch an AI agent shop your storeThe UCP Simulator running a real checkout against a Dockware shop, end-to-end0:40

Repository map

text
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)