TradeItem — Domain Model Tree

Trade Item

Complete trade item information including identification, details, ordering, pricing, logistics, and related data. St…

supplierIdGlnGlnrequiredGlobal Location Number (GLN) of the supplier. Primary key component.

supplierItemNumberstringrequiredmin: 1, max: 35Supplier's unique item number. Primary key component.

orderingTradeItemOrderingrequiredOrdering information for the trade item.

Ordering information for the trade item including order unit, minimum quantities, and lead time. Extracted from ETIM …

orderUnitUnitCodesrequiredANN | DAY | HUR | MIN | SEC | WEE | GRM | KGM | MGM | TNE | LTN | LBR | ONZ | CMT | KTM | MMT | MTR | FOT | INH | SMI | YRD | CMK | CMQ | MMK | MMQ | MTK | MTQ | FTQ | INQ | LTR | MLT | HLT | BE | BG | BO | BX | CA | CI | CL | CQ | CR | CS | CT | DR | C62 | DZN | NMP | NPL | NRL | PA | PF | PK | PL | PR | PU | RG | RL | RO | SA | SET | ST | TN | TU | Z2 | Z3 | D99 | KGUnit in which the item can be ordered (e.g., pieces, boxes, meters).

minimumOrderQuantitynumberdecimalrequired≥ 0, ≤ 999999999999.9999Minimum quantity that must be ordered (converted from ETIM xChange string to number).

orderStepSizenumberdecimalrequired≥ 0, ≤ 999999999999.9999Quantity increment for orders beyond minimum (converted from ETIM xChange string to number). For example, if minimum …

standardOrderLeadTimeinteger≥ 0Standard lead time for orders in days.

useUnitUnitCodesANN | DAY | HUR | MIN | SEC | WEE | GRM | KGM | MGM | TNE | LTN | LBR | ONZ | CMT | KTM | MMT | MTR | FOT | INH | SMI | YRD | CMK | CMQ | MMK | MMQ | MTK | MTQ | FTQ | INQ | LTR | MLT | HLT | BE | BG | BO | BX | CA | CI | CL | CQ | CR | CS | CT | DR | C62 | DZN | NMP | NPL | NRL | PA | PF | PK | PL | PR | PU | RG | RL | RO | SA | SET | ST | TN | TU | Z2 | Z3 | D99 | KGUnit in which the item is used or consumed (may differ from order unit).

useUnitConversionFactornumberdecimal≥ 0, ≤ 999999999999.9999Conversion factor from order unit to use unit (converted from ETIM xChange string to number).

singleUseUnitQuantitynumberdecimal≥ 0, ≤ 999999999999.9999Quantity of use units in a single order unit (converted from ETIM xChange string to number).

alternativeUseUnitUnitCodesANN | DAY | HUR | MIN | SEC | WEE | GRM | KGM | MGM | TNE | LTN | LBR | ONZ | CMT | KTM | MMT | MTR | FOT | INH | SMI | YRD | CMK | CMQ | MMK | MMQ | MTK | MTQ | FTQ | INQ | LTR | MLT | HLT | BE | BG | BO | BX | CA | CI | CL | CQ | CR | CS | CT | DR | C62 | DZN | NMP | NPL | NRL | PA | PF | PK | PL | PR | PU | RG | RL | RO | SA | SET | ST | TN | TU | Z2 | Z3 | D99 | KGAlternative unit in which the item can be used or consumed.

alternativeUseUnitConversionFactornumberdecimal≥ 0, ≤ 999999999999.9999Conversion factor from order unit to alternative use unit (converted from ETIM xChange string to number).

detailsTradeItemDetailsTrade item identification and operational details, combining fields from ETIM xChange `ItemIdentification` and `ItemD…

Trade item identification and details information without composite key fields. Combines fields from ETIM xChange `It…

manufacturerIdGlnGlnrequiredGlobal Location Number (GLN) of the manufacturer. 13-digit GS1 identifier. Required product key reference - together …

manufacturerProductNumberstringrequiredmin: 1, max: 35Manufacturer's product number. Required product key reference - together with `manufacturerIdGln` identifies the pare…

itemValidityDatestringdaterequiredDate from which the trade item is valid for ordering. ISO 8601 date format (YYYY-MM-DD). Defaults to CatalogueValidit…

supplierAltItemNumberstringmin: 1, max: 35Alternative supplier item number. Used when the supplier has multiple numbering systems or legacy item numbers.

manufacturerItemNumberstringmin: 1, max: 35Manufacturer's item number. May differ from supplier's number if supplier is a distributor.

