Magento 2 Modul

Punchout

Magento 2 PunchOut Modul für OCI- und cXML-Beschaffungsprozesse mit Käufer-Login, kundenspezifischem Shopzugang, Warenkorbrückgabe und Vorlagen für SAP Ariba, Coupa und Oracle Procurement.

Aktuelle Version
1.2.3
Magento
2.4.7 - 2.4.9
PHP
8.1 - 8.5

Wenn Ihre Umgebung von den angegebenen Anforderungen abweicht, prüfen wir die Kompatibilität vorab auf Wunsch. Kontaktieren Sie uns dazu gerne über das Kontaktformular.

Funktionen

Was das Modul kann.

  1. OCI- und cXML-Endpunkte

    Verarbeiten Sie Punchout-Setup und Transfer über dedizierte OCI- und cXML-Routen für standardisierte Beschaffungsprozesse.

  2. Käuferprofile im Admin

    Verwalten Sie Käuferprofile mit Protokollzuordnung, Aktivstatus und verschlüsselten Zugangsdaten zentral im Backend.

  3. Kontexttoken und Sitzungslebenszyklus

    Steuern Sie Punchout-Sitzungen über Token, Korrelation und Ablaufstatus für reproduzierbare Abläufe.

  4. Tokenisierte Cart-API

    Nutzen Sie Add-, Update-, Remove- und Get-Endpunkte für externe Warenkorbsteuerung pro Punchout-Kontext.

  5. Mapping-Profile mit Transformern

    Definieren Sie Feldzuordnungen, Pflichtregeln und Transformationen pro Protokoll ohne Custom-Code je Partner.

  6. Template-basierter Rollout

    Starten Sie Mapping-Profile aus Vorlagen und verkürzen Sie die Einführung neuer Einkaufspartner.

  7. Mehrstufige Sicherheitsprüfung

    Kombinieren Sie IP-Filter, Signaturprüfung, Käuferauthentifizierung und Hook-URL-Validierung für sichere Endpunkte.

  8. Idempotenz und Retry-Kontrolle

    Behandeln Sie wiederholte Requests deterministisch, um Doppelverarbeitung und instabile Integrationsläufe zu vermeiden.

  9. Trace-Viewer mit Export

    Analysieren Sie Punchout-Vorgänge über Trace-Liste, Detailansicht und JSON-Export mit Korrelation.

  10. Simulator für Integrationsabnahmen

    Generieren Sie reproduzierbare Testrequests inklusive Signatur- und cURL-Ausgabe für schnellere Abstimmungen.

  11. Kompatibilitäts- und Prozess-Keywords

    Passend für SAP-OCI-Szenarien und cXML-Prozesse mit SAP Ariba, Coupa und Oracle Procurement sowie für Käuferprofil-Steuerung und Mapping-Regeln.

Beschreibung

So funktioniert es.

SoftwareSilo PunchOut verbindet Magento 2 über OCI und cXML mit betrieblichen Beschaffungssystemen. Ein Einkäufer startet im Einkaufssystem, gelangt ohne zusätzliche manuelle Anmeldung in Ihren Magento-Shop, arbeitet im zugeordneten Kundenkontext und gibt den fertigen Warenkorb zur Freigabe und Bestellung zurück.

Der vertraute Shop bleibt erhalten: Der Einkäufer nutzt weiterhin Ihren normalen Magento-Katalog, die Produktsuche, Produktseiten und den Warenkorb. PunchOut verändert den Einstieg in die Sitzung und das Ziel des fertigen Warenkorbs. Ein getrenntes Katalogsystem ist dafür nicht erforderlich.

OCI und cXML in einem Modul: Das Kernmodul verarbeitet OCI-Login und Warenkorbrückgabe ebenso wie cXML PunchOut Setup und Cart Return. Damit lassen sich SAP-orientierte OCI-Projekte und cXML-Beschaffungsumgebungen ohne zwei getrennte Protokollmodule abbilden.

Vorbereitete Profile für gängige Beschaffungsplattformen: Das Paket enthält Mapping-Vorlagen für SAP OCI 4 und 5, SAP Ariba, Coupa, Oracle Procurement und allgemeine cXML-Szenarien. Die Vorlagen geben dem Projektteam einen dokumentierten Ausgangspunkt. Jedes Feld bleibt an die tatsächlichen Anforderungen des Käufers anpassbar.

Kundenspezifischer Katalog- und Preiskontext: Ein Käuferprofil kann mit einem Magento-Kunden, Unternehmen, einer Preisgruppe, Store View und einem Mapping-Profil verknüpft werden. Nach dem Start der PunchOut-Sitzung kann Magento die Katalogsichtbarkeit und Preise dieses Kundenkontexts anwenden. Das Modul pflegt keine zweite Preisdatenbank.

Warenkorbrückgabe statt Magento-Checkout: Während einer aktiven PunchOut-Sitzung kann die normale Checkout-Aktion durch eine Rückgabeaktion ersetzt werden. Magento überführt den Warenkorb in die benötigten OCI-Formulardaten oder eine cXML PunchOutOrderMessage und sendet ihn an das Einkaufssystem zurück. Freigabe und Bestellanlage bleiben im Beschaffungssystem.

Mappings ohne eigene Codevariante für jeden Käufer: Im Admin lassen sich Magento-Werte aus Produkt, Kunde, Adresse und Warenkorb den erwarteten Feldern des Einkaufssystems zuordnen. Pflichtfelder, Wertumsetzungen, Formatierungen und individuelle Zielschlüssel werden in wiederverwendbaren Mapping-Profilen gepflegt.

Kontrolle über Produkt- und Preisdaten: Standardmäßig sind die Magento-Preise für Warenkorbaktionen maßgeblich. Benötigt eine kontrollierte Integration eingehende Positionspreise, kann dieses Verhalten ausdrücklich in der Store-Konfiguration aktiviert werden. Währungs- und Transferprüfungen verhindern die Rückgabe unvollständiger oder widersprüchlicher Warenkörbe.

Mehr als die erste Warenkorbübergabe: Das Modul stellt Endpunkte für eingehende Bestellungen sowie ausgehende Versandmeldungen und Rechnungen bereit. Eine Dokumentenwarteschlange verarbeitet ausgehende Nachrichten mit Wiederholungsregeln, damit vorübergehende Verbindungsfehler nicht zu manueller Doppelarbeit führen.

Sicherheit pro Verbindung: Zugangsdaten der Käufer werden verschlüsselt gespeichert. Anfragen können anhand erlaubter IP-Bereiche, Signaturen, Protokollzugangsdaten und zusätzlicher Transportauthentifizierung geprüft werden. Rückgabe-URLs werden validiert, bevor Magento Warenkorb- oder Dokumentdaten an ein externes Ziel sendet.

Werkzeuge für Test und Support: Der Admin-Simulator erzeugt wiederholbare OCI- und cXML-Anfragen für Integrationstests. Trace-Einträge verbinden die einzelnen Schritte über eine Korrelationskennung und speichern bereinigte Nutzdaten. So erhalten beide Seiten verwertbare Informationen, wenn Einrichtung oder Transfer scheitern.

Für Magento Open Source und Adobe Commerce: SoftwareSilo PunchOut richtet sich an B2B-Shops, die einen vorhandenen Magento-Katalog mit den Beschaffungssystemen ihrer Kunden verbinden müssen. Besonders sinnvoll ist das Modul, wenn mehrere Käufer unterschiedliche Zugangsdaten, Kundenkontexte, Mappings oder Rückgabeformate benötigen und der Händler diese Unterschiede in Magento verwalten möchte.

Screenshots

So sieht es aus.

Changelog

Was sich geändert hat.

Punchout

Version 1.2.3 - 2026-11-04

Added
  • Added a JAGGAER-oriented cXML cart-return mapping template
Changed
  • Required Magento 2.4.7 or later
  • Required returned auxiliary item identifiers to restore original cart prices and product options
Fixed
  • Allowed independent cXML cart returns to reuse BuyerCookies
  • Buyer-supplied PunchOut inbound order line values now render as plain text in the admin
  • Preserved store-scoped debug logging across the Monolog versions used by supported Magento releases

Version 1.2.2 - 2026-10-19

Fixed
  • Fixed inbound order admin actions crashing on non-exception errors by showing the configured error message instead

