Published

Tradable Offer / Commodity view

vr.wm-obj-003 · wm-obj-003-tradable-offer-commodity-view

Describe a governed market-facing view of an identified good, preserving product, item, lot and commercial-offer masters.

World Models Physical world and living systems PHY.OBJ.TYPE

Bundle → Layer → Finding → Questions Classifiers What it is Why it exists Distinguishing features What robots and AI may and may not do Moral aspects Owners Links to other meta-models Identity and identifiers Direct properties Recognition Capabilities and actions Hazards and failure modes Standards and interfaces Context of use Sources

Bundle → Layer → Finding → Questions Filled

6 bundles · 12 layers · 12 findings · 36 questions

Subject and market binding A view selects a subject without creating its master identity.

Subject binding context

Proposed view key and typed subject reference distinguish product class, variant, individual and lot selection. A new view revision does not create a new product.

Subject binding

Proposed view key and typed subject reference distinguish product class, variant, individual and lot selection. A new view revision does not create a new product.

Which master subject and revision does this market view describe? identity
What distinguishes this materialized view from another view of the same subject? definition
Which missing or conflicting subject bindings prevent a trustworthy projection? exception

Market context context

Proposed context records where and for whom a view is intended, with external seller authority evidence. Market scope does not establish legal permission.

Market context

Proposed context records where and for whom a view is intended, with external seller authority evidence. Market scope does not establish legal permission.

Which market, channel and language qualify the displayed assertions? spatial
Who stewards this view and what external authority supports acting for the seller? authority
Which audience restrictions change the content visible in this market view? access

Description and recognition Represent selected product descriptions as attributed assertions.

Description and variant projection context

Project names, variant dimensions and declared characteristics with their master revision. Physical measures belong to identified subjects; the view itself has no mass or dimensions.

Description and variant projection

Project names, variant dimensions and declared characteristics with their master revision. Physical measures belong to identified subjects; the view itself has no mass or dimensions.

Which name and descriptive attributes are selected from which product revision? provenance
Which declared dimensions distinguish this variant and which values remain unknown? classification
Which claimed capability or intended use is only declared and which has supporting evidence? evidence

Recognition and classification context

Labels, images and scanned identifiers are fallible recognition evidence. Scheme-qualified categories aid discovery but do not establish equivalence, customs treatment or authenticity.

Recognition and classification

Labels, images and scanned identifiers are fallible recognition evidence. Scheme-qualified categories aid discovery but do not establish equivalence, customs treatment or authenticity.

Which label, image or scan supports the candidate match to the subject? evidence
Which classification scheme, edition and code qualify the market category? classification
How is a lookalike, ambiguous scan or disputed category prevented from becoming a confirmed match? quality

Trade unit projection Carry scheme-scoped identifiers and packaging quantities as references and assertions.

Identifier assertions context

Preserve strings, issuer namespaces and level scope. A seller SKU, trade-item identifier and serial number are distinct; validation of syntax is not validation of issuer rights.

Identifier assertions

Preserve strings, issuer namespaces and level scope. A seller SKU, trade-item identifier and serial number are distinct; validation of syntax is not validation of issuer rights.

Which identifier scheme and issuer name the subject at the selected trade level? identity
What evidence distinguishes identifier syntax checks from authoritative assignment verification? validation
Which external identity decision applies after a pack or declared-content change? lifecycle

Packaging and quantity basis context

Project optional pack relationships and nominal quantities separately from observed measures. Proposed checks reject cycles and undocumented conversions; bulk or unpackaged goods need no fictional packaging hierarchy.

Packaging and quantity basis

Which packaging level and contained-subject quantities are declared for this view? composition
What quantity, unit scheme and measurement basis qualify the displayed content? measurement
What evidence supports converting between sale, count, mass and volume units? constraint

Exchange references and constraints Expose exchange context without owning commercial proposals or operational eligibility decisions.

Offer and availability references context

