eHealth Infrastructure
8.0.0 - release Denmark flag

eHealth Infrastructure, published by Den telemedicinske infrastruktur (eHealth Infrastructure). This guide is not an authorized publication; it is the continuous build for version 8.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/fut-infrastructure/implementation-guide/ and changes regularly. See the Directory of published versions

CapabilityStatement: plan

Official URL: http://ehealth.sundhed.dk/fhir/CapabilityStatement/plan Version: 8.0.0
Active as of 2026-01-13 Computable Name: plan

Raw OpenAPI-Swagger Definition file | Download

  • Implementation Guide Version: 8.0.0
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+xml, xml, application/fhir+json, json, application/x-turtle, ttl, html/json, html/xml, html/turtle
  • Published on: 2026-01-13 11:12:47+0000
  • Published by: Den telemedicinske infrastruktur (eHealth Infrastructure)

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

This CapabilityStatement instantiates the CapabilityStatement http://hl7.org/fhir/uv/bulkdata/CapabilityStatement/bulk-data

FHIR RESTful Capabilities

Mode: server

Summary of System-wide Operations
ConformanceOperationDocumentation
SHALL$reindex
SHALL$migrate

Data migration

SHALL$export-poll-status

Operation for polling the status of a previously initiated FHIR Bulk Data System Level Export. A complete URL including the '_jobId' is returned in the 'Content-Location' response header when initiating the export. A 'GET' request to the polling location will return '202 Accepted' with a response header 'X-Progress' containing a status message for the progress of the export job. When the job has finished, the polling location will return '200 OK', and the contents of the body will be a JSON object providing metadata and links to the generated bulk data files. A 'DELETE' request can be used to cancel the export. If the export has already finished, the delete will return '404 Not Found', else the export job will be cancelled and a '202 Accepted' is returned with an operation outcome response.

Parameters

  • _jobId: the job ID for the Bulk Export job which was returned in the 'Content-Location' header when initiating the export
SHALL$export

FHIR Operation to initiate an export of data from a FHIR server. The type of resources returned can be restricted using the '_type' parameter, and the '_since' parameter can be used to restrict resources to be only included if changed since the supplied time. The FHIR server support invocation of this operation using the FHIR Asynchronous Request Pattern.

Initiation of export

The initiation of an export must specify the request header 'Prefer: respond-async', and will return '202 Accepted' with a polling location in the response header 'Content-Location'. The polling location is for the endpoint '$export-poll-status' and has the export job ID as parameter '_jobId'.

Parameters

  • _outputFormat: Optional parameter to specify the output format of the exported files. Default is 'application/fhir+ndjson'
  • _type: Optional parameter to specify a comma separated list of resource types to be included in the export. If not provided, all resource types will be included.
  • _since: Optional parameter to specify a time. Only resources that have been created or modified after this time will be included in the export (i.e., if Resource.meta.lastUpdated is later than the supplied _since time).
  • _typeFilter: Optional parameter to apply search filter of resources for export. It is a string of comma-delimited FHIR REST search queries in the format [resourceType]?[parameters]. The filter will be applied when searching resources.
  • _typePostFetchFilterUrl: Optional parameter to apply filtering of resources for export. It is a string of comma-delimited FHIR REST search queries in the format [resourceType]?[parameters]. The filter will be applied on resources after being fetched from the database.
  • _exportId: Optional parameter to specify a client provided identifier for the export. Resulting exported files (Binary) will be labeled with the identifer in meta extension 'https://hapifhir.org/NamingSystem/bulk-export-identifier'

Polling status of export

Subsequent GET requests to the polling location will return '202 Accepted' with a response header 'X-Progress' containing a status message for the progress of the export job. When the job has finished, the polling location will return '200 OK', and the contents of the body will be a JSON object providing metadata and links to the generated bulk export data files.

Retrieving exported files

The JSON object returned when the export job is complete will contain a list of files (Binary resources) available for download. Each file can be retrieved using a standard HTTP GET request to the provided URL. The security context of the Binary resources resulting from the export is the user that initiated the export. The files can therefore only be retrieved by the same user.

Retention of exported files

The exported files are retained for a limited time after which they are deleted. The retention time is a server configuration with default 2 hours.

SHALL$meta
SHALL$get-resource-counts

Provides the number of resources currently stored on the server, broken down by resource type

