Combined Finnish Business Vocabularies

Repository: github.com/jgmikael/vocabularies

About this site: This documentation combines three core vocabularies from Tietomallit.suomi.fi (Finnish Interoperability Platform) into a unified reference for business process digitalization using W3C Verifiable Credentials and the EU Business Wallet framework.

📖 → View the Complete Technical Specification

Vocabulary Overview

Vocabulary	Prefix	Namespace	Purpose	Status
WE BUILD	`webuild`	`https://iri.suomi.fi/model/webuild/`	Electronic attestations of attributes (QEAA, PubEAA, EAA) for WE BUILD Large Scale Pilot	Draft
EU-Core	`eu-core`	`https://iri.suomi.fi/model/eu-core/`	EU Core Vocabularies (Person, Organization, Location, Address, Evidence, etc.)	Draft
NCBV	`ncbv`	`https://iri.suomi.fi/model/ncbv/`	Nordic Core Business Vocabulary for business information	Draft (v0.0.8)

Vocabulary Relationships

┌─────────────────────┐
│    WE BUILD         │
│  (webuild:)         │
│                     │
│  Attestations,      │
│  Posted Workers,    │
│  Tax/Social Debt    │
└──────────┬──────────┘
           │ owl:imports
           ▼
┌─────────────────────┐         ┌─────────────────────┐
│    EU-Core          │         │     NCBV            │
│  (eu-core:)         │         │   (ncbv:)           │
│                     │◄────────│                     │
│  Person, Org,       │ imports │  Legal Entity,      │
│  Location, Address, │         │  Mandate, Role,     │
│  Evidence, Document │         │  Representation     │
└─────────────────────┘         └─────────────────────┘

WE BUILD extends EU-Core; NCBV imports EU-Core (ISA2core v1.0.0)

Individual Vocabularies

WE BUILD Vocabulary

Description: Vocabulary for the electronic attestations of attributes (QEAA, PubEAA, EAA) that are designed by and for the Use Cases of the WE BUILD Large Scale Pilot.

Namespace: https://iri.suomi.fi/model/webuild/

Prefix: webuild

Language: English

Imports: EU-Core, GS1 Vocabulary

Last Modified: 2026-02-06

Maintainer: yhteentoimivuus@dvv.fi (Finnish Digital and Population Data Services Agency)

JSON-LD View on Tietomallit

Key Classes:

ComplianceAttestation - Base class for compliance attestations
TaxDebtStatusAttestation - Tax debt status verification
SocialContributionsDebtStatusAttestation - Social security debt status
StatutoryInsuranceCoverageAttestation - Insurance coverage verification
PostedWorkerNotification - Posted worker declarations
PDA1Certificate - Portable Document A1 (social security)
Employment, WorkAssignment, Occupation - Work-related entities

EU-Core Vocabularies

Description: A local implementation of the EU Core Vocabularies for use by the WP4 Semantics Group in the WE BUILD Large Scale Pilot. EU Core Vocabularies are simplified, reusable, and extensible data models that capture the fundamental characteristics of entities like persons and organizations.

Namespace: https://iri.suomi.fi/model/eu-core/

Prefix: eu-core

Languages: English, Finnish

Based on: EU Core Vocabularies v2.0.0 (published 2022-04-07)

Last Modified: 2026-01-12

JSON-LD View on Tietomallit

Key Classes:

Person - Natural person with demographics and identification
LegalEntity - Legal person/organization with registration details
Organization, PublicOrganization - Organizational structures
Address, Location - Geographic and postal information
Evidence, Document - Supporting documentation
Identifier - Formal identification schemes
ContactPoint - Communication details
Requirement, InformationRequirement, Criterion - Regulatory requirements

Nordic Core Business Vocabulary (NCBV)

Description: The common Nordic data vocabulary for business information, initiated by the Nordic Smart Government & Business 4.0 program in 2022-24, further developed and maintained by the Nordic Data Quality and Semantics working group (2025-).

Namespace: https://iri.suomi.fi/model/ncbv/

Prefix: ncbv

Languages: English, Finnish, Swedish, Norwegian, Danish, Icelandic

Version: 0.0.8

Imports: ISA2core (EU-Core v1.0.0), busdoc

Last Modified: 2025-10-23

Maintainer: Finnish Tax Administration (Verohallinto)

JSON-LD View on Tietomallit

Key Classes:

LegalEntity - Business entity with legal status and registration
Role, Membership - Business roles and memberships
Mandate, MandateTransfer - Representation and delegation
RepresentationRule - Rules for legal representation (alone, jointly, composite)
BeneficialOwner, BeneficialOwnerRole - Ultimate beneficial ownership
ShareCapital - Capital and ownership structure
EconomicOperator - Business operator status
LegalStatus - Registration and operational status

Usage in W3C Verifiable Credentials

These vocabularies are designed to support the creation of W3C Verifiable Credentials for business processes. Example usage in a JSON-LD context:

{
  "@context": [
    "https://www.w3.org/ns/credentials/v2",
    "https://iri.suomi.fi/model/webuild/",
    "https://iri.suomi.fi/model/eu-core/",
    "https://iri.suomi.fi/model/ncbv/"
  ],
  "@type": ["VerifiableCredential", "webuild:TaxDebtStatusAttestation"],
  "credentialSubject": {
    "@type": ["eu-core:LegalEntity", "ncbv:LegalEntity"],
    "eu-core:legalName": "Acme Corporation",
    "ncbv:legalIdentifier": {
      "@type": "ncbv:Identifier",
      "ncbv:notation": "FI12345678"
    },
    "webuild:hasTaxDebtStatus": "no-debt"
  }
}

Related Resources

Tietomallit.suomi.fi - Finnish Interoperability Platform
WE BUILD Consortium WP4 Semantics Group
EU Core Vocabularies (SEMIC)
EU Digital Identity Wallet

Documentation & Source

📖 View the Complete Technical Specification – Detailed W3C-style documentation with full class and property definitions, examples, and usage patterns.

This combined vocabulary documentation is maintained at github.com/jgmikael/vocabularies.

For the original vocabulary sources, visit each vocabulary's page on Tietomallit.suomi.fi: