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.

Ü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>