Product catalog

The product catalog defines the hierarchy of product categories. The initial spend-based factor mapping is provided in the product catalog.

The product catalog is defined during the initial load of CSV data and is maintained on an ongoing bases by uploading the data to object storage. The full set of primary and secondary entities for the Catalog object are defined in the data dictionary.

The following configuration rules apply:
  • The product hierarchy supports up to 5 levels. These include;
    • CATEGORY
    • BRAND
    • FAMILY
    • LINE
    • SEGMENT
  • CATEGORY must be assigned.
  • Factor codes are assigned to one of the levels in the hierarchy. Typically, factor codes are assigned at the CATEGORY level.

Table 1 describes the fields of the catalog object that are configured during onboarding.

Table 1. Object Model
Field name Data type Display name Example Description Required
levelType String Level type CATEGORY

The type of level. It is used for filtering and categorization.

Valid values are CATEGORY, BRAND, FAMILY, LINE, and SEGMENT.

Required
code String code HMC

The name of the level type.

Required
catalogType String Catalog type ITEM

The category type.

Valid values are PRODUCT and ITEM.

Required
name String Name Pedestrian Lighting

The descriptive name of the catalog code.

Required
description String Description Category code for Pedestrian Lighting Description of the product. Recommended
emissions
Factor
Group.
factorCode
String reference to FactorGroup.
factor
Code
.
Factor code Fabricated metal products

A classification code that identifies the emission factor. For the list of valid values, see

Factor codes.
Required for at least one factor level.

Factor codes

Valid factor codes from the Eora66 - MRIO (Multi-region input-output) factor set include:

  • Administrative and support services
  • Ambulatory health care services
  • Amusements, gambling, and recreation
  • Insurance carriers and related activities
  • Legal services, general
  • Housing
  • Hospitals, general
  • General merchandise, general
  • Air transportation
  • Mining, except oil and gas
  • Broadcasting and telecommunications
  • Misc prof, scientific, technical services
  • Other real estate, general
  • Nursing and residential care facilities
  • Other services, except government
  • Furniture and related products
  • Fabricated metal products
  • Apparel and leather and allied products
  • Computer and electronic products
  • Transit and ground passenger transportation
  • Construction
  • Management of companies and enterprises
  • Rail transportation
  • Motion picture, sound recording industries
  • Miscellaneous manufacturing
  • Food and beverage and tobacco products
  • Water transportation
  • Paper products
  • Nonmetallic mineral products
  • Pipeline transportation
  • Warehousing and storage
  • Data processing, internet publish, other IT
  • Support activities for mining
  • Perf arts, spectator sports, museums, other
  • Plastics and rubber products
  • Oil and gas extraction
  • Machinery
  • Accommodation
  • Rental, leasing ser, lessors intangible ass.
  • Other transportation and support activities
  • Food and beverage, general
  • Motor vehicle and parts dealers
  • Educational services
  • Fed Res banks, credit services, and other
  • Farms
  • Wholesale trade
  • Securities, commodity contracts, investments
  • Printing and related support activities
  • Wood products
  • Other transportation equip., general

Example

The following is example is an excerpt from the sample CSV file for the Catalog object.
catalogType,levelType,code,name,emissionsFactorGroup.factorCode
"ITEM","CATEGORY","Enclosures","Enclosures","Fabricated metal products"
"ITEM","CATEGORY","Pedestrian Lighting","Pedestrian Lighting","Fabricated metal products"
"ITEM","CATEGORY","Luminaire","Luminaire","Electrical equipment, appliances, other"

You can use the sample CSV files to define the Catalog object. For more information, see Sample files.