PunchOut über OCI (erweiterte Funktionen)

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

Zusätzlich benötigte Parameter:

  • FUNCTION = DETAIL
  • PRODUCTID = Bestellnummer des Produktes

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

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


Validation of a Product

Zusätzlich benötigte Parameter:

  • FUNCTION = VALIDATE
  • PRODUCTID = Bestellnummer des Produktes
  • QUANTITY = Gewünschte Menge

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

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


Sourcing / Product Search

Zusätzlich benötigte Parameter:

  • FUNCTION = SOURCING
  • SEARCHSTRING = Suchbegriff

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

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


Background Search

Zusätzlich benötigte Parameter:

  • FUNCTION = BACKGROUND_SEARCH
  • SEARCHSTRING = Suchbegriff

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

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


DOWNLOADJSON

Zusätzlich benötigte Parameter:

  • FUNCTION = DOWNLOADJSON
  • PAGESIZE = Anzahl an Produkten pro Seite
  • REQUESTEDPAGE = Nummer der angeforderten Seite (bei initialer Request leer)

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

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 ü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

© 2020 - 2022
netzdirektion | Gesellschaft für digitale Wertarbeit mbH