Mittels SSO-Schnittstelle kann eine automatisierte Anmeldung und Registrierung von Benutzern vorgenommen werden. In der Regel wird die Schnittstelle dazu verwendet, dass die Daten von einem Kundensystem (z.B. durch ein CMS oder CRM-System, Intranet oder Procurementplattform) aufbereitet werden. Über einen Link mit speziell verschlüsselten Query String wird die PRINT LOUNGE aufgerufen.
Die URL lautet wie folgt:
http[s]://[www.]shopname.print-server.net/sso.php?h=ENCODED_KEY_VALUE_PAIRS
Für shopname wird der Shopname angegeben der in der Administration der Print-Lounge (Verwaltung - Kunden - bearbeiten) eingestellt wurde. Bitte konfigurieren Sie in der Administration Ihres Shops die SSO Schnittstelle (Verwaltung - Kunden - bearbeiten - SSO-Schnittstelle) und verwenden Sie die dort ein gestellte Passphrase um die Daten zu verschlüsseln.
| Bezeichnung | Typ / Wert | Bemerkung | Version |
|---|---|---|---|
| request_time * | Datum und Uhrzeit (ISO 8601) | Zeitpunkt des Aufrufs (Standardgültigkeit des Requests 500s - 8 min) | since 4.3.23 |
customer_user_name * | 50 Zeichen (A-Z0-9_-.@) | Benutzen Sie eindeutige Zuordnungen wie UserIds, E-Mails oder Benutzernamen | |
customer_user_budgetgruppe__id | Integer | Wird keine Benutzergruppe übergeben, wird der Benutzer in einer definierten Standardbenutzergruppe angelegt. Gleiches gilt, wenn das System anhand der ID keine gültige Benutzergruppe ermitteln kann. | |
customer_longname | 50 Zeichen (Utf8) | ||
customer_user_businessunit | 50 Zeichen (Utf8) | ||
customer_user_purchaser | 50 Zeichen (Utf8) | ||
customer_user_company1 | 200 Zeichen (Utf8) | ||
customer_user_company2 | 200 Zeichen (Utf8) | ||
customer_user_company3 | 200 Zeichen (Utf8) | ||
customer_user_street | 200 Zeichen (Utf8) | ||
customer_user_zip | 10 Zeichen (Utf8) | ||
customer_user_town | 200 Zeichen (Utf8) | ||
customer_user_country | 200 Zeichen (Utf8) | Veraltet, nutzen Sie customer_user_countrycode | |
| customer_user_countrycode | Ländercode (ISO 3166) | since 4.2.10 | |
customer_user_costcenter | 200 Zeichen (Utf8) | ||
customer_user_telefon | 200 Zeichen (Utf8) | ||
customer_user_telefax | 200 Zeichen (Utf8) | ||
customer_user_email | 100 Zeichen (Utf8) | ||
| user_groups_binary_url | 200 Zeichen (Utf8) | URL für Logo (Bild) einer Benutzergruppe | |
| user_groups_binary_description | 50 Zeichen (Utf8) | Beschreibung für Logo (Bild) einer Benutzergruppe | |
customer_user_internet | 100 Zeichen (Utf8) | ||
customer_user_mobil | 50 Zeichen (Utf8) | ||
customer_user_kundennummer | 100 Zeichen (Utf8) | ||
customer_user_level | Integer | ||
freigabeportal_zeigen | 53: Ja | ||
customer_user_aussendienst | 200 Zeichen (Utf8) | ||
customer_funktion | 200 Zeichen (Utf8) | ||
sprache | de: Deutsch (Standard) (veraltet) | ||
customfield1 | 200 Zeichen (Utf8) | ||
customfield2 | 200 Zeichen (Utf8) | ||
customfield3 | 200 Zeichen (Utf8) | ||
customfield4 | 200 Zeichen (Utf8) | ||
customfield5 | 200 Zeichen (Utf8) | ||
customer_user_level | 57: A - Benutzer (Standard) | ||
dest_page | wg: Eine Warengruppenseite | ||
dest_id | Die ID des Eintrags (Warengruppe oder Artikel) | ||
qty | Die Anzahl aus der Preisstaffel (Wird keine Anzahl übermittel, ermittelt das System die kleinste Preisstaffel für den jeweiligen Artikel) | ||
skip_cart | 53: Ja | ||
| continue_shopping | Zeigt im Warenkorb den Button "Weiter einkaufen". 0: Deaktivieren Achtung: Beim Aktivieren wird die Variable "skip_cart" ignoriert. | ||
| pers_data | Dient der Übermittlung von Personalisierungsdaten (siehe unten) | ||
| test | Zum Aktivieren des Testmodus kann der Parameter „test=true“ übergeben werden. Anstelle der Weiterleitung findet eine Bildschirmausgabe der übergebenen Daten statt. | ||
| lang | de_DE en_EN | ||
| dynamic_lists | Listeneinträge über die SSO Schnittstelle als JSON-String übergeben. (Mehr dazu erfahren Sie unter dem Punkt "Dynamische Listeneinträge") | ||
| view_settings | Typ / Wert: Array
|
* Pflichtfelder
Nach der Anmeldung am System stehen alle Funktionen wie gewohnt zur Verfügung, als ob der Benutzer sich regulär angemeldet hätte. Optional kann die reguläre Anmeldung mit Benutzernamen und Kennwort deaktiviert werden, so dass Benutzer nur noch über die Schnittstelle ins System gelangen können.
Bestellung stornieren
Folgende Daten müssen übermittelt werden:
| Bezeichnung | Typ / Wert | Bemerkung | Version |
|---|---|---|---|
| request_time * | Datum und Uhrzeit (ISO 8601) | Zeitpunkt des Aufrufs (Standardgültigkeit des Requests 500s - 8 min) | since 4.3.23 |
dest_page | cancel_order | ||
dest_id | Der Bestellcode |
Dynamische Listeneinträge
Mit dieser Funktion können die Listeneinträge über die SSO Schnittstelle in JSON-Format übergeben werden.
Diese Funktion kann unter Feldspezialoptionen aktiviert werden:
Hinweis
Die Erweiterung unterstützt ausschlißlich eindimensionale Listen, weitere Felder werden von dier Listenfunktion nicht beeinflusst
JSON-String Beispiel:
{
"FELD_ANREDE": {
"default_value": "w",
"options": [
{
"name": "Frau",
"value": "w"
},
{
"name": "Herr",
"value": "h"
}
]
},
"FELD_TELEFON_LAENDERVORWAHL": {
"default_value": "0049",
"options": [
{
"name": "(+49 Deutschland)",
"value": "0049"
},
{
"name": "(+43 Österreich)",
"value": "0043"
}
]
}
}
Übermittlung von Personalisierungsdaten
Zur direkten Personalisierung eines Artikels kann der Parameter „pers=true“ und „dest_page=pers“ angegeben werden. Wird der Parameter weggelassen wird der Benutzer zu angegebenen Zielseite weitergeleitet. Zusätzlich kann man Personalisierungsdaten übergeben. Dazu wird der Paramater „pers_data“ angegeben. Die Datenübergabe kann auf zwei Wegen erfolgen:
- „pers_data“ wird als Array übergeben. Hierbei wird als Key der Variablen-Name aus der Druckvorlage übergeben und als Value ein gewünschter Wert.
- „pers_data“ wird als Integer übergeben. Hierbei handelt es sich um die „Id“ eines für die Vorlage gespeicherten Datensatzes. Wird ein Datensatz erfolgreich ermittelt, werden diese Daten automatisch geladen.
$userData["request_time"] = (new DateTime())->format(DateTime::ISO8601); // ab PHP 5.4
$userData["customer_user_name"] = "max@mustermann.de";
$userData["customer_longname"] = "Max Mustermann";
$userData["customer_user_company1"] = "Mustermann GmbH";
//Übermittlung von weiteren Personalisierungsdaten
$userData["pers"] = true;
$userData["pers_data"]["Feld1"] = "Wert1";
$userData["pers_data"]["Feld2"] = "Wert2";
$string = http_build_query($userData);
$myPasshrase = "Passphrase";
$myCipher = "AES-256-CBC"; // Die Einstellungen unter "Verwaltung - Shops - SSO Schnittstelle - Verschlüsselungsverfahren" beachten!
$iv = substr (hash('sha256', $myPasshrase), 0, 16);
$encoded_string = openssl_encrypt ($string, $myCipher, $myPasshrase, false, $iv);
$encoded_string = urlencode($encoded_string);
Innerhalb der Administration im Bereich Verwaltung-->Kunden-->bearbeiten-->SSO-Schnittstelle können die oben beschriebenen Informationen abgelegt und die Funktionen aktiviert werden.
