glam/schemas/20251121/linkml/modules/classes/TaxScheme.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

166 lines
7.3 KiB
YAML

id: https://nde.nl/ontology/hc/class/TaxScheme
name: TaxScheme
title: TaxScheme Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
skos: http://www.w3.org/2004/02/skos/core#
org: http://www.w3.org/ns/org#
prov: http://www.w3.org/ns/prov#
imports:
- linkml:types
- ../slots/expires_on_expired_at
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_type
- ../slots/is_or_was_effective_at
- ../slots/jurisdiction
- ../slots/legal_basis
- ../slots/offers_or_offered
- ../slots/regulatory_body
default_prefix: hc
classes:
TaxScheme:
class_uri: schema:GovernmentService
description: "A tax or regulatory scheme that governs fiscal treatment of donations\nand charitable activities for heritage institutions.\n\n**PURPOSE**:\n\nTaxScheme provides structured representation of the various tax\nincentive programs that heritage institutions operate under. This\nenables:\n- Accurate documentation of donor tax benefits\n- Cross-jurisdictional comparison of giving incentives\n- Compliance tracking and reporting\n- Historical tracking of scheme changes\n\n**MIGRATION**:\n\nReplaces the bespoke `tax_scheme` slot (string range) with a\nstructured class per slot_fixes.yaml revision and Rule 53/56.\n\n**HERITAGE SECTOR CONTEXT**:\n\nTax schemes significantly impact heritage institution fundraising:\n\n| Country | Scheme | Donor Benefit |\n|---------|--------|---------------|\n| NL | ANBI | 100% deductible |\n| NL | Cultural ANBI | 125% deductible |\n| UK | Gift Aid | 25% charity reclaim |\n| UK | Cultural Gifts | 30% tax reduction |\n| US | 501(c)(3) | Itemized deduction\
\ |\n| DE | Gemeinn\xFCtzigkeit | Up to 20% deductible |\n| FR | M\xE9c\xE9nat culturel | 66% reduction (individuals) |\n\n**DATA MODEL**:\n\n```\nTaxScheme\n \u2502\n \u251C\u2500\u2500 has_or_had_type \u2500\u2500\u2192 TaxSchemeType (ANBI, GiftAid, etc.)\n \u2502\n \u251C\u2500\u2500 has_or_had_label \u2500\u2500\u2192 \"Culturele ANBI\"\n \u2502\n \u251C\u2500\u2500 jurisdiction \u2500\u2500\u2192 \"NL\"\n \u2502\n \u251C\u2500\u2500 offers_or_offered \u2500\u2500\u2192 TaxDeductibility (with percentage)\n \u2502\n \u251C\u2500\u2500 regulatory_body \u2500\u2500\u2192 \"Belastingdienst\"\n \u2502\n \u2514\u2500\u2500 legal_basis \u2500\u2500\u2192 \"Wet inkomstenbelasting 2001\"\n```\n\n**ONTOLOGY ALIGNMENT**:\n\n- schema:GovernmentService - Tax scheme as government service\n- skos:Concept - Scheme as member of controlled vocabulary\n- org:Organization - Regulatory body reference\n- prov:Entity - Trackable entity with provenance\n"
exact_mappings:
- schema:GovernmentService
close_mappings:
- skos:Concept
- org:Organization
related_mappings:
- prov:Entity
- schema:Legislation
slots:
- has_or_had_type
- has_or_had_label
- has_or_had_description
- has_or_had_identifier
- jurisdiction
- offers_or_offered
- regulatory_body
- legal_basis
- is_or_was_effective_at
- expires_on_expired_at
slot_usage:
has_or_had_type:
range: uriorcurie
required: true
examples:
- value: CulturalANBI
- value: GiftAid
- value: Section501c3
has_or_had_label:
range: string
examples:
- value: Cultural ANBI (125%)
- value: Gift Aid eligible
has_or_had_description:
range: string
has_or_had_identifier:
range: string
examples:
- value: RSIN 123456789
- value: Charity No. 1234567
jurisdiction:
range: string
required: true
examples:
- value: NL
- value: UK
- value: US
- value: DE
offers_or_offered:
range: TaxDeductibility
inlined: true
multivalued: true
examples:
- value:
has_or_had_type:
has_or_had_label: Fully Deductible
has_or_had_percentage:
- value:
has_or_had_type:
has_or_had_label: Enhanced Cultural
has_or_had_percentage:
regulatory_body:
range: string
examples:
- value: Belastingdienst
- value: HMRC
- value: IRS
legal_basis:
range: string
examples:
- value: Wet inkomstenbelasting 2001
- value: Finance Act 1990
- value: Internal Revenue Code Section 501(c)(3)
is_or_was_effective_at:
range: date
expires_on_expired_at:
range: TimeSpan
inlined: true
comments:
- Tax schemes vary significantly by jurisdiction - always document jurisdiction
- Cultural institutions often qualify for enhanced rates beyond standard charity status
- Scheme status may need periodic renewal - track effective_date and expiration_date
- Link to regulatory body websites for current requirements
see_also:
- https://www.belastingdienst.nl/wps/wcm/connect/nl/aftrek-en-kortingen/content/gift-aftrekken
- https://www.gov.uk/donating-to-charity/gift-aid
- https://www.irs.gov/charities-non-profits/charitable-organizations
- https://www.impots.gouv.fr/professionnel/dons-et-mecenat
examples:
- value:
has_or_had_type: CulturalANBI
has_or_had_label: Cultural ANBI (125%)
has_or_had_description: Rijksmuseum is registered as Cultural ANBI, providing donors with 125% tax deduction (100% standard + 25% cultural bonus).
has_or_had_identifier: RSIN 002006066
jurisdiction: NL
offers_or_offered:
- has_or_had_type:
has_or_had_label: Enhanced Cultural Deductibility
has_or_had_percentage:
regulatory_body: Belastingdienst
legal_basis: Wet inkomstenbelasting 2001, Art. 6.39a
is_or_was_effective_at: '2008-01-01'
- value:
has_or_had_type: GiftAid
has_or_had_label: Gift Aid eligible
has_or_had_description: "British Library is registered for Gift Aid, allowing the library to reclaim 25p for every \xA31 donated by UK taxpayers."
has_or_had_identifier: Charity No. 1034686
jurisdiction: UK
offers_or_offered:
- has_or_had_type:
has_or_had_label: Fully Deductible
has_or_had_percentage:
regulatory_body: HMRC
legal_basis: Finance Act 1990
is_or_was_effective_at: '1990-10-01'
- value:
has_or_had_type: Section501c3
has_or_had_label: 501(c)(3) tax-exempt
has_or_had_description: Smithsonian Institution is recognized as a 501(c)(3) organization, allowing donors to deduct contributions on federal income taxes.
has_or_had_identifier: EIN 53-0206027
jurisdiction: US
offers_or_offered:
- has_or_had_type:
has_or_had_label: Fully Deductible
has_or_had_percentage:
regulatory_body: IRS
legal_basis: Internal Revenue Code Section 501(c)(3)
annotations:
specificity_score: 0.5
specificity_rationale: 'Moderately specific - tax scheme details are primarily relevant
for donation and fiscal compliance queries, not general heritage
discovery.
'
replaces_slot: tax_scheme
migration_date: '2026-01-16'
custodian_types: "['*']"