Version 1.2.1 - 2026-09-29

Added
  • Added support for iframe (using mageb2b/punchout-iframe package as suggested by composer)
  • OCI 5.0 `QUANTITYCHECK` function: `FUNCTION=QUANTITYCHECK` on the OCI endpoint returns `AVAILABLE_QUANTITY` from the MSI salable quantity (sources minus reservations) and `LEADTIME` from a new optional "OCI Quantity Check Lead Time Attribute" select on the Buyer Profile; requires an OCI 5.0 profile and works without `HOOK_URL`
  • PunchOutOrderMessage `ItemIn` elements now emit sequential `lineNumber` identifiers, and under the "Auxiliary ID then SKU" line-match strategy returned cart lines additionally match on the echoed `lineNumber` (with SKU cross-check) between the auxiliary identifier and unique-SKU fallbacks, preserving duplicate SKU lines in order reconstruction; `sku_only` matching remains strictly SKU-based
Changed
  • OCI login returns a single generic authentication failure for unknown buyers and invalid credentials
Fixed
  • Transfer endpoints, session activation and the active-context resolver now reject contexts that are no longer AUTHENTICATED, so a transferred PunchOut session cannot trigger additional transfers or re-login; request replay still serves recorded responses for retried request keys
  • PunchOut session restore now falls back to logging out the PunchOut customer when no pre-PunchOut session was captured, and browser logout requests authenticated by the session token no longer fail on the procurement IP allowlist while request-supplied tokens keep full security validation
  • Analytics daily metrics no longer trigger an undefined-variable warning on every write and resolve the period date in the store time zone of the PunchOut context instead of the default scope
Add-On: iframe-Integration

Version 1.0.0 - 2026-08-24

Added
  • Initial release

FAQ

Häufige Fragen.

Zum Modul

Was ist ein Magento 2 PunchOut Modul?

Ein Magento 2 PunchOut Modul verbindet den Shop eines Lieferanten mit dem Beschaffungssystem eines Kunden. Der Einkäufer startet im Einkaufssystem, gelangt in einen authentifizierten Magento-Kundenkontext, füllt den Warenkorb und gibt ihn zur Freigabe zurück, statt den normalen Magento-Checkout abzuschließen.

Welche PunchOut-Protokolle unterstützt SoftwareSilo?

SoftwareSilo PunchOut unterstützt OCI und cXML im Kernmodul. Beide Protokolle decken den Einstieg in die Sitzung und die Warenkorbrückgabe ab, unterscheiden sich aber bei Authentifizierung, Nachrichtenaufbau und Feldzuordnung.

Funktioniert SoftwareSilo PunchOut mit SAP Ariba?

Ja. SAP Ariba PunchOut wird über cXML unterstützt. Das Modul enthält Ariba-orientierte Vorlagen für Einrichtung und Warenkorbrückgabe, einschließlich Level-2-Varianten. Das endgültige Mapping sollte trotzdem mit der Konfiguration des Käufers abgeglichen werden.

Kann Magento 2 per PunchOut mit Coupa verbunden werden?

Ja. Coupa-Verbindungen verwenden cXML-Setup und PunchOutOrderMessage. SoftwareSilo liefert Coupa-orientierte Vorlagen und erlaubt die Anpassung von Käuferzugang, Feldmapping und Rückgabeverhalten an das tatsächliche Coupa-Konto.

Wird Oracle Procurement unterstützt?

Ja. Das Modul enthält Oracle-orientierte cXML-Vorlagen für Einrichtung und Warenkorbrückgabe. Da Oracle-Konfigurationen variieren können, sollten Identitäten, Pflichtfelder und Callback-Verhalten während der Integrationstests geprüft werden.

Wird Jaggaer sofort einsatzbereit unterstützt?

Das aktuelle Paket enthält keine eigene Jaggaer-Vorlage. Deshalb bewerben wir Jaggaer nicht als sofort einsatzbereite Integration. Ein Jaggaer-Projekt mit passenden cXML-Flows kann geprüft und nach Klärung der konkreten Anforderungen über das Mapping eingerichtet werden.

Was ist der Unterschied zwischen OCI und cXML PunchOut?

