Data Models
TreatmentGroup
Represents a treatment group with ranked treatment alternatives for a specific disease.
{
"id": "string",
"name": "string",
"description": "string | null",
"diseaseGroup": "string | null",
"jurisdictions": [ Coding ],
"validityPeriod": { "start": "YYYY-MM-DD", "end": "YYYY-MM-DD" },
"reviewDate": "YYYY-MM-DD | null",
"indications": [ CodeableConcept ],
"treatmentAlternatives": [ TreatmentAlternative ]
}
| Field | Type | Description |
|---|---|---|
id |
string |
Unique identifier for the treatment group |
name |
string |
Name of the treatment group (e.g., "Natalizumab") |
description |
string? |
Human-readable description |
diseaseGroup |
string? |
Disease group code (e.g., "MS") |
jurisdictions |
Coding[] |
Regional Health Authorities (RHF) where this applies |
validityPeriod |
Period |
Date range when this treatment group is valid |
reviewDate |
string? |
Date of last review (YYYY-MM-DD) |
indications |
CodeableConcept[] |
Medical indications (ICD-10, MedDRA) |
treatmentAlternatives |
TreatmentAlternative[] |
Ranked list of treatment options |
TreatmentAlternative
A specific treatment option within a treatment group, ranked by preference.
{
"rank": 1,
"treatmentId": "string",
"name": "string",
"description": "string | null",
"medicines": [ MedicinalReference ]
}
| Field | Type | Description |
|---|---|---|
rank |
int |
Priority ranking (1 = highest priority) |
treatmentId |
string |
Unique identifier for this treatment alternative |
name |
string |
Name of the treatment (e.g., "Natalizumab (Tysabri)") |
description |
string? |
Additional description |
medicines |
MedicinalReference[] |
Associated medicines |
ReimbursementGroup
Represents a reimbursement group: the legal basis (hjemmel) and the indications (diagnoses) it covers.
{
"id": "string",
"legalBasis": CodeableConcept,
"indications": [ CodeableConcept ],
"medicines": [ MedicinalReference ]
}
| Field | Type | Description |
|---|---|---|
id |
string |
Unique identifier for the reimbursement group |
legalBasis |
CodeableConcept |
Legal basis (hjemmel) for reimbursement, e.g., H-resept §950. Single CodeableConcept allows the same hjemmel to be expressed in multiple code systems |
indications |
CodeableConcept[] |
Diagnoses (typically ICD-10) eligible under this hjemmel. Each indication is its own CodeableConcept so a single indication can carry multiple parallel codings |
medicines |
MedicinalReference[] |
Medicines covered by this reimbursement group. Empty if upstream provides no article number |
The model is intentionally hjemmel-agnostic — it can represent H-resept §950, §951, §952 (without indications), or future schemes such as blåresept.
MedicinalReference
A reference to a medicine in an external system.
{
"reference": "string | null",
"type": "string | null",
"identifier": { "system": "string", "value": "string" },
"display": "string | null"
}
| Field | Type | Description |
|---|---|---|
reference |
string? |
Full reference URL (e.g., MedicinalProductPackaged/mpkg-12345) |
type |
string? |
Source system type (see reference types below) |
identifier |
Identifier? |
System and value pair identifying the medicine |
display |
string? |
Human-readable name |
Reference Types
| Type | Description |
|---|---|
FEST/LegemiddelPakning |
Norwegian FEST drug database package reference |
NOMPD/MedicinalProductPackaged |
NOMPD ISO-IDMP structured product reference |
Shared Types
Coding
A single code from a code system.
{
"system": "string",
"code": "string",
"display": "string"
}
CodeableConcept
Groups one or more codes representing the same concept across different code systems.
{
"coding": [ Coding ],
"text": "string | null"
}
The text field provides a human-readable representation of the concept.
Identifier
A system-value pair uniquely identifying a resource.
{
"system": "string",
"value": "string"
}
Period
A date range.
{
"start": "YYYY-MM-DD",
"end": "YYYY-MM-DD"
}
Code Systems
| System URI | Description | Example Code |
|---|---|---|
urn:oid:2.16.578.1.12.4.1.102 |
Norwegian Regional Health Authority (RHF) | 100022 (Helse Nord) |
urn:oid:2.16.578.1.12.4.1.1.7110 |
ICD-10 (Norwegian edition) | G35 (Multiple sclerosis) |
http://terminology.hl7.org/CodeSystem/meddra |
MedDRA | 10028245 (Multiple sclerosis) |
urn:oid:2.16.578.1.12.4.1.1.7427 |
Reimbursement regulation | 950 (H-resept) |
FEST/Varenummer |
FEST article number | 166028 |
Norwegian RHF Codes
| Code | Display |
|---|---|
100022 |
Helse Nord RHF |
100024 |
Helse Midt-Norge RHF |
100021 |
Helse Vest RHF |
111919 |
Helse Sør-Øst RHF |