OCI Punchout

E-Procurement

Open Catalog Interface (OCI) ist eine offene und standardisierte Katalogdatenschnittstelle zum Austausch von Katalog- und Bestelldaten zwischen Systemen zur Beschaffung und Webshops der Lieferanten.

Der OCI-Punchout Standard wurde ursprünglich von SAP ins Leben gerufen. Über diese Schnittstellte greift der Einkäufer direkt auf den aktuellen Katalog im Onlineshop des Lieferanten zu und fügt die gewünschten Artikel dem Warenkorb hinzu.

Nachdem die Artikelauswahl im Webshop des Lieferanten abgeschlossen ist, kann der Einkäufer dann über die Punchout Funktion alle relevanten Informationen des Warenkorbes in sein Einkaufssystem übertragen.

Die weitere Bearbeitung bis zur Bestellung findet im System des Einkäufers statt.

Onboarding Prozess

Sobald die Zuordnung oder auch das Mapping benötigter Felder durchgeführt worden ist (siehe auch unter «OCI Mapping Konfigurationen»), kann OCI auf einem Benutzerkonto freigegeben werden.

(1) Auswahl der anzuwendenden Konfiguration
(2) Bereits verwendete Konfiguration dieses Kontos.
Über das Symbol des Schlüssel wird das Passwort für die OCI Anmeldung gesetzt. Dieses Passwort ist nur für die OCI Anmeldung gültig.

Webserver Konfiguration

Falls die Seite des Shops den HTTP Header X-Frame-Options oder mit einer Content-Security-Policy: frame-ancestors mit sameorigin oder deny ausliefert, kann der Shop beim Einkäufersystem nicht in einem IFrame eingebettet werden. Falls die Verwendung in einem IFrame erforderlich ist, kann das Einkäufersystem in der Content-Security-Policy zugelassen werden.

Content-Security-Policy: frame-ancestors

Content-Security-Policy: frame-ancestors 'self' https://www.kundensystem.ch;

OCI Mapping Konfigurationen

Um Anforderungen unterschiedlicher Einkäufersysteme erfüllen zu können, lassen sich beliebige Konfigurationen mit spezifischen Feldzuordnungen und zusätzlichen Parametern erstellen.

(1) Liste verfügbare Konfigurationen
Um das «Onboarding» neuer Einkäufersysteme zu erleichtern, kann eine bestehende Konfiguration auf Knopfdruck kopiert werden.
(2) Bearbeitung einer einzelnen Konfiguration mit den Grundeinstellungen unter «Basisdaten» und den «Eingehenden Parametern»
(3) Die Zuordnung, bzw. das Mapping einzelner interner Felder auf die Felder der Punchout Funktion
Unter dem Register «Verwendet von» finden Sie die Konten, welche die aktuelle Konfiguration verwenden.

OCI Basis Einstellungen

Neben den selbsterklärenden Feldern wie dem Titel und der Beschreibung können folgendende Einstellungen vorgenommen werden:

(1) Aktivierung, Button im Warenkorb
Eine Konfiguration kann inaktiviert werden. Entsprechende Authentifizierungen sind dann nicht mehr möglich.Die Beschriftung der Schaltfläche im Warenkorb des Shops für die Datenübergabe an das Einkäufersystem.Bei Bedarf kann hier der technische Name der Schaltfläche und deren Wert festgelegt werden.

(2) Funktionsprovider und «Speichern der Antworten» zur Fehlersuche
Dieser behandelt zusätzliche OCI Funktionen wie beispielsweise «VALIDATE» und der Eintrag ist nur erforderlich, wenn diese Funktionen verwendet werden sollen.Wenn «Speichern der Antworten» gesetzt ist, werden HTTP Responses des Einkäufersystems auf dem Webserver im «/Temp» Verzeichnis der Anwendung abgelegt. Dies ist wirksam für die Funktionen, bei welchen der Server direkt mit dem Einkäufersystem kommuniziert, wie beispielsweise bei «VALIDATE».
(3) Steuerung der Verarbeitung der Zusatzkosten
Zusatzkosten wie die Versandkosten eines kompletten Auftrages oder regulatorischer Abgaben auf den Warenzeilen können einzeln oder summiert verarbeitet werden.

