Scope and usage

The kl-gateway-119-focus-condition holds a diagnosiscode, as it is reported to the municipality in the request (XREF15) for prevention/health promotion from a Hospital or General practitioner using SKS (ICD10), ICPC2 or text.

Each of the codes Henvisningsdiagnosen_i_kode and tillaegsdiagnose_01_i_kode from XREF15 should typically each result in its own instance of kl-gateway-119-focus-condition. The one exception is described in the following:

In FHIR each ‘whole meaning’ should have its own instance of kl-gateway-119-focus-condition. A ‘whole meaning’ may be a single diagnosis code OR a diagnosis code with add-on-codes (tillægskoder) e.g. DK257+MN02BA01 means that a hospital patient has a chronic ulcer caused by the intake of acetylsalicylacid. They are a ‘whole meaning’ because the codes would loose their meaning if represented in two different focus-condition instanses. The code should be represented in Condition.code. Be aware that the only add-on codes that should be represented this way is where Henvisnings_tillaegsdiagnosekodes_type attribute of XREF15 equals ‘tillaegsdiagnose’.

It is not very common yet that SKS or ICPC2 codes are send to the municipality, as a result a text can be used to represent the condition as well, in this case the attribute Henvisningsdiagnosekodens_t ype/Henvisnings_tillaegs_diagnosens_art equals ‘uspecificeretkode’ or no value is given. In this case, populate Condition.code.text with the content of Henvisningsdiagnosens_betydning_eller_fri_tekst/Henvisnings_tillaegsdiagnose_i_tekst.

Condition.clinicalStatus should be populated with the value ‘active’ if the citizen has the condition, and ‘inactive’ if the citizen no longer has the condition. Condition.verificationStatus should be able to ditiguish between ‘confirmed’ and ‘entered-in-error’. It is a good idea to always provide the verificationStatus. If not populated, the verificationStatus is assumed to be “confirmed”.

The citizen is referred in Condition.subject

Conversions between Danish information model and FHIR-profile

Nedenstående tabel oversætter mellem de attributter der er defineret i den fælleskommunale informationsmodel (FKI), definerer kort den enkelte attribut på dansk og specificere hvilke af FHIR-profilens atributter der skal bruges til specifikation af indholdet

• Differential Table
• Key Elements Table
• Snapshot Table
• Statistics/References
• All

This structure is derived from DkCoreCondition

Name	Flags	Card.	Type	Description & Constraints
Condition			DkCoreCondition
extension:dueTo		0..0
extension:conditionLastAssertedDate		0..0
extension:notFollowedAnymore		0..0
identifier		0..0
clinicalStatus		1..1	CodeableConcept	[DK] tilstandsstatus
category		0..0
severity		0..0
code
coding		0..*	Coding	[DK] fokusTilstandskode
version		0..0
userSelected		0..0
coding:FSIIIConditionCode		0..0
coding:SCTConditionCode		0..0
coding:FFBConditionCode		0..0
coding:SKS-D		0..1	Coding	[DA] Kode fra D-hierarkiet i SKS
version		0..0
userSelected		0..0
coding:ICPC2code		0..1	Coding	ICPC2 code
version		0..0
userSelected		0..0
text		0..1	string	[DK] fokusTilstandKodetekst
bodySite		0..0
subject		1..1	Reference(KLGateway119Citizen)	[DK] fokusTilstandsubjekt
encounter		0..0
onset[x]		0..0
abatement[x]		0..0
recordedDate		0..0
recorder		0..0
asserter		0..0
stage		0..0
evidence		0..0
note		0..0
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints
Condition	C	0..*	DkCoreCondition	Detailed information about conditions, problems or diagnoses
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
clinicalStatus	?!ΣC	1..1	CodeableConcept	[DK] tilstandsstatus Binding: ConditionClinicalStatusCodes (required): The clinical status of the condition or diagnosis.
verificationStatus	?!ΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required): The verification status to support or decline the clinical status of the condition or diagnosis.
subject	Σ	1..1	Reference(KLGateway119Citizen)	[DK] fokusTilstandsubjekt
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Condition.clinicalStatus	required	ConditionClinicalStatusCodes
Condition.verificationStatus	required	ConditionVerificationStatus

