FAQ

Kurze Antworten auf die häufigsten Fragen von Shop-Betreibern, Entwicklern und Einkaufsteams zu punchout.dev. Jede Antwort verweist auf die ausführliche Seite.

Was ist der Unterschied zwischen OCI, cXML und IDS Connect?

Mit allen drei Protokollen öffnet ein Einkaufssystem Ihren Shop und holt den Warenkorb zurück. Sie unterscheiden sich darin, wer sie nutzt. OCI stammt von SAP und wird von SAP SRM und SAP S/4HANA genutzt. cXML nutzen SAP Ariba, Coupa und viele andere Einkaufslösungen. IDS Connect 2.5 ist der Standard der Handwerkersoftware im deutschsprachigen Raum. punchout.dev unterstützt die Warenkorbübergabe aller drei; bei cXML wird der Einstieg auf einen einzelnen Artikel (Level 2) auf Anfrage freigeschaltet. Wie Sie jedes System einrichten, steht unter Einkaufssysteme.

Welche Einkaufssysteme funktionieren damit?

Jedes Einkaufssystem, das OCI, cXML oder IDS Connect spricht. SAP SRM und SAP S/4HANA nutzen OCI. SAP Ariba, Coupa, Jaggaer, Oracle Fusion Procurement und Workday nutzen cXML. Onventis unterstützt beides. Handwerkersoftware verbindet sich über IDS Connect. Siehe Einkaufssysteme.

Funktioniert das mit Shopware, WooCommerce, Magento, Shopify oder meinem eigenen Shop?

Ja, mit jedem Shop, der seine Warenkorbseite im Browser zeigt. Das Script-Tag gehört ins Layout-Template; bei Shopify ist das zum Beispiel die Theme-Datei theme.liquid, die Sie im Shopify-Adminbereich unter Onlineshop → Themes → Code bearbeiten öffnen. Optionale Plugins gibt es für Shopware 6.7, WooCommerce und Magento 2.4. Sie markieren den Warenkorb und ergänzen Auto-Login. Auf anderen Plattformen findet die geführte Warenkorb-Erkennung den Warenkorb, und Auto-Login braucht Ihren eigenen Login-Endpunkt. Siehe Das Tag einbinden, Shop-Plugins und Eigene Integration.

Brauche ich einen Entwickler?

Meist nicht. Wer das Layout-Template des Shops bearbeiten kann, kann das Script-Tag einfügen. Ein Plugin installiert sich wie jede andere Erweiterung für Shopware, WordPress oder Magento. Sendet Ihr Shop eine Content-Security-Policy, muss jemand die vier Zeilen aus dem Tab Einbindung darin ergänzen (siehe unten).

Macht das Script-Tag meinen Shop langsamer?

Nicht spürbar. Das Script lädt mit async und ist gzip-komprimiert kleiner als 25 KB. Ohne laufenden Punchout sendet es nichts und zeigt nichts; normale Kunden sehen es also nie. Während eines Punchouts hält es ein eigenes Cookie für höchstens vier Stunden und liest keine Cookies des Shops. Das Panel bringt eigene Styles mit und lässt das Design des Shops unberührt.

Welche Daten verlassen die Shop-Seite, und wo werden sie verarbeitet?

Nur der Inhalt der Warenkorbseite während eines laufenden Punchouts oder eine Seite, die der Shop-Betreiber bei der Warenkorb-Erkennung bewusst sendet. Ohne Punchout verlässt nichts die Seite. Die Inhalte von Formularfeldern für Passwörter, E-Mail-Adressen, Telefonnummern und Kartendaten bleiben außen vor, und die Cookies des Shops werden nie gelesen. punchout.dev verarbeitet die Warenkorbseite auf eigenen Servern, gehostet bei AWS in Frankfurt, und die Daten bleiben in der EU. Details: Sicherheit und Datenschutz.

Werden Warenkörbe gespeichert?

Nur solange der Punchout läuft. Ein Punchout und der dabei gelesene Warenkorb laufen vier Stunden nach dem Launch ab und werden dann gelöscht. Danach bleiben nur Tageszahlen je Shop, etwa Sitzungen und Übergaben, und die Ergebnisse der Test-Punchouts des Portals, die 30 Tage aufbewahrt werden. Die Liste Aktuelle Sitzungen im Tab Nutzung zeigt für jeden laufenden Punchout den Einkäufer, den Rücksprung-Host, den Status und die Zahl der Positionen, nie den Warenkorb.

Was braucht der Einkäufer von mir?

Einen Einkäufer-Zugang und eine Adresse, beides aus dem Portal. Legen Sie den Zugang im Tab Einkäufer des Shops an; das Secret wird nur einmal angezeigt. Die Adresse steht im Tab Einbindung: OCI-Launch für SAP, cXML PunchOutSetupRequest für Ariba, Coupa und andere cXML-Systeme, IDS Connect Roundtrip-URL für Handwerkersoftware. Siehe Einen Einkäufer verbinden.

Kann ich ohne echten Einkäufer testen?

Ja. Der Tab Einrichtung des Shops hat einen Test-Punchout. Er startet einen echten OCI-, cXML- oder IDS-Connect-Punchout gegen Ihren Shop und öffnet ihn in einem neuen Tab. Legen Sie etwas in den Warenkorb und übergeben Sie ihn im Panel; das Portal zeigt dann, was ein Einkaufssystem bekommen hätte, Position für Position und als Rohdaten. Test-Punchouts funktionieren in der Sandbox und zählen nicht zu den monatlichen Übergaben. Siehe Test-Punchout.

Was passiert, wenn sich mein Warenkorb-Layout ändert?