Optional offer links retain counterpart identity and as-of time. Any price or availability display is an attributed external snapshot with basis and expiry, never a local quote or reservation.

Offer and availability references

Optional offer links retain counterpart identity and as-of time. Any price or availability display is an attributed external snapshot with basis and expiry, never a local quote or reservation.

Which external offers reference this subject and what exchange purpose do they declare? relationship
How fresh is the linked availability or price assertion at the selected market scope? temporal
What is shown when an offer expires, stock evidence is missing or sources disagree? state

Restriction and disclosure context context

Proposed policy-level controls separate unknown eligibility, restrictions and approved disclosure. Regulated goods require specialist profile review; local display suppression neither enforces a trade ban nor certifies safety.

Restriction and disclosure context

Which external restriction or disclosure profile applies to this subject and market? requirement
Which unresolved safety, rights or restriction evidence requires suppression or review? security
What evidence and authority would permit changing a local restriction flag? decision

Traceability and view continuity Keep external events separate from the lifecycle of this projection.

Lot and event references context

Optional lot or instance filters select bounded populations. Event assertions retain their source and subject scope; absence of an event is not proof of absence of recall or risk.

Lot and event references

Optional lot or instance filters select bounded populations. Event assertions retain their source and subject scope; absence of an event is not proof of absence of recall or risk.

Which external lot or instance selection bounds the displayed traceability information? relationship
Which event time, record time and ingestion time qualify a traceability assertion? temporal
How are corrected or contradictory event references represented without overwriting source history? event

View revision and retirement context

Proposed view lifecycle has draft, reviewed, active, stale, suppressed and retired states. These states describe presentation fitness only, not product discontinuation, offer acceptance or recall release.

View revision and retirement

Which source or policy revision triggered this view revision and who approved it? lifecycle
When must this view be marked stale or rebuilt after an upstream change? process
What retention basis permits retiring or erasing this view while preserving necessary references? retention

Evidence and governed exchange Preserve derivation and loss during audience-specific projection.

Assertion provenance and conflict context

Proposed assertion records distinguish source quotation, transformation, observation and inference. Competing claims remain visible to authorized reviewers; the chosen display value retains its selection rationale.

Assertion provenance and conflict

Which source fields and transformations produced each displayed assertion? provenance
How are conflicting claims selected, withheld or preserved as unknown? quality
Which evidence is sufficient for a reviewer to reproduce the view without exposing restricted content? evidence

Disclosure and mapping profile context

Proposed exports bind recipient, purpose and mapping version. Redactions and unsupported fields remain explicit; a successful serialization is not conformance certification or permission to publish.

Disclosure and mapping profile

Proposed exports bind recipient, purpose and mapping version. Redactions and unsupported fields remain explicit; a successful serialization is not conformance certification or permission to publish.

Which recipient and purpose authorize this export at each content scope? privacy
What mapping version and losses qualify an external catalogue representation? interoperability
Which validation failures prevent local export preparation or require review? validation

Classifiers Filled

Family: World Models
Category: Physical world and living systems
Entry kind: pattern
Navigation path: NAV.PHY.OBJ.TYPE
Domain: PHY.OBJ.TYPE
Industry: Cross-industry
Tags: tradableoffercommodityviewphy.obj.type
Also called: M3

What it is Filled

A format-neutral projection pattern for goods in a market context. Each materialization binds a subject reference and revision, catalogue steward, channel or audience, market, language and view revision. It holds selected assertions and provenance, not a new product class, stock ledger or executable offer. Commodity means a good viewed for exchange here, not a financial derivative or a universal fungibility assertion.

In scope

View identity, market context, subject and variant bindings, scheme-qualified identifiers and category assertions
Projected pack and measure descriptions, recognition evidence, offer and availability references, restricted-use and traceability flags
Materialization provenance, freshness, conflict handling, audience filtering and local revision retirement

Out of scope

