Einleitung
Das Universal Commerce Protocol (UCP) ist ein offener Standard, mit dem KI-Agenten für Einkauf und Beschaffung Commerce-Kataloge maschinenlesbar finden und abfragen können. Die Intershop UCP-Integration stellt die nicht transaktionalen Katalogfunktionen von Intershop Commerce Management (ICM) über dieses Protokoll bereit. Agenten, die UCP „sprechen“, können ohne eine proprietäre Integration den Intershop-Katalog entdecken, Suchen ausführen und Produkte nachschlagen.
Die Integration ist ein eigenständiger Dienst. Sie läuft in einem eigenen Container, unabhängig von der Storefront des Shops, und arbeitet als schlanker, rein lesender Adapter. Agenten senden UCP-Anfragen über REST. Der Dienst übersetzt jede Anfrage in einen Aufruf der ICM-REST-API und bildet die Ergebnisse wieder auf das UCP-Produktmodell ab. Der Dienst stellt ausschließlich nicht transaktionale Katalogfunktionen bereit. Warenkorb, Checkout, Zahlung und Bestellabläufe werden weder umgesetzt noch angeboten.
Die Integration folgt der UCP-Spezifikation in GitHub | UCP | Release v2026-08-25.
Funktionsübersicht
Funktion | Beschreibung |
|---|
Auffindbarkeit | Maschinenlesbares UCP-Business-Profil unter /.well-known/ucp Deklaration der Capability Katalogsuche (dev.ucp.shopping.catalog.search) Deklaration der Capability Katalog-Lookup (dev.ucp.shopping.catalog.lookup) Links auf Schema und Spezifikation für jede deklarierte Capability OpenAPI-Dokumentation für die Endpunkte Search und Lookup Ausschließlich nicht transaktionale Capabilities werden angeboten
|
|---|
Katalogsuche | UCP-konforme Katalogsuche über die ICM-REST-API Freitextsuche Kategoriefilter, der an die kategoriebezogene Suche in ICM weitergegeben wird Preisfilter mit Unter- und Obergrenze Seitenweise Ausgabe mit Cursor und Gesamtzahl der Treffer
|
|---|
Katalog-Lookup und Produktdetails | Abfrage einzelner oder mehrerer Produkte im Stapel über ihre Kennung Zuordnung jeder zurückgegebenen Variante zur angefragten Kennung Unbekannte Kennungen werden als Hinweis gemeldet statt als Fehler Vollständige Produktdetails mit allen Varianten und Optionen Interaktive Variantenauswahl in den Produktdetails, mit Verfügbarkeitssignalen je Option Unterstützung der ICM-Produkttypen: einfache Produkte, Variation Master, Variationen, Produktbundles und Retail Sets Produktattribute Produktbilder Deep Links auf die Produktseite in der Storefront für jedes Produkt und jede Variante Hersteller als Produkt-Tag Preise und Preisspannen als ganzzahlige kleinste Währungseinheit mit einem ISO 4217 Währungscode Durchgestrichener Listenpreis, wenn der Listenpreis über dem Verkaufspreis liegt
|
|---|
Lokalisierung | Sprachauswahl je Anfrage über den Header Accept-Language (BCP-47) Währungsauswahl je Anfrage über den Header Accept-Currency (ISO 4217) Angabe der unterstützten Sprachen und Währungen im UCP-Profil Rückgabe der ausgehandelten Sprache im Antwort-Header Content-Language Rückfall auf den Standard des Channels bei nicht unterstützten Werten
|
|---|
Multi-Channel | Optionaler Betrieb mehrerer Channels aus einer einzigen Instanz Zuordnung der Host-Werte einer Anfrage zu ICM Channels Überschreibungen je Channel für Locale, Währung, angebotene Locales und Währungen, öffentliche Adresse und Produktlinks in der Storefront
|
|---|
Betrieb und Developer Experience | UCP-konforme Antwort mit Produktinformationen und Angaben zur Seitenauswahl (Paging) Prüfung der Anfragen an der Systemgrenze Fehlerbehandlung, die ICM-Interna vor den Clients verbirgt Health-Endpunkt für Liveness- und Readiness-Prüfungen ECS-kompatibles JSON-Logging Interaktiver Playground (standardmäßig deaktiviert) mit geführtem Ablauf und direkter Prüfung gegen die offiziellen UCP-JSON-Schemata
|
|---|