Requirements

advertisement
MANN+HUMMEL
Requirements regarding BMEcat format
for eCatalog Suppliers
Date:
April 2013
1
Introduction
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 6.1 and have filled out the appropriate feature bars.
Applied standards:
•
BMEcat, Version 1.2
•
eCl@ss, Version 6.1
•
UNECE Recommendation N°. 20 (Order and quantity unit)
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.eclass-online.com.
The current standards and additional information you will find on the following web sites:

BMEcat: Homepage of the BME www.bmecat.org at „Download“

UNECE: http://www.unece.org/cefact/recommendations/rec_index.htm at the Recommendation N° .20
Content Delivery
Please send your BMEcat as well as images and additional documents via email to
eCatalog@mann-hummel.com
Requirements regarding BMEcat format
Page 2
2
Basics of the BMEcat Standard
„BME“ stands for the German Association of Materials Management, Purchasing and Logistics (AMMPL)
(German: “Bundesverband Materialwirtschaft, Einkauf und Logistik e.V.“) and „cat“ for „catalog“.
The specification of the AMMPL aims to standardize the presentation of electronic catalogs. Catalogs which
meet these standards can be imported into catalog systems.
The BMEcat supports following mode for the transfer of catalog information:

T_NEW_CATALOG: A complete catalog
The BMEcat format is based on XML.
A BMEcat catalog is structured into four sections:
1. Catalog Header Data (see 3.1)
There is the general information to the catalog. With these information it is possible to identify the catalog
exactly by for example the buyer, supplier or the catalog ID.
2. Catalog Structure (see 3.2)
The catalog structure is the structure the supplier has defined for grouping his products. The catalog
structure is mandatory (CATALOG_GROUP_SYSTEM). Every article has to be related to minimum one node
in the structure.
Please do not confound the catalog structure with the classification system. A classification system is a
standardized structure. They have been developed for example by the eCl@ss.
3. Article Details (see 3.3)
In this section the details of the articles are defined. For example the suppliers item number, the order unit
and the price.
4. Mapping of the Articles to the Catalog Structure (see 3.4)
Here the item numbers are mapped to the catalog structure.
The following chapters of this document are sorted in these four sections and are describing the included
fields in detail.
Requirements regarding BMEcat format
Page 3
3
Requirements regarding supplier catalogs
 All mandatory fields of BMEcat specification are also a MUST field at MANN+HUMMEL
 The following fields are in the search engine involved: Article-Number, short description, manufacturer,
