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.
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 erteilen): 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.