itemGtinsGtin[]Array of Global Trade Item Numbers (GTIN-8, GTIN-12, GTIN-13, or GTIN-14) for the item. Multiple GTINs may exist for …

buyerItemNumberstringmin: 1, max: 35Buyer's specific item number. Used when buyer has assigned their own numbering to supplier items.

discountGroupIdstringmin: 1, max: 20Identifier for the discount group this item belongs to. Used for pricing and discount calculations.

bonusGroupIdstringmin: 1, max: 20Identifier for the bonus group this item belongs to. Used for bonus/rebate calculations.

itemObsolescenceDatestringdateDate when the trade item becomes obsolete and is no longer available for ordering. ISO 8601 date format (YYYY-MM-DD).

itemStatusItemStatusPRE-LAUNCH | ACTIVE | ON HOLD | PLANNED WITHDRAWAL | OBSOLETECurrent lifecycle status of the trade item in the supplier's catalog.

itemConditionItemConditionNEW | USED | REFURBISHEDPhysical condition of the trade item.

stockItembooleanIndicates whether the item is a stock item (true) or made-to-order (false). Stock items are typically available for i…

shelfLifePeriodinteger≥ 0, ≤ 999Shelf life period of the item in days. Indicates how long the item remains usable after production. Applicable for it…

descriptionsItemDescription[]Array of multilingual item descriptions. Each item contains descriptions in a specific language.

Item description in a specific language. Extracted from ETIM xChange `TradeItem.ItemDetails.ItemDescriptions[]` struc…

descriptionLanguageLanguageCoderequiredLanguage code for the description in ISO 639-1 and ISO 3166-1 format (e.g., "en-GB", "de-DE"). Sourced from ETIM xCha…

minimalItemDescriptionstringrequiredmin: 1, max: 80Minimal description of the trade item (short description).

uniqueMainItemDescriptionstringmin: 1, max: 255Extended unique description of the trade item (long description).

discountGroupDescriptionstringmin: 1, max: 100Human-readable description of the discount group in this language.

bonusGroupDescriptionstringmin: 1, max: 100Human-readable description of the bonus group in this language.

pricingsTradeItemPricing[]Array of pricing information for different conditions or customer groups.

Pricing information for a trade item including prices, price unit, and validity dates. Extracted from ETIM xChange `T…

priceUnitUnitCodesrequiredANN | DAY | HUR | MIN | SEC | WEE | GRM | KGM | MGM | TNE | LTN | LBR | ONZ | CMT | KTM | MMT | MTR | FOT | INH | SMI | YRD | CMK | CMQ | MMK | MMQ | MTK | MTQ | FTQ | INQ | LTR | MLT | HLT | BE | BG | BO | BX | CA | CI | CL | CQ | CR | CS | CT | DR | C62 | DZN | NMP | NPL | NRL | PA | PF | PK | PL | PR | PU | RG | RL | RO | SA | SET | ST | TN | TU | Z2 | Z3 | D99 | KGUnit for which the price applies (e.g., pieces, boxes, meters).

priceQuantitynumberdecimalrequired≥ 0, ≤ 99999.9999Quantity for which the price applies (converted from ETIM xChange string to number).

currencyCodeCurrencyCoderequiredEUR | USD | GBP | CHF | SEK | NOK | DKK | PLN | CZKCurrency code for all monetary values in this pricing entry. Sourced from ETIM xChange `CurrencyCode` at catalog level.

priceValidityDatestringdaterequiredDate from which the price is valid. ISO 8601 date format (YYYY-MM-DD). Defaults to CatalogueValidityStart if not over…

priceUnitFactornumberdecimal≥ 0, ≤ 99999999999.9999Factor to convert price unit to order unit (converted from ETIM xChange string to number).

priceOnRequestbooleanIndicates whether the price is available only on request.

grossListPricenumberdecimal≥ 0, ≤ 99999999999.9999Gross list price (before discounts) (converted from ETIM xChange string to number).

netPricenumberdecimal≥ 0, ≤ 99999999999.9999Net price (after discounts, before tax) (converted from ETIM xChange string to number).

recommendedRetailPricenumberdecimal≥ 0, ≤ 99999999999.9999Recommended retail price (MSRP) (converted from ETIM xChange string to number).

vatnumberdecimal≥ 0, ≤ 99.99VAT/tax percentage (converted from ETIM xChange string to number).

priceExpiryDatestringdateDate when the price expires. ISO 8601 date format (YYYY-MM-DD).

allowanceSurchargesAllowanceSurcharge[]Allowances and surcharges applied to this pricing entry. Omit when no allowances or surcharges are defined for this p…

Allowance or surcharge applied to trade item pricing, including fixed and percentage-based adjustments.

allowanceSurchargeIndicatorstringrequiredALLOWANCE | SURCHARGEIndicates whether this price adjustment is an allowance (discount) or a surcharge (additional charge).

allowanceSurchargeTypeAllowanceSurchargeTypesrequiredAAT | ABL | ADO | ADR | ADZ | AEM | AEO | AEP | AEQ | CAI | DAE | DBD | FC | HD | INS | MAC | MAT | PAD | PI | QD | RAD | SH | TD | WHE | X21Code describing the reason for the allowance or surcharge. Uses shared enumeration aligned with ETIM codes.

allowanceSurchargeValidityDatestringdateDate from which the allowance or surcharge becomes valid. ISO 8601 date format (YYYY-MM-DD).

allowanceSurchargeAmountnumberdecimal≥ 0, ≤ 99999999999.9999Fixed monetary amount of the allowance or surcharge (converted from ETIM string pattern to numeric form).

allowanceSurchargeSequenceNumberinteger≥ 1Sequence number used to order multiple allowances or surcharges applied to the same price.

allowanceSurchargePercentagenumberdecimal≥ 0, ≤ 999.999Percentage rate of the allowance or surcharge (converted from ETIM string pattern to numeric form).

allowanceSurchargeMinimumQuantitynumberdecimal≥ 0, ≤ 999999999999.9999Minimum ordered quantity required for the allowance or surcharge to apply (converted from ETIM string pattern to nume…

relationsItemRelation[]Array of relationships to other trade items (accessories, spare parts, etc.).

Defines a relationship between trade items (e.g., accessories, spare parts, related products). Extracted from ETIM xC…

relatedSupplierItemNumberstringrequiredmin: 1, max: 35Supplier item number of the related trade item.

relatedItemQuantityintegerrequired≥ 1Quantity of the related item required or recommended (converted from ETIM xChange string to integer).

relatedManufacturerItemNumberstringmin: 1, max: 35Manufacturer item number of the related trade item.

relatedItemGtinsGtin[]Array of GTINs for the related trade item.

logisticDetailsItemLogistic[]Array of logistic details including dimensions and weights.

Logistic details including dimensions, weight, and volume of the base item. Extracted from ETIM xChange `TradeItem.It…