manufacturer article number, keywords, long description
BMEcat
• Catalog data standard: BMEcat, Version 1.2
• Classification standard: eCl@ss, Version 6.1
• Use the encoding
which is named
e.g. <?xml version="1.0" encoding="UTF-8"?>
in
the
first
line
of
the
BMEcat
Catalog:
• Be sure to have the following second line in the BMEcat Catalog:
<!DOCTYPE BMECAT SYSTEM "bmecat_new_catalog_1_2.dtd">
• Avoid empty fields and blanks at the beginning and the end of fields.
E.g.: False: <KEYWORD> Screw </KEYWORD>
Correct: <KEYWORD>Screw</KEYWORD>
The following chapters are sorted like the sections of the BMEcat catalog, described in the basics of BMEcat:
Header Data, Catalog Structure, Article Details, Mapping of the articles to the catalog structure. Each chapter
is followed by a description of the most important fields.
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.
3.1 Catalog Header Data
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
LANGUAGE
CATALOG_ID
CATALOG_VERSION
CATALOG_NAME
TERRITORY
CURRENCY
BUYER_ID
Content
ces / deu / eng / esl / fra / scr /por
Supplier Name_Supplier No._Country (abbreviation)
(max. 20 figures!)
001.001
Product range_supplier name
CZ, FR, GB, DE, ES, BA, BR
EUR/GBP/CZK/BAM/BRL
MH_001 (DE) / MH_002 (CZ) / MH_003 (GB) / MH_004 (BA) / MH_005 (FR) /
MH_006 (ES) / MH_007 (BR)
MH_001 (DE) / MH_002 (CZ) / MH_003 (GB) / MH_004 (BA) / MH_005 (FR) /
MH_006 (ES) / MH_007 (BR)
BUYER_NAME
SUPPLIER_ID
type="buyer_specific" Supplier No. of SAP
SUPPLIER_NAME
Supplier Name
Requirements regarding BMEcat format
Page 4
Additional Hints Header Data:
Catalog version
The version number consists of a Master_ID and a Sub_ID in the format xxx.yyy (Versioning according to
BMEcat). Each new supplier starts with 001.001. The Master_ID is increased by 1 for each complete update.
Sub_ID is not considered by MANN+HUMMEL
CATALOG_ID
It is very important to use the same CATALOG_ID for every catalog update, so the existing catalog is replaced or updated. Always use the CATALOG_ID assigned by MANN+HUMMEL.
LANGUAGE & TERRITORY
The visibility of catalogs is navigated by the fields LANGUAGE and TERRITORY.
Example: A Catalog with Territory DE is for an English user not visible. The visibility of the product range
depends on the log-in language.
3.2 Fields for the Catalog Structure
The catalog structure is the structure the supplier has defined for grouping his products. The Catalog Structure is independent, without using a classification standard. This catalog structure is to distinguish from
standardized classification systems like eCl@ss. The catalog structure (CATALOG_GROUP_SYSTEM) is
necessary. Every article has to be assigned to a catalog group with the type leaf. The mapping of the articles
is done at the fields mentioned at the chapter 3.4.
Used / required fields for catalog structure
Field /
Label
Description
BMEcat field
Field
Mandatory/
length Optional
Specification of the catalog structure (CATALOG_GROUP_SYSTEM)
Catalog system ID
Identification of the catalog group system
Catalog system name Name of the catalog group system
Description
Description of the catalog group system
Catalog structure
Designation of the individual catalog groups as
specified below.
root
node
leaf
Group No.
Unique designator which identifies the
group
Name of the catalog group, which is displayed in the catalog system
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 name
Group description
Parent group
Sequence
MIME information
Keyword
Requirements regarding BMEcat format
GROUP_SYSTEM_ID
GROUP_SYSTEM_NAME
GROUP_SYSTEM_
DESCRIPTION
CATALOG_STRUCTURE
type = ...
50
50
250
Optional
Optional
Optional
4
Mandatory
GROUP_ID
50
Mandatory
GROUP_NAME
50
Mandatory
GROUP_DESCRIPTION
PARENT_ID
250
50
Optional
Mandatory
GROUP_ORDER
MIME_INFO (see above)
KEYWORD
-
Optional
Optional
Optional
50
Page 5
3.3 Fields to Specify the Article Details
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
Supplier article No.
Article number from the supplier
SUPPLIER_AID
Short description
Brief and concise description of the
DESCRIPTION_SHORT
article
Long description
Detailed description of the article
DESCRIPTION_LONG
Alternative article No.
Further article ID from the supplier
SUPPLIER_ALT_ID
Article No. from buyer “type" defines the type of article number. BUYER_AID type = …
type = "Standard range": value = S
Field
length
Mandatory/
Optional
6
32
80
Mandatory
Mandatory
Mandatory
64000
50
50
Mandatory
type = "SAP_MATNR": value = SAP
material number
REQUIREMENT from MANN+HUMMEL for field type =
“SAP_MATNR”: please do NOT fill in MANN+HUMMEL SAP
material number (10-digit-number)
Manufacturer
article No.
Manufacturer
ERP product group of
buying company
Optional
Mandatory
for type
“standard
range”
Part number from the manufacturer
MANUFACTURER_AID
50
Optional
Name of the manufacturer
Material group or category of the article
in the ERP system of the buying company
MANUFACTURER_NAME
ERP_GROUP_BUYER
50
10
*Mandatory*
*Mandatory*
DELIVERY_TIME
6
*Mandatory*
SPECIAL_TREATMENT_CLASS type
=…
KEYWORD
20
Optional
50
*Mandatory*
REMARKS
ARTICLE_STATUS type =
…
64000
250
Optional
Optional
REFERENCE_FEATURE_
SYSTEM_NAME
50
*Mandatory*
REFERENCE_FEATURE_
GROUP_ID
60
*Mandatory*
FNAME
60
Mandatory
FUNIT
FDESCR
FVALUE
20
250
60
Optional
Optional
Mandatory
Specification from MANN+HUMMEL:
eCl@ss number of the article without "-", i.e. 24240100 for e.g. pencil
Planned delivery time
Time in working days that the supplier
requires for delivery. 0 is not allowed.
Special treatment
Additional classification of the article
class
(hazardous goods). Here "type" defines
the special treatment regulation.
Keyword
Keyword which makes finding the article
easier
Remarks
Additional remarks from the supplier
Special article features Assignment of additional special attributes. Here "type" specifies the special
feature.
Classification of articles (ARTICLE_FEATURES) – *Mandatory*
Classification and
feature group system
Classification and feature group system
Specification from MANN+HUMMEL:
Group ID
Feature name
Feature unit
Feature description
Feature value
ECL@SS-6.1
ID of the referenced group within the
classification and feature group system,
eCl@ss Number from eCl@ss Version
6.1
e.g. 24240100
Unique name of the feature to be described
Measurement unit of the feature
Additional description of the feature
Prominence of the referenced feature
Requirements regarding BMEcat format
Page 6
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 orORDER_UNIT
dered
Content unit
Unit used for the article within an
CONTENT_UNIT
order unit
Package quantity
Number of content units per order
NO_CU_PER_OU
unit of the article
Price quantity
A multiple or fraction of the order
PRICE_QUANTITY
unit indicating the quantity to which
all specified prices relate
Minimum order quanti- Minimum order quantity of the article QUANTITY_MIN
3
Mandatory
3
*Mandatory*
-
*Mandatory*
-
*Mandatory*
-
Mandatory
Number indicating the multiples in
QUANTITY_INTERVAL
which the article can be ordered
Specification of price data (ARTICLE_PRICE_DETAILS)
Valid as of
Date from which the article prices
DATETIME
become valid
type=“valid_start_date”
Valid until
Date after which the article prices
DATETIME
are no longer valid
type=“valid_end_date”
Attention: At end of valid date, article
is no longer visible!
Daily price
Daily price identifier
DAILY_PRICE
Price type
Attribute which specifies the price
ARTICLE_PRICE
type
Specification from MANN+HUMMEL:
ARTICLE_PRICE price_type=“net_customer“, NOT: net_list
Price
Price amount
PRICE_AMOUNT
Lower graduated price Lower quantity limit for graduated
LOWER_BOUND
limit
prices
VAT
Vat tax percentage for the item, e.g. VAT
0.20 (please do NOT write 20%)
References to supplementary multimedia data (MIME_INFO)
 See also the paragraph "Images and supplementary documents"
