Das Open Catalog Interface (OCI) ist eine standardisierte Schnittstelle zum Austausch von Kataloginformationen zwischen Online-Katalogen und ERP-Systemen. Der Standard wurde von SAP definiert.

Das Modul ermöglicht die freie Schnittstellenkonfiguration über das Backend.

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 Standard-Budgetgruppe für neue Benutzer definiert werden. Weitere Einstellungen sind nicht erforderlich.

Rückgabe konfigurieren

Die Rückgabe kann frei konfiguriert werden. Die Konfiguration befindet sich unter "Add-ons → Oci". Es werden nur die SAP OCI-Felder unterstützt.

Alle aufgelisteten Felder können mit folgenden Feldern aus Lead-Print verknüpft werden:
Oci, Mandant, Shop, Artikel, Bestellung, Bestellposition, Einstellungen. Des Weiteren ist es möglich einen statischen Text zu hinterlegen und die Zeichenlänge anzupassen.

Verwendung von Smarty-Befehlen AB V6.60.0

Um Berechnungen oder Textmanipulationen innerhalb der OCI-Daten zu ermöglichen, können Smarty-Befehle verwendet werden. Hierzu muss trotzdem weiterhin die Variable in eigenen geschweiften Klammern angegeben werden.

{$order_cart.s_ntotal}

{(({$order_cart.s_ntotal} * 20)|round:0) / 20}

Über den Button "Standard Einstellungen laden" werden die Standardverknüpfungen wiederhergestellt.

Über den Link "Vorschau anzeigen" können Bestellungen mit der aktuellen Konfiguration angezeigt werden. Die Vorschau enthält die Ansicht der POST-Daten (Übergabe an das SAP-System).

Über die URL-Eingabe können die POST-Daten abgesendet werden.

Grundeinstellungen

Preis und Menge aktualisieren?

Ist die Option aktiviert, wird der Bestellpreis und die Menge innerhalb der OCI-Freigabe aktualisiert.

Die Aktualisierung erfolgt erst dann, wenn die Menge in der XML gesetzt ist oder die Menge über das GET-Parameter "quantity" übermittelt wird. 

[...]

<E1EDP01 SEGMENT="1">

 <MENGE>1</MENGE>

 [...]

</E1EDP01>

[...]

[...]

<TotalQuantity>

 <Quantity>
 <QuantityValue>1</QuantityValue>
 </Quantity>
</TotalQuantity>

[...]

Warenkorb Zusatzfelder 

Ab Version 5.15.0

Alle OCI relevanten Felder können mit Hilfe von Artikelzusatzfeldern überschrieben werden.

Alle angelegten Warenkorb Zusatzfelder können den OCI-Feldern zugewiesen werden.

Der Besteller kann für das jeweilige Feld im Shop die Eingaben im Bestellprozess tätigen.

OCI-XML

Zusatzinformationen

Übertragen

Unter <OrderHeader> muss ein Knoten <OrderAdditionalInfoFields> existieren.

Dieser kann mehrere Informationen mit einem key und value enthalten. Diese werden dann als Zusatzinformation in der Order gespeichert.

<?xml version="1.0" encoding="UTF-8"?>
<Order>
    <OrderHeader>
        <OrderNumber>...</OrderNumber>
        <OrderIssueDate>...</OrderIssueDate>
        <OrderCurrency>...</OrderCurrency>
        <OrderParty>...</OrderParty>
        <OrderAdditionalInfoFields>
            <Info>
                <key>k1</key>
                <value>val1</value>
            </Info>
            <Info>
                <key>k2</key>
                <value>val2</value>
            </Info>
        </OrderAdditionalInfoFields>
    </OrderHeader>
    <OrderDetail>
        ...
    </OrderDetail>
    <OrderSummary>
        ...
    </OrderSummary>
</Order>

Abfragen

Im Dienstleister XML-Export, können die Werte wie folgt abgefragt werden.

Der übermittelte key bekommt den prefix ociInfo_ und so können diese Daten abgefragt und verwendet werden:

<Info>
    {if $o->getOrderInfo('ociInfo_k1')}
        <k1>{$o->getOrderInfo('ociInfo_k1')}</k1>
    {/if}
</Info>