Eine PunchOut-Verbindung kann technisch klein sein, überschreitet aber Unternehmensgrenzen. Der Lieferant betreibt Magento, der Käufer seine Beschaffungsplattform. Beide Seiten brauchen dieselbe Antwort auf Fragen zu Identität, Produkten, Preisen, Einheiten, Warenkorbrückgabe und Support.
Kurzantwort: Beginnen Sie mit einem benannten Käufer und einem dokumentierten Geschäftsablauf. Sammeln Sie Beispielnachrichten, richten Sie ein eigenes Käuferprofil ein, ordnen Sie Positionsfelder zu, schützen Sie die Endpunkte und testen Sie den zurückgegebenen Warenkorb im echten Freigabeprozess. Bestellungen, Versandmeldungen und Rechnungen sollten nur als klar abgegrenzte weitere Nachrichtenprozesse ergänzt werden.
1. Geschäftlichen Umfang festlegen
- Einkaufsorganisation und Beschaffungsplattform benennen.
- OCI oder cXML samt benötigter Version festhalten.
- Klären, ob Nutzer Warenkörbe anlegen, bearbeiten oder prüfen.
- Magento-Website, Store View und Währung bestimmen.
- Katalog- und Vertragspreisregeln festlegen.
- Entscheiden, ob das Projekt mit der Warenkorbrückgabe endet.
- Bestellungen, Versand und Rechnungen bei Bedarf jeweils separat beschreiben.
„Magento mit Ariba verbinden“ reicht als Spezifikation nicht aus. Käuferidentität, Nachrichten und Pflichtfelder bleiben dabei offen.
2. Verantwortliche benennen
| Bereich | Verantwortlich beim Lieferanten | Verantwortlich beim Käufer | Abgestimmt? |
|---|---|---|---|
| Magento-Konto und Katalog | |||
| OCI- oder cXML-Konfiguration | |||
| Zugangsdaten und Wechsel | |||
| Produkt- und Einheitenzuordnung | |||
| Testsystem der Einkaufsplattform | |||
| Abnahme und Go-live | |||
| Störungseskalation |
PunchOut-Fehler liegen oft zwischen zwei Systemen. Benannte Ansprechpartner verhindern, dass beide Supportteams aufeinander warten.
3. Verbindungsvertrag einsammeln
Für OCI werden Anforderungen an Hook-URL, Anmeldeparameter, Rückgabeziel, Feldliste, Indizes, Version und ein Beispielwarenkorb benötigt.
Für cXML werden ein bereinigter PunchOutSetupRequest, Identity-Domains, Sender- und Shared-Secret-Regeln, erlaubte Operationen, Rückgabeziel, erwartetes PunchOutOrderMessage und Pflicht-Extrinsics benötigt.
Für beide Protokolle gehören dazu:
- Produktkennung
- Liste der Einheitencodes
- Währungs- und Steuererwartung
- Klassifikationsschema
- Sonderfelder und Prüfregeln
- maximale Feldlängen
- Test- und Produktivendpunkte
- Kontakt bei abgelehnten Nachrichten
4. Magento-Käuferprofil einrichten
- Eigenes Profil je Einkaufsorganisation anlegen.
- Zugangsdaten geschützt speichern und Wechsel planen.
- Kunde, Unternehmen oder Kundengruppe zuordnen.
- Website und Store View auswählen.
- OCI- oder cXML-Mapping festlegen.
- Stabile Quelladressen bei Bedarf erlauben.
- Nur benötigte Operationen freigeben.
- Rückgabeziele gegen eine Freigaberegel prüfen.
Unabhängige Käufer sollten kein gemeinsames Sammelprofil verwenden. Getrennte Profile erleichtern Preissteuerung, Sicherheit und Fehlersuche.
5. Mapping aufbauen und abnehmen
Jeder Rückgabewert erhält eine dokumentierte Datenquelle. Unterschiedliche Codes werden über Wertetabellen übersetzt. Transformationen sollten nur eingesetzt werden, wenn ihre Geschäftsregel verständlich ist.
Zu prüfen sind mindestens SKU oder Lieferantenteilenummer, Name, Menge, Einheit, Preis, Währung, Klassifikation, Produkt-URL und Sonderfelder. Bei konfigurierbaren Produkten muss feststehen, ob Eltern-, Kind- oder beide Kennungen benötigt werden.
Ein vom Käufer bestätigtes Beispiel dient später als Referenz bei Änderungen.
6. Sicherheit und Fehlerfälle testen
- Ungültige Zugangsdaten werden ohne verräterische Fehlermeldung abgelehnt.
- Abgelaufene oder wiederverwendete Sitzungen verändern keinen fremden Warenkorb.
- Warenkorbaktionen sind an das PunchOut-Token gebunden.
- Nicht freigegebene Rückgabe-URLs werden abgelehnt.
- Unsichere oder fehlerhafte XML-Eingaben werden gestoppt.
- Shared Secrets erscheinen nicht in Logs und Traces.
- Administrationsrechte folgen dem Minimalprinzip.
- Wiederholungen erzeugen keine doppelten Belege.
7. Ende-zu-Ende-Abnahme durchführen
- Gültige Anmeldung und richtiger Magento-Kontext.
- Falsche Zugangsdaten und unbekannter Käufer.
- Richtiger Katalog und Vertragspreise.
- Ein einfacher Artikel wird angenommen.
- Mehrere Artikel und Mengen.
- Produktoptionen oder konfigurierbare Produkte.
- Einheiten, Währung, Steuer und Klassifikation.
- Anlegen, Bearbeiten und Prüfen, falls verlangt.
- Sitzungsablauf, Doppelklick und Browser-Zurück.
- Freigabe nach der Warenkorbrückgabe.
- Genehmigte Bestellung nach Magento, falls im Umfang.
- Versand- und Rechnungsnachrichten, falls im Umfang.
Für jeden Fall werden erwartetes Ergebnis und Nachweis festgehalten. Eine geöffnete Seite ist noch keine PunchOut-Abnahme.
8. Betrieb vorbereiten
- Go-live-Fenster und Rückfallentscheidung vereinbaren.
- Testzugangsdaten kontrolliert durch Produktivwerte ersetzen.
- Nur die für Support nötigen Protokolle aktivieren.
- Korrelations-IDs und Trace-Zugriff dokumentieren.
- Wiederholt fehlgeschlagene Nachrichten und ausgeschöpfte Versuche überwachen.
- Eskalationskontakte beider Seiten festhalten.
- Zugangsdaten und Mapping regelmäßig prüfen.
- Nach Magento-, Plattform- oder Katalogänderungen erneut testen.
Häufig gestellte Fragen
Wie lange dauert eine Magento-PunchOut-Einführung?
Die Dauer hängt weniger von der Installation als von Käuferspezifikation, Mapping-Abstimmung und Zugang zum Testsystem ab. Ein einzelner Standardkunde ist wesentlich kleiner als eine Einführung für mehrere Käufer und Belegarten.
Sollten OCI und cXML gleichzeitig eingeführt werden?
Nur wenn zwei konkrete Käufer beides verlangen. Meist ist es übersichtlicher, zuerst eine echte Verbindung vollständig abzunehmen und das Betriebsmodell danach auf das zweite Protokoll zu übertragen.
Braucht PunchOut eine Bestellschnittstelle?
Nein. Kataloganmeldung und Warenkorbrückgabe können der vollständige erste Umfang sein. Eingehende Bestellungen werden ergänzt, wenn der genehmigte Auftrag automatisch in Magento ankommen soll.
Was sollte nach dem Go-live überwacht werden?
Abgelehnte Anmeldungen, Rückgabefehler, nicht zuordenbare Werte, abgelaufene Sitzungen, fehlgeschlagene Belegnachrichten und ausgeschöpfte Wiederholungen. Korrelations-IDs helfen beiden Seiten, denselben Vorgang zu besprechen.