PunchOut über OCI

Wir unterstützen den PunchOut über das OCI-Protokoll. Die Funktionen die in OCI 5.0 hinzugekommen sind (Validate, Sourcing, Detail u.ä.) werden ebenfalls unterstützt. Bitte achten Sie darauf, dass das aufrufende System alle Parameter per HTTP-POST übergibt.

Aufruf des PunchOut-Kataloges

Rückgabe an das einkaufende System

Auf dem Rückweg in das aufrufende System übergeben wir für den Warenkorb die nachfolgenden Werte für jede Position zurück an das aufrufende System. Sie haben die Möglichkeit für jeden Ihrer PunchOut-Kunden eine eigene Feldzuordnung zu konfigurieren.

Erweiterte OCI-Funktionen (nur OCI 5.0)

Dieses Dokument beschreibt den Zugriff auf die mit dem OCI-Standard in der Version 5.0 eingeführten erweiterten OCI-Funktionsaufrufe.

Hinweis: Bei allen Funktionalitäten wird die kundenindividuelle Feldzuordnung berücksichtigt.

Detailed Display of a Product or Service

Über diese Funktionalität erreichen Sie die Detailansicht eines Produktes, welches anhand der Bestellnummer identifiziert wird.

Zusätzlich benötigte Parameter:

Beispielhafte URL:

https://punchcommerce.de/punchout/oci/handle?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=DETAIL&PRODUCTID=50123

Validation of a Product

Mittels dieser Funktionalität können die Eigenschaften des Produktes validiert werden. Der Parameter "QUANTITY" dient zur Feststellung des korrekten Preises bei Staffelpreisen.

Zusätzlich benötigte Parameter:

Beispielhafte URL:

    https://punchcommerce.de/punchout/oci/handle?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=VALIDATE&PRODUCTID=50123&QUANTITY=10

Sourcing / Product Search

Diese Funktionalität entspricht einer Suche, welche eine Liste aller passenden Produkte zurückgibt.

Zusätzlich benötigte Parameter:

Beispielhafte URL:

    https://punchcommerce.de/punchout/oci/handle?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=SOURCING&SEARCHSTRING=knopf

Background Search

Diese Funktionalität entspricht einer Suche, welche die Ergebnisse im OCI Format mittels versteckter Eingabe-Felder übergibt.

Zusätzlich benötigte Parameter:

Beispielhafte URL:

    https://punchcommerce.de/punchout/oci/handle?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=BACKGROUND_SEARCH&SEARCHSTRING=knopf

DOWNLOADJSON

Mit dieser Funktionalität wird der gesamte Katalog in Teilstücken (Seiten) übertragen. Das Format, in dem Daten übertragen werden, ist JSON. Welche Produkte auf einer Seite stehen berechnet sich ausschließlich über die Seitengröße und die angeforderte Seite. Mit jeder übertragenen Seite werden folgende Information zusätzlich zu den Produkten an das aufrufende System übergeben:

• CURRENTPAGE = Die aktuelle Seitennummer
• TOTALPAGES = Die Anzahl an Seiten, welche über die Seitengröße und der Anzahl an Produkten bestimmt wird
• TOTALITEMS = Die Anzahl an Produkten im Katalog
• CTI = Das "Complete Transfer Indicator"-Flag, welches anzeigt, ob alle Produkte bereits über die erste Seite transferiert werden

Zusätzlich benötigte Parameter:

Beispielhafte URL:

    https://punchcommerce.de/punchout/oci/handle?USERNAME=Beispiel&PASSWORD=Passwort&HOOK_URL=https://test.de&FUNCTION=DOWNLOADJSON&PAGESIZE=20&REQUESTEDPAGE=3

Weitere Informationen zum OCI-Protokoll

Eine weiterführende Dokumentation zum OCI 5.0 Standard finden Sie im Wiki der SAP unter https://wiki.scn.sap.com/wiki/download/attachments/395284636/OCI_50_EN20130121.pdf