COGS¶

COGS represents the unit cost of the material sold or served. It supports gross-margin and contribution analyses, but it is not a substitute for production, transportation, storage, tax, or other operating costs. Those costs remain separate so the result can be traced to the physical decision that generated it.

How COGS selection works¶

The platform finds COGS lists assigned to the location and valid for the requested period.
A lower priority number is evaluated first.
Within the selected list, the material line provides unit COGS.
If no applicable list provides the value, the standard material-location COGS is evaluated.
A material-level standard COGS may provide the next reference when it is available in the planning context.
If no source provides the value, COGS remains absent. Absence must not be interpreted as a real zero cost.

COGS list¶

Path in the platform¶

Data > Data Operations > Costs > Cost Lists > Cost List

Granularity and key¶

Granularity: one row per COGS list.
Key: a unique id.

Required fields¶

Field	Meaning
`id`	Unique COGS-list identifier

Optional fields¶

Field	Meaning	Default Value When Not Provided
`description`	Human-readable name	Blank
`priority`	Selection order; lower numbers are evaluated first	Evaluated after lists with an explicit priority
`effectiveStartDate`	First date on which the list applies	No lower date boundary
`effectiveEndDate`	Last date on which the list applies	No expiration date

COGS list — locations¶

Path in the platform¶

Data > Data Operations > Costs > Cost Lists > Cost List - Locations

Granularity and key¶

Granularity: one applicable location per COGS list.
Key: cogsListId + locationId.

Required fields¶

Field	Meaning
`cogsListId`	COGS list assigned to the location
`locationId`	Location where the list applies

COGS list — products¶

Path in the platform¶

Data > Data Operations > Costs > Cost Lists > Cost List - Products

Granularity and key¶

Granularity: one material per COGS list.
Key: cogsListId + materialId.

Required fields¶

Field	Meaning
`cogsListId`	COGS list containing the material
`materialId`	Material being valued

Optional fields¶

Field	Meaning	Default Value When Not Provided
`unitOfMeasureId`	Unit in which unit COGS is stated	Default Supply Planning unit from Global Planning Parameters
`unitCogs`	Cost of one unit of the material	This line does not provide COGS; selection continues to the next applicable source

Standard COGS — material/location¶

Path in the platform¶

Data > Data Operations > Costs > Material / Location Costs > Standard Cost - Material/Location

Granularity and key¶

Granularity: one standard COGS per material-location.
Key: materialId + locationId.

Required fields¶

Field	Meaning
`materialId`	Material being valued
`locationId`	Location where standard COGS applies

Optional fields¶

Field	Meaning	Default Value When Not Provided
`unitOfMeasureId`	Unit in which unit COGS is stated	Default Supply Planning unit from Global Planning Parameters
`unitCogs`	Standard cost of one unit of the material	This record does not provide COGS; selection continues to the next applicable source

Dependencies¶

materialId references Materials.
locationId references Locations.
unitOfMeasureId references Units of Measure or follows the Global Planning Parameters.
cogsListId references the COGS list header documented on this page.
Validity is evaluated against the period of the demand, plan, or economic fact being valued.

Used by¶

gross-margin and contribution analyses;
Supply Planning scenario valuation;
Inventory Optimization when an inventory decision changes sales, write-off, or material exposure;
Cost-to-Serve and P&L as the material-cost component of served demand;
pricing and assortment analyses;
the economic decision data model.

Checks¶

use a unique, non-empty id for every list;
use only positive integers for explicit priority;
do not place the end of validity before the start;
register referenced lists, materials, locations, and units before loading relationship or value rows;
do not repeat the same composite key;
provide finite numeric values;
verify that the intended list is assigned to the location and intersects the analysis period;
treat a blank, zero, or negative value as not providing positive COGS for economic selection;
do not combine COGS with production, freight, storage, or tax in the same field.