Creating product types, assigning global identifiers, owning individual physical items, production lots or inventory
Authoring commercial quotes, prices, acceptance, reservations, orders, settlements, title transfer or exchange trading
Initiating or lifting recalls, certifying authenticity, deciding customs classification, regulated-item clearance or safety
Detailed service, digital entitlement and financial commodity profiles; runtime mappings and universal compliance engines

Why it exists Filled

Describe a governed market-facing view of an identified good, preserving product, item, lot and commercial-offer masters.

Distinguishing features Derived, awaiting review

Unlike WM-OBJ-002 Product Type / Catalog Item: Owns reusable product and variant definitions. This pattern carries a revision-pinned subject binding and selected projections only; the legacy M3 product-class root is reconciled to that separate master.
Unlike WM-OBJ-001 Physical Item Instance: Owns serial instance identity, actual condition and physical history. A class-level declaration cannot be promoted into a measured property of every instance.
Unlike WM-ECO-021 Offer / Quote: Owns commercial terms and proposal lifecycle. Its incoming registry parent candidate is not accepted as inheritance: use optional offer references; a market view can exist without a live offer.
Unlike WM-MAT-004 Material Batch / Lot and WM-OBJ-020 Inventory Stock Position: Own lot membership, production history and stock position respectively. Traceability and availability references remain time-qualified external evidence, never local stock or batch lifecycle.
Unlike WM-MAT-001 Chemical Substance and WM-XCT-001 Ownership / Stewardship: Composition or hazard details and rights remain externally mastered. A catalogue steward, seller and title holder can differ; a listing is not proof of ownership or permission to trade.
Unlike Legacy M3 Tradable Good: Catalogue, identification and pack concerns survive as view projections. Mandatory packaging, universal classification, batch creation and automatic food or medicine inheritance are not carried forward. Specialized restrictions require separate profiles.

Note: Derived from boundary notes against neighbouring models.

What robots and AI may and may not do Derived, awaiting review

Must not

Keep claims, observed facts, derived values and unknowns distinct; unknown safety or permission never becomes approval.
Supplier declarations and nominal pack values cannot substitute for instance measurements or legal origin evidence.
Dimension storage governance executes authorized deletion; keep only lawful minimal tombstones and never delete referenced product, offer, lot, rights or event masters.
Deny by default until adopting-Dimension grants specify recipient, purpose, expiry and content scope; public source URLs do not authorize payload redistribution.

May

Bind a view subject: Proposed local operation binding one market context to existing master revisions. Unimplemented research proposal.
Build an attributed projection: Proposed local operation selecting and deriving approved description and trade-unit fields. Unimplemented research proposal.
Check view coherence: Proposed local semantic check for references, scope, identifier levels, units, pack cycles and evidence freshness. Unimplemented research proposal.
Reconcile changed source references: Proposed local operation comparing an upstream revision or correction with the pinned projection. Unimplemented research proposal.
Prepare recipient projection: Proposed local operation assembling an audience-scoped draft export. Unimplemented research proposal.
Retire a view revision: Proposed local operation recording supersession and a disposition request. Unimplemented research proposal.

Note: Derived from functions, policies, CRUD and access rules; prohibitions were not authored for agents as such.

Moral aspects Missing, in the backlog

Not described yet. This gap is in the card backlog.

Owners Filled

Steward

Adopting Dimension identifies a role-based catalogue steward, governing namespace and subject master bindings.

Roles

Catalogue steward: Own local view policy, subject selection and revision review without claiming title to goods.
Source custodian: Supply and correct externally mastered assertions within their authority.
Profile reviewer: Review market applicability, unit and identity exceptions, restrictions and disputed mappings.
Authorized consumer: Read only granted audience projections and report stale or conflicting evidence.
Automation operator: Prepare local artifacts within policy, reject unresolved authority and record idempotent outcomes.

Links to other meta-models Filled

references

