SAP SRM und S/4HANA (OCI)

Diese Seite zeigt SAP-Administratoren, wie sie einen punchout.dev-Shop in SAP SRM oder SAP S/4HANA als OCI-Katalog eintragen. Bis auf die SAP-Begriffe gilt sie für jedes Einkaufssystem, das OCI unterstützt.

Was Sie vom Shop-Betreiber brauchen

Angabe	Beispiel	Wo der Shop-Betreiber sie findet
OCI-Launch-URL	https://api.punchout.dev/v1/oci/launch/pob_live_…	Tab Einbindung, Launch-URLs für das Einkaufssystem, OCI-Launch
Benutzername	SAP-SRM-01	Tab Einkäufer, Kennung des Einkäufer-Zugangs
Passwort	(einmal angezeigt)	Tab Einkäufer, beim Anlegen oder Erneuern des Zugangs

Schränkt der Shop-Betreiber die Rücksprung-Adressen unter Erlaubte Rücksprung-Hosts ein, nennen Sie ihm den Hostnamen der Rücksprung-Adresse Ihres SAP-Systems.

Was Sie in SAP eintragen

In SAP legen Sie einen OCI-Katalog üblicherweise als Web-Service an: in SAP SRM und im On-Premise-S/4HANA im Customizing, in S/4HANA Cloud in der App „Settings for Web Services“. Masken und Menüpfade hängen vom Release ab; die SAP-Dokumentation zu Ihrem Release zeigt sie. Der Katalogaufruf braucht diese Einträge:

Parameter	Typischer Typ	Wert
Aufruf-URL	URL	https://api.punchout.dev/v1/oci/launch/<shop id>
USERNAME	Fester Wert	Der Benutzername vom Shop-Betreiber
PASSWORD	Fester Wert	Das Passwort vom Shop-Betreiber
HOOK_URL	Rücksprung-URL	Kein Wert: SAP setzt die Rücksprung-Adresse zur Laufzeit selbst ein
FUNCTION	(keiner)	Weglassen oder leer lassen

Verwenden Sie POST, dann erscheint das Passwort weder in der Adresszeile noch im Verlauf des Browsers. GET funktioniert ebenfalls. Bei POST gehören alle Parameter in die Aufrufstruktur und keiner in die Aufruf-URL.

punchout.dev unterstützt nur den klassischen Katalogaufruf. Aktivieren Sie für diesen Katalog deshalb keine Katalogfunktionen wie Validierung oder Hintergrundsuche.

Braucht Ihr Katalogaufruf andere Parameternamen als USERNAME und PASSWORD, kann der Shop-Betreiber sie im Portal im Tab Allgemein unter Erweiterte Einstellungen anpassen.

Alternativ kann der Katalog mit den OCI-Parametern direkt auf den Shop zeigen, dann allerdings nur per GET. Besser ist die gehostete URL oben, denn nur sie prüft die Anmeldung, bevor sich der Shop öffnet.

Den Katalog testen

1. Legen Sie in SAP einen Einkaufswagen an und öffnen Sie daraus den neuen Katalog.
2. Legen Sie zwei oder drei Artikel in den Warenkorb des Shops und öffnen Sie die Warenkorbseite.
3. Prüfen Sie die Positionen, die das Panel anzeigt, und klicken Sie auf An Einkaufssystem übergeben.
4. Öffnen Sie den Katalog erneut und klicken Sie auf Zurück zum Einkaufssystem.

So sieht ein erfolgreicher Test aus

• Der Shop öffnet sich mit dem Punchout-Panel, das „Punchout aktiv“ anzeigt.
• Auf der Warenkorbseite zeigt das Panel die Positionen mit Menge und Preis.
• Nach der Übergabe stehen die Positionen mit Bezeichnung, Menge, Einheit, Preis und Währung im SAP-Einkaufswagen.
• Nach Zurück zum Einkaufssystem kehrt SAP ohne neue Positionen zum Einkaufswagen zurück.

Hat der Shop-Betreiber für Ihren Zugang Auto-Login eingerichtet, ist der Benutzer im Shop gleich mit dem zugeordneten Shop-Konto angemeldet und sieht dessen Preise.

punchout.dev übergibt die Preise so, wie SAP sie erwartet. Ob sie brutto oder netto ankommen, legt der Shop-Betreiber im Portal fest. Brauchen Sie die andere Variante, bitten Sie ihn, im Tab Allgemein die Preisangabe umzustellen.

Wenn der Test fehlschlägt

Was Sie sehen	Ursache	Was zu tun ist
Eine Seite „Zugang verweigert / Access denied“	Benutzername oder Passwort stimmen nicht, oder der Zugang ist deaktiviert	Gleichen Sie beides mit dem Shop-Betreiber ab oder lassen Sie sich ein neues Passwort geben
Dieselbe Seite	Der Shop lässt die Rücksprung-Adresse Ihres SAP-Systems nicht zu	Nennen Sie dem Shop-Betreiber Ihren Hostnamen; er trägt ihn unter Erlaubte Rücksprung-Hosts ein
Dieselbe Seite	Die Aufruf-URL enthält eine falsche Shop-ID, FUNCTION ist gesetzt, oder die Rücksprung-Adresse fehlt	Prüfen Sie den Katalogaufruf anhand der Tabelle oben
Eine Seite „Punchout nicht freigeschaltet / Punchout not enabled“	Der Shop ist noch in der Sandbox	Bei Ihnen ist nichts zu tun. Siehe Pläne und Sandbox
Der Shop öffnet sich ohne Punchout-Panel	Der Shop leitet den Browser auf eine Adresse um, die nicht für punchout.dev eingetragen ist, zum Beispiel mit oder ohne www.	Der Shop-Betreiber trägt diese Adresse im Tab Allgemein unter Erlaubte Origins ein
Die Schaltfläche An Einkaufssystem übergeben reagiert nicht	Die Content-Security-Policy des Shops blockiert Ihren Rücksprung-Host	Der Shop-Betreiber gibt Ihren Host in dieser Policy frei
Die Übergabe schlägt nach einer längeren Pause fehl	Ein Punchout ist vier Stunden gültig	Öffnen Sie den Katalog neu

Die Seite „Zugang verweigert“ sieht bei jeder Ursache gleich aus. Das ist Absicht: Sie soll nichts über den Shop oder den Zugang verraten. Gehen Sie die Ursachen deshalb der Reihe nach durch.