# SAP Ariba (cXML)

Einen punchout.dev-Shop als cXML-Punchout-Katalog an SAP Ariba anbinden, testen und die Fehlermeldungen von Ariba richtig deuten.

URL: https://punchout.dev/de/docs/buyer-systems/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](https://punchout.dev/de/docs/plugins/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](https://punchout.dev/de/docs/account/plans-and-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.