OCI arbeitet häufig mit Browser-Formulardaten und ist besonders in SAP-orientierter Beschaffung verbreitet. cXML überträgt strukturierte XML-Nachrichten und wird oft mit SAP Ariba, Coupa und Oracle Procurement eingesetzt. Das Einkaufssystem des Kunden gibt normalerweise das benötigte Protokoll vor.

Wie funktioniert die PunchOut-Warenkorbrückgabe in Magento 2?

In einer aktiven PunchOut-Sitzung füllt der Einkäufer den Magento-Warenkorb und wählt die Rückgabeaktion. Das Modul prüft den Warenkorb, erstellt OCI-Formulardaten oder eine cXML PunchOutOrderMessage und sendet sie an die freigegebene Rückgabe-URL. Freigabe und Bestellanlage erfolgen anschließend im Einkaufssystem.

Wie werden Käufer und Zugangsdaten verwaltet?

Jede Verbindung erhält ein Käuferprofil mit Protokoll, Store-Zuordnung, Identitäten, Zugangsdaten, Kundenkontext und Mapping. Geheimnisse werden verschlüsselt gespeichert. Für Installationen mit mehreren Store Views sind globale und storespezifische Profile möglich.

Sehen PunchOut-Einkäufer kundenspezifische Kataloge und Preise?

Ja, wenn das Käuferprofil den richtigen Magento-Kundenkontext auflöst. Magento kann dann die Katalogsichtbarkeit und Preise dieses Kunden, Unternehmens, der Preisgruppe und Store View anwenden. Das genaue Ergebnis hängt auch von den installierten Katalog- und Preismodulen ab.

Können Feldzuordnungen je Beschaffungskunde abweichen?

Ja. Mapping-Profile definieren Quellfelder, Zielschlüssel, Pflichtwerte, Formatierung, Transformationen und Wertumsetzungen. Ein Profil kann aus einer mitgelieferten Vorlage entstehen und anschließend angepasst werden, ohne für jeden Käufer eine eigene Modulvariante zu pflegen.

Kann ein Einkaufssystem den Magento-Warenkorb direkt ändern?

Das Modul stellt tokengebundene Endpunkte zum Hinzufügen, Ändern, Entfernen und Lesen von Warenkorbpositionen bereit. Damit lassen sich Integrationen umsetzen, die vor der endgültigen Rückgabe eine kontrollierte Warenkorbsynchronisierung benötigen.

Wie verhindert das Modul doppelte Transfers?

Transfer- und Dokumentenflüsse unterstützen Idempotenzschlüssel. Eine identische Wiederholung kann das gespeicherte Ergebnis zurückgeben. Wird derselbe Schlüssel mit verändertem Inhalt verwendet, behandelt das Modul dies als Konflikt. Das reduziert Doppelverarbeitung nach Timeouts oder Netzwerkfehlern.

Welche Sicherheitsprüfungen stehen zur Verfügung?

Verbindungen können Käuferzugangsdaten, erlaubte IP-Bereiche, Request-Signaturen, HTTPS-Prüfung der Rückgabe-URL und zusätzliche Transportauthentifizierung wie Basic oder Bearer verwenden. Die erforderliche Kombination sollte vor dem Go-Live mit dem Beschaffungspartner abgestimmt werden.

Wie lässt sich eine OCI- oder cXML-Verbindung vor dem Go-Live testen?

Der Magento-Admin-Simulator erzeugt wiederholbare OCI- und cXML-Anfragen, zeigt den Zielendpunkt und liefert eine cURL-Ausgabe. Teams können Login, Warenkorbänderungen, Rückgabedaten, fehlerhafte Anmeldungen und Wiederholungen prüfen, bevor das produktive Käuferkonto verbunden wird.

Wie werden PunchOut-Fehler untersucht?

Trace-Einträge zeigen Protokoll, Richtung, Status, Korrelationsdaten und bereinigte Request-Informationen. Die gemeinsame Korrelationskennung hilft Magento- und Beschaffungsteam, einen Vorgang über Setup, Warenkorb, Transfer und Dokumentenfluss hinweg zu verfolgen.

Unterstützt das Modul Bestellungen, Versandmeldungen und Rechnungen?