baseItemNetLengthnumberdecimal≥ 0, ≤ 999999999999.9999Net length of the base item in specified unit (converted from ETIM xChange string to number).

baseItemNetWidthnumberdecimal≥ 0, ≤ 999999999999.9999Net width of the base item in specified unit (converted from ETIM xChange string to number).

baseItemNetHeightnumberdecimal≥ 0, ≤ 999999999999.9999Net height of the base item in specified unit (converted from ETIM xChange string to number).

baseItemNetDiameternumberdecimal≥ 0, ≤ 999999999999.9999Net diameter of the base item in specified unit (for cylindrical items) (converted from ETIM xChange string to number).

netDimensionUnitstringCMT | DMT | KMT | MMT | MTR | FOT | INH | SMI | YRDUnit of measurement for net dimensions (CMT=centimeter, MTR=meter, etc.).

baseItemNetWeightnumberdecimal≥ 0, ≤ 999999999999.9999Net weight of the base item in specified unit (converted from ETIM xChange string to number).

netWeightUnitstringGRM | KGM | MGM | TNE | LTN | LBR | ONZUnit of measurement for net weight (GRM=gram, KGM=kilogram, etc.).

baseItemNetVolumenumberdecimal≥ 0, ≤ 999999999999.9999Net volume of the base item in specified unit (converted from ETIM xChange string to number).

netVolumeUnitstringFTQ | INQ | MTQ | MMQ | OZA | GLL | LTR | MLT | PT | QTUnit of measurement for net volume (LTR=liter, MTQ=cubic meter, etc.).

attachmentsItemAttachment[]Array of attachments (images, documents, certificates, etc.).

