Open Catalog Interface (OCI)

Der POLLEX-LC WebShop4 verfügt über eine OCI Schnittstelle.


Aufruf

Der Aufruf der Schnittstelle funktioniert folgendermaßen: https://SHOPADRESSE/oci/Index

Hier müssen dann in der Aufruf Query einige Parameter angefügt werden.


HOOK_URL = Verpflichtend. Url an welche das Formular übermittelt werden soll.

returntarget = Optional Ziel der zurückgesendeten Daten

username = Verpflichtend. Benutzername

password = Verpflichtend. Passwort

OCI_VERSION = Optional. Keine Auswirkung aktuell

OPI_VERSION = Optional. Keine Auswirkung aktuell

http_content_charset = Optional: Keine Auswirkung aktuell

FUNCTION = Verpflichtend. Auswahl Methode: DETAIL, VALIDATE, SOURCING, BACKGROUND_SEARCH. (SOURCING Enthält aktuell keine Implementierung.)

PRODUCTID = Abhängig von Methode (Bei angeführten verpflichtend): DETAIL, VALIDATE QUANTITY = Abhängig von Methode (Bei angeführten verpflichtend): VALIDATE

SEARCHSTRING = Abhängig von Methode (Bei angeführten verpflichtend): SOURCING, BACKGROUND_SEARCH, VENDOR = Abhängig von Methode (Bei angeführten verpflichtend): SOURCING


z.B.: https://SHOPADRESSE/oci/Index?Function=DETAIL&HOOK_URL=http://ADRESSE&username=user&password=passw

Antworten

Zurück kommen folgende Antworten and die über HOOK_URL übermittelte Adresse abhängig vom Aufruf

BACKGROUND_SEARCH , VALIDATE


NEW_ITEM-DESCRIPTION[X] = Artikelbezeichnung

NEW_ITEM-QUANTITY[X] = Menge

NEW_ITEM-UNIT[X] = Kundenspezifische Mengeneinheit

NEW_ITEM-PRICE[X] = Preise exkl

NEW_ITEM-CURRENCY[X] = ISO Währungskürzel

NEW_ITEM-PRICEUNIT[X] = Preiseinheit

NEW_ITEM-LEADTIME[X] = Lieferzeit

NEW_ITEM-LONGTEXT_X:132[] = Artikelbeschreibung

NEW_ITEM-VENDORMAT[X] = Sonderartikelnummer 

NEW_ITEM-MANUFACTMAT[X] = Herstellerartikelnummer

NEW_ITEM-EXT_PRODUCT_ID[X] = Artikelindex Webshop

NEW_ITEM-MATGROUP[X] = eClass

Wobei X durch einen 1 basierten Index ersetzt wird. Bei VALIDATE immer 1 da nur 1 Ergebnis geliefert werden kann. Bei BACKGROUND_SEARCH abhängig von Anzahl der Treffer


DETAIL: Ansicht in welcher Artikel in gewünschter Menge in den Warenkorb gelegt werden können.

Nachdem alle Artikel in den Warenkorb gelegt wurden kann dieser mit dem Aufruf von https://SHOPADRESSE/oci/Basket an die über HOOK_URL übermittelte Adresse zurückübermittelt werden. Nachdem Aufruf kann ein Button geklickt werden welcher das Formular übermittelt.

Dabei werden folgende Felder übertragen:

NEW_ITEM-DESCRIPTION[X] = Artikelbezeichnung

NEW_ITEM-MATNR[X] = Kundenspezifische Artikelnummer

NEW_ITEM-QUANTITY[X] = Menge

NEW_ITEM-UNIT[X] = Kundenspezifische Mengeneinheit

NEW_ITEM-PRICE[X] = Preise exkl

NEW_ITEM-CURRENCY[X] = ISO Währungskürzel

NEW_ITEM-PRICEUNIT[X] = Preiseinheit

NEW_ITEM-LEADTIME[X] = Lieferzeit

NEW_ITEM-LONGTEXT_X:132[] = Artikelbeschreibung

NEW_ITEM-VENDORMAT[X] = Sonderartikelnummer

NEW_ITEM-MANUFACTMAT[X] = Herstellerartikelnummer

NEW_ITEM-EXT_PRODUCT_ID[X] = Artikelindex Webshop

NEW_ITEM-VENDOR[X] = Kundenspezifische Lieferantennummer

Nachdem Aufruf von https://SHOPADRESSE/OCI/Basket ist der Warenkorb wieder geleert.


Einstellungen

eClass

In den Storeeinstellungen kann für OCI das eClass Profilierungskriterium angegeben werden.

Es handelt sich hierbei um ein Artikelprofilierungskriterium.

image2022-10-3_10-5-17.png