Das Modul bietet einen Endpunkt für eingehende Bestellungen sowie ausgehende Flüsse für Versandmeldungen und Rechnungen. Ausgehende Dokumente können über eine Warteschlange mit einstellbarer Paketgröße, maximalen Wiederholungen und Wartezeit verarbeitet werden.

Funktioniert PunchOut mit Magento Open Source und Adobe Commerce?

Das Modul ist für Magento-2-Shops konzipiert und kann in Magento-Open-Source- und Adobe-Commerce-Projekten eingesetzt werden. Vor der Umsetzung sollten Magento-Version, Theme, Kundenmodell, Preismodule und Beschaffungsanforderungen geprüft werden.

Ist ein externer PunchOut-Gateway erforderlich?

Für die im Modul enthaltenen OCI- und cXML-Flows ist kein externer Gateway erforderlich. Das Modul läuft in Magento und kommuniziert mit dem Beschaffungssystem. Ein zusätzlicher Gateway kann trotzdem sinnvoll sein, wenn das Projekt Dienste oder Protokolle außerhalb dieses Umfangs verlangt.

Welche Informationen werden für den Start eines PunchOut-Projekts benötigt?

Vom Käufer werden Protokoll, Identitäten und Zugangsdaten, Login- oder Setup-Format, Rückgabe-URL, Beispielanfragen, benötigte Warenkorbfelder, Währungsregeln, Testkonto und Abnahmeprozess benötigt. Für cXML-Dokumente sollten zusätzlich Bestellung, Versandmeldung und Rechnung abgestimmt werden.

Wie lange dauert eine PunchOut-Implementierung?

Eine feste Dauer wäre unseriös. Eine passende Vorlage und ein reaktionsschneller Testpartner verkürzen das Projekt. Individuelle Mappings, Sicherheitsprüfungen, kundenspezifische Preise oder zusätzliche Dokumentnachrichten erhöhen den Aufwand. Eine Schätzung sollte erst nach Prüfung echter Beispieldaten erfolgen.

Können Gäste eine PunchOut-Verbindung nutzen?

PunchOut basiert auf einer authentifizierten Käuferbeziehung und nicht auf einer anonymen Gastsitzung. Die Anfrage aus dem Beschaffungssystem identifiziert das Käuferprofil und stellt den Kundenkontext für Magento her.

Welcher Preis gilt, wenn das Einkaufssystem Positionspreise mitsendet?

Standardmäßig sind die Magento-Preise maßgeblich. Eingehende Positionspreise werden ignoriert, solange der Shop sie nicht ausdrücklich für eine kontrollierte Integration freigibt. So kann eine externe Warenkorbanfrage Magento-Preise nicht unbeabsichtigt ersetzen.

Kann eine Magento-Installation mehrere PunchOut-Käufer bedienen?

Ja. Käuferprofile trennen Zugangsdaten, Protokoll, Store-Zuordnung, Kundenkontext und Mapping. Mehrere Beschaffungskunden können dieselbe Magento-Installation verwenden, ohne eine gemeinsame Verbindungskonfiguration teilen zu müssen.

Kauf, Lizenz und Support

Für wie viele Magento-Installationen gilt die Lizenz?

Die Lizenz gilt für eine Magento-Installation inklusive Multi-Website-Betrieb. Zusätzlich darf das Modul auf beliebig vielen Entwicklungs- oder Staging-Servern installiert werden. Weitere Details finden Sie in unseren Lizenzbestimmungen.

Ist die Installation im Preis enthalten?

Installation und Konfiguration sind nicht im Preis enthalten. Wir unterstützen Sie auf Wunsch bei einer reibungslosen Integration in Ihr System.

Wie installiere ich ein Modul?

Composer ist der Paketmanager für PHP, den auch Magento 2 für Module und deren Abhängigkeiten nutzt. Nach dem Kauf finden Sie die passenden Befehle in Ihrem Kundenkonto unter Lizenzen. Zuerst hinterlegen Sie das private SoftwareSilo-Repository und Ihren Lizenz-Token. Danach installieren Sie das angegebene Paket mit composer require und führen php bin/magento setup:upgrade sowie php bin/magento cache:clean aus.

Welche Zahlungsmethoden stehen zur Verfügung?