Attachment information for trade items (images, documents, certificates, etc.). Extracted from ETIM xChange `TradeIte…

attachmentTypeAttachmentTyperequiredATX001 | ATX002 | ATX003 | ATX004 | ATX010 | ATX011 | ATX012 | ATX013 | ATX014 | ATX015 | ATX016 | ATX017 | ATX018 | ATX019 | ATX020 | ATX021 | ATX022 | ATX023 | ATX024 | ATX025 | ATX026 | ATX099Type of attachment (image, document, certificate, etc.).

attachmentUristringurirequiredURI/URL to the attachment file.

attachmentTypeSpecificationAttachmentTypeSpecificationMDX002 | MDX005 | MDX007 | MDX008 | MDX010 | MDX012 | MDX013 | MDX014 | MDX015 | MDX016 | MDX017 | MDX018 | MDX019 | MDX020 | MDX021 | MDX022 | MDX023 | MDX024 | MDX025 | MDX026 | MDX027 | MDX028 | MDX029 | MDX030 | MDX033 | MDX034 | MDX035 | MDX037 | MDX038 | MDX039 | MDX041 | MDX042 | MDX045 | MDX047 | MDX048 | MDX049 | MDX050 | MDX051 | MDX052 | MDX053 | MDX054 | MDX055 | MDX057 | MDX058 | MDX059 | MDX060 | MDX061 | MDX062 | MDX063 | MDX064 | MDX065 | MDX100 | MDX101 | MDX102 | MDX103 | MDX104 | MDX105 | MDX106 | MDX107 | MDX108 | MDX109 | MDX999Additional specification code providing more detail about the attachment type.

attachmentLanguagesLanguageCode[]Languages for which the attachment is applicable (e.g., 'en-GB', 'de-DE').

attachmentFilenamestringmin: 1, max: 100Filename of the attachment.

attachmentDescriptionstringmin: 1, max: 255Human-readable description of the attachment. Flattened from multilingual array.

attachmentIssueDatestringdateDate when the attachment was issued. ISO 8601 date format (YYYY-MM-DD).

attachmentExpiryDatestringdateDate when the attachment expires. ISO 8601 date format (YYYY-MM-DD).

packagingUnitsPackagingUnit[]Array of packaging unit information for different packaging levels.

Packaging unit information describing hierarchical packaging levels (e.g., piece, box, pallet). Extracted from ETIM x…

packagingTypeCodePackagingTypeCoderequiredBE | BG | BJ | BO | BR | BX | C62 | CA | CL | CQ | CR | CS | CT | CY | D99 | DR | EV | KG | NE | PA | PF | PK | PL | PR | PU | RG | RL | RO | SA | SET | TN | TU | WR | Z2 | Z3Type of packaging (box, pallet, etc.).

supplierPackagingNumberstringmin: 1, max: 35Supplier's packaging number for this packaging unit.

manufacturerPackagingNumberstringmin: 1, max: 35Manufacturer's packaging number for this packaging unit.

packagingGtinsGtin[]Array of GTINs for this packaging unit.

packagingUnitNamestringmin: 1, max: 20Human-readable name of the packaging unit. Flattened from multilingual array.

packagingQuantitynumberdecimal≥ 0, ≤ 999999999999.9999Quantity of base items in this packaging unit (converted from ETIM xChange string to number).

tradeItemPrimaryPackagingbooleanIndicates whether this is the primary/consumer packaging.

packagingGs1Code128stringmin: 1, max: 48GS1-128 barcode for the packaging unit.

grossLengthnumberdecimal≥ 0, ≤ 999999999999.9999Gross length of the packaging in specified unit (converted from ETIM xChange string to number).

grossWidthnumberdecimal≥ 0, ≤ 999999999999.9999Gross width of the packaging in specified unit (converted from ETIM xChange string to number).

grossHeightnumberdecimal≥ 0, ≤ 999999999999.9999Gross height of the packaging in specified unit (converted from ETIM xChange string to number).

grossDiameternumberdecimal≥ 0, ≤ 999999999999.9999Gross diameter of the packaging in specified unit (for cylindrical packaging) (converted from ETIM xChange string to …

grossDimensionUnitstringCMT | DMT | KMT | MMT | MTR | FOT | INH | SMI | YRDUnit of measurement for gross dimensions (CMT=centimeter, MTR=meter, etc.).

grossWeightnumberdecimal≥ 0, ≤ 999999999999.9999Gross weight of the packaging in specified unit (converted from ETIM xChange string to number).

grossWeightUnitstringGRM | KGM | MGM | TNE | LTN | LBR | ONZUnit of measurement for gross weight (GRM=gram, KGM=kilogram, etc.).

tradeItemEnclosedTradeItemEnclosed[]Array of trade items enclosed within this packaging unit. Describes which other trade items are physically contained …

An item enclosed within a packaging unit, describing which trade items are physically contained in a specific package.

enclosedSupplierItemNumberstringrequiredmin: 1, max: 35Supplier item number of the enclosed trade item.

enclosedItemQuantityintegerrequired≥ 1Quantity of this enclosed item within the packaging unit.

enclosedManufacturerItemNumberstringmin: 1, max: 35Manufacturer item number of the enclosed trade item.

enclosedItemGtinsGtin[]Array of GTINs for the enclosed trade item.

TradeItem Domain Model