SHALL$expunge

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRV-RSUCSearches_include_revincludeOperations
ActivityDefinitionhttp://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-activitydefinitionyyyyy_content, _has, _id, _language, _lastUpdated, _profile, _security, _source, _tag, _text, base, baseEnvironment, composed-of, context, context-quantity, context-type, context-type-value, date, depends-on, derived-from, description, effective, ehealthPredecessor, employeeTitle, identifier, intendedAudience, jurisdiction, modifier_role_reference, modifier_role_role, name, predecessor, publisher, recommendation, status, successor, title, topic, url, versionActivityDefinition:composed-of, ActivityDefinition:depends-on, ActivityDefinition:derived-from, ActivityDefinition:predecessor, ActivityDefinition:successorActivityDefinition:composed-of, ActivityDefinition:depends-on, ActivityDefinition:derived-from, ActivityDefinition:intendedAudience, ActivityDefinition:modifier_role_reference, ActivityDefinition:predecessor, ActivityDefinition:successor, DocumentReference:authenticator, DocumentReference:author, DocumentReference:custodian, DocumentReference:encounter, DocumentReference:intendedOrganization, DocumentReference:modifier_role_reference, DocumentReference:patient, DocumentReference:related, DocumentReference:relatesto, DocumentReference:subject, PlanDefinition:composed-of, PlanDefinition:definition, PlanDefinition:depends-on, PlanDefinition:derived-from, PlanDefinition:documentation, PlanDefinition:intendedAudience, PlanDefinition:modifier_role_reference, PlanDefinition:predecessor, PlanDefinition:successor$validate, $create-clone
Binaryhttp://hl7.org/fhir/StructureDefinition/Binaryyy*ActivityDefinition:composed-of, ActivityDefinition:depends-on, ActivityDefinition:derived-from, ActivityDefinition:intendedAudience, ActivityDefinition:modifier_role_reference, ActivityDefinition:predecessor, ActivityDefinition:successor, DocumentReference:authenticator, DocumentReference:author, DocumentReference:custodian, DocumentReference:encounter, DocumentReference:intendedOrganization, DocumentReference:modifier_role_reference, DocumentReference:patient, DocumentReference:related, DocumentReference:relatesto, DocumentReference:subject, PlanDefinition:composed-of, PlanDefinition:definition, PlanDefinition:depends-on, PlanDefinition:derived-from, PlanDefinition:documentation, PlanDefinition:intendedAudience, PlanDefinition:modifier_role_reference, PlanDefinition:predecessor, PlanDefinition:successor
DocumentReferencehttp://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-documentreferenceyyyyy_content, _filter, _has, _id, _language, _lastUpdated, _profile, _security, _source, _tag, _text, authenticator, author, category, contenttype, custodian, date, description, encounter, event, facility, format, identifier, intendedOrganization, language, location, modifier_role_reference, modifier_role_role, patient, period, related, relatesto, relation, relationship, security-label, setting, status, subject, type, use-context-context, use-context-context-type, use-context-context-type-value*, DocumentReference:authenticator, DocumentReference:author, DocumentReference:custodian, DocumentReference:encounter, DocumentReference:intendedOrganization, DocumentReference:modifier_role_reference, DocumentReference:patient, DocumentReference:related, DocumentReference:relatesto, DocumentReference:subjectActivityDefinition:composed-of, ActivityDefinition:depends-on, ActivityDefinition:derived-from, ActivityDefinition:intendedAudience, ActivityDefinition:modifier_role_reference, ActivityDefinition:predecessor, ActivityDefinition:successor, DocumentReference:authenticator, DocumentReference:author, DocumentReference:custodian, DocumentReference:encounter, DocumentReference:intendedOrganization, DocumentReference:modifier_role_reference, DocumentReference:patient, DocumentReference:related, DocumentReference:relatesto, DocumentReference:subject, PlanDefinition:composed-of, PlanDefinition:definition, PlanDefinition:depends-on, PlanDefinition:derived-from, PlanDefinition:documentation, PlanDefinition:intendedAudience, PlanDefinition:modifier_role_reference, PlanDefinition:predecessor, PlanDefinition:successor$validate
OperationDefinitionhttp://hl7.org/fhir/StructureDefinition/OperationDefinitiony*ActivityDefinition:composed-of, ActivityDefinition:depends-on, ActivityDefinition:derived-from, ActivityDefinition:intendedAudience, ActivityDefinition:modifier_role_reference, ActivityDefinition:predecessor, ActivityDefinition:successor, DocumentReference:authenticator, DocumentReference:author, DocumentReference:custodian, DocumentReference:encounter, DocumentReference:intendedOrganization, DocumentReference:modifier_role_reference, DocumentReference:patient, DocumentReference:related, DocumentReference:relatesto, DocumentReference:subject, PlanDefinition:composed-of, PlanDefinition:definition, PlanDefinition:depends-on, PlanDefinition:derived-from, PlanDefinition:documentation, PlanDefinition:intendedAudience, PlanDefinition:modifier_role_reference, PlanDefinition:predecessor, PlanDefinition:successor
PlanDefinitionhttp://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-plandefinitionyyyyy_content, _has, _id, _language, _lastUpdated, _profile, _security, _source, _tag, _text, base, baseEnvironment, composed-of, context, context-quantity, context-type, context-type-value, date, definition, depends-on, derived-from, description, documentation, effective, ehealthPredecessor, employeeTitle, identifier, intendedAudience, jurisdiction, modifier_role_reference, modifier_role_role, name, predecessor, publisher, recommendation, status, successor, title, topic, type, url, version*, PlanDefinition:composed-of, PlanDefinition:definition, PlanDefinition:depends-on, PlanDefinition:derived-from, PlanDefinition:documentation, PlanDefinition:predecessor, PlanDefinition:successorActivityDefinition:composed-of, ActivityDefinition:depends-on, ActivityDefinition:derived-from, ActivityDefinition:intendedAudience, ActivityDefinition:modifier_role_reference, ActivityDefinition:predecessor, ActivityDefinition:successor, DocumentReference:authenticator, DocumentReference:author, DocumentReference:custodian, DocumentReference:encounter, DocumentReference:intendedOrganization, DocumentReference:modifier_role_reference, DocumentReference:patient, DocumentReference:related, DocumentReference:relatesto, DocumentReference:subject, PlanDefinition:composed-of, PlanDefinition:definition, PlanDefinition:depends-on, PlanDefinition:derived-from, PlanDefinition:documentation, PlanDefinition:intendedAudience, PlanDefinition:modifier_role_reference, PlanDefinition:predecessor, PlanDefinition:successor$validate, $import, $export, $create-clone, $apply
Base System Profile
ehealth-activitydefinition
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports update, search-type, vread, read, create.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_contentstring

