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

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.