SAP Ariba (cXML)

Diese Seite zeigt SAP-Ariba-Administratoren, wie sie einen punchout.dev-Shop als cXML-Punchout-Katalog anbinden.

Was Sie brauchen

Angabe	Wert
Punchout-Setup-URL	https://api.punchout.dev/v1/cxml/setup/<shop id>
Domain	Die Credential-Domain, die Ariba sendet, zum Beispiel NetworkID
Kennung	Die Kennung (Identity), die Ariba sendet
Shared Secret	Vom Portal erzeugt oder von Ihnen gewählt (mindestens 16 Zeichen)

Der Shop-Betreiber findet die Setup-URL im Tab Einbindung des Shops unter Launch-URLs für das Einkaufssystem und legt den Einkäufer-Zugang im Tab Einkäufer an. Stimmen Sie Domain und Kennung vorher mit ihm ab. Das Portal bietet NetworkID, DUNS und AribaNetworkUserId zur Auswahl an; jede andere Domain lässt sich als eigene Domain eintragen. Ist auf Ihrer Seite bereits ein Shared Secret gesetzt, wählt der Shop-Betreiber Selbst eingeben und hinterlegt denselben Wert.

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

Wo die URL in Ariba hingehört

In den meisten Installationen sind Setup-URL und Shared Secret Teil der Punchout-Konfiguration des Lieferanten. Läuft der Punchout über das SAP Business Network, stehen sie im Netzwerk-Konto des Lieferanten, bei einem direkten Punchout in Ihrer eigenen Ariba-Konfiguration. Welcher Weg bei Ihnen gilt, hängt davon ab, wie Ihr Unternehmen Punchout organisiert; die Masken zeigt die Ariba-Dokumentation von SAP. Für punchout.dev macht der Weg keinen Unterschied.

Übernehmen Sie Domain, Kennung und Shared Secret zeichengenau so, wie der Shop-Betreiber sie angelegt hat, auch in der Groß- und Kleinschreibung: NetworkID und NetworkId sind zwei verschiedene Domains. Über das SAP Business Network kann Ariba Zugangsdaten senden, die dem Netzwerk gehören und nicht Ihrem Unternehmen. Prüfen Sie, was Ihre Konfiguration sendet, und lassen Sie diese Werte beim Shop-Betreiber hinterlegen.

Der hier beschriebene Punchout öffnet die Landing-Seite des Shops und gibt einen Warenkorb zurück. Den Einstieg auf Artikelebene (Level 2) schalten wir auf Anfrage frei; wenden Sie sich dafür an den Shop-Betreiber, er kommt auf uns zu.

Den Katalog testen

1. Öffnen Sie den Punchout-Katalog aus einer neuen Bestellanforderung in Ariba.
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. Rufen Sie den Katalog erneut auf 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 Artikelnummer, Bezeichnung, Einheit, Preis und Währung in der Bestellanforderung.
• Nach Zurück zum Einkaufssystem schließt Ariba den Punchout, ohne etwas hinzuzufügen.

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 Ariba 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 Ariba meldet	Ursache	Was zu tun ist
Authentication failed	Domain, Kennung oder Shared Secret stimmen nicht, oder der Zugang ist deaktiviert	Gleichen Sie alle drei mit dem Shop-Betreiber ab, auch die Groß- und Kleinschreibung
Unknown tenant or credentials	Die Shop-ID in der Setup-URL ist falsch, oder der Shop ist inaktiv	Lassen Sie sich die URL noch einmal vom Shop-Betreiber geben
Invalid PunchOutSetupRequest	Meist lässt der Shop die Rücksprung-Adresse von Ariba nicht zu	Nennen Sie dem Shop-Betreiber den Hostnamen; er trägt ihn unter Erlaubte Rücksprung-Hosts ein
Supplier not enabled for productive punchout	Der Shop ist noch in der Sandbox	Bei Ihnen ist nichts zu tun. Siehe Pläne und Sandbox

Andere Probleme zeigen sich erst im Shop:

• 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 unter Erlaubte Origins ein.
• Die Schaltfläche „An Einkaufssystem übergeben“ reagiert nicht. Die Content-Security-Policy des Shops blockiert den Rücksprung-Host von Ariba. Der Shop-Betreiber gibt ihn in dieser Policy frei.
• Die Übergabe schlägt nach einer längeren Pause fehl. Ein Punchout ist vier Stunden gültig. Rufen Sie den Katalog neu auf.