Search the contents of the resource's data using a fulltext search

SHALL_hasstring

Return resources linked to by the given target

SHALL_idtoken

The ID of the resource

SHALL_languagestring

The language of the resource

SHALL_lastUpdateddate

Only return resources which were last updated as specified by the given range

SHALL_profileuri

Search for resources which have the given profile

SHALL_securitytoken

Search for resources which have the given security labels

SHALL_sourceuri

Search for resources which have the given source value (Resource.meta.source)

SHALL_tagtoken

Search for resources which have the given tag

SHALL_textstring

Search the contents of the resource's narrative using a fulltext search

SHALLbasetoken

Base of resource

SHALLbaseEnvironmenttoken

Base Environment of resource

SHALLcomposed-ofreference

What resource is being referenced

SHALLcontexttoken

A use context assigned to the activity definition

SHALLcontext-quantityquantity

A quantity- or range-valued use context assigned to the activity definition

SHALLcontext-typetoken

A type of use context assigned to the activity definition

SHALLcontext-type-valuecomposite

A use context type and value assigned to the activity definition

SHALLdatedate

The activity definition publication date

SHALLdepends-onreference

What resource is being referenced

SHALLderived-fromreference

What resource is being referenced

SHALLdescriptionstring

The description of the activity definition

SHALLeffectivedate

The time during which the activity definition is intended to be in use

SHALLehealthPredecessortoken

Predecessor of resource

SHALLemployeeTitlestring

Title intented for clinicians

SHALLidentifiertoken

External identifier for the activity definition

SHALLintendedAudiencereference

The intended audience of the plan definition

SHALLjurisdictiontoken

Intended jurisdiction for the activity definition

SHALLmodifier_role_referencereference

Reference to either Organization, CareTeam, Practitioner

SHALLmodifier_role_roletoken

Role of Organization, CareTeam, Practitioner

SHALLnamestring

Computationally friendly name of the activity definition

SHALLpredecessorreference

What resource is being referenced

SHALLpublisherstring

Name of the publisher of the activity definition

SHALLrecommendationtoken

Recommendation for the plan definition

SHALLstatustoken

The current status of the activity definition

SHALLsuccessorreference

What resource is being referenced

SHALLtitlestring

