Home / Schnittstellen / OCI
OCI
Open Catalog Interface
Einstieg in den OCI-Prozess
Es gibt es zwei Möglichkeiten, in den OCI-Prozess einzusteigen:
1. Via GET (Parameterübergabe in der URL)
2. Via POST (direkt aus bspw. SAP SRM heraus, die Parameter werden in der SAP-Konfiguration hinterlegt)
Der GET-Case setzt voraus, dass Ihnen die HOOK_URL Ihres Systems bekannt ist. Der Einstieg in den OCI-Prozess unserer Onlineshops erfolgt über den Aufruf der folgenden URLS:
https://www.alltron.ch/oci
https://www.alltron.ch/oci/v4
https://business.brack.ch/oci
https://business.brack.ch/oci/v4
https://www.brack.ch/oci
Alle Onlineshops unterstützen den GET- sowohl als auch den POST-Case.
Bitte beachten Sie zwingend:
- Die Schreibweise (Gross- und Kleinschreibung) der URL und der Parameter
- Passwörter dürfen kein &- sowie #-Zeichen enthalten
- Der Ihr-Konto-Bereich/MyAccount der Shops kann nach dem Einstieg via OCI nicht aufgerufen werden
- In den Parametern USERNAME und PASSWORD übergeben Sie Ihre Webshop-Logindaten
Beispiel-URL (GET-Case):
https://www.alltron.ch/oci?HOOK_URL=www.url.ch&USERNAME=oci@brack.ch&PASSWORD=1234
Prozess
- Der Aufruf der OCI-URL meldet den im Parameter USERNAME übergebenen Webshop-Account automatisch in unserem Onlineshop an und speichert die übergebene HOOK_URL. Gleichzeitig wird der Warenkorb geleert.
- Der Warenkorb kann nun mit den gewünschten Produkten befüllt werden.
- Um den Inhalt des Warenkorbes an die übergebene HOOK_URL zu senden, zur Kasse gehen / den Warenkorb anzeigen.
- Zum Übergeben der Produkte an Ihr System drücken Sie bitte am Ende der Warenkorbübersicht den roten Button «OCI SENDEN».
Parameter IN (Übergabe bei Aufruf)
Name | Wert |
---|---|
HOOK_URL | URL an die der Warenkorb gesendet werden soll (Pflichtfeld bei GET) |
USERNAME | E-Mail-Adresse Ihres Webshop-Accounts (Pflichtfeld) |
PASSWORD | Passwort Ihres Webshop-Accounts (Pflichtfeld) |
matgroup | Wenn übergeben, Rückgabe via Parameter NEW_ITEM-MATGROUP | vendor | Wenn übergeben, Rückgabe via Parameter NEW_ITEM-VENDOR |
language | fr/de (Angezeigte Sprache des Shops bei Einstieg) |
FUNCTION=DETAIL&PRODUCTID=SKU | Wenn übergeben, Anzeige entsprechende Produktdetailseite |
Parameter OUT (Rückgabe an das aufrufende System)
Name | Wert |
---|---|
NEW_ITEM-DESCRIPTION | Artikelkurztext |
NEW_ITEM-QUANTITY | Menge |
NEW_ITEM-UNIT | Mengeneinheit (Fixwert PCE) |
NEW_ITEM-PRICE | Artikel Preis (Inkl. oder exkl. MwSt., kann im Shop konfiguriert werden*) |
NEW_ITEM-CURRENCY | Währung (Fixwert CHF) |
NEW_ITEM-LEADTIME | Anzahl Tage von heute bis das Produkt verfügbar ist |
NEW_ITEM-VENDORMAT | SKU (Artikelnummer) |
NEW_ITEM-MATGROUP | eClass-Nummer (oder Wert aus IN Parameter „matgroup“) |
NEW_ITEM-PRICEUNIT | 1 |
NEW_ITEM-CUST_FIELD1 | MwSt.-Prozentsatz |
NEW_ITEM-VENDOR | Wert aus IN Parameter "vendor" |
Wichtige Hinweise
* Ob der Artikelpreis mit oder ohne MwSt. übergeben wird, hängt von der Einstellung ab, wie Sie sich die Artikelpreise im Webshop anzeigen lassen. Sie können die Einstellung im Webshop unter Ihr Konto->Übersicht->Standardeinstellung->Preisanzeige jederzeit ändern.