OCI-Funktionen (FUNCTION-Parameter)
Neben dem normalen Punchout-Ablauf unterstützt der Connector spezielle OCI-Funktionen, die das Procurement-System direkt beim Login per FUNCTION-Parameter anfordern kann. Damit lassen sich bestimmte Aktionen im Shop gezielt auslösen – ohne dass der Käufer den Shop manuell bedient.
Der Parameter wird an die Login-URL angehängt:
https://shop.example.com/AgiqonOciEntry/login
?USERNAME=...
&PASSWORD=...
&HOOK_URL=...
&FUNCTION=DETAIL
&PRODUCTID=SW-10001
Unterstützte Funktionen
DETAIL
Öffnet die Detailseite eines bestimmten Produkts im Shop.
| Parameter | Pflicht | Beschreibung |
|---|---|---|
PRODUCTID | Ja | Produktnummer des gesuchten Artikels |
Ablauf: Der Connector sucht das Produkt anhand der Produktnummer und leitet direkt zur Produktdetailseite weiter. Der Käufer kann das Produkt von dort in den Warenkorb legen und wie gewohnt übertragen.
VALIDATE
Gibt Preise und Verfügbarkeit für ein bestimmtes Produkt zurück, ohne dass der Käufer den Shop aufruft.
| Parameter | Pflicht | Beschreibung |
|---|---|---|
PRODUCTID | Ja | Produktnummer |
QUANTITY | Ja | Gewünschte Menge |
Ablauf: Der Connector legt das Produkt mit der angegebenen Menge in den Warenkorb und sendet die Artikeldaten sofort als OCI-Formular an die Hook-URL des Procurement-Systems zurück. Der Käufer sieht den Shop nicht. Die Session wird nach der Übertragung beendet.
SOURCING
Startet eine Produktsuche im Shop.
| Parameter | Pflicht | Beschreibung |
|---|---|---|
SEARCHSTRING | Ja | Suchbegriff |
Ablauf: Der Connector leitet direkt auf die Suchergebnisseite des Shops weiter. Der Käufer sieht die Treffer und kann Produkte auswählen, in den Warenkorb legen und übertragen.
BACKGROUND_SEARCH
Führt eine Suche im Hintergrund durch und überträgt alle Treffer direkt an das Procurement-System.
| Parameter | Pflicht | Beschreibung |
|---|---|---|
SEARCHSTRING | Ja | Suchbegriff |
Ablauf: Der Connector führt die Suche serverseitig aus und legt alle gefundenen Produkte in den Warenkorb. Anschließend werden die Artikeldaten sofort als OCI-Formular an die Hook-URL des Procurement-Systems zurückgesendet. Der Käufer sieht den Shop nicht. Die Session wird nach der Übertragung beendet.
DOWNLOADJSON
Liefert einen paginierten Produktkatalog als JSON (OCI 5).
| Parameter | Pflicht | Beschreibung |
|---|---|---|
pagesize | Nein | Anzahl der Produkte pro Seite (Standard: 50) |
requestedpage | Nein | Gewünschte Seite |
transactionid | Nein | Transaktions-ID des Procurement-Systems |
cti | Nein | Catalog Transfer Interface-Kennung |
Ablauf: Der Connector gibt den vollständigen Produktkatalog des Shops seitenweise als JSON zurück. Diese Funktion wird von OCI-5-Systemen genutzt, um den Katalog des Shops automatisch zu importieren, anstatt einen manuellen Punchout durchzuführen.
QUANTITYCHECK
Gibt den verfügbaren Lagerbestand für ein bestimmtes Produkt als JSON zurück.
| Parameter | Pflicht | Beschreibung |
|---|---|---|
PRODUCTID | Ja | Produktnummer |
Ablauf: Der Connector gibt die Verfügbarkeit als JSON zurück:
{
"AVAILABLE_QUANTITY": 42,
"LEADTIME": ""
}
Die Session wird nach der Abfrage beendet.
Hinweis
Nicht alle Procurement-Systeme unterstützen alle FUNCTION-Modi. Welche Funktionen aktiv genutzt werden, ergibt sich aus der Konfiguration und den Möglichkeiten des jeweiligen Procurement-Systems.