Feature Lists
16-Nov-2026
Feature List - Universal Commerce Protocol (EN)
Document Properties
Kbid
48V778
Added to KB
16-Nov-2026
Status
online
Product
Intershop Commerce Platform
Last Modified
16-Nov-2026
Public Access
everyone
Doc Type
Feature Lists
Product
Universal Commerce Protocol
Document Link
https://knowledge.intershop.com/kb/48V778
Table Of Contents


Introduction

The Universal Commerce Protocol (UCP) is an open standard that lets AI shopping and procurement agents discover and query commerce catalogs in a machine-readable way. The Intershop UCP integration exposes the non-transactional catalog capabilities of Intershop Commerce Management (ICM) through this protocol. Agents that “speak” UCP can discover the Intershop catalog, run searches, and look up products without a proprietary integration.

The integration is a standalone service. It runs as its own container, independent of the storefront. It acts as a thin, read-only adapter. Agents send UCP requests over REST. The service translates each request to the ICM REST API. It then maps the results back into the UCP product model. The service exposes only non-transactional catalog capabilities. It does not implement or advertise cart, checkout, payment, or order flows.

The integration follows the UCP specification in GitHub | UCP | Release v2026-08-25.

Feature List

Feature

Description

Discovery

  • Machine-readable UCP business profile under /.well-known/ucp

  • Declaration of the catalog Search capability (dev.ucp.shopping.catalog.search)

  • Declaration of the catalog Lookup capability (dev.ucp.shopping.catalog.lookup)

  • Schema and specification links for each declared capability

  • OpenAPI documentation for the Search and Lookup endpoints

  • Advertisement of non-transactional capabilities only

Catalog Search

  • UCP-conformant catalog search through the ICM REST API

  • Free-text query

  • Category filter, forwarded to the ICM category-scoped search

  • Price filter with inclusive minimum and maximum bounds

  • Pagination with cursor and total count

Catalog Lookup and Product Detail

  • Single and batch product lookup by identifier

  • Correlation of each returned variant with the requested identifier

  • Reporting of unknown identifiers as informational messages instead of errors

  • Full product detail with all variants and options

  • Interactive variant selection on the product detail, with per-option availability signals

  • Support for ICM product types: simple products, variation masters, variations, product bundles, and retail sets

  • Product attributes

  • Product images

  • Deep links to the storefront product page for each product and variant

  • Manufacturer exposed as a product tag

  • Prices and price ranges as integer minor units with a currency code as defined in ISO 4217 | Currency Codes

  • Strike-through list price when the list price is higher than the sale price

Localization

  • Language selection per request through the Accept-Language header (RFC Editor | BCP-47)

  • Currency selection per request through the Accept-Currency header (ISO 4217 | Currency Codes)

  • Advertisement of the supported languages and currencies in the UCP profile

  • Echo of the negotiated language in the Content-Language response header

  • Fallback to the channel default for unsupported values

Multi-Channel

  • Optional multi-channel operation from a single instance

  • Binding of request Host values to ICM channels

  • Per-channel overrides for locale, currency, advertised locale and currency sets, public origin, and storefront product links

Operations and Developer Experience

  • UCP-conformant response envelope with product and pagination data

  • Boundary request validation

  • Error handling that hides ICM internals from clients

  • Health endpoint for liveness and readiness probes

  • ECS-compatible JSON logging

  • Interactive playground (disabled by default) with a guided flow and inline validation against the official UCP JSON schemas

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Website, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Home
Knowledge Base
User Manuals
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.