The human-friendly name of the activity definition

SHALLtopictoken

Topics associated with the module

SHALLurluri

The uri that identifies the activity definition

SHALLversiontoken

The business version of the activity definition

 
Extended Operations
ConformanceOperationDocumentation
SHALL$validate
SHALL$create-clone

Input

  • resourceId: reference to the ActivityDefinition resource that should be cloned
  • clone_operation: minor-version/major-version/copy Coding from codesystem: http://ehealth.sundhed.dk/cs/ehealth-clone-operation
  • default-clone-behavior: true/false. False signifies deep-clone mode where the list of deep-clone-references determine which resources should be cloned
  • deep-clone-references: References to resources to create as new resources rather than referencing the existing ones.

Output

Bundle containing all resources that were created during the operation.

Validation

  • New business versions require that the user has modifier-role: owner or co-author for the resource
  • New copy does not require that the user has a modifier-role.
  • New business version can be made only when no draft resource exists (having identical base identifier).
  • Read/search/create privileges are required for the resource types affected by $create-clone
Base System Profile
Binary
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports vread, read.

Base System Profile
ehealth-documentreference
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports update, search-type, vread, read, create.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_contentstring

Search the contents of the resource's data using a fulltext search

SHALL_filterstring

Search the contents of the resource's data using a filter

SHALL_hasstring

Return resources linked to by the given target

SHALL_idtoken

The ID of the resource

SHALL_languagestring

The language of the resource

SHALL_lastUpdateddate

Only return resources which were last updated as specified by the given range

SHALL_profileuri

Search for resources which have the given profile

SHALL_securitytoken

Search for resources which have the given security labels

SHALL_sourceuri

Search for resources which have the given source value (Resource.meta.source)

SHALL_tagtoken

Search for resources which have the given tag

SHALL_textstring

Search the contents of the resource's narrative using a fulltext search

SHALLauthenticatorreference

Who/what authenticated the document

SHALLauthorreference

Who and/or what authored the document

SHALLcategorytoken

Categorization of document

SHALLcontenttypetoken

Mime type of the content, with charset etc.

SHALLcustodianreference

Organization which maintains the document

SHALLdatedate

When this document reference was created

SHALLdescriptionstring

Human-readable description

SHALLencounterreference

Context of the document content

SHALLeventtoken

Main clinical acts documented

SHALLfacilitytoken

Kind of facility where patient was seen

SHALLformattoken

Format/content rules for the document

SHALLidentifiertoken

Master Version Specific Identifier

SHALLintendedOrganizationreference

The Organization which is intended to use the DocumentReference

SHALLlanguagetoken

Human language of the content (BCP-47)

SHALLlocationuri

Uri where the data can be found

SHALLmodifier_role_referencereference

Reference to modifier Organization

SHALLmodifier_role_roletoken

Role of Organization related to modification of the DocumentReference

SHALLpatientreference

Who/what is the subject of the document

SHALLperioddate

Time of service that is being documented

SHALLrelatedreference

Related identifiers or resources

SHALLrelatestoreference

Target of the relationship

SHALLrelationtoken

replaces | transforms | signs | appends

SHALLrelationshipcomposite

Combination of relation and relatesTo

SHALLsecurity-labeltoken

Document security-tags

SHALLsettingtoken

Additional details about where the content was created (e.g. clinical specialty)

SHALLstatustoken

current | superseded | entered-in-error

SHALLsubjectreference

Who/what is the subject of the document

SHALLtypetoken

Kind of document (LOINC if possible)

SHALLuse-context-contexttoken

A use context assigned to the DocumentReference

SHALLuse-context-context-typetoken

A type of use context assigned to the DocumentReference

SHALLuse-context-context-type-valuecomposite

A use context type and value assigned to the DocumentReference

 
Extended Operations
ConformanceOperationDocumentation
SHALL$validate
Base System Profile
OperationDefinition
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read.

Base System Profile
ehealth-plandefinition
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports update, search-type, vread, read, create.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_contentstring

Search the contents of the resource's data using a fulltext search

SHALL_hasstring

Return resources linked to by the given target

SHALL_idtoken

The ID of the resource

SHALL_languagestring

The language of the resource

SHALL_lastUpdateddate

Only return resources which were last updated as specified by the given range

SHALL_profileuri

Search for resources which have the given profile

SHALL_securitytoken

Search for resources which have the given security labels

SHALL_sourceuri

Search for resources which have the given source value (Resource.meta.source)

