 |
SERIES
|
This element is used to specify all series of the catalogue/data with the properties and elements assigned to them, e.g. product groups or items.
A series usually corresponds to a model. |
| |
 |
Sequence
|
SERIE 1..1000000
This element is used to define the series. A series usually corresponds to a model.
An item from series 0 is valid in all other series, which means that items of series 0 must not exist with the same type designation (SERIES/SERIE/PRODUCT_GROUPS/PRODUCT_GROUP/ITEMS/ITEM/TYPE_NO) in any other series. Items of other series (other than 0) may however exist in multiple series with identical type designation. |
 |
SERIE_NO required Restriction of xs:nonNegativeInteger
| This attribute is used to specify the serial number of the series. |
D nonNegativeInteger
P
M [0:999999] | |
|
SEQUENCE_NO required xs:positiveInteger
This attribute allows for the specification of series with a freely-defined sorting order.
If a SEQUENCE_NO is specified for one series, a SEQUENCE_NO must be specified for all series. |
D positiveInteger
P
M | |
|
Sequence
|
SERIES_NAME
This element is used to specify the series name.
|
Sequence
|
LANGUAGE 1..∞
This element allows for the specification of texts in multiple languages. One element is created for each language. Language is specified in the attribute ISO_LANGUAGE_ID. The same languages must be specified for each element in the data pool.
|
ISO_LANGUAGE_ID required Restriction of xs:language
| This attribute specifies the ISO code of the stored text's language. |
D language
P [A-Za-z]{1,3}
M [1:3]
| |
|
Sequence
|
TEXT_LINE
This element is used to specify a line of text.
The TEXT element contains a short text. The FULL_TEXT element contains a text of any length.
|
Sequence
|
TEXT Restriction of xs:string
| This element is used to store the short text in the language specified in the LANGUAGE element of the ISO_LANGUAGE_ID attribute. |
D string
P [\S ]{1,30}
M [1:30]
|
|
|
FULL_TEXT optional xs:string
| This element is used to store the text (any length) in the language specified in the LANGUAGE element of the ISO_LANGUAGE_ID attribute. |
D string
P
M
|
| | | | | | |
|
PURCHASE_RETAIL_ID Restriction of xs:nonNegativeInteger
|
This element assigns an identifier for series-specific purchasing/sales prices:
EK_VK_ID
0 = purchasing price including VAT (or list price)
1 = sales price including VAT ( recommended sales price)
2 = purchasing price excluding VAT
3 = purchasing price excl. VAT/VAT
The price is defined as a function of the price-ID (Element PRICE_ID (path 1)) as follows:
Price ID = 1 (price), the value from the ITEM_PRICE (path 2) element will be used.
Price ID = 2 (ID number), the price from the IDENT_NUMBER/PRICE (path 3)element, the ITEM_PRICE/PRICE_MINIMUM_BASIC (path 2) element or the ADDITIONAL_PRICE (element 5) is used.
Price ID = 3 (offsetting point), the value from the ITEM_PRICE (path 2) element or the PRICE_MINIMUM_BASIC Element multiplied by the settlement factor from the PRICE_DEFINITION/MERCHANDISE_GROUP/CALC_GROUP/CALCULATION_FACTOR is used.
Due to the key, only one price (combination of the elements VAT (path 4) and PURCHASE_RETAIL_ID ) can be specified within the same series.
If a file contains both purchasing and retail prices, models with purchasing prices must not be assigned the same calculation groups (PRICE_DEFINITION/MERCHANDISE_GROUP/CALC_GROUP) as models with retail prices.
This element is very important for pricing. If the purchasing prices are used, this must be the dealership's purchasing price, not the manufacturer purchasing price.
Element paths
Path 1: CATALOG/CATALOG_IDENTIFICATION/
Path 2: SERIES/SERIE/PRODUCT_GROUPS/PRODUCT_GROUP/ITEMS/ITEM/PRICE_FEATURE_GROUP_BASE_PRICE_REF/
Path 3: PRICE_DEFINITION/IDENT_NUMBERS
Path 4: CATALOG/CATALOG_IDENTIFICATION/
Path 5 : PRICE_DEFINITION/PRICE_FEATURE_GROUPS/PRICE_FEATURE_GROUP |
D nonNegativeInteger
P
M [0:3]
|
|
|
DECISIONS optional
This element is used to collect series specific rules.
|
Sequence
|
DECISION_REF 1..∞
This element is used to reference a rule assigned to a series.
|
DECISION_NO required Restriction of xs:positiveInteger
| This attribute is used to reference a rule. |
D nonNegativeInteger
P
M [1:9999999999]
| | | | |
|
PRODUCT_GROUPS
This element is used to define product groups. Articles with identical features are grouped together in product groups.
|
Sequence
|
PRODUCT_GROUP 1..∞
This element is used to create modified items that are combined in product groups. "Identical" product groups must therefore not be captured.
|
Sequence
|
|
Sequence
|
|
ISO_LANGUAGE_ID required Restriction of xs:language
| This attribute is used to specify the ISO code of the language in which the text is stored. |
D language
P [A-Z]{2}
M [2:2] | |
|
Sequence
|
TEXT Restriction of xs:string
| This element is used to store the text in the language specified in the LANGUAGE element of the ISO_LANGUAGE_ID attribute. |
D string
P [\S ]{1,60}
M [1:60] |
| | | | |
|
|
FEATURE_CLASS_NO required Restriction of xs:positiveInteger
| This attribute is used to identify the referenced feature class (FEATURE_CLASS). |
D positiveInteger
P
M [1:9999999999] | | |
|
ITEMS
This element is used to define all items of a product group.
|
Sequence
|
ITEM 1..∞
This element is used to define items. An item is identified via the SERIE_NO (path 1) and TYPE_NO (path 1) attributes.
The characteristic features/properties, or a reference via ITEM_REF to another series (SERIE_NO) and the item number of valid for the other series, are stored for each item. If the ITEM_REF element contains a value, the item is a reference item belonging to another series, otherwise the item belongs to the series in which it is specified at this position.
Path 1: SERIES/SERIE/PRODUCT_GROUPS/PRODUCT_GROUP/ITEMS/ITEM
Path 2: PRICE_DEFINITION/PRICE_TABLES/PRICE_TABLE
|
TYPE_NO required Restriction of xs:string
| This element is used to enter the item code/item type. |
D string
P
M [1:30]
| |
|
SEQUENCE_NO optional Restriction of xs:positiveInteger
|
This attribute allows for the specification of items with a freely-defined sorting order.
The sorting of the items always relates to the series in which the items are stored. If a SEQUENCE_NO is specified for one item within the series, a SEQUENCE_NO must be specified for all items within this series. |
D positiveInteger
P
M | |
|
Sequence
 |
