Product pillar · v0.16.0
product-identifier ProductIdentifier
Typed product identifier record.
$id · https://corpospec.com/schemas/v0.16.0/product-identifier.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| kind | IdentifierKind | yes | The kinds of identifier we know how to record. Multiple identifiers per product are normal (a SaaS product can carry an SWID tag and a PURL; a physical good can carry a GTIN-13 and a UPC alias). |
| value | string | yes | The identifier value. Validation is per-kind: GTIN values must match the expected digit length; PURL values must parse per the CycloneDX PURL spec; etc. |
| issued_by | string? | — | Issuing authority (e.g. "GS1", "USPTO", "MyCompany Internal"). |
| valid_from | IsoDate? | — | When this identifier became valid for the product. |
| valid_to | IsoDate? | — | When this identifier was retired (rare; GTINs are typically product-lifetime stable). |
Definitions
Shared types referenced within this schema.
IdentifierKind
The kinds of identifier we know how to record. Multiple identifiers per
product are normal (a SaaS product can carry an SWID tag and a PURL; a
physical good can carry a GTIN-13 and a UPC alias).
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/product-identifier.schema.json