Mit Plugin passiert nichts: Der Marker sitzt im Warenkorb-Template und wandert mit. Ohne Plugin kann ein Theme-Update den Warenkorb aus dem Container schieben, den die Warenkorb-Erkennung gefunden hat. Das Panel zeigt auf der Warenkorbseite dann „Kein Warenkorb auf dieser Seite“. punchout.dev bemerkt, wenn sich der Warenkorb nicht mehr lesen lässt, und der Tab Nutzung warnt „Der Warenkorb wird nicht mehr gefunden“. Starten Sie die Warenkorb-Erkennung dann im Tab Einrichtung neu. Siehe Warenkorb-Erkennung.

Welche Sprachen spricht das Panel?

Deutsch und Englisch. Das Panel folgt dem lang-Attribut der Shop-Seite oder, wenn die Seite keines hat, der Sprache des Browsers: Deutsch, wenn sie mit de beginnt, sonst Englisch.

Kann ich mehrere Shops in einem Konto betreiben?

Ja. Jeder Shop hat seine eigene Shop-ID, sein eigenes Script-Tag, eigene Einkäufer-Zugänge und eigene Einstellungen. Wie viele Shops eine Organisation haben kann, hängt von ihrem Plan ab. Für Shops, die ein eigenes Team und einen eigenen Plan brauchen, legen Sie eine zweite Organisation an: Sie hat eigene Shops, eigene Mitglieder und eine eigene Abrechnung. Siehe Team.

Mein Shop sendet eine Content-Security-Policy. Was muss ich ergänzen?

Vier Zeilen. Der Abschnitt Content-Security-Policy im Tab Einbindung zeigt sie mit den Werten für Ihren Shop:

script-src https://js.punchout.dev
connect-src https://api.punchout.dev
style-src 'unsafe-inline'
form-action https://<host of each buyer system>:*

Das Panel lädt von js.punchout.dev (script-src), spricht mit api.punchout.dev (connect-src) und hat Inline-Styles (style-src 'unsafe-inline'). Der Warenkorb wird von der Shop-Seite aus an das Einkaufssystem übergeben, dafür ist form-action nötig. Das Portal baut die Zeile form-action aus dem Feld Erlaubte Rücksprung-Hosts im Tab Allgemein, eine Quelle https://<host>:* je Host (jeder Port, weil SAP-Systeme oft auf anderen Ports als 443 antworten). Solange diese Liste leer ist, zeigt es den Platzhalter https://buyer-system.example. Für den Test-Punchout muss form-action zusätzlich https://api.punchout.dev erlauben. Siehe Das Tag einbinden.

Werden Preise brutto oder netto übergeben?

Die Preise werden so übergeben, wie das Einkaufssystem sie erwartet, und Sie wählen im Portal brutto oder netto. Standardmäßig übergibt punchout.dev sie so, wie die Warenkorbseite sie zeigt. Zeigt Ihr Warenkorb Preise inklusive MwSt. und erwartet das Einkaufssystem Nettopreise, stellen Sie im Tab Allgemein des Shops die Preisangabe auf „Inklusive MwSt. — herausrechnen“ und setzen Sie einen MwSt.-Satz; punchout.dev übergibt dann Nettopreise, auf zwei Nachkommastellen gerundet. Handwerkersoftware bekommt Nettopreise und, sobald ein MwSt.-Satz gesetzt ist, zusätzlich Bruttopreise.

Können Einkäufer ihre eigenen Preise sehen?

Ja, mit Auto-Login. Der Launch meldet den Einkäufer in dem Kundenkonto an, das zu seinem Einkäufer-Zugang gehört. Der Warenkorb trägt dann die Preise dieses Kunden. Auto-Login braucht ein Plugin oder Ihren eigenen Login-Endpunkt und funktioniert mit den gehosteten Launches. Ohne Auto-Login kauft der Einkäufer als Gast ein. Siehe Auto-Login.

Kann der Einkäufer den Shop verlassen, ohne einen Warenkorb zu übergeben?

Ja. Zurück zum Einkaufssystem im Panel fragt „Ohne Positionen zum Einkaufssystem zurückkehren?“ und übergibt dem Einkaufssystem nach Ja, zurück einen leeren Rücksprung in dessen eigenem Protokoll. Der Punchout endet dort.

Was kostet das, und was ist die Sandbox?

Die Sandbox ist der kostenlose Plan. Jeder Shop bekommt einen Sandbox-Zeitraum, in dem Einrichtung und Test-Punchouts ohne Kreditkarte funktionieren, im Rahmen des Tagesbudgets. Launches aus einem echten Einkaufssystem werden abgewiesen, bis die Organisation einen bezahlten Plan hat. Jeder Plan enthält eine bestimmte Zahl an Verbindungen; eine Verbindung ist ein aktiver Einkäufer-Zugang, und in einem bezahlten Plan können Inhaber weitere buchen. Das monatliche Übergabe-Kontingent ist ein weiches Limit: Eine Übergabe wird nie abgewiesen, und die Inhaber bekommen bei 80 % und bei 100 % eine E-Mail. Preise und Limits: Preise und Pläne und Sandbox.

Wo liegen die Daten, und ist das DSGVO-konform?

punchout.dev ist bei AWS in Frankfurt gehostet, und die Daten bleiben in der EU. Bei Punchout-Sessions ist der Shop der Verantwortliche und punchout.dev der Auftragsverarbeiter. Aufbewahrungsfristen: Sicherheit und Datenschutz. Unterauftragsverarbeiter und Auftragsverarbeitungsvertrag: Datenschutzerklärung.

Gibt es eine API oder einen MCP-Server?

Heute nicht. Shops, Einkäufer und Einstellungen verwalten Sie im Portal.