Go to Items

1 Definition 2 Functional Requirements 3 Syntax 4 Semantics

1      Definition

ValueMetadataIDs defines the set of identifiers that may be used to tag metadata values associated with transactional or functional attributes in MMM-TEC frameworks.

The identifiers are expressed as strings. Two forms are currently allowed:

  1. Enumerated identifiers (authoritative list; will eventually become complete).
  2. Pattern‑based identifiers, allowed temporarily until the enumeration reaches completion.

When the authoritative enumeration is considered complete, the pattern fallback will be removed.

2      Functional Requirements

The ValueMetadataIDs data type shall represent a Value Metadata Identifier as a string.

The ValueMetadataIDs data type shall accept identifiers included in the authoritative enumeration of VM-* codes.

The ValueMetadataIDs data type shall permit, until finalisation, identifiers matching the regular expression: ^VM-[A-Za-z0-9_-]{2,48}$

The ValueMetadataIDs data type shall require that all identifiers begin with the prefix VM-.

The ValueMetadataIDs data type shall ensure that enumerated identifiers take precedence over pattern‑matched identifiers.

The ValueMetadataIDs data type shall support future extension through the addition of new enumerated VM-* identifiers.

The ValueMetadataIDs data type shall treat the fallback pattern as temporary and removable once the authoritative enumeration is complete.

Current Enumerated VM Codes (Authoritative Set)

  • VM-ListPrice
  • VM-Discount
  • VM-VATIncluded
  • VM-Region
  • VM-LicenseScope

3      Syntax

https://schemas.mpai.community/MMM4/V2.2/data/ValueMetadataIDs.json

4      Semantics

Label Description
Header Value Metadata IDs Header – Standard “MMM-VMD.Vx.y”
VM-ListPrice Indicates the base listed price of an item prior to the application of discounts or taxes.
VM-Discount Indicates a discount amount or discount rate applicable to the listed price.
VM-VATIncluded Indicates whether the listed price already includes Value Added Tax.
VM-Region Indicates the geographical region to which the value metadata applies (e.g., market, jurisdiction).
VM-LicenseScope Indicates the permitted scope of use for a licensed asset (e.g., personal use, commercial use, region-restricted use).
DataExchangeMetadata Data describing and/or regulating the use, origin, authorisation, and security state of a Data Instance.
Trace Information about the Process producing the Data and the Time of production.
DescrMetadata Any free-text descriptive metadata.

Go to Items