Ihre Systeme anbinden

Ein Punchout einrichten

Kanal, Sortiment und Zugangsdaten für die OCI- oder cXML-Verbindung eines Kunden anlegen, und sie gegen sein echtes System testen.

Das hier ist die Einrichtung für einen Punchout-Kunden. Punchout wird je Vertrag eingerichtet und nicht einmal je Plattform: Ein zweiter Kunde bedeutet einen zweiten Kanal, ein zweites Sortiment und einen zweiten Satz Zugangsdaten.

Bevor Sie beginnen. Lesen Sie Punchout erklärt, falls noch nicht geschehen. Vom Kunden brauchen Sie: welchen Standard (OCI 4, OCI 5 oder cXML), den Namen seines Beschaffungssystems, einen technischen Ansprechpartner, der einen Testaufruf auslösen kann, und seine Testumgebung. Von Ihrer Seite brauchen Sie das vereinbarte Sortiment und die vereinbarten Preise, beides geklärt, bevor Sie anfangen.

1. Den Kanal anlegen

  1. Öffnen Sie Configuration › Kanäle.
  2. Wählen Sie Neuer Kanal.
  3. Vergeben Sie einen Code, den Sie in einem Jahr in einem Protokoll noch wiedererkennen: punchout-acme statt channel3. Über den Code grenzt sich alles Weitere ein.
  4. Setzen Sie den Typ auf PunchOut.
  5. Ordnen Sie den Markt zu. Der Markt trägt Währung, Locales und Steuerklassen, die dieser Einkäufer sieht. Ein Kunde, der in CHF bestellt, braucht einen Schweizer Markt und keinen Rabatt auf einen EUR-Preis.
  6. Setzen Sie Produkte ohne Zuordnung zu diesem Kanal sind auf Ausgeblendet bis zur Zuordnung. Das ist die wichtige Einstellung: Der Kanal zeigt dann nur, was Sie ausdrücklich hineinlegen.
Lassen Sie diese Einstellung auf Von der Mandanteneinstellung erben, während der Mandantenstandard offen ist, zeigt dieses Punchout Ihren gesamten Katalog: jeden Artikel und jeden Preis, auch die, die mit diesem Kunden nie verhandelt wurden. Schließen Sie den Kanal, bevor Sie Zugangsdaten übergeben.

2. Das Sortiment zuordnen

Ordnen Sie die vereinbarten Produkte dem Kanal zu. Bei einem verhandelten Sortiment ist das normalerweise eine gefilterte Auswahl aus der Produktliste statt ein Klick je Artikel: eine Produktgruppe, ein Hersteller, oder die Artikel auf der Vertragsliste.

Prüfen Sie dann vom anderen Ende her: Filtern Sie die Produktliste nach diesem Kanal und zählen Sie. Sagt der Vertrag etwa 2.400 Artikel und Sie sehen 18.000, ist etwas zugeordnet, das nicht zugeordnet sein sollte.

3. Die Daten beschaffungstauglich machen

Beschaffungssysteme lehnen Positionen ab, die eine Webseite anstandslos darstellen würde. Bestätigen Sie vor dem Go-Live für jeden Artikel in diesem Kanal:

FeldAnforderung
MengeneinheitVorhanden, und ein Code, den deren System akzeptiert, kein Freitext
Bestellmengenschritt / VerpackungseinheitVorhanden, damit 1 nicht eine Palette bedeutet
HerstellerteilenummerVorhanden und verschieden von Ihrer eigenen Artikelnummer
SteuerklasseGesetzt, und korrekt für den Markt
KurzbeschreibungReiner Text, innerhalb deren Längenlimit

Nutzen Sie die Vollständigkeit, gefiltert auf diesen Kanal, um die Arbeitsliste zu erzeugen. An diesem Schritt verlieren Punchout-Projekte ihre Wochen. Erledigen Sie ihn vor der Verbindung statt während der Testrunde.

4. Die Preise setzen

Der Einkäufer muss den Preis sehen, den sein Vertrag nennt. Bestätigen Sie, dass die Konditionen des Kunden (Vertragspreise, Staffelpreise und Währung) für diesen Kanal aufgelöst werden, bevor jemand von außen testet. Ein Punchout, das einem Vertragskunden Listenpreise zeigt, ist der schnellste Weg, das Projekt zu verlieren. Siehe So funktioniert die Preisfindung.

