SAP OCI

So funktioniert der Aufruf

Im SAP-System ist der Katalog des Lieferanten mit seiner Adresse und festen Aufrufparametern hinterlegt. Wählt der Einkäufer den Katalog, öffnet SAP diese Adresse im Browser und übergibt Anmeldedaten sowie den HOOK_URL, also die Adresse, an die der Warenkorb zurückgehen soll. Der Shop meldet den Einkäufer an und zeigt ihm das Sortiment mit seinen Konditionen.

Ist der Warenkorb vollständig, sendet der Shop über den Browser ein Formular an den HOOK_URL. Jede Position steht in Feldern nach dem Muster NEW_ITEM-<Feld>[n], etwa NEW_ITEM-DESCRIPTION[1], NEW_ITEM-QUANTITY[1], NEW_ITEM-UNIT[1], NEW_ITEM-PRICE[1] und NEW_ITEM-CURRENCY[1]. SAP legt aus diesen Feldern eine Bestellanforderung an.

Versionen und Funktionen

Im Einsatz sind vor allem die Versionen OCI 4 und OCI 5. Neben dem Einkauf mit Rückgabe des Warenkorbs beschreibt die Spezifikation Zusatzfunktionen, die das Einkaufssystem über den Parameter FUNCTION anstößt:

DETAIL zeigt einen Artikel, der schon im Einkaufssystem steht, erneut in der Detailansicht des Katalogs.

VALIDATE fragt die aktuellen Daten eines Artikels im Hintergrund ab, etwa wenn er aus einer Vorlage übernommen wird, mit der Menge für Staffelpreise.

SOURCING ruft den Katalog mit einem Suchbegriff auf und öffnet ihn gleich mit den passenden Treffern.

BACKGROUND_SEARCH durchsucht den Katalog im Hintergrund; das Einkaufssystem zeigt die Treffer aller Kataloge in einer Liste.

DOWNLOADJSON, neu in OCI 5, lädt die Katalogdaten seitenweise als JSON in den Suchindex des Einkaufssystems.

Welche davon genutzt werden, legt das Einkaufssystem des Kunden fest; der Grundfall ist immer der Warenkorb.

Wo SAP OCI genutzt wird

SAP OCI wird vor allem in SAP SRM und SAP S/4HANA für den Katalogeinkauf verwendet. Auch Beschaffungsplattformen außerhalb von SAP binden Lieferantenkataloge per OCI an. Für Lieferanten ist SAP OCI dann wichtig, wenn Geschäftskunden über SAP einkaufen und Artikel samt vereinbarter Preise direkt aus dem Shop übernehmen wollen, statt Kataloge als Datei zu pflegen.

SAP OCI und cXML

SAP OCI und cXML lösen dieselbe Aufgabe: Beide bringen den Warenkorb aus dem Shop des Lieferanten in das Einkaufssystem des Kunden. SAP OCI überträgt die Positionen als Formularfelder; cXML nutzt XML-Dokumente, eröffnet die Sitzung mit einem PunchOutSetupRequest von System zu System und gibt den Warenkorb als PunchOutOrderMessage zurück. Welches Protokoll gilt, bestimmt das Einkaufssystem: SAP SRM und SAP S/4HANA setzen auf SAP OCI, SAP Ariba, Coupa und viele andere auf cXML.

Die Bestellung selbst gehört bei beiden nicht zum Punchout. Sie folgt nach der Freigabe auf einem eigenen Weg, etwa als IDoc ORDERS05, cXML OrderRequest oder openTRANS ORDER.

SAP OCI mit orcamultimedia und punchout.dev

orcamultimedia bietet SAP OCI auf drei Wegen an: als Plugin für Adobe Commerce, Magento 1/2, Shopware 5/6, WooCommerce, OroCommerce und OXID eShop (die SAP OCI Schnittstelle), als OCI-Katalog im Komplettpaket, den das Team von orcamultimedia einrichtet und anbindet, und mit punchout.dev, das jeden Shop über ein einziges Script-Tag zum Lieferanten für SAP OCI und cXML macht.

Die SAP-OCI-Plugins von orcamultimedia unterstützen neben dem Warenkorb DETAIL, VALIDATE, SOURCING, BACKGROUND_SEARCH und DOWNLOADJSON. Mit den beiden letzten findet der Einkäufer die Produkte des Lieferanten in der Suche seines Einkaufssystems, ohne den Katalog zu öffnen.