Constraints

Id	Grade	Path(s)	Details	Requirements
con-3	best practice	Condition	Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item : clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()
con-4	error	Condition	If condition is abated, then clinicalStatus must be either inactive, resolved, or remission : abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()
con-5	error	Condition	Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error : verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()
dom-2	error	Condition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Condition	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Condition	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Condition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Condition	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

Name	Flags	Card.	Type	Description & Constraints
Condition	C	0..*	DkCoreCondition	Detailed information about conditions, problems or diagnoses
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
clinicalStatus	?!ΣC	1..1	CodeableConcept	[DK] tilstandsstatus Binding: ConditionClinicalStatusCodes (required): The clinical status of the condition or diagnosis.
verificationStatus	?!ΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required): The verification status to support or decline the clinical status of the condition or diagnosis.
code	Σ	0..1	CodeableConcept	Identification of the condition, problem or diagnosis Binding: Condition/Problem/DiagnosisCodes (example): Identification of the condition or diagnosis.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
Slices for coding	Σ	0..*	Coding	[DK] fokusTilstandskode Slice: Unordered, Open by value:system
coding:All Slices				Content/Rules for all slices
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	0..1	uri	Identity of the terminology system
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
coding:SKS-D	Σ	0..1	Coding	[DA] Kode fra D-hierarkiet i SKS
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Required Pattern: urn:oid:1.2.208.176.2.4.12
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
coding:ICPC2code	Σ	0..1	Coding	ICPC2 code
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Required Pattern: urn:oid:1.2.208.176.2.31
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
text	Σ	0..1	string	[DK] fokusTilstandKodetekst
subject	Σ	1..1	Reference(KLGateway119Citizen)	[DK] fokusTilstandsubjekt
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Condition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding
Condition.clinicalStatus	required	ConditionClinicalStatusCodes
Condition.verificationStatus	required	ConditionVerificationStatus
Condition.code	example	Condition/Problem/DiagnosisCodes
Condition.stage.summary	example	ConditionStage
Condition.stage.type	example	ConditionStageType
Condition.evidence.code	example	ManifestationAndSymptomCodes

Constraints

Id	Grade	Path(s)	Details	Requirements
con-3	best practice	Condition	Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item : clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()
con-4	error	Condition	If condition is abated, then clinicalStatus must be either inactive, resolved, or remission : abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()
con-5	error	Condition	Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error : verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()
dom-2	error	Condition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Condition	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Condition	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Condition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Condition	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

Differential View

This structure is derived from DkCoreCondition

Name	Flags	Card.	Type	Description & Constraints
Condition			DkCoreCondition
extension:dueTo		0..0
extension:conditionLastAssertedDate		0..0
extension:notFollowedAnymore		0..0
identifier		0..0
clinicalStatus		1..1	CodeableConcept	[DK] tilstandsstatus
category		0..0
severity		0..0
code
coding		0..*	Coding	[DK] fokusTilstandskode
version		0..0
userSelected		0..0
coding:FSIIIConditionCode		0..0
coding:SCTConditionCode		0..0
coding:FFBConditionCode		0..0
coding:SKS-D		0..1	Coding	[DA] Kode fra D-hierarkiet i SKS
version		0..0
userSelected		0..0
coding:ICPC2code		0..1	Coding	ICPC2 code
version		0..0
userSelected		0..0
text		0..1	string	[DK] fokusTilstandKodetekst
bodySite		0..0
subject		1..1	Reference(KLGateway119Citizen)	[DK] fokusTilstandsubjekt
encounter		0..0
onset[x]		0..0
abatement[x]		0..0
recordedDate		0..0
recorder		0..0
asserter		0..0
stage		0..0
evidence		0..0
note		0..0
Documentation for this format

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
Condition	C	0..*	DkCoreCondition	Detailed information about conditions, problems or diagnoses
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
clinicalStatus	?!ΣC	1..1	CodeableConcept	[DK] tilstandsstatus Binding: ConditionClinicalStatusCodes (required): The clinical status of the condition or diagnosis.
verificationStatus	?!ΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required): The verification status to support or decline the clinical status of the condition or diagnosis.
subject	Σ	1..1	Reference(KLGateway119Citizen)	[DK] fokusTilstandsubjekt
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Condition.clinicalStatus	required	ConditionClinicalStatusCodes
Condition.verificationStatus	required	ConditionVerificationStatus

