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 Übergang zur Lead-Print Anwendung hergestellt werden kann. Hierbei müssen aus dem externen Shopsystem folgende Parameter an die Lead'Print Anwendung übergeben werden:

HOOK_URL
USERNAME

Optionale Parameter:

SKIP_CART
BG
NAME
FIRMA
STREET
ZIP
TOWN
COUNTRY
COSTCENTER
TELEFON
TELEFAX
EMAIL
KUNDENNR

Mit den übermittelten Daten wird in der Lead-Print Anwendung der Benutzer angemeldet. Warenkorbübermittlung an das externe Shopsystem. Der Warenkorb in der Lead-Print Anwendung wird mit folgenden Parametern an das externe Shopsystem im utf8-Format übertragen:

NEW_ITEM-DESCRIPTION (Bezeichnung des Artikels) Die max. Zeichenläge für diesen Parameter beträgt 40 Zeichen
NEW_ITEM-QUANTITY (Bestellmenge) Die max. Zeichenläge für diesen Parameter beträgt 15 Zeichen
NEW_ITEM-UNIT (Bestellmengeneinheit) Die max. Zeichenläge für diesen Parameter beträgt 3 Zeichen
NEW_ITEM-Price (Preis) Die max. Zeichenläge für diesen Parameter beträgt 15 Zeichen
NEW_ITEM-PRICEUNIT (gibt an für wie viele Bestelleinheiten der Preis gilt) Die max. Zeichenläge für diesen Parameter beträgt 9 Zeichen
NEW_ITEM-CURRENCY (Währung in dem der Preis angegeben ist) Die max. Zeichenläge für diesen Parameter beträgt 5 Zeichen
NEW_ITEM-LEADTIME (Lieferzeit in Werktagen) Die max. Zeichenläge für diesen Parameter beträgt 5 Zeichen
NEW_ITEM-VENDORMAT (Artikelnummer) Die max. Zeichenläge für diesen Parameter beträgt 40 Zeichen
NEW_ITEM-CUST_FIELD1 (Mehrwertsteuersatz (0.07 oder 0.19) ) Die max. Zeichenläge für diesen Parameter beträgt 10 Zeichen

Die OCI'Schnittstelle besitzt einige zwingende Einschränkungen, welche im Rahmen dieser Schnittstelle berücksichtigt werden:

OCI-Felder dürfen keine führenden Leerstellen enthalten
Numerische Felder sind mit dem Dezimaltrennzeichen „Punkt“ zu versehen
Numerische Felder dürfen kein „Komma“ enthalten. Auch nicht als Tausendertrennzeichen
Mengeneinheiten müssen als ISO-Code übergeben werden

Die Warenkorb-Informationen werden als HTML Dokument zurück an das externe Shopsystem übermittelt.

Prozessä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 ausgeführt. Erst zu diesem Zeitpunkt werden weitere Aktionen innerhalb der Lead'Print Anwendung (wie z.B. die Übertragung der Daten an Druckdienstleister) angestoßen.

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
EMAIL
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
BG	Mit dieser Angabe kann eine abweichende Benutzergruppen-Id übergeben werden. Die Standardbenutzergruppe wird in der Administration im Bereich Shops > bearbeiten > SSO hinterlegt. Angemeldete Benutzer werden automatisch in die jeweilige Benutzergruppe zugewiesen.

Rückgabe

