Einkaufssysteme

Dieser Bereich richtet sich an Administratoren, die einen punchout.dev-Shop als Punchout-Katalog in einem Einkaufssystem eintragen, etwa in SAP SRM, S/4HANA, SAP Ariba, Coupa oder einer Handwerkersoftware.

Systeme und Protokolle

System	Protokoll	Anleitung
Healy Hudson	OCI (über Veenion)	OCI-Anleitung
SAP S/4HANA	OCI	SAP SRM und S/4HANA (OCI)
SAP SRM	OCI	SAP SRM und S/4HANA (OCI)
Synertrade	OCI	OCI-Anleitung
Veenion (impact ordering)	OCI	OCI-Anleitung
Coupa	cXML	Coupa (cXML)
GEP SMART	cXML	cXML-Anleitung
GHX	cXML	cXML-Anleitung
hubwoo (heute Proactis)	cXML	cXML-Anleitung
Ivalua	cXML	cXML-Anleitung
Jaggaer (JAGGAER ONE)	cXML	cXML-Anleitung
Oracle (Fusion Procurement, iProcurement)	cXML	cXML-Anleitung
SAP Ariba	cXML	SAP Ariba (cXML)
Wescale	cXML	cXML-Anleitung
Workday (Procurement)	cXML	cXML-Anleitung
Basware	OCI oder cXML	OCI-Anleitung, cXML-Anleitung
Onventis	OCI oder cXML	OCI-Anleitung, cXML-Anleitung
Proactis	OCI oder cXML	OCI-Anleitung, cXML-Anleitung
Medius	Auf Anfrage	hello@punchout.dev
Unite (Mercateo)	Auf Anfrage	hello@punchout.dev
Handwerker- und Großhandels-Software	IDS Connect	Handwerkersoftware (IDS Connect)

Grundlage der Tabelle ist die öffentliche Dokumentation der Hersteller. Systeme, die hier fehlen, funktionieren genauso, sofern sie den Punchout über OCI, cXML oder IDS Connect starten.

Welche Seite brauche ich?

Ihr System	Lesen Sie
SAP SRM oder SAP S/4HANA	SAP SRM und S/4HANA (OCI)
Ein anderes OCI-System	SAP SRM und S/4HANA (OCI): gleiche Schritte, nur die Menüs heißen anders
SAP Ariba	SAP Ariba (cXML)
Coupa	Coupa (cXML)
Ein anderes cXML-System	Coupa (cXML) oder SAP Ariba (cXML): gleiche Schritte, nur die Masken heißen anders
Handwerkersoftware	Handwerkersoftware (IDS Connect)

Was jeder Einkaufs-Administrator wissen muss

Die Launch-URL

Im empfohlenen Aufbau ruft Ihr System nicht den Shop auf, sondern punchout.dev. Erst wenn die Anmeldung stimmt, öffnet punchout.dev den Shop im Browser des Benutzers. Jeder Shop hat je Protokoll eine eigene Adresse, die seine Shop-ID enthält:

Protokoll	Launch-URL
OCI	https://api.punchout.dev/v1/oci/launch/<shop id>
cXML	https://api.punchout.dev/v1/cxml/setup/<shop id>
IDS Connect	https://api.punchout.dev/v1/ids/launch/<shop id>

Der Shop-Betreiber findet alle drei im Portal im Tab Einbindung des Shops unter Launch-URLs für das Einkaufssystem und gibt Ihnen die Adresse, die Ihr System braucht.

Der Einkäufer-Zugang

Für jedes Einkaufssystem legt der Shop-Betreiber im Tab Einkäufer des Shops einen eigenen Einkäufer-Zugang an und gibt Ihnen die Daten: Benutzername und Passwort bei OCI und IDS Connect, Domain, Kennung und Shared Secret bei cXML. Das Portal zeigt ihm das Secret nur ein einziges Mal. Erneuert er es, ist das alte Secret sofort ungültig, und jeder Launch schlägt fehl, bis Sie das neue eingetragen haben.

Bei cXML müssen Domain und Kennung zu dem passen, was Ihr System sendet. Stimmen Sie beides deshalb vorher mit dem Shop-Betreiber ab. Seine Schritte beschreibt Einen Einkäufer verbinden.

Der Warenkorb kommt über den Browser zurück

punchout.dev schickt den Warenkorb nicht von Server zu Server an Ihr System. Der Browser des Benutzers übergibt ihn an die Rücksprung-Adresse, die Ihr System bei jedem Launch mitschickt. Diese Adresse muss deshalb im Browser des Benutzers erreichbar sein, aus dem Internet dagegen nicht.

Der Shop-Betreiber kann festlegen, welche Rücksprung-Adressen Warenkörbe empfangen dürfen. Tut er das, nennen Sie ihm den Hostnamen der Rücksprung-Adresse Ihres Systems. Sendet der Shop eine Content-Security-Policy, muss auch diese den Host erlauben, sonst blockiert der Browser die Übergabe. Beides stellt der Shop-Betreiber ein.

Der erste Test ist ein echter Punchout

Mit dem Test-Punchout des Portals kann der Shop-Betreiber den Ablauf vorab durchspielen (siehe Test-Punchout). Das prüft die Seite des Shops. Ihr eigener erster Test sollte ein echter Launch aus Ihrem System sein:

1. Öffnen Sie den Katalog aus einem neuen Einkaufswagen oder einer neuen Bestellanforderung, so wie ein Benutzer es tun würde.
2. Der Shop öffnet sich mit dem Punchout-Panel. Legen Sie zwei oder drei Artikel in den Warenkorb des Shops und öffnen Sie die Warenkorbseite. Das Panel zeigt die Positionen an.
3. Klicken Sie auf An Einkaufssystem übergeben. Die Positionen erscheinen im Warenkorb Ihres Systems.
4. Rufen Sie den Katalog noch einmal auf und klicken Sie auf Zurück zum Einkaufssystem. Ihr System erhält einen Warenkorb ohne Positionen.

Ein Punchout ist ab dem Launch vier Stunden gültig. Danach schlägt die Übergabe fehl, und der Benutzer muss den Punchout neu starten.

Achtung

Solange ein Shop in der Sandbox ist, weist er Launches aus echten Einkaufssystemen ab. Ihr Test endet dann auf einer Seite mit „Punchout nicht freigeschaltet“ (OCI, IDS Connect) oder mit der Meldung „Supplier not enabled for productive punchout“ (cXML). Das liegt am Plan des Shops, nicht an Ihrer Konfiguration. Siehe Pläne und Sandbox.