MANN+HUMMEL Requirements regarding BMEcat format for eCatalog Suppliers Contact for Suppliers: eCatalog@mann-hummel.com Date: November 2006 Catalog and data format MANN+HUMMEL GMBH makes great demands with regard to the quality of its suppliers. This also applies to the quality of the electronic product catalogs. To be as accommodating as possible towards the suppliers, MANN+HUMMEL does not intend to define its own solutions and has decided instead to use a common standard for electronic purchasing using a central catalog system. For this reason, the BMEcat Standard 1.2 is being used for integrating electronic supplier catalogs into the internal catalog solution. It is used for exchanging catalog data between the supplier and MANN+HUMMEL. Another requirement is that the suppliers have classified all articles according to the classification standard eCl@ss 4.0 and have filled out the appropriate feature bars. Applied standards: • BMEcat, Version 1.2 • eCl@ss, Version 4.0 with feature bars filled out as far as possible The current specifications and further information on the BMEcat can be found in the download section of the BME homepage at www.bmecat.org. Information on eCl@ss can be found at www.eclassonline.com. Explanations Catalog version The version number consists of a Master_ID and a Sub_ID in the format xxx.yyy. Each new supplier starts with 001.001. The Master_ID is increased by 1 for each complete update. MANN+HUMMEL decides whether or not the update is a complete update. The Sub_ID is increased by 1 for each iteration. The version number is unique and is applicable across the entire system. Differing version numbers originated by the supplier will be corrected accordingly by MANN+HUMMEL. Features Features are used to specify a particular article more precisely in the lowest page node of the classification system and to facilitate precise selection of the correct article. The BMEcat specifies the FNAME and FVALUE fields as mandatory fields as soon as a classification system is used. Since a number of suppliers are at present still unable to provide features for the used classification system eCl@ss 4.0, a catalog is imported even if these fields are empty. Example A retractable pencil has the eClass number 24-11-01-02. The following features are defined for this number: colour, weight, manufacturer, length, refill system, product name, product type, line thickness, body material, certificates, approval. Prices In the PRICE_AMOUNT field, a "." must be used as the decimal point, i.e. 3.12 instead of 3,12. The same also applies for the value-added tax in the TAX field. For example, 0.16 must be entered instead of 0,16. Requirements regarding BMEcat format Page 2 Order and quantity units The order and quantity units used in the BMEcat must comply with UN/ECE Recommendation 20. The units of quantity and measurement are entered in the CONTENT_UNIT field in the BMEcat. Possible units of measurement are, for example, m (metres) or kg (kilograms). The order units must be entered in the ORDER_UNIT field. The correct quantity unit for e.g. piece is not piece or PCE but rather C62. The specifications of UN/ECE Recommendation 20 can be found at: http://www.unece.org/cefact/recommendations/rec_index.htm http://www.unece.org/cefact/recommendations/rec20/rec20_rev3_Annex1e.pdf Example The article "cola bottle" which can only be purchased in a crate of ten bottles at a price of € 1.00 per bottle can be presented in the following way in the BMEcat. Note: The labels for ORDER_UNIT and CONTENT_UNIT have been selected in real language for illustration purposes and do not conform to UN/ECE Recommendation 20. Case 1: Presentation of price per bottle ORDER_UNIT = Crate CONTENT_UNIT = Bottle NO_CU_PER_OU = 10 PRICE_QUANTITY = 1/10 = 0.1 QUANTITY_MIN = 1 QUANTITY_INTERVAL = 1 PRICE_AMOUNT = 1 Case 2: Presentation of price per crate ORDER_UNIT = Crate CONTENT_UNIT = Bottle NO_CU_PER_OU = 10 PRICE_QUANTITY = 1 QUANTITY_MIN = 1 QUANTITY_INTERVAL = 1 PRICE_AMOUNT = 10 Images and supplementary documents To be able to display images and supplementary documents correctly in the catalog system, the BMEcat fields MIME_TYPE, MIME_SOURCE and MIME_PURPOSE must be filled out. The JPEG or GIF format is always used to display images. Other MIME_TYPEs can be, for example, HTML documents, PDF documents or URLs. In the MIME_PURPOSE field, the catalog system uses the attribute value "normal" for images displayed in article lists, "normal" for displaying in a single-article view and "detail" for an enlarged view of the article. "others" and "data_sheet" can be used for other multimedia files, e.g. descriptions in PDF format. Classification system CLASSIFICATION_SYSTEM does not need to be supplied since the classification system is already available in the catalog system. All that is necessary to assign the article via ARTICLE_FEATURE. Requirements regarding BMEcat format Page 3 Requirements regarding supplier catalogs To guarantee consistent and high-quality data in the supplier catalogs, it must be ensured that a supplier is able to provide the necessary "content quality". The required criteria are listed below. General specifications • Catalog data standard: BMEcat, Version 1.2 • Classification standard: eCl@ss, Version 4.0 Predefined fields The supplier must fill certain BMEcat fields with a predefined content. These fields are listed below. They must be transferred unchanged to the catalog. The italicized data need to be defined individually for each supplier by the MANN+HUMMEL purchaser. BMEcat element BUYER_ID BUYER_NAME SUPPLIER_ID type="buyer_specific" SUPPLIER_NAME CATALOG_ID CATALOG_NAME CATALOG_VERSION CURRENCY LANGUAGE TERRITORY Requirements regarding BMEcat format Content MHUK MHUK Supplier no. of SAP Supplier Name Name_Supplier_no. Catalog Name which user can see 001.001 GBP/EUR….. EN,deu…. GB;DE;FR….. Page 4 Used / required fields for articles We use the following fields of BMEcat 1.2 for displaying your catalog and product data in our target system. Depending on the type of field, the field is either optional or mandatory. The field length value indicates the maximum field length. Note: Certain fields are defined as mandatory fields contrary to the BMEcat specifications. These are indicated as follows: *Mandatory*. Field / Description BMEcat field Label Specification of data fields which identify and verbally describe an article (ARTICLE_DETAILS) – Mandatory Article Mode in which articles are read in ARTICLE mode=new Article number from the supplier SUPPLIER_AID Supplier Field Mandatory/ length Optional 6 32 Mandatory Mandatory Mandatory article No. Short description Brief and concise description of the DESCRIPTION_SHORT article 80 Long description Detailed description of the article EAN number Further article ID from the supplier DESCRIPTION_LONG 64000 Optional EAN SUPPLIER_ALT_ID 14 50 Optional Optional BUYER_AID type = … 50 Optional MANUFACTURER_AID 50 Optional MANUFACTURER_NAME ERP_GROUP_BUYER 50 *Mandatory* 10 *Mandatory* 6 Optional 20 Optional 50 Optional 64000 Optional 250 Optional 50 *Mandatory* 60 *Mandatory* EAN number Alternative article No. Article No. from buyer “type" defines the type of article number. type = "Standard range": value = S type = "SAP_MATNR": value = SAP material number Manufacturer article No. Manufacturer ERP product group of buying company Article number from the manufacturer Name of the manufacturer Material group or category of the article in the ERP system of the buying company Specification from MANN+HUMMEL: Planned delivery time Special treatment class Keyword Remarks Special article features eCl@ss number of the article without "-", i.e. 24140501 for e.g. copying paper Time in working days that the sup- DELIVERY_TIME plier requires for delivery Additional classification of the arti- SPECIAL_cle (hazardous goods). Here "type" TREATMENT_CLASS defines the special treatment regu- type = … lation. Keyword which makes finding the KEYWORD article easier Additional remarks from the supREMARKS plier Assignment of additional special ARTICLE_STATUS type = attributes. Here "type" specifies the … special feature. Classification of articles (ARTICLE_FEATURES) – *Mandatory* Classification and Classification and feature group feature group system system REFERENCE_FEATURE_ SYSTEM_NAME Specification from MANN+HUMMEL: Group ID ECLASS-4.0 ID of the referenced group within the classification and feature group system, e.g. 24-14-05-01 REFERENCE_FEATURE_ GROUP_ID Optional Requirements regarding BMEcat format Page 5 Feature name Feature unit Feature description Feature value Unique name of the feature to be described Measurement unit of the feature Additional description of the feature Prominence of the referenced feature FNAME 60 Mandatory FUNIT FDESCR FVALUE 20 250 60 Optional Optional Mandatory 3 Mandatory 3 *Mandatory* - *Mandatory* - *Mandatory* - Optional - Optional - Optional - Optional - Optional Specification of ordering conditions and packaging arrangements (ARTICLE_ORDER_DETAILS) Æ See also the paragraph "Order and quantity units" Order unit Unit in which the article can be ORDER_UNIT ordered Content unit Unit used for the article within CONTENT_UNIT an order unit Package quantity Number of content units per NO_CU_PER_OU order unit of the article Price quantity A multiple or fraction of the PRICE_QUANTITY order unit indicating the quantity to which all specified prices relate Minimum order Minimum order quantity of the QUANTITY_MIN quantity article Quantity interval Number indicating the multiples QUANTITY_INTERVAL in which the article can be ordered Specification of price data (ARTICLE_PRICE_DETAILS) Valid as of Date from which the article DATETIME prices become valid type=“valid_start_date” Valid until Date after which the article DATETIME prices are no longer valid type=“valid_end_date” Daily price Daily price identifier DAILY_PRICE Field / Label Price type Description BMEcat field Attribute which specifies the ARTICLE_PRICE price type Specification from MANN+HUMMEL: ARTICLE_PRICE price_type=“net_customer“ Price Price amount PRICE_AMOUNT Lower graduated Lower quantity limit for graduLOWER_BOUND price limit ated prices References to supplementary multimedia data (MIME_INFO) Field Mandalength tory/Optional - Mandatory 20 Mandatory - Mandatory Optional MIME_TYPE MIME_SOURCE 30 250 Optional Mandatory MIME_DESCR 250 Optional MIME_ALT 50 Optional MIME_PURPOSE 20 *Mandatory* Æ See also the paragraph "Images and supplementary documents" Mime type Source Description Alternative text Purpose Type of supplementary document Relative path and file name or URL address Description of the supplementary file Alternative text in case, for example, the file cannot be reproduced by the browser on the target system Desired purpose of the MIME document on the target system Specification from MANN+HUMMEL: At least one image must be supplied as MIME_PURPOSE = "normal" Note: If a catalog is also provided in another language, the values must be left unchanged in the MIME_SOURCE (Source) element. Optional: References to other articles (ARTICLE_REFERENCE) Reference type Describes how the two articles are Requirements regarding BMEcat format ARTICLE_REFERENCE 20 Mandatory Page 6 Number Reference article Product catalog Version related Indicates the number of articles being referred to Unique article number which is to be referred to Unique CATALOG_ID if the reference article is not listed in the same catalog Version of the referenced product catalog type = ... ARTICLE_REFERENCE quantity = … ART_ID_TO - Optional 32 Mandatory CATALOG_ID 20 Optional CATALOG_VERSION 7 Optional BMEcat field Field Mandatory/ length Optional Used / required fields for catalog structure Field / Label Description Specification of the catalog structure (CATALOG_GROUP_SYSTEM) Catalog system ID Catalog system name Description Catalog structure Group No. Group name Group description Parent group Sequence MIME information Keyword ID of the catalog group system Name of the catalog group system GROUP_SYSTEM_ID 50 GROUP_SYSTEM_NAME 50 Optional Optional Description of the catalog group system Specifies a group within a catalog group system Unique ID which identifies the group Name of the catalog group Brief description of the respective group GROUP_ID of the higher-level catalog group Sequence for catalog groups Supplementary multimedia information Keyword for the group GROUP_SYSTEM_ DESCRIPTION CATALOG_STRUCTURE type = ... GROUP_ID 250 Optional 4 Mandatory 50 Mandatory GROUP_NAME GROUP_DESCRIPTION 50 250 Mandatory Optional PARENT_ID 50 Mandatory GROUP_ORDER MIME_INFO (see above) - Optional Optional KEYWORD 50 Optional BMEcat field Field Mandatory/ length Optional Used / required fields for mapping articles to catalog structure Field / Label Description Specification for mapping the articles to the catalog structure (ARTICLE_TO_CATALOG_GROUP_MAP) Article No. Catalog group Article sequence Unique number identifying the article (SUPPLIER_AID) Unique ID identifying the catalog group (GROUP_ID) Sequence in which articles are placed in a catalog group in the target system ART_ID 32 Mandatory CATALOG_GROUP_ID 50 Mandatory ARTICLE_TO_CATALOG_ GROUP_MAP_ORDER - Optional Note: The following fields are used for searching in the catalogs: DESCRIPTION_SHORT, MANUFACTURER_NAME, MANUFACTURER_AID, SUPPLIER_AID Requirements regarding BMEcat format Page 7