Open Catalog Interface (OCI)

Aus FestoWiki - deutsch
Wechseln zu: Navigation, Suche

Definition

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.

Einrichtung der Schnittstelle

  • Festo setzt den SAP OCI Standard 3.0 ein (keine Unterstützung der Funktionen VALIDATE und DETAIL sowie der Background-Search)
  • Der OCI Shop muss in einem separaten Fenster aufgerufen werden – Inframe ist nicht möglich!
  • Der Festo OCI Shop ist kompatibel zu Internet Explorer 8 (ab Windows Vista) und Internet Explorer 9 (ab Windows Vista)

 

 

Parameter der URL

Name Inhalt Typ
 

 

 

 

  https://www.festo.com/jsl/de_de/FORMDS/ocilogin?

0 URL
l_user <Ihr Benutzername> 2 Festwert
j_password <Ihr Passwort> 2 Festwert
HOOK_URL Eigener Rücksprunglink 4 Rückgabe - URL
~OKCode ADDI 2 Optional
~target _top 2 Optional
~caller CTLG 2 Optional

Aufbau der URL

  https://www.festo.com/jsl/de_de/FORMDS/ocilogin?l_user=''Benutzername''&j_password=''Passwort''&HOOK_URL=''hook_url''%3F~OkCode=ADDI%26~Target=_top%26~caller=CTLG

  • hook_url: Bitte durch eigenen Link ersetzen

Bitte beachten:

  • Parameter l_user – (mit kleinem L!)
  • User und Passwort sind Case Sensitive (Groß- und Kleinschreibung beachten)
  • Die generierte URL darf nach der Zeichenkette "ocilogin" nur ein Fragezeichen enthalten.

Standard Rückgabeparameter

  • In den Feldern <new_item-matgroup> und <new_item-ext_category_id> wird die eCl@ss-Version 6.01 übertragen
  • Wichtig: Im Feld <new_item-longtext> wird Ihnen bei konfigurierbarem Material der Identcode übermittelt. Diese Daten sind auf allen Folgebelegen die an Festo übermittelt werden zwingend erforderlich.

    Beispiele für Rückgabewerte bei <new_item-longtext>:
    Beispiel 1: <FESTO_CONFIG>@IC1@10P-10-2A-IC-R-V-MM</FESTO_CONFIG>
    Beispiel 2: <FESTO_CONFIG>@IC1@DNC-32-222-PPV-A-Q-S2-V3</FESTO_CONFIG>
     
  • Die OCI Daten werden mit mimetype text/html;charset=utf-8 versendet. UTF-8 ist damit auch die Codepage (8-bit Unicode Transformation Format)
  • Anpassungen an den Rückgabeparametern sind grundsätzlich möglich, jedoch kostenpflichtig (einmalig € 675,-)
  • Beschreibung der Felder

Beispiel eines Rücksprungs

new_item-matnr[1]
new_item-quantity[1] 1
new_item-description[1] MAGNETVENTIL MFH-5-1/4
new_item-vendormat[1] 6211
new_item-price[1] 1.20
new_item-priceunit[1] 1
new_item-currency[1] EUR
new_item-unit[1] PCE
new_item-leadtime[1] 4
new_item-longtext_1:132[] MAGNETVENTIL MFH-5-1/4
new_item-vendor[1] Festo
new_item-contract[1]
new_item-contract_item[1]
new_item-matgroup[1] 27291390
new_item-ext_category_id[1] 27291390
new_item-ext_schema_type[1]
new_item-cust_field1[1]
new_item-cust_field2[1]
new_item-cust_field3[1]
new_item-cust_field4[1]
new_item-cust_field5[1]
 

Beschreibung der Felder

Item Name Details Type length Festo Beispiel
Product master NEW_ITEM-MATNR[n] The SAP product master number in the buyer system. CHAR - 18 Kundenmaterialnummer, falls vorhanden Bsp: 08154711
Quantity NEW_ITEM-QUANTITY[n] Quantity to add. There can be a maximum of 11 digits to the left of the decimal point, and there must be 3 digits to the right. If the quantity contains decimal places, there must be a decimal point, not a comma. Otherwise problems will occur. CHAR - 15 Menge 1
Description NEW_ITEM-DESCRIPTION[n] The description of the item to be ordered CHAR - 40 Typenbezeichnung MAGNETVENTIL MFH-5-1/4
Vendor product number NEW_ITEM-VENDORMAT[n] The vendor product part number of the product CHAR - 22 Teilenummer Festo 6211
Price NEW_ITEM-PRICE[n] Price of the item in the catalog. There can be a maximum of 11 digits to the left of the decimal point, and there must be 3 digits to the right. CHAR - 15 Nettopreis 40.64
Price unit NEW_ITEM-PRICEUNIT[n] The number of units that must be purchased at the given price. This quantity defaults to one. CHAR - 9 Preiseinheit 1
Currency NEW_ITEM-CURRENCY[n] Must be the ISO code for the currency. CHAR - 5 Währung EUR
Unit of measure NEW_ITEM-UNIT[n] Unit of measure of the item. Must be the standard ISO code. CHAR - 3 Mengeneinheit PCE, MTR oder KGM
Lead time NEW_ITEM-LEADTIME[n] Number of days from today until the product will be available. If not specified, no assumptions will be made about the lead time. CHAR - 5 Lieferzeit 5
Description NEW_ITEM-LONGTEXT_n:132[] (see Note below) Description of a configuration, for example. CHAR - No restriction Typenbezeichnung oder bei Baukastenprodukten Identcode MAGNETVENTIL MFH-5-1/4
Vendor NEW_ITEM-VENDOR[n] If the product is purchased through a multi-supplier catalog, this field contains the business partner number in the buyer system. CHAR - 10 Lieferant Festo
Contract number NEW_ITEM-CONTRACT[n] The number of the contract with the vendor. CHAR - 10   leer
Item of a contract NEW_ITEM-CONTRACT_ITEM[n] The number of an item within a contract with the vendor. CHAR - 5   leer
Product group NEW_ITEM-MATGROUP[n] The SAP product group CHAR - 10 eCl@ss 6.01 27291390
Product group EXT_CATEGORY_ID[n] The SAP product group CHAR - 10 eCl@ss 6.01 27291390
External schema type new_item-ext_schema_type[n] This field contains a schema name, as it appears in the Enterprise Buyer system CHAR - 10   leer
Customer-specific field NEW_ITEM-CUST_FIELD1-5[n] Customer-specific field, which may be handled in a business add-in in the Enterprise Buyer system CHAR - 10   leer

Übermittlung der Bestellung

Die Bestellung übermitteln Sie uns bitte per Mail an bestellservice@festo.com oder per Fax an 0711-347-2628 (nicht im XML/HTML-Format).

  • Bitte geben Sie bei der Bestellung als Kopfdaten Ihre Kundennummer und Ihre Bestellnummer an.
  • Pro Position senden Sie uns bitte die Materialnummer von Festo, die Langbeschreibung und die Menge.

Empfohlene Browsereinstellungen

siehe Browsereinstellungen - Empfohlene Browser und Einstellungen fuer den Online Shop