# Coupa (cXML)

Welche Punchout-URL, Domain, Kennung und welches Shared Secret Sie für einen punchout.dev-Shop in Coupa oder einem anderen cXML-Einkaufssystem eintragen und wie Sie die Verbindung testen.

URL: https://punchout.dev/de/docs/buyer-systems/coupa-cxml/

Diese Seite zeigt Coupa-Administratoren, wie sie einen punchout.dev-Shop in Coupa als cXML-Punchout-Lieferanten einrichten. Die Schritte gelten genauso für jedes andere Einkaufssystem, das cXML unterstützt.

## Was Sie brauchen

| Angabe | Wert |
| --- | --- |
| Punchout-URL | `https://api.punchout.dev/v1/cxml/setup/<shop id>` |
| Domain | Die Credential-Domain, die Coupa sendet, abgestimmt mit dem Shop-Betreiber |
| Kennung | Die Kennung, die Coupa sendet, abgestimmt mit dem Shop-Betreiber |
| Shared Secret | Vom Portal erzeugt oder von Ihnen gewählt (mindestens 16 Zeichen) |

Der Shop-Betreiber findet die URL im Tab Einbindung des Shops unter **Launch-URLs für das Einkaufssystem** und legt den Einkäufer-Zugang im Tab Einkäufer an. Haben Sie in Coupa schon ein Shared Secret festgelegt, 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 Coupa.

## Was Sie in Coupa eintragen

In Coupa sind die Punchout-Einstellungen üblicherweise Teil des Lieferantenstammsatzes. Je nachdem, wie Ihre Instanz organisiert ist, pflegt sie Ihr Coupa-Administrator oder der Lieferant selbst im Coupa Supplier Portal. Die Feldnamen unterscheiden sich von Release zu Release, die aktuelle Maske zeigt die Coupa-Dokumentation. Die Tabelle ordnet die Felder deshalb nach ihrer Bedeutung zu:

| Coupa-Feld (nach Bedeutung) | Eintrag |
| --- | --- |
| Punchout-URL | `https://api.punchout.dev/v1/cxml/setup/<shop id>` |
| Protokoll | cXML |
| Domain | Die abgestimmte Domain, zum Beispiel `NetworkID` oder `DUNS` |
| Kennung | Die abgestimmte Kennung |
| Shared Secret | Das Secret des Zugangs |

Tragen Sie die Domain so ein, wie Sie sie abgestimmt haben, auch in der Groß- und Kleinschreibung: `DUNS` und `duns` sind zwei verschiedene Domains.

Der Punchout öffnet die Landing-Seite des Shops und gibt einen Warenkorb zurück. Den Einstieg auf Artikelebene (Level 2) schalten wir auf Anfrage frei.

## Den Punchout testen

1. Öffnen Sie den Punchout des Lieferanten aus einer neuen Bestellanforderung in Coupa.
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. Starten Sie den Punchout 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 Artikelnummer, Bezeichnung, Einheit, Preis und Währung im Coupa-Warenkorb.
- Nach **Zurück zum Einkaufssystem** schließt Coupa den Punchout, ohne etwas hinzuzufügen.

punchout.dev übergibt die Preise so, wie Coupa 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 Coupa 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 Punchout-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 Coupa 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 Coupa. 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. Starten Sie ihn neu.