5. Verbindung und Zugangsdaten anlegen

Es gibt keinen einzelnen „Punchout“-Bildschirm. Ein Punchout setzt sich aus drei Teilen zusammen: dem Kanal aus Schritt 1, Zugangsdaten, und einem Connector oder Workflow, der den Hin- und Rückweg abwickelt.

  1. Öffnen Sie Integrations › Zugangsdaten und legen Sie Zugangsdaten für diesen Kunden an. Benennen Sie sie nach dem Kanal (punchout-acme), damit ein Ausführungsprotokoll lesbar ist. Legen Sie das Shared Secret oder Passwort unter Integrations › Secrets ab und referenzieren Sie es.
    • Bei OCI ruft das System des Kunden Sie mit Benutzername und Passwort in der Aufruf-URL auf.
    • Bei cXML tauschen Sie eine Identity, eine Domain und ein Shared Secret aus. Diese Werte stammen aus dem Setup-Blatt des Kunden und müssen exakt übereinstimmen, einschließlich Groß- und Kleinschreibung.
  2. Installieren oder konfigurieren Sie den Punchout-Connector aus Extend and Develop › Marketplace, oder bauen Sie den Hin- und Rückweg als Workflow. Er muss drei Dinge kennen: den Standard (OCI 4, OCI 5 oder cXML), den Kanal aus Schritt 1, und die Kundenorganisation, zu der dieser Vertrag gehört. Diese letzte Verknüpfung sorgt dafür, dass eine eingehende Sitzung zum richtigen Sortiment und zu den richtigen Preisen aufgelöst wird.
  3. Setzen Sie den Sitzungs-Timeout. Neunzig Minuten sind ein vernünftiger Standard: lang genug, dass ein Einkäufer unterbrochen werden kann, kurz genug, um abzulaufen.
  4. Konfigurieren Sie die Warenkorbrückgabe: bei OCI die HOOK_URL, die deren System beim Aufruf mitgibt, bei cXML das Ziel der PunchOutOrderMessage. Prüfen Sie das Feld-Mapping für die zurückgegebenen Positionen: welches Ihrer Felder NEW_ITEM-MATNR, NEW_ITEM-VENDORMAT, NEW_ITEM-UNIT und den Rest füllt.
  5. Konfigurieren Sie die Bestellübertragung separat: ein Connector, oder ein Workflow, den das Event order.placed auslöst. Das Punchout übergibt einen Warenkorb; die Bestellung kommt danach als eigene Nachricht an.
  6. Senden Sie dem Kunden seine Setup-URL und die Zugangsdaten, über einen Weg, der keine unverschlüsselte E-Mail ist.

6. Gegen sein echtes System testen

Ihr eigener Testaufruf beweist, dass Ihr Endpunkt antwortet. Über seine Installation, die angepasst ist, beweist er nichts.

  1. Bitten Sie seinen technischen Ansprechpartner, aus seiner Testumgebung heraus ein Punchout auszulösen.
  2. Beobachten Sie, wie die Sitzung aufgelöst wird: richtiger Kunde, richtiges Sortiment, richtige Preise.
  3. Lassen Sie einen Einkäufer, keinen Administrator, einen Warenkorb mit mindestens drei Positionen bauen, darunter eine mit einer sperrigen Mengeneinheit.
  4. Übergeben Sie den Warenkorb und lassen Sie bestätigen, was in der Bedarfsanforderung angekommen ist, Feld für Feld.
  5. Führen Sie die Bedarfsanforderung durch die Freigabe bis zur Bestellung, und bestätigen Sie, dass die Bestellung im vereinbarten Format bei Ihnen ankommt. Punchout und Bestellübertragung sind zwei verschiedene Nachrichten, und dieser Schritt ist der, der übersprungen wird.

Was Sie prüfen

  • Der Einkäufer sieht nie eine Anmeldemaske.
  • Die Artikelzahl im Punchout stimmt mit dem Vertrag überein.
  • Die Preise stimmen mit dem Vertrag überein, einschließlich Staffelpreisen.
  • Jede übergebene Position trägt eine Mengeneinheit und eine Herstellerteilenummer.
  • Die Bestellung kommt an und lässt sich ohne Abtippen verarbeiten.

Weiter