Choice
|
Sequence
|
ITEM_REF
This element is used to reference an item.
| |
|
Sequence
|
PRICE_FEATURE_GROUP_BASE_PRICE_REF
This element is used to reference a base price group. A base Price group is a PRICE_FEATURE_GROUP (path 1) where the ADDITIONAL_PRICE element has a value of 0. An item must be assigned to precisely one base price group. Additional price groups are assigned via the ADDITIONAL_PRICE_GROUP element. Element paths: Path 1: PRICE_DEFINITION/PRICE_FEATURE_GROUPS/
|
|
PRICE_TYPE_REF
This element is used to reference a price type. Price types are defined in the path1/PRICE_TYPE element.
Element paths:
Path 1: PRICE_DEFINITION/PRICE_TYPES
|
|
ADDITIONAL_PRICE_GROUP 0..∞
This element is used to reference PRICE_FEATURE_GROUPS with additional price groups. The base price group that must be referenced precisely 1x by an item is specified in the PRICE_FEATURE_GROUP_BASE_PRICE_REF element. All items that reference the identical PRICE_FEATURE_GROUP must also reference the same calculation group (CALC_GROUP_REF) and exchange ID (EXCHANGE_ID_REF). The following combinations are permitted when assigning different price types to items and surcharges for the same item:
| Item |
Surcharge |
| Unit price |
Unit price |
| length-dependent |
length-dependent |
| length-dependent |
Unit price | The following combination is not permitted:
| Item |
Surcharge |
| Unit price |
length-dependent |
|
|
DECISIONS optional
This element is used to combine product item-specific rules.
|
|
ADDITIONAL_ITEMS optional
This element is used to assign additional items. It defines quantities of optional and/or necessary additional items, from which the additional items will be selected during planning.
|
|
EDP_NUMBER optional Restriction of xs:string
This element is used to enter the (internal) item EDP number of the manufacturer.
If the EDP_NUMBER is used, it must be unique within a series and created for all items. |
D string
P
M [1:30] |
|
|
EAN_NUMBER optional Restriction of xs:string
| If existing, the EAN number of the item must be entered in this element. |
D string
P
M [1:15] |
|
|
ITEM_IDENTIFICATION Restriction of xs:string
|
This element is used to assign an identifier to the article:
B = Block
E = Replacement part
K = Catalogue item
S = Special item
M = Additional equipment
Z = Configuration
V = Settlement block
P = Settlement position
1 = Planning proposal
2 = Preferred combination
The following applies for the planning proposal (1):
The individual items in the piece list can accept the default values.
There must not be any sub-positions that are only sub-positions and that cannot be ordered individually.
Only the resulting items are ordered. The composition itself never shows in the order forms.
The positions are eliminated and options passed down in the planning.
The individual positions must then be positioned in the magnet planner in their order from left-to-right.
Planning suggestions may contain preferred combinations.
The following rules apply to preferred combinations:
It must not contain a planning suggestion.
If a preferred combination is eliminated (e.g. by deleting a sub-position), the individual prices are newly determined for the individual positions, and the price advantage no longer applies.
The pricing then takes place exclusively on main position level. |
D string
P [BEKSMZVP12]
M [1:1]
|
|
|
CATALOG_PAGE optional Restriction of xs:string
This element should be used to specify the item's catalogue page. This information helps to quickly find an item within the printed catalogue.
Items may feature on multiple catalogue pages. In this case, the number of the page on which the item appears first should be used. In the case of accessories, it makes sense to use the page that contains a full description of the item. This is often done in the section/register "accessories". |
D string
P
M [1:7] |
|
|
VALID_FROM optional Restriction of xs:date
This element specifies the date on which the item becomes available for delivery.
If this element is left blank, the CATALOG/VALID_FROM_DATE element will apply.
Elements with the designation VALID_FROM must not contain a date prior to the catalogue start date. |
D date
P
M |
|
|
VALID_UNTIL optional Restriction of xs:date
This element specifies the date until which the item is available for delivery. If the date element is left blank, the item is available for delivery indefinitely.
Elements with the designation VALID_UNTIL must not contain a date that is more than 10 years in the future from the catalogue date. The element must be left blank for an indefinite period. |
D date
P
M |
|
|
WEIGHT_BRUTTO optional Restriction of xs:nonNegativeInteger
| This element is used to specify the item gross weight (100 g), i.e. exclusive of packaging materials. (e.g. 50 = 5000 g) |
D nonNegativeInteger
P
M [0:9999] |
|
|
WEIGHT_NETTO optional Restriction of xs:nonNegativeInteger
| This element is used to specify the item net weight (100 g), i.e. including packaging material, i.e. exclusive of packaging materials. (e.g. 50 = 5000 g) |
D nonNegativeInteger
P
M [0:9999] |
|
|
VOLUME optional Restriction of xs:nonNegativeInteger
| This element is used to specify the item volume [dm³] including packaging material. (e.g. 50 = 50 dm³) |
D nonNegativeInteger
P
M [0:9999] |
|
|
MINIMUM_DELIVERY_TIME optional Restriction of xs:nonNegativeInteger
This element is used to specify the minimum delivery time in weeks.
The minimum delivery time is for information, the planning software does not interfere with the order controlling (e.g. postponement of the order, partial delivery) |
D nonNegativeInteger
P
M [0:999] |
|
|
BASIC_PROFILE optional
This element is used to specify the basic shapes assigned to an item.
|
|
ITEM_TEXT
This element is used to define the item-specific texts. These may be long texts, short texts, as well as planning notes. At least one item text must be specified for each item.
The following text combinations are permitted:
- Short text;
- Short text + recommended text;
- Short text + recommended text + long text;
- Short text + long text (only if no recommended text is been stored).
The short text may consist of three lines.
|
|
TYPE_KEY
This element is used to define the item's model code. The values for model codes can be found in a table in the introduction, section Model codeThe model code is specified precisely once for each item.
|
|
CLASSIFICATIONS optional
This element is used to store standardized classification numbers.
|
|
DETAIL_INFOS optional
This element is used to specify detailed media information, such as milieu photos, PDFs or video links.
|
|
SALES_NUMBER optional Restriction of xs:string
| If existing, the sale number of the item must be entered in this element. |
D string
P
M [1:30] |
|
|
PART_LIST_REF optional
This element references a piece list contained in an item.
The item passes on its options (OPTIONS) to the sub positions if these have identical features (FEATURES) in the feature class associated with the respective sub-position.
The sub-positions can have rules that determine whether a sub-position is displayed. The sub-position is then specified with the corresponding piece quantity.
Items that are only permitted as sub-positions are marked separately (element PARTS_LIST_EXCLUSIVE).
If the item is a catalogue item (ITEM_IDENTIFICATION 'K'), prices may be assigned to the item.The total price of the catalogue item results from the price assigned to it and the prices of the components from the piece list.
The following applies for the planning proposal (ITEM_IDENTIFICATION '1'):
The individual items in the piece list can accept the default values.
There must not be any sub-positions that are only sub-positions and that cannot be ordered individually.
Only the resulting items are ordered. The composition itself never shows in the order forms.
The positions are eliminated and options passed down in the planning.
The individual positions must then be positioned in the magnet planner in their order from left-to-right.
Planning suggestions may contain preferred combinations.
The following rules apply to preferred combinations (ITEM_IDENTIFICATION '2'):
It must not contain a planning suggestion.
If a preferred combination is eliminated (e.g. by deleting a sub-position), the individual prices are newly determined for the individual positions, and the price advantage no longer applies.
The pricing then takes place exclusively on main position level.
|
|
PART_LIST_EXCLUSIVE optional Restriction of xs:boolean
This element is used to identify whether the item is only permitted as a sub position within a piece list (value set to 1 (true)).
The value 0 (false) has the same meaning as no value at all. |
D boolean
P
M |
|
|
PROPERTIES optional
This element is used to combine item-specific characteristic features/properties.
|
|
PACKAGE_LIST optional
This element is used to specify the packaged pieces per item. An optimisation of packaged items for purchases is not possible.
The width, depth and height must be specified for each packaged item in full mm figures. The weight is specified in decimal kg.
Packaged items may be rule-based, i.e. depending on options, e.g. when drawers or mirrors are added as an option then this triggers a new packaged item. The option for a new packaged item should only be used in simple cases.This means that each element of the list of packaged items can also make reference to rules.
| | | | | | |
|
DECISIONS optional
This element is used to combine product group-specific rules.
|
Sequence
|
DECISION_REF 1..∞
This element is used to reference a rule assigned to a product group.
|
DECISION_NO required Restriction of xs:positiveInteger
| This attribute is used to reference a rule. |
D positiveInteger
P
M [1:9999999999] | | | | | | | | |
|
COLOR_CONSULTANCIES optional
This element is used to define colour consultancies.
Each colour consultancy COLOR_CONSULTANCY contains any number of references to combinations of detailed information and assessments FEATURE_DETAIL_INFO_REF, which are sorted by SEQUENCE_NO. The applied assessments must contain colour variations.
|
Sequence
|
COLOR_CONSULTANCY 1..∞
This element is used to directly assign assessments to image layers.
The applied assessments must contain colour variations.
|
COLOR_CONSULTANCY_NO required Restriction of xs:nonNegativeInteger
| This attribute defines the colour consultancy number. |
D nonNegativeInteger
P
M [0:9999] | |
|
Sequence
|
FEATURE_DETAIL_INFO_REF 1..∞
This element allows for the assignment of precisely one assessment or rule to the image layers.
The assessment and/or rule must contain a colour feature. The assignment is done via DETAIL_INFO_NO and either RESTRICTION_NO or DECISION_NO. Either an assessment (RESTRICTION) or rule (DECISION) can be assigned.
|
DETAIL_INFO_NO required Restriction of xs:positiveInteger
| This attribute references a detailed information. |
D positiveInteger
P
M [1:999999999] | |
|
SEQUENCE_NO required Restriction of xs:positiveInteger
| This attribute defines the order of the colour consultancy. |
D positiveInteger
P
M | |
|
DECISION_NO optional Restriction of xs:positiveInteger
| This attribute references a rule. |
D positiveInteger
P
M [1:9999999999] | | | | | | |
|
DETAIL_INFOS 0..∞
This element is used to specify detailed media information, such as milieu photos, PDFs or video links.
|
Sequence
|
DETAIL_INFO_REF 1..∞
This element is used to reference the detailed information.
|
DETAIL_INFO_NO required Restriction of xs:positiveInteger
| This attribute is used to specify the identification number of the referenced detailed information. |
D positiveInteger
P
M [1:999999999] | | | | |
|
VALID_FROM optional Restriction of xs:date
This element specifies the date on which the series becomes available for delivery.
If this element is left blank, the CATALOG/VALID_FROM_DATE element will apply.
Elements with the designation VALID_FROM must not contain a date prior to the catalogue start date. |
D date
P
M |
|
|
VALID_UNTIL optional Restriction of xs:date
This element specifies the date until which the item is available for delivery. If the date element is left blank, the item is available for delivery indefinitely.
Elements with the designation VALID_UNTIL must not contain a date that is more than 10 years in the future from the catalogue date. The element must be left blank for an indefinite period. |
D date
P
M |
| | |
|
DECISIONS optional
This element is used to collect cross-series rules.
|
Sequence
|
DECISION_REF 1..∞
This element is used to reference a cross-series rule.
|
DECISION_NO required Restriction of xs:positiveInteger
| This attribute is used to reference a rule. |
D positiveInteger
P
M [1:9999999999] | | | | |
|
SERIE_GROUPS optional
This element can be used to combine different series in groups (model groups).
|
Sequence
|
SERIE_GROUP 1..∞
A model group (combination of multiple series) is defined here.
|
SERIE_GROUP_KEY required Restriction of xs:string
|
This attribute assigns unique identifiers to series groups/model groups. |
D string
P
M [1:30] | |
|
SEQUENCE_NO optional Restriction of xs:nonNegativeInteger
|
This attribute allows for the specification of series groups with a freely-defined sorting order. |
D nonNegativeInteger
P
M | |
|
Sequence
|
SERIE_REF 1..∞
This element is used to reference series.
|
SERIE_NO required Restriction of xs:nonNegativeInteger
| This attribute is used to reference a series. |
D nonNegativInteger
P
M [0:999999] | |
|
SEQUENCE_NO optional Restriction of xs:nonNegativeInteger
| This attribute defines the order of the series within a series group. |
D nonNegativeInteger
P
M | | |
|
|
Sequence
|
|
ISO_LANGUAGE_ID required Restriction of xs:language
| This attribute is used to specify the ISO code of the language in which the text is stored. |
D language
P [A-Z]{2}
M [2:2] | |
|
Sequence
|
TEXT Restriction of xs:string
| This element is used to store the text in the language specified in the LANGUAGE element of the ISO_LANGUAGE_ID attribute. |
D string
P [\S ]{1,60}
M [1:60] |
| | | | |
|
DETAIL_INFOS 0..∞
This element is used to specify detailed media information, such as milieu photos, PDFs or video links.
|
Sequence
|
DETAIL_INFO_REF 1..∞
This element is used to reference the detailed information.
|
DETAIL_INFO_NO required Restriction of xs:positiveInteger
| This attribute references a detailed information. |
D positiveInteger
P
M [1:999999999] | | | | | | | | | | |
