glam/schemas/20251121/linkml/modules/classes/Expenses.yaml
kempersc f7bf1cc5ae Refactor schema slots and classes
- Deleted obsolete slot definitions: statement_summary, statement_text, statement_type, status_name, supersede_articles, supersede_condition, supersede_name, temporal_dynamics, total_amount, typical_contents, use_cases, was_acquired_through, was_fetched_at, was_retrieved_at.
- Updated existing slot definitions for states_or_stated to enhance clarity and structure.
- Introduced new classes: Article, ConditionofAccess, FinancialStatementType, MaximumQuantity, Series, Summary, Type, and their respective slots to improve schema organization and usability.
- Added new slots: changes_or_changed_through, has_or_had_condition_of_access, has_or_had_heritage_type, is_or_was_part_of_series, is_or_was_retrieved_at, maximum_of_maximum to capture additional metadata and relationships.
2026-01-30 00:29:31 +01:00

170 lines
6.4 KiB
YAML

id: https://nde.nl/ontology/hc/class/Expenses
name: expenses_class
title: Expenses Class
description: >-
Represents financial expenses/expenditures for a heritage custodian.
Provides structured expense categorization following nonprofit functional
expense classification (program, administrative, fundraising).
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
frapo: http://purl.org/cerif/frapo/
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ../slots/has_or_had_description
# MIGRATED 2026-01-22: amount → has_or_had_quantity per slot_fixes.yaml feedback F3
- ../slots/has_or_had_quantity
- ./Quantity
# ARCHIVED: ../slots/has_or_had_currency - currency is now part of Quantity.has_or_had_measurement_unit
# ARCHIVED: ../slots/currency - currency is now part of Quantity.has_or_had_measurement_unit
# ARCHIVED: ../slots/valid_from - use temporal_extent instead
# ARCHIVED: ../slots/valid_to - use temporal_extent instead
- ../slots/temporal_extent # was: valid_from + valid_to
- ../enums/ExpenseTypeEnum
- ./TimeSpan
- ../slots/has_or_had_type # was: expense_type - migrated per Rule 53 (2026-01-26)
- ../slots/has_or_had_label
# ARCHIVED: ../slots/amount → has_or_had_quantity (2026-01-22)
# - ../slots/expense_type
default_prefix: hc
classes:
Expenses:
class_uri: hc:Expenses
description: >-
Represents a categorized expense/expenditure for a heritage custodian.
**FUNCTIONAL EXPENSE CLASSIFICATION (Nonprofit-Specific)**:
Heritage custodians (predominantly nonprofits) must classify expenses by function:
| Type | Description | Examples |
|------|-------------|----------|
| PROGRAM | Mission-related | Exhibitions, conservation, education |
| ADMINISTRATIVE | Overhead | Executive, finance, HR, facilities |
| FUNDRAISING | Donor relations | Events, grants, marketing |
| INNOVATION | R&D | New programs, technology |
**USAGE**:
The `has_or_had_expenses` slot links entities to Expenses instances.
Since 2026-01-22, uses `has_or_had_quantity` instead of separate amount/currency:
```yaml
financial_statement:
has_or_had_expenses:
- expense_type: ADMINISTRATIVE
has_or_had_quantity:
quantity_value: 10000000.0
quantity_type: BUDGET_AMOUNT
has_or_had_measurement_unit:
unit_symbol: EUR
unit_type: CURRENCY
description: "Management and general expenses FY2023"
- expense_type: PROGRAM
has_or_had_quantity:
quantity_value: 62000000.0
quantity_type: BUDGET_AMOUNT
has_or_had_measurement_unit:
unit_symbol: EUR
unit_type: CURRENCY
description: "Program service expenses FY2023"
```
**ONTOLOGY ALIGNMENT**:
- No standard ontology has a direct "expense" predicate
- Uses FRAPO (Funding, Research Administration and Projects Ontology) patterns
- Aligns with schema:MonetaryAmount for monetary values
exact_mappings:
- frapo:Expenditure
close_mappings:
- schema:MonetaryAmount
related_mappings:
- frapo:hasFunding
slots:
- has_or_had_type
- has_or_had_quantity # was: amount + currency (migrated 2026-01-22)
- has_or_had_description
- temporal_extent # was: valid_from + valid_to
slot_usage:
has_or_had_type:
range: ExpenseTypeEnum
required: true
description: |
Functional expense classification.
MIGRATED from expense_type (2026-01-26).
has_or_had_quantity:
range: Quantity
required: true
inlined: true
description: >-
Expense amount as a Quantity instance. Replaces separate amount + currency fields.
The Quantity contains:
- quantity_value: decimal amount (e.g., 10000000.0)
- has_or_had_measurement_unit: MeasureUnit with currency code (e.g., EUR, USD, GBP)
- quantity_type: BUDGET_AMOUNT
description:
range: string
required: false
description: Human-readable description of the expense.
temporal_extent:
range: TimeSpan
inlined: true
description: >-
Time period this expense applies to.
Use begin_of_the_begin for start date, end_of_the_end for end date.
annotations:
custodian_types: '["*"]'
custodian_types_rationale: Financial expenses applicable to all heritage custodian types.
custodian_types_primary: M
specificity_score: 0.55
specificity_rationale: >-
Moderately specific - financial expense tracking is specialized but applicable
across institution types with financial reporting requirements.
examples:
- value:
has_or_had_type: ADMINISTRATIVE
has_or_had_quantity:
quantity_value: 10000000.0
quantity_type: BUDGET_AMOUNT
has_or_had_measurement_unit:
unit_symbol: EUR
unit_type: CURRENCY
description: "Management and general expenses for FY2023"
temporal_extent:
begin_of_the_begin: "2023-01-01"
end_of_the_end: "2023-12-31"
description: Administrative expense for Dutch museum
- value:
has_or_had_type: PROGRAM
has_or_had_quantity:
quantity_value: 62000000.0
quantity_type: BUDGET_AMOUNT
has_or_had_measurement_unit:
unit_symbol: EUR
unit_type: CURRENCY
description: "Program service expenses including exhibitions, conservation, education"
temporal_extent:
begin_of_the_begin: "2023-01-01"
end_of_the_end: "2023-12-31"
description: Program expense for major museum
- value:
has_or_had_type: FUNDRAISING
has_or_had_quantity:
quantity_value: 3200000.0
quantity_type: BUDGET_AMOUNT
has_or_had_measurement_unit:
unit_symbol: EUR
unit_type: CURRENCY
description: "Fundraising and donor relations expenses"
description: Fundraising expense
# REMOVED inline slots 2026-01-16 - Rule 48 violation
# Slots are imported from ../slots/ - do not define inline