OCI Aufrufparameter

Aufruf der OCI Funktion

Vom Einkäufersystem werden beim Aufruf der OCI Funktion gewisse Parameter erwartet. Diese können bei Bedarf beliebig ergänzt werden.

In der folgenden Ansicht sind unter der Ziffer (1) folgenden Einstellungen vorzunehmen:

Parameter für die Hook Url
Falls das Einkäufersystem die «HOOK_URL» nicht im Standardparameter übergibt, kann ein unter (2) erstellter Parameter zugeordnet werden.
GET Parameter aus der «HOOK_URL» in den PunchOut (Formular) integrieren
Wenn aktiviert, werden die in «HOOK_URL» enthaltenen GET-Paramter extrahiert/entfernt und in das Formular als eigene Felder integriert.
HTTP Methode für den Postback (Post ist empfohlen)

Unter der Ziffer (2) sind sowohl die regulären Parameter für den Start am Beispiel einer OCI Sitzung der Version 4.0, als auch zwei optionale Parameter für das ANTRAS CMS ersichtlich. Zusätzlich dazu ein Kunden-, bzw. einkäuferspezifischer Parameter:

DirectoryServiceId
Dient zur Einschränkung der OCI Anmeldung auf Konten des entsprechenden Verzeichnisdienstes
lang
Stellt die OCI Sitzung auf die entsprechende Sprache der Benutzeroberfläche ein. Eine entsprechende Lizenzierung der Sprache ist hierbei erforderlich.
sellerSystemIdSpecific
Das Einkäufersystem erwartet bei jedem Punchout einen festen Wert, welcher hier konfiguriert wurde.

Weitere Einstellungen

Obligatorische Parameter werden beim Aufruf geprüft.
In PunchOut Integrieren
Der Parameter wird beim «PunchOut» zurück an das Einkäufersystem übergeben.

Damit der PunchOut auf andere «targets» als das aktuelle Browser Fenster/Tab funktionieren kann, müssen im Browser des Einkäufers Popups für den OCI Shop zugelassen sein.

OCI Feld Zuordnung

Die Zuordnung, bzw. das Mapping eines internen Feldes auf ein Feld der Punchout Funktion.

(1) Auswahl des internen Feldes aus dem Warenkorb, der Warenzeile, dem Artikel, etc.
(2) Anzeige der Grösse des Felder aus der jeweiligen Schnittstellendefintion (OCI 3.0, 4.0, 5.0)
(3) Auswahl einer optionalen Tabelle für das Transformieren von Informationen
Beispielsweise 'Stk.' nach 'Stk' oder 'PCE'
(4) Modus beim Mapping
Links nach Rechts, Rechts nach Links, Berücksichtigung der Gross- und Kleinschreibung, etc.
(5) Vorbelegter Standardwert
Wird verwendet, falls das Feld in den Daten nicht belegt ist
(6) Verwendung eines festen Wertes
Diese Nutzung übersteuert, bzw. deaktiviert das Mapping mittels der Tabelle aus (3) und den Standardwert

OCI Aufruf

Sobald die notwendigen Konfigurationsarbeiten vorgenommen wurden, kann die Funktion auf dem Einkäufersystem konfiguriert werden.

Die Url lautet idR. https://www.domain.ch/?_oci=
Der Parameter _oci kann auch im POST übergeben werden.

Die beim Aufruf anzuzeigende Seite kann im CMS beim entsprechenden Mandanten in der Registerkarte «Zugeordnete Inhalte» im Feld «Startseite nach der OCI Anmeldung» festgelegt werden.