glam/schemas/20251121/linkml/modules/classes/CommissionRate.yaml

54 lines
2 KiB
YAML

id: https://nde.nl/ontology/hc/class/CommissionRate
name: commission_rate_class
title: Commission Rate Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
imports:
- linkml:types
- ../metadata
- ../slots/has_percentage
default_prefix: hc
classes:
CommissionRate:
class_uri: hc:CommissionRate
description: "Structured representation of a commission rate.\n\n**PURPOSE**:\n\
\nModels commission percentages with context (market type,\nrate type) replacing\
\ simple string representation.\n\n**DESIGN RATIONALE**:\n\nCreated per slot_fixes.yaml\
\ migration from `commission_rate` string\nto structured representation with\
\ Percentage class.\n\n**ART MARKET STANDARDS**:\n\n- **Primary market**: 40-50%\
\ standard (gallery takes half)\n- **Secondary market**: 10-20% (resale commission)\n\
- **Auction**: 10-25% buyer's premium + seller's commission\n\n**EXAMPLE**:\n\
\n```yaml\ntakes_or_took_comission:\n rate_type: \"primary_market\"\n has_percentage:\n\
\ percentage_value: 50\n percentage_display: \"50%\"\n```\n"
close_mappings:
- schema:PriceSpecification
slots:
- has_percentage
slot_usage:
has_percentage:
range: Percentage
inlined: true
required: true
examples:
- value: null
examples:
- value:
has_percentage: null
- value:
has_percentage: null
- value:
has_percentage: null
comments:
- Created 2026-01-22 from commission_rate migration (Rule 53)
- Provides structured commission representation
- Supports art market commission conventions
see_also:
- https://schema.org/PriceSpecification
annotations:
custodian_types: '["G", "C"]'
custodian_types_rationale: Primarily for galleries (G) and commercial organizations
(C).
specificity_score: '0.80'
specificity_rationale: Specific to commercial sales commission context.