Constraints

Id	Grade	Path(s)	Details	Requirements
con-3	best practice	Condition	Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item : clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()
con-4	error	Condition	If condition is abated, then clinicalStatus must be either inactive, resolved, or remission : abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()
con-5	error	Condition	Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error : verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()
dom-2	error	Condition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Condition	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Condition	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Condition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Condition	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
Condition	C	0..*	DkCoreCondition	Detailed information about conditions, problems or diagnoses
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
clinicalStatus	?!ΣC	1..1	CodeableConcept	[DK] tilstandsstatus Binding: ConditionClinicalStatusCodes (required): The clinical status of the condition or diagnosis.
verificationStatus	?!ΣC	0..1	CodeableConcept	unconfirmed | provisional | differential | confirmed | refuted | entered-in-error Binding: ConditionVerificationStatus (required): The verification status to support or decline the clinical status of the condition or diagnosis.
code	Σ	0..1	CodeableConcept	Identification of the condition, problem or diagnosis Binding: Condition/Problem/DiagnosisCodes (example): Identification of the condition or diagnosis.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
Slices for coding	Σ	0..*	Coding	[DK] fokusTilstandskode Slice: Unordered, Open by value:system
coding:All Slices				Content/Rules for all slices
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	0..1	uri	Identity of the terminology system
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
coding:SKS-D	Σ	0..1	Coding	[DA] Kode fra D-hierarkiet i SKS
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Required Pattern: urn:oid:1.2.208.176.2.4.12
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
coding:ICPC2code	Σ	0..1	Coding	ICPC2 code
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Required Pattern: urn:oid:1.2.208.176.2.31
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
text	Σ	0..1	string	[DK] fokusTilstandKodetekst
subject	Σ	1..1	Reference(KLGateway119Citizen)	[DK] fokusTilstandsubjekt
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
Condition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding
Condition.clinicalStatus	required	ConditionClinicalStatusCodes
Condition.verificationStatus	required	ConditionVerificationStatus
Condition.code	example	Condition/Problem/DiagnosisCodes
Condition.stage.summary	example	ConditionStage
Condition.stage.type	example	ConditionStageType
Condition.evidence.code	example	ManifestationAndSymptomCodes

Constraints

Id	Grade	Path(s)	Details	Requirements
con-3	best practice	Condition	Condition.clinicalStatus SHALL be present if verificationStatus is not entered-in-error and category is problem-list-item : clinicalStatus.exists() or verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code = 'entered-in-error').exists() or category.select($this='problem-list-item').empty()
con-4	error	Condition	If condition is abated, then clinicalStatus must be either inactive, resolved, or remission : abatement.empty() or clinicalStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-clinical' and (code='resolved' or code='remission' or code='inactive')).exists()
con-5	error	Condition	Condition.clinicalStatus SHALL NOT be present if verification Status is entered-in-error : verificationStatus.coding.where(system='http://terminology.hl7.org/CodeSystem/condition-ver-status' and code='entered-in-error').empty() or clinicalStatus.empty()
dom-2	error	Condition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Condition	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Condition	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Condition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Condition	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

This structure is derived from DkCoreCondition

Summary

Mandatory: 1 element
Prohibited: 25 elements

Structures

This structure refers to these other structures:

• KLGateway119Citizen (http://fhir.kl.dk/prevention/StructureDefinition/klgateway-119-citizen)