OCI-Bestellworkflow über OCI-Punchout inkl. Rückantwort
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, sodass 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
- BG
- NAME
- FIRMA
- STREET
- ZIP
- TOWN
- COUNTRY
- COSTCENTER
- TELEFON
- TELEFAX
- KUNDENNR
Bei der Übergabe der Daten im OpenTrans Format können zusätzlich die Parameter FIRSTNAME, LASTNAME und NAME2 (wird auf company2 gemappt) verwendet werden.
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änge für diesen Parameter beträgt 40 Zeichen.
- NEW_ITEM-QUANTITY (Bestellmenge). Die max. Zeichenlänge für diesen Parameter beträgt 15 Zeichen.
- NEW_ITEM-UNIT (Bestellmengeneinheit). Die max. Zeichenlänge für diesen Parameter beträgt 3 Zeichen.
- NEW_ITEM-Price (Preis). Die max. Zeichenlänge für diesen Parameter beträgt 15 Zeichen.
- NEW_ITEM-PRICEUNIT (Gibt an, für wie viele Bestelleinheiten der Preis gilt). Die max. Zeichenlänge für diesen Parameter beträgt 9 Zeichen.
- NEW_ITEM-CURRENCY (Währung in dem der Preis angegeben ist). Die max. Zeichenlänge für diesen Parameter beträgt 5 Zeichen.
- NEW_ITEM-LEADTIME (Lieferzeit in Werktagen). Die max. Zeichenlänge für diesen Parameter beträgt 5 Zeichen.
- NEW_ITEM-VENDORMAT (Artikelnummer). Die max. Zeichenlänge für diesen Parameter beträgt 40 Zeichen.
- NEW_ITEM-CUST_FIELD1 (Mehrwertsteuersatz (0.07 oder 0.19)). Die max. Zeichenlänge 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.
- Nummerische Felder sind mit dem Dezimaltrennzeichen „Punkt“ zu versehen.
- Nummerische Felder dürfen kein „Komma“ enthalten. Auch nicht als Tausendertrennzeichen.
- Mengeneinheiten müssen als ISO-Code übergeben werden.
Die Warenkorbinformationen 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.
Anmeldung
Bei der Anmeldung wird geprüft, ob ein Benutzer (USERNAME) bereits vorhanden ist. Ist dies der Fall, so wird der Benutzer mit den übergebenen 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 Warenkorbposition 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, die aufgerufen werden soll. Mögliche Werte: wg: Eine Warengruppenseite; pers: Eine Personalisierungsseite; eine Artikel-Detailseite: article_detail |
TEST | Testmodus 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 (wird bei der SSO-Schnittstelle angegeben). |
ORDER_CODE | Referenz zur Bestellung |
ORDER_CART [] | Id der Warenkorbposition |
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[] | Downloadlink zur Druckdatei. |
Hinweis: Weitere Informationen (Felder) zur Bestellung können auf Anfrage bereitgestellt werden.
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 "BuyerOrderNumber", Liefer-/Rechnungsdaten 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 den 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 Bestelleingang mit dem Statusfilter „WARTE AUF BEZAHLLUNG“ eingesehen werden. Von dort ist über die Funktion „FREIGEBEN“ eine manuelle Durchführung der Rückantwortbestätigung mö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 mö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 Bestellbenachrichtigung aktiviert werden. Diese Bestellbenachrichtigung wird hierbei an den Besteller und an den Systembetreiber versendet. Der Versand der E-Mail findet bei erfolgreicher Freigabe statt.
→→