Aktivierung
Um OCI nutzen zu können, muss die SSO Schnittstelle in der Kundenverwaltung aktiviert werden. Diese ist unter Verwaltung | Kunden | bearbeiten | SSO-Schnittstelle zu finden. Bei der Aktivierung der SSO Schnittstelle muss eine Standardbudgetgruppe für neue Benutzer definiert werden. Weitere Einstellungen sind nicht erforderlich.
Beschreibung
Die SSO-Schnittstelle der Lead-Print Anwendung wird angepasst, so dass aus dem externen Shopsystem ein reibungsloser Übergang zur Lead-Print Anwendung hergestellt werden kann. Hierbei müssen aus dem externen Shopsystem folgende Parameter an die Lead'Print Anwendung übergeben werden:
- HOOK_URL
- USERNAME
Optionale Parameter:
- SKIP_CART
- NAME
- FIRMA
- STREET
- ZIP
- TOWN
- COUNTRY
- COSTCENTER
- TELEFON
- TELEFAX
- KUNDENNR
Mit den übermittelten Daten wird in der Lead-Print Anwendung der Benutzer angemeldet. Warenkorbübermittlung an das externe Shopsystem. Der Warenkorb in der Lead-Print Anwendung wird mit folgenden Parametern an das externe Shopsystem im utf8-Format übertragen:
- NEW_ITEM-DESCRIPTION (Bezeichnung des Artikels) Die max. Zeichenläge für diesen Parameter beträgt 40 Zeichen
- NEW_ITEM-QUANTITY (Bestellmenge) Die max. Zeichenläge für diesen Parameter beträgt 15 Zeichen
- NEW_ITEM-UNIT (Bestellmengeneinheit) Die max. Zeichenläge für diesen Parameter beträgt 3 Zeichen
- NEW_ITEM-Price (Preis) Die max. Zeichenläge für diesen Parameter beträgt 15 Zeichen
- NEW_ITEM-PRICEUNIT (gibt an für wie viele Bestelleinheiten der Preis gilt) Die max. Zeichenläge für diesen Parameter beträgt 9 Zeichen
- NEW_ITEM-CURRENCY (Währung in dem der Preis angegeben ist) Die max. Zeichenläge für diesen Parameter beträgt 5 Zeichen
- NEW_ITEM-LEADTIME (Lieferzeit in Werktagen) Die max. Zeichenläge für diesen Parameter beträgt 5 Zeichen
- NEW_ITEM-VENDORMAT (Artikelnummer) Die max. Zeichenläge für diesen Parameter beträgt 40 Zeichen
- NEW_ITEM-CUST_FIELD1 (Mehrwertsteuersatz (0.07 oder 0.19) ) Die max. Zeichenläge für diesen Parameter beträgt 10 Zeichen
Die OCI'Schnittstelle besitzt einige zwingende Einschränkungen, welche im Rahmen dieser Schnittstelle berücksichtigt werden:
- OCI-Felder dürfen keine führenden Leerstellen enthalten
- Numerische Felder sind mit dem Dezimaltrennzeichen „Punkt“ zu versehen
- Numerische Felder dürfen kein „Komma“ enthalten. Auch nicht als Tausendertrennzeichen
- Mengeneinheiten müssen als ISO-Code übergeben werden
Die Warenkorb-Informationen werden als HTML Dokument zurück an das externe Shopsystem übermittelt.
Prozessänderung im Rahmen der OCI-Schnittstelle: Die Daten werden zuerst an die OCI Schnittstelle geschickt und nur nach einer Erfolgsmeldung der Buchung seitens des externen Shopsystems wird die Bestellung in der Lead'Print Anwendung ausgeführt. Erst zu diesem Zeitpunkt werden weitere Aktionen innerhalb der Lead'Print Anwendung (wie z.B. die Übertragung der Daten an Druckdienstleister) angestoßen.
Aktivierung der Funktion
Das Modul „OCI“ wird durch die Be.Beyond GmbH aktiviert. Die Funktion kann im Backend unter „Verwaltung – Kunden –bearbeiten – OCI Schittstelle“ aktiviert werden.Anmeldung
Bei der Anmeldung wird geprüft, ob ein Benutzer (USERNAME) bereits vorhanden ist. Ist dies der Fall, so wird der Benutzer mit den übergeben Daten aktualisiert und mit dem bestehenden Account angemeldet. Alle zuvor gespeicherten Einstellungen sowie die Bestellhistorie sind vorhanden. Ist ein Benutzer nicht vorhanden, so wird dieser in der unter „SSO-Schnittstelle“ hinterlegten Benutzergruppe angelegt. Wurde kein Benutzername übergeben, so wird dieser automatisch generiert, mit Suffix „oci.“.
| SHOP-URL | https://*.print-server.net/autologin.php |
HOOK-URL | Pflicht, Rücksprung Adresse nach dem Warenkorb |
USERNAME | Unique |
PASSWORT | Wird nicht unterstützt! |
NAME |
|
FIRMA |
|
STREET |
|
ZIP |
|
TOWN |
|
COUNTRY |
|
COSTCENTER |
|
TELEFON |
|
TELEFAX |
|
| |
KUNDENNR |
|
CUSTOMFIELD1 |
|
CUSTOMFIELD2 |
|
CUSTOMFIELD3 |
|
CUSTOMFIELD4 |
|
CUSTOMFIELD5 |
|
CART | Mit dieser Angabe kann die Personalisierung der Warenkorb-Position erneut aufgerufen werden nach Abschluss der Personalisierung wird die Übergabe einer neuen Bestellung an die HOOK_URL erfolgen. |
SKIP_CART = 53 | Mit dieser Angabe kann der Warenkorb nach der Personalisierung übersprungen werden und direkt eine Übergabe der Bestellung an die HOOK_URL erfolgen. |
DEST_ID | Die ID des Eintrags (Warengruppe oder Artikel) |
DEST_PAGE | Zielseite, welche aufgerufen werden soll. Mögliche Werte: wg: Eine Warengruppenseite; pers: Eine Personalisierungsseite; eine Artikel-Detailseite: article_detail |
TEST | Test-Modus aktivieren |
Rückantwort von der OCI
Die Rückantwort von der OCI über den Status einer Bestellung erfolgt über folgenden Aufruf:
Die bei der Rückmeldung enthaltene BuyerOrderNumber wird als Orderinformation "OCI_BuyerOrderNumber" zum Auftrag gespeichert.
https://xxx.print'server.net/oci.php
Folgende Parameter können per GET oder POST übergeben werden:
order_code: 6 stelliger Bestellcode aus der PRINT LOUNGE
status: 1 = Freigabe für Bestellung wird erteilt 0 = Freigabe für Bestellung wird abgelehnt
Beide Parameter sind Pflichtfelder und müssen zwingend für eine erfolgreiche Rückantwort angegeben werden. Eine erfolgreiche Rückantwort erfolgt nur mit einem gültigen Bestellcode und einem gültigen Status.
Beispiel (Freigabe erteilen): https://xxx.print'server.net/oci.php?order_code=XXXXXX&status=1
Beispiel (Freigabe ablehnen): https://xxx.print'server.net/oci.php?order_code=XXXXXX&status=0
Bei fehlerhaftem Aufruf wird eine Statusmeldung im JSON'Format ausgegeben. Bei erfolgreichem Aufruf erfolgt eine Weiterleitung auf die Bestellbestätigungsseite. Die Weiterleitung kann man über das Parameter "disable_redirect=1" unterbinden. Statt Weiterleitung wird die Statusmeldung im JSON Format ausgegeben.
Offene Aufträge können zusätzlich in der Administration der Print Lounge im Bestelleinang mit dem Status'Filter „WARTE AUF BEZAHLLUNG“ eingesehen werden. Von dort ist über die Funktion „FREIGEBEN“ eine manuelle Durchführung der Rückantwort'Bestätigung möglich.
Hinweis
Die Verwendung des OCI Freigabeworkflows ist nur möglich wenn das Modul aktiviert wurde.
Mustereinstellung SAP