SHALL_tagtoken

Search for resources which have the given tag

SHALL_textstring

Search the contents of the resource's narrative using a fulltext search

SHALLbasetoken

Base of resource

SHALLbaseEnvironmenttoken

Base Environment of resource

SHALLcomposed-ofreference

What resource is being referenced

SHALLcontexttoken

A use context assigned to the plan definition

SHALLcontext-quantityquantity

A quantity- or range-valued use context assigned to the plan definition

SHALLcontext-typetoken

A type of use context assigned to the plan definition

SHALLcontext-type-valuecomposite

A use context type and value assigned to the plan definition

SHALLdatedate

The plan definition publication date

SHALLdefinitionreference

Activity or plan definitions used by plan definition

SHALLdepends-onreference

What resource is being referenced

SHALLderived-fromreference

What resource is being referenced

SHALLdescriptionstring

The description of the plan definition

SHALLdocumentationreference

What resource is being referenced

SHALLeffectivedate

The time during which the plan definition is intended to be in use

SHALLehealthPredecessortoken

Predecessor of resource

SHALLemployeeTitlestring

Title intented for clinicians

SHALLidentifiertoken

External identifier for the plan definition

SHALLintendedAudiencereference

The intended audience of the plan definition

SHALLjurisdictiontoken

Intended jurisdiction for the plan definition

SHALLmodifier_role_referencereference

Reference to either Organization, CareTeam, Practitioner

SHALLmodifier_role_roletoken

Role of Organization, CareTeam, Practitioner

SHALLnamestring

Computationally friendly name of the plan definition

SHALLpredecessorreference

What resource is being referenced

SHALLpublisherstring

Name of the publisher of the plan definition

SHALLrecommendationtoken

Recommendation for the plan definition

SHALLstatustoken

The current status of the plan definition

SHALLsuccessorreference

What resource is being referenced

SHALLtitlestring

The human-friendly name of the plan definition

SHALLtopictoken

Topics associated with the module

SHALLtypetoken

The type of artifact the plan (e.g. order-set, eca-rule, protocol)

SHALLurluri

The uri that identifies the plan definition

SHALLversiontoken

The business version of the plan definition

 
Extended Operations
ConformanceOperationDocumentation
SHALL$validate
SHALL$import

Import a Plandefinition

Parameters

  • planDefinitionPackage: Binary package produced by the export operation

Output

Bundle containing the created resources. PlanDefinitions, ActivityDefinitions, and Questionnaires will be created. Imports QFFD DocumentReference into Document-Transformation service.Libraries and Organizations are used to find the corresponding resources on the target system.

SHALL$export

Export a PlanDefinition.

Export Contents

The export contains the PlanDefinition including referenced resources:- PlanDefinitions

  • ActivityDefinitions
  • Questionnaires
  • Libraries
  • Organizations
  • DocumentReference + QFDD

Each resource is returned in a separate JSon file.

Parameters

  • exclude: references to ActivityDefinitions or PlanDefinitions to exclude from the export.

Output

Output can be found in Binary.content. This is a Base64 encoded .zip file containing JSon files. All returned objects are Fhir resources. See the implementation guide for details

SHALL$create-clone

Input

  • resourceId: reference to the PlanDefinition resource that should be cloned
  • clone_operation: minor-version/major-version/copy Coding from codesystem: http://ehealth.sundhed.dk/cs/ehealth-clone-operation
  • default-clone-behavior: true/false. False signifies deep-clone mode where the list of deep-clone-references determine which resources should be cloned
  • deep-clone-references: References to resources to create as new resources rather than referencing the existing ones.

Output

Bundle containing all resources that were created during the operation.

Validation

  • New business versions require that the user has modifier-role: owner or co-author for the resource
  • New copy does not require that the user has a modifier-role.
  • New business version can be made only when no draft resource exists (having identical base identifier).
  • Read/search/create privileges are required for the resource types affected by $create-clone
SHALL$apply

Create a careplan with service requests for a specific episodeOfCare using the PlanDefinition as a template.

HTTP Methods

  • If using POST the operation will persist resources and return the careplan.
  • If using GET the operation will return transient resources in a transaction bundle. The bundle with transient careplan and servicerequest resources can then be modified before being persisted using a FHIR transaction.

Parameters

  • episodeOfCare: Reference(EpisodeOfCare) - The episode of care for which the plan is being applied.

Output

CarePlan or Bundle of transient CarePlan and ServiceRequest resources.