Page Status: draft updated 2025-08-05
ValueSets
Page index
- Introduction
- CodeableConcept, Coding and code
- Resource types and relations
- ValueSets used in this guide
Introduction
The Swedish National Catalog of Organization, Offerings and Contracts is to a large extent based on coded values published as terminologies, later referred to as code systems and value sets. Code systems and value sets are used within elements of the type code. Coded values are used in many FHIR resources to structure the information and make it system readable. The content of code systems and value sets define a set of values in a specific context. The expression code is commonly also called concept and is a structured and often standardized way of expressing a value e.g. mg for milligram.
A code system/value set can represent codes from a wellknown terminology e.g. Snomed CT, or locally defined codes.
The picture below shows how the binding to code systems or value sets can be seen in a FHIR profile elements. In this case, the profile HVOBusiness has an element with a binding (1) to the value set hvo-business-category (2) which defines all valid codes for the element.
Value sets were the basepath of the URI starts with http://electronichealth.se or http://ehalsomyndigheten.se are defined by the Swedish eHealth Agency and can be fetched from the endpoint [base]/ValueSet. Value sets and code systems defined by other organisations are usually not republished by the Swedish eHealth Agency. The identity of a value set or code system can take many forms, e.g. OID, URI etc. An URI identity may in some cases be used as an URL as well, and make it possible to look up and view the concepts by a browser.
CodeableConcept, Coding and code
The way FHIR usually uses codes in resources is by defining a CodableConcept. One single concept can be described in CodableConcept by specifing one or more Codings (with a codes and potentially a textual description). In some cases the use of codes in the resource is very strict, e.g. in the "status" element that is available in many resources. In those cases a plain code is used.
Resource types and relations
The figure below shows how the terminology resources relate to each other.
Code System
A code system is a set of concepts where each concept has a unique code and a display name and possibly a definition of the concept. Each code system also has a globally unique identifier, sometimes in the form of an URI or OID. When exchanging a coded element in FHIR, the elements used for this information is Coding.code, Coding.display and Coding.system respectively.
No code systems are published in this guide but each value set refers to the code system of each code in the value set.
Value Set
A value set is a subset of codes from one or more code systems. A code is understood in a value set only in combination with what code system it is from, hence this information always has to be present when passing around coded values. In actual implementations you can often see value sets and code systems being mixed up. While FHIR elements are bound to value sets to show which subset of codes are valid for those elements, it is always the code system that is specified in the Coding.system element. If you can not read which code system the code comes from, you do not know what code it is - in theory, one code can by chance be the same in multiple code systems.
Some value sets contains the code OTH ("other", HL7 Nullflavor code) which represents that there is no applicable concept. In most such cases it is required to add a textual description in combination with OTH code.
ValueSets used in this guide
ValueSets defined in this guide
Note that the links of the value sets will open the value set in the Swedish National Catalog of Organization, Offerings and Contracts project on Simplifier.
| Name | Area | Description | Version |
|---|---|---|---|
| Ägarkategori enligt SCB (hvo-organization-ownership-scb) | Organisation och verksamhet (hvo-organization-business) | Includes categories of ownership which an organization can have, according to code system ÄGAR 2000 from Statistics Sweden (sv: SCB). | 0.1.0 |
| ASA-klasser (hvo-offerings-patientgroup-asa-class) | Utbud (hvo-offerings) | Includes physical status according to the American Society of Anesthesiologists (ASA). | 1.0.0 |
| Avtalsområde Underkategori (hvo-contract-sub-type-lfu) | Uppdrag och avtal (hvo-agreement) | Includes sub types of contracts according to LfU. | 1.0.0 |
| Avtalsområde (hvo-contract-type-lfu) | Uppdrag och avtal (hvo-agreement) | Includes domains of contracts according to LfU. | 1.0.0 |
| Funktion som plats fyller (hvo-location-functionality) | Plats (hvo-location) | Includes functionalities which locations can have. | 0.1.0 |
| HVO Felkoder (hvo-error-code) | Includes errors that can occur in OperationOutcome responses from API calls. | 0.1.0 | |
| Juridisk form (hvo-legal-form-skatteverket) | Organisation och verksamhet (hvo-organization-business) | Includes legal forms from the JURFORM code system, under which an organization conducts business. JURFORM is maintained by the Swedish Tax Agency. | 0.1.0 |
| Kommuner i kodnummerordning från SCB (hvo-municipalities-scb) | Plats (hvo-location) | Includes numbered municipalities from SCB. | 0.1.0 |
| Kön (hvo-offerings-patientgroup-gender) | Utbud (hvo-offerings) | Includes administrative genders which can define the target group of a service. | 1.0.0 |
| Lagrum för upphandling och ersättning (hvo-contract-procurement-regulation) | Uppdrag och avtal (hvo-agreement) | Includes sections of law in which a procurement has been done or an task has been delivered. | 0.1.0 |
| Län i kodnummerordning från SCB (hvo-counties-scb) | Plats (hvo-location) | Includes numbered counties from SCB. | 0.1.0 |
| Mötesform som tjänst erbjuder (hvo-encounter-means) | Utbud (hvo-offerings) | Includes means of encounter which a service can offer. | 0.1.0 |
| Personroll inom organisation (hvo-practitioner-role) | Includes roles which a person can fill within an organization or organizational unit. | 0.1.0 | |
| Samband mellan avtal (hvo-contract-additional-relationship-type) | Uppdrag och avtal (hvo-agreement) | Includes types of relationships between contracts. | 0.1.0 |
| Samband mellan organisationer (hvo-organization-additional-relationship-type) | Organisation och verksamhet (hvo-organization-business) | Includes types of relationships between organizations. | 0.1.0 |
| Samband mellan organisatoriska enheter (hvo-organizational-unit-additional-relationship-type) | Organisation och verksamhet (hvo-organization-business) | Includes types of relationships between organizational units. | 0.1.0 |
| Samling värdemängder med avtalsområden (hvo-contract-type-with-sub-type-lfu) | Includes domains and sub domains of contract types according to LfU. | 0.1.0 | |
| Samling värdemängder med egenskaper för behörighet (hvo-eligibility-characteristic-value) | Includes characteristics which makes a person eligible for a service. | 0.1.0 | |
| Samling värdemängder med egenskapstyper för behörighet (hvo-eligibility-characteristic) | Includes types of characteristics which define eligibility for a service. | 0.1.0 | |
| Syfte för kontaktuppgift (hvo-contact-purpose) | Organisation och verksamhet (hvo-organization-business), Utbud (hvo-offerings) | Includes purposes for which a contact detail can be contacted. | 0.1.0 |
| Typ av egenskap hos målgrupp (hvo-target-group-eligibility-characteristic) | Utbud (hvo-offerings) | Includes types of characteristics which can define a target group. | 0.1.0 |
| Typ av organisation (hvo-organization-type) | Organisation och verksamhet (hvo-organization-business) | Includes types of organizations. | 0.1.0 |
| Typ av organisatorisk enhet (hvo-organizational-unit-type) | Organisation och verksamhet (hvo-organization-business) | Includes types of organizational units. An organizational unit can be categorized in multiple ways depending on the purpose of the categorization. | 0.1.0 |
| Typ av remiss (hvo-referral-type) | Utbud (hvo-offerings) | Includes types of referrals to a service. | 0.1.0 |
| Vårdtjänster (hvo-offerings-services) | Utbud (hvo-offerings) | Includes types of services that can be offered. | 1.0.0 |
| Verksamhetsinriktning (HVO) (hvo-business-category) | Organisation och verksamhet (hvo-organization-business) | Includes business categories. | 0.1.0 |
| Verksamhetsinriktning (Inera) (hvo-business-category-inera) | Organisation och verksamhet (hvo-organization-business) | Includes business categories according to HSA codes from Inera. | 1.0.0 |
| Verksamhetsinriktning (hvo-organization-affiliation-business-category) | Uppdrag och avtal (hvo-agreement) | Includes business categories to which a contract can refer to. | 1.0.0 |
| Villkor för behörighet till tjänst (hvo-service-eligibility-condition) | Utbud (hvo-offerings) | Includes conditions which needs to be met to be eligible for a service. | 0.1.0 |
ValueSets defined by external parties
| Name | Area | Description |
|---|---|---|
| ContactPointSystem | Organisation och verksamhet (hvo-organization-business); Utbud (hvo-offerings); Uppdrag och avtal (hvo-agreement) | Telecommunications form for contact point. |
| DaysOfWeek | Utbud (hvo-offerings) | The days of the week. |
| LocationStatus | Plats (hvo-location) | Indicates whether the location is still in use. |
| LocationType | Plats (hvo-location) | This example value set defines a set of codes that can be used to indicate the physical form of the Location. |