OCI – Login konfigurieren

Im Tab Allgemein sind unter „Login" alle Einstellungen aufgeführt, die bestimmen, wie das Procurement-System den Punchout-Vorgang startet.

HTTP-Anfragemethode

Option	Beschreibung
GET & POST	Beide Methoden werden akzeptiert (Standardeinstellung, empfohlen)
GET	Nur GET-Anfragen erlaubt
POST	Nur POST-Anfragen erlaubt

Variablennamen

Das Procurement-System übergibt Benutzerdaten und Rückgabe-URL als URL-Parameter oder POST-Body. Die Feldnamen sind im OCI-Standard vorgegeben, können aber von System zu System abweichen.

Variablenname	Standard	Beschreibung
Variablenname Benutzer	USERNAME	Parametername für E-Mail-Adresse oder Benutzername
Variablenname Passwort	PASSWORD	Parametername für das Passwort
Variablenname URL	HOOK_URL	Parametername für die Rückgabe-URL
Variablenname Token	TOKEN	Parametername für einen Token (alternativ zu Passwort)

Beispiel

Ein SAP-System sendet möglicherweise ~username statt USERNAME.

Token-Authentifizierung

Als Alternative zum Passwort kann ein Token verwendet werden. Das Token wird in einem Shopware Custom Field des Kunden gespeichert.

Feld	Beschreibung
Variablenname Token	Parametername, den das Procurement-System für den Token verwendet
Token-Benutzerdefiniertes Feld	Technischer Name des Shopware Custom Fields am Kundenprofil, in dem das Token hinterlegt ist

Beim Login vergleicht der Connector den übermittelten Token mit dem Wert im Custom Field des passenden Shopware-Kunden.

Weitere Optionen

Option	Standard	Beschreibung
URL validieren	ein	Prüft, ob HOOK_URL eine gültige HTTP/HTTPS-URL ist. Ausschalten, wenn das System eine nicht-HTTP-URL übergibt (z.B. SAPEVENT:POST bei SAP).
Gastsitzung	ein	Der Kunde wird in einer isolierten Gast-Session eingeloggt. Er hat einen eignen Warenkorb, erhält aber alle Kundenspezifischen Preise und Rabatte. Ausschalten, wenn der Kunde in seiner regulären Session eingeloggt werden soll.

Beispiel-Login-URL (GET)

https://shop.example.com/AgiqonOciEntry/login
  ?USERNAME=kunde@firma.de
  &PASSWORD=geheim
  &HOOK_URL=https://procurement.firma.de/oci/return

Beispiel mit Token

https://shop.example.com/AgiqonOciEntry/login
  ?TOKEN=abc123xyz
  &HOOK_URL=https://procurement.firma.de/oci/return

Häufige Probleme

Login schlägt fehl — „URL-Validierung"
Wenn das Procurement-System eine nicht-HTTP-URL als Hook-URL übergibt (z.B. SAPEVENT:POST), deaktiviere die Option URL validieren.

Kunde kann sich nicht einloggen

• Ist der Kunde dem System im Tab Kunden zugewiesen?
• Ist das System auf Aktiv gestellt?
• Stimmt der Lizenzschlüssel?
• Stimmen die Variablennamen (z.B. ~username statt USERNAME)?