Sie können per Kreditkarte (Stripe) oder per Überweisung (Vorkasse) bezahlen. Bei Kreditkartenzahlung wird die Bestellung sofort verarbeitet und die Zugangsdaten werden direkt in einer weiteren E-Mail bereitgestellt.

Wie läuft der Bestellprozess ab?

Nach Kreditkartenzahlung erhalten Sie unmittelbar Zugangsdaten für den Bezug des Moduls per Composer. Bei Überweisung erhalten Sie den Zugang, sobald die Rechnung bezahlt ist.

Ich benötige eine individuelle Anpassung des Moduls. Ist das möglich?

Individuelle Wünsche sind kein Problem. Wir passen unsere Magento‑2‑Module an Ihr Projekt an und pflegen eine eigene interne Version, sodass wir bei Supportanfragen genau wissen, was in Ihrem System läuft.

Kann ich eine Demo-Version lokal installieren?

Sie können auf der Detailseite des jeweiligen Moduls eine eigene Demo-Instanz anfordern, in der Sie das Modul intensiv 7 Tage testen können. Eine lokale Demo-Version stellen wir jedoch nicht bereit.

Ist der Quellcode verschlüsselt?

Nein, der Quellcode unserer Module ist nicht verschlüsselt. Wenn Sie eine Anpassung wünschen, senden Sie uns gerne eine Anfrage. Wir melden uns zeitnah mit einem unverbindlichen Angebot.

Wie sehen Updates und Support aus?

Sie können Ihrer Bestellung ein Support-Paket hinzufügen. Es umfasst Unterstützung sowie Updates und Upgrades rund um das Modul. Ein dauerhaftes Abo ist nicht erforderlich.

Ich habe bereits eine Lizenz. Wie kann ich ein Update durchführen?

Das Lizenzupdate können Sie bequem hier abschließen. Wenn Sie ein aktives Support-Paket haben, erhalten Sie Updates automatisch via Composer. Falls Ihr Support-Paket abgelaufen ist, können Sie Ihre Lizenz hier oder in Ihrem Kundenkonto verlängern.

Ich habe eine weitere Frage – wie erreiche ich Sie?

Sie erreichen uns jederzeit über E-Mail.

$999.00

Einsatz

Ideal für diese Branchen & Anwendungsfälle

  • ERP- und Beschaffungssystem-Anbindung

    Verbinden Sie Einkaufssysteme über OCI oder cXML direkt mit Ihrem Magento-2-Katalog und Warenkorb.

  • Käuferbezogene Punchout-Flows

    Steuern Sie Zugriffe, Profile und Feldmapping je Käufer für klare Integrationsverantwortung.

  • Retry-sichere Integrationen

    Stabilisieren Sie Transfers bei Netzwerkproblemen durch idempotente Request-Verarbeitung.

  • Mehrere Partner mit individuellen Mappings

    Pflegen Sie pro Partner und Protokoll eigene Feldregeln ohne parallele Codevarianten.

  • Support und Fehleranalyse mit Trace

    Klären Sie Integrationsprobleme schneller über Korrelation, Trace-Details und Exportdaten.

  • Technische Abnahme vor Go-Live

    Testen Sie Endpunkte und Payloads reproduzierbar über den Admin-Simulator vor dem Produktivstart.

Nächste Schritte

Erst ausprobieren. Dann kaufen.

  • Technische Dokumentation

    Praxisnahe Magento-2-Anleitungen, Entwicklerdokumentation und API-Referenzen für Installation, Konfiguration und Troubleshooting.

    Zur Knowledge Base
  • Vor dem Kauf testen

    Fordern Sie eine persönliche Demo an und testen Sie das Modul mit realistischen Beispieldaten im Magento-Admin und im Shop. So können Sie in Ruhe prüfen, ob es zu Ihren Anforderungen und Abläufen passt.

  • Sie benötigen eine individuelle Lösung?

    Ihre Anforderungen gehen über den Funktionsumfang unserer Magento 2 Module hinaus? Wir entwickeln passende Magento 2 Module und Integrationen für Ihre Geschäftsprozesse.

    Jetzt anfragen

Weiterlesen

Leitfäden zu diesem Modul