WM-OBJ-002 - Default class or variant subject master. Required when subject_kind is product-type; other permitted subject kinds use their corresponding master.
WM-OBJ-001 - Conditional individual subject and observed-condition evidence; no physical lifecycle ownership.
WM-MAT-004 - Conditional lot subject or population selection; production and recall event processing remain external.
WM-ECO-021 - Optional commercial proposal references; reject incoming parent candidate as semantic inheritance or mandatory offer containment.
WM-OBJ-020 - Optional time-qualified availability evidence; do not derive a stock ledger or reserve quantities.
WM-MAT-001 - Optional composition and hazard disclosure references, kept at policy level in this view.
WM-XCT-001 - Stewardship, title and delegation evidence remain externally governed; the view cannot grant ownership.

aligned

GS1 GTIN and GPC - Scheme and edition-qualified identifier and category bindings, not issuance, classification authority or tested conformance.
UNECE Recommendation 20 - Candidate unit-code alignment; current lists and conversions require separate verification.
Schema.org and GS1 Web Vocabulary - Conceptual product and offer-link projection only; no operational mapping asserted.
EPCIS and PROV-O - External visibility-event and provenance references; no event repository implementation.

neighbor

WM-OBJ-002 Product Type / Catalog Item - Owns reusable product and variant definitions. This pattern carries a revision-pinned subject binding and selected projections only; the legacy M3 product-class root is reconciled to that separate master.
WM-OBJ-001 Physical Item Instance - Owns serial instance identity, actual condition and physical history. A class-level declaration cannot be promoted into a measured property of every instance.
WM-ECO-021 Offer / Quote - Owns commercial terms and proposal lifecycle. Its incoming registry parent candidate is not accepted as inheritance: use optional offer references; a market view can exist without a live offer.
WM-MAT-004 Material Batch / Lot and WM-OBJ-020 Inventory Stock Position - Own lot membership, production history and stock position respectively. Traceability and availability references remain time-qualified external evidence, never local stock or batch lifecycle.
WM-MAT-001 Chemical Substance and WM-XCT-001 Ownership / Stewardship - Composition or hazard details and rights remain externally mastered. A catalogue steward, seller and title holder can differ; a listing is not proof of ownership or permission to trade.
Legacy M3 Tradable Good - Catalogue, identification and pack concerns survive as view projections. Mandatory packaging, universal classification, batch creation and automatic food or medicine inheritance are not carried forward. Specialized restrictions require separate profiles.

What else AI and robots need to interact with it Incomplete

Sources Filled

Product - Schema.org
offers - Schema.org
GTIN Management Standard - GS1
EPCIS Standard - GS1
PROV-O: The PROV Ontology - World Wide Web Consortium
GS1 Web Vocabulary - GS1
How GPC works - GS1
Recommendation No. 20: Codes for Units of Measure used in International Trade - United Nations Economic Commission for Europe

Open questions

Resolve all source retrieval and edition gaps, including the EPCIS URL/document mismatch, dynamic vocabulary terms, classification edition and current unit lists.
Develop qualified profiles and executable fixtures for missing subjects, conflicting identifiers, used goods, bulk and variable measures, pack cycles, expired offers, disputed recalls, revoked grants and lawful erasure.
Restore independent external review before promotion toward a canonical or publishable draft.
Independent external review is absent; the later local self-audit cannot replace it.
Browser access is partial: source 006 is a dynamic landing overview and 007-008 have indexed evidence only; direct HTTP checks are unattempted under the reported sandbox block.
EPCIS URL/document edition mismatch, current unit list, GPC edition, vocabulary release and non-new item identification policy remain unresolved.
Concrete instance schemas, profile fixtures, executable mappings, specialized service/digital entitlement profiles and legal eligibility decisions are not supplied.

Machine files

Card as JSON Specification AGENTS.md Source Card backlog vercy.card/1

Provenance

world-models research · reviewable-draft

Built from: models/wm-obj-003-tradable-offer-commodity-view/spec.yaml