-
Optional
-
Optional
-
Optional
-
Optional
Mandatory
20
Mandatory
-
Mandatory
Optional
Mime type
MIME_TYPE
30
Optional
MIME_SOURCE
250
Mandatory
MIME_DESCR
MIME_ALT
250
50
Optional
Optional
MIME_PURPOSE
20
*Mandatory*
ty
Quantity interval
Source
Description
Alternative text
Purpose
Type of supplementary document
JPEG  image/jpeg
PDF  application/pdf
HTML Document  text/html
URL to the internet  url
Relative path and file name or URL
address
e.g. Picture.jpg or datasheet.pdf
Attention: in Mime-file must be the same
path
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
“normal” for pictures
“detail” for detail pictures
“data_sheet” for PDF files
“others” for other files
Mandatory
Specification from MANN+HUMMEL: At least one image must
be supplied as
MIME_PURPOSE = "normal"
Requirements regarding BMEcat format
Page 7
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
Number
Reference article
Product catalog
Version
Describes how the two articles are related
- sparepart
- similar
- followup
- mandatory
- select
- accessories
- consists of
- others
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
ARTICLE_REFERENCE
type = ...
20
Mandatory
ARTICLE_REFERENCE
quantity = …
ART_ID_TO
-
Optional
32
Mandatory
CATALOG_ID
20
Optional
CATALOG_VERSION
7
Optional
Additional Hints Article Details:
Short Description
Please be sure to insert a specific detail of the article into the first 40 characters of the short description (DESCRIPTION_SHORT). So the item will be easier to find for the users. The short description is limited to 80
characters. Example: Screw Cross Recess 6x40mm
Features
MANN+HUMMEL wants to have features, because they are helping to differentiate articles which are sorted
into the same catalog structure or classification group. So the users are able to choose articles more easy.
The fields FNAME and FVALUE are defined as MUST fields, if features are used. It is possible to define
features attached or as independent from the classification system.
Prices and Tax
Use a dot as a decimal separator for all numeric values in BMEcat catalogs. E.g. in the field
PRICE_AMOUNT a dot “.” has to be used and NOT a comma “,” as decimal separator, 3.12 instead of 3,12.
The same is true for the VAT in the field TAX. Insert 0.19 instead of 0,19 for example. Do not specify values
greater than 1 for the tax field. A maximum of 2 decimal places is allowed.
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.
Requirements regarding BMEcat format
Page 8
Case 1: Presentation of price per bottle
ORDER_UNIT = CS (case)
CONTENT_UNIT = BO (Bottle)
NO_CU_PER_OU = 10
PRICE_QUANTITY = 0.1 (1/10)
QUANTITY_MIN = 1
QUANTITY_INTERVAL = 1
PRICE_AMOUNT = 1
Case 2: Presentation of price per crate
ORDER_UNIT = CS (Crate)
CONTENT_UNIT = Bottle
NO_CU_PER_OU = 10
PRICE_QUANTITY = 1
QUANTITY_MIN = 1
QUANTITY_INTERVAL = 1
PRICE_AMOUNT = 10
Example for Units
Unit
Piece
Meter
Centimeter
Cubikmeter
Liter
Kilogram
Package
Palette
Case
Bottle
Bag
Carton
Unit UNECE
C62
MTR
CMT
D90
LTR
KGM
PA
PF
CS
BO
BG
CT
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.
BMEcat Field
Description
The catalog system uses the attribute “normal” in the field MIME_PURPOSE for
displaying the picture in the list or detail view of the items. Use “detail” for additional
larger pictures.
Attention: Only one picture (image/jpeg) per item is allowed to be declared as
“normal”. If pictures are used, one has to be declared as “normal”.
MIME_PURPOSE Use “data_sheet” for an additional instructions in the PDF file format.
Examples:
- “normal” for pictures
- “detail” for detail pictures
- “data_sheet” for PDF files
- “others” for other files & URLs
All possibilities of the BMEcat specification are possible.
Examples:
MIME_TYPE
MIME_SOURCE
JPEG  image/jpeg
PDF  application/pdf
URL  url
HTML Document  text/html
Source and name of the file
If you insert file directories for picture files in the MIME_SOURCE field, be sure to file the files in these directories (e.g. in the zip file or at the CD), otherwise they are not displayed.
The standard item picture (purpose=normal) is scaled down to a maximum size of 300 pixel height and 400
pixel width. Any lager image is a waste of space.
Example
MIME_SOURCE: <MIME_SOURCE>datasheets/987262.pdf</MIME_SOURCE>
Picture-ZIP file or CD: datasheets/987262.pdf
Requirements regarding BMEcat format
Page 9
Please pay attention to the case sensitivity and to use no special characters like \ / : * ? „ < > | . Compared to
the example mentioned above, a MIME_SOURCE with
MIME_SOURCE>DataSheet/98726*2.PDF</MIME_SOURCE> will not work.
References to other Articles
It is possible to refer to another article in the detail view of an article, to
point the user for example to a necessary additional article or an accessory. Important is to use the correspondent type of reference.
Example
<ARTICLE_REFERENCE type=“mandatory“>
<ART_ID_TO>123456</ART_ID_TO>
</ARTICLE_REFERENCE>
Possible Field Types:
- sparepart
- similar
- followup
- mandatory
- select
- accessories
- consists of
- others
3.4 Fields for the Mapping of Articles to the Catalog Structure
Every article have to be linked to the catalog structure, otherwise the article is not visible in a folder. At end of the file,
this have to be done for all articles. Every article needs a entry as following:
Required fields for the mapping of articles to the Catalog Structure:
Field / Label
Description
BMEcat field
Field
Mandatory/
length Optional
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
This is an independent catalog structure, without using a classification standard. This catalog structure is to
distinguish from standardized classification systems like eCl@ss or UNSPSC. The catalog structure (CATALOG_GROUP_SYSTEM) is necessary for MANN+HUMMEL. It allows the user to drill down into your items.
Use a hierarchical structure that helps finding things easier or is similar to your printed catalog. Every article
has to be assigned to a catalog group with the type leaf. The definition of the catalog structure is done in the
fields mentioned at the chapter 3.2.
Note: The following fields are used for searching in the catalogs: DESCRIPTION_SHORT, MANUFACTURER_NAME, MANUFACTURER_AID, SUPPLIER_AID
Requirements regarding BMEcat format
Page 10
Download