Feld	Beschreibung
HOOK_URL	Zieladresse für Rückgabe (Wir bei der SSO-Schnittstelle angegeben)
ORDER_CODE	Referenz zur Bestellung
ORDER_CART []	Id der Warenkorb-Position
NEW_ITEM-UNIT[]	statischer Wert "C62"
NEW_ITEM-DESCRIPTION[]	Zeichenkette bestehend aus Bestellcode und Artikelbezeichnung. Kann in der Artikeladministration (Shop - Artikel - bearbeiten) editiert werden.
NEW_ITEM-LONGTEXT_n:132[]	Zeichenkette bestehend aus Bestellcode und Artikelbezeichnung. Kann in der Artikeladministration (Shop - Artikel - bearbeiten) editiert werden.
NEW_ITEM-VENDORMAT[]	SAP Nummer aus dem Artikel. Kann in der Artikeladministration (Shop - Artikel - bearbeiten - Erweiterte Einstellungen) editiert werden.
NEW_ITEM-VENDOR[]	OCI: Lieferanten Nr. aus dem Artikel.Kann in der Artikeladministration (Shop - Artikel - bearbeiten - Erweiterte Einstellungen) editiert werden.
NEW_ITEM-QUANTITY[]	Bestellmenge Warenkorbposition.Kann in der Artikeladministration (Shop - Artikel - bearbeiten - Preisstaffel / Bestelloptionen) editiert werden.
NEW_ITEM-PRICE[]	Preis Warenkorbposition. Kann in der Artikeladministration (Shop - Artikel - bearbeiten - Preisstaffel / Bestelloptionen) editiert werden.
NEW_ITEM-PRICEUNIT[]	Einheit: Wird ermittelt aus der Preisbezeichnung i.d.R. Stück. Kann in der Artikeladministration (Shop - Artikel - bearbeiten - Preisstaffel / Bestelloptionen) editiert werden.
NEW_ITEM-CURRENCY[]	statischer Wert "EUR"
NEW_ITEM-LEADTIME[]	Lieferzeit aus dem Artikel. Kann in der Artikeladministration (Shop - Artikel - bearbeiten - Erweiterte Einstellungen) editiert werden.
NEW_ITEM-EXT_CATEGORY_ID[]	OCI: ext. Kategorie-Id aus dem Artikel. Kann in der Artikeladministration (Shop - Artikel - bearbeiten - Erweiterte Einstellungen) editiert werden.
NEW_ITEM-CUST_FIELD1[]	MwSt. (Artikeleinstellungen). Kann in der Artikeladministration (Shop - Artikel - bearbeiten) eingestellt werden.
NEW_ITEM-CUST_FIELD5[]	Download-Link zur Druck-Datei

Hinweis: weitere Informationen (Felder) zur Bestellung können auf Anfrage bereitgestellt werden.

Rückantwort von der OCI

Die Rückantwort von der OCI über den Status einer Bestellung erfolgt über folgenden Aufruf:

Die bei der Rückmeldung enthaltene BuyerOrderNumber wird als Orderinformation "BuyerOrderNumber", Liefer-/Rechnungsdaten zum Auftrag gespeichert.

https://xxx.print'server.net/oci.php

Folgende Parameter können per GET oder POST übergeben werden:

order_code: 6 stelliger Bestellcode aus der PRINT LOUNGE
status: 1 = Freigabe für Bestellung wird erteilt 0 = Freigabe für Bestellung wird abgelehnt

Beide Parameter sind Pflichtfelder und müssen zwingend für eine erfolgreiche Rückantwort angegeben werden. Eine erfolgreiche Rückantwort erfolgt nur mit einem gültigen Bestellcode und einem gü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 Aufträge können zusätzlich in der Administration der Print Lounge im Bestelleinang mit dem Status'Filter „WARTE AUF BEZAHLLUNG“ eingesehen werden. Von dort ist über die Funktion „FREIGEBEN“ eine manuelle Durchführung der Rückantwort'Bestätigung möglich.

Sofern bei der Übergabe die BuyerOrderNumber übermittelt wird, wird diese in die entsprechende Bestellung geschrieben und kann in der PRINT LOUNGE in Rechnung, Lieferschein, Jobticket verwendet werden. Des Weiteren steht diese Information auch in den Exporten unter "Shop > Bestellungen > Einträge nach Excel exportieren" und "Shop > Bestellungen > Bestelldaten exportieren" zur Verfügung.

Um das Freigabedatum in den Vorlagen Lieferschein, Jobticket und Rechnung zu verwenden kann folgender Parameter verwendet werden:
{$orderObject->getOrderInfo('oci_release_date')}

Hinweis

Die Verwendung des OCI Freigabeworkflows ist nur möglich wenn das Modul aktiviert wurde.

Mustereinstellung SAP

E-Mail Benachrichtigung

Für das OCI Modul in der Lead-Print PRINT LOUNGE kann eine optionale Bestellbestätigung aktiviert werden. Innerhalb der Administration kann unter

"Verwaltung > Shops > bearbeiten > OCI Schnittstelle" die Funktion Bestell-Benachrichtigung aktiviert werden. Diese Bestell-Benachrichtigung wird hierbei an den Besteller und an den Systembetreiber versendet. Der Versand der E-Mail findet bei erfolgreicher Freigabe statt.

OCI Bestellworkflow über OCI-Punchout inkl Rückantwort