Materials¶

A material identifies a plannable item. One record may represent a finished product, component, raw material, or another item according to process scope.

Path in the platform¶

Data > Data Operations > Master Data > Materials / Locations > Materials > Material Master

Granularity and key¶

Granularity: one row per material.
Key: a unique, stable id.

Required fields¶

Field	Meaning
`id`	Unique material identifier

Optional fields¶

Field	Meaning	Default Value When Not Provided
`description`	Human-readable description	Blank
`active`	Participation in planning	`true`
`lifecycleStage`	Lifecycle Stage	`Regular` when no lifecycle dates exist (otherwise derived from the dates)
`operationalModel`	Operational Model	`MTS`
`introductionDate`	Introduction date	No introduction date
`discontinuationDate`	Discontinuation date	No discontinuation date
`defaultUomId`	Default unit	Default Supply Planning unit (global fallback: `UN`)
`salesUomId`	Sales unit	Material default unit
`transferUomId`	Transfer unit	Material default unit
`valueByCharacteristic`	Planning characteristics	No classification characteristics

Dependencies¶

Units of Measure.
Lifecycle Stage and introduction/discontinuation dates.
Operational Model.
Global Planning Parameters for the new-item window.
Planning characteristics used by rules and clusters.

Used by¶

Supply Planning data model;
materialId in Sell-out and Sell-in;
Forecast Clusters;
series definition in the Demand Planning Execution Profile;
Demand Plan rows;
materialId and salesUomId in Prices, and materialId in COGS;
material-specific lane valuation in Logistics and location costs;
AutoFit, analysis, and collaboration;
Supply Planning, DRP, inventory optimization, production, cost, and reporting.

Checks¶

unique, non-empty IDs;
existing default unit;
consistent lifecycle dates;
reconciled description and status;
governed characteristic names and values;
no code reuse after discontinuation.