OCI – Übersicht
OCI (Open Catalog Interface) ist ein von SAP entwickelter Standard für die Produktkatalog-Anbindung zwischen Procurement-Systemen und Online-Shops. Heute wird OCI von vielen Systemen unterstützt: SAP SRM, SAP Ariba, ivalua und allen OCI-kompatiblen Plattformen.
Der AgiqonConnector unterstützt OCI 4 und OCI 5.
Wie funktioniert OCI Punchout?
Ein OCI-Punchout-Vorgang läuft in drei Phasen ab:
Phase 1 — Login
Das Procurement-System ruft die Login-URL des Shops auf und übergibt dabei:
- Benutzername und Passwort (oder einen Token)
- Die Hook-URL — die Rückgabe-Adresse, an die der Warenkorb später gesendet wird
https://shop.example.com/AgiqonOciEntry/login
?USERNAME=kunde@firma.de
&PASSWORD=geheim
&HOOK_URL=https://procurement.firma.de/return
Der Connector validiert die Zugangsdaten, legt eine neue Transmission an und loggt den Kunden im Shop ein.
Phase 2 — Einkaufen
Der Käufer sieht den Shop wie ein normaler Shopware-Kunde: Produkte suchen, in den Warenkorb legen, Mengen anpassen. Er sieht jedoch statt eines Checkout-Buttons einen „Warenkorb übertragen"-Button.
Phase 3 — Transfer
Beim Transfer sendet der Connector die Warenkorbdaten als HTML-Formular (OCI 4) oder JSON (OCI 5) per POST direkt an die Hook-URL des Procurement-Systems. Der Käufer wird dabei automatisch weitergeleitet.
Procurement-System ←── POST an Hook-URL ── Shopware Shop
(Artikeldaten)
Ab diesem Moment ist der Punchout-Vorgang abgeschlossen. Das Procurement-System verarbeitet die Daten intern weiter (Genehmigung, Bestellung).
OCI 4 vs. OCI 5
| OCI 4 | OCI 5 | |
|---|---|---|
| Übertragungsformat | HTML-Formular (POST) | JSON |
| Feldnamen | NEW_ITEM-DESCRIPTION[n], NEW_ITEM-MATNR[n], … | items[].description, items[].matNumber, … |
| Verbreitung | Sehr weit verbreitet, Klassiker | Modernere Systeme |
| Konfiguration | „OCI-Version: 4" | „OCI-Version: 5" |
Die Version wird pro System festgelegt und beeinflusst nur das Übertragungsformat – die Konfigurationsoberfläche ist identisch.
Login-URL
https://shop.example.com/AgiqonOciEntry/login
Die Parameternamen (USERNAME, PASSWORD, HOOK_URL, TOKEN) können pro System individuell konfiguriert werden. Der Standard entspricht der OCI-Spezifikation.
Logout-URL
https://shop.example.com/AgiqonOciEntry/logout