Koppeltaal 2.0 Implementation Guide (Full Documentation)
0.16.2 - ci-build NL

Koppeltaal 2.0 Implementation Guide (Full Documentation) - Local Development build (v0.16.2) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: KT2_CareTeam

Official URL: http://koppeltaal.nl/fhir/StructureDefinition/KT2CareTeam Version: 0.16.2
Draft as of 2023-01-24 Computable Name: KT2_CareTeam

Copyright/Legal: VZVZ

The CareTeam resource represents a group of healthcare professionals and related persons who collaborate to provide coordinated care and treatment for a patient. It defines the roles and participants involved in delivering healthcare services within the Koppeltaal ecosystem.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* NlcoreCareTeam CareTeam
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:resource-origin 0..1 Reference(KT2_Device) Extension
URL: http://koppeltaal.nl/fhir/StructureDefinition/resource-origin
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!Σ 1..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... subject Σ 1..1 Reference(KT2_Patient) Patient treated by this care team
... Slices for participant C 0..* BackboneElement Members of the team
Slice: Unordered, Open by profile:member.resolve()
Constraints: ctm-1
.... participant:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... participant:kt2contactperson C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal RelatedPerson Role ValueSet (extensible): Koppeltaal authorization roles for RelatedPersons in a CareTeam.
..... member Σ 0..1 Reference(KT2_RelatedPerson) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2healthcareProfessional C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal Practitioner Role ValueSet (extensible): SNOMED CT authorization roles for Practitioners in a CareTeam (extends ZorgverlenerRolCodelijst).
..... member Σ 0..1 Reference(KT2_Practitioner) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
... managingOrganization Σ 0..1 Reference(KT2_Organization) Organization responsible for the care team

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role:healthProfessionalRole Base required ZorgverlenerRolCodelijst 📦2020-09-01T00:00:00 FHIR implementation of zibs 2020 v0.12
CareTeam.participant:kt2contactperson.​role Base extensible Koppeltaal RelatedPerson Role ValueSet 📦0.16.2 This IG
CareTeam.participant:kt2healthcareProfessional.​role Base extensible Koppeltaal Practitioner Role ValueSet 📦0.16.2 This IG

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant, CareTeam.participant:kt2contactperson, CareTeam.participant:kt2healthcareProfessional CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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 NlcoreCareTeam

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* NlcoreCareTeam CareTeam
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:resource-origin 0..1 Reference(KT2_Device) Extension
URL: http://koppeltaal.nl/fhir/StructureDefinition/resource-origin
... identifier 1..* Identifier External Ids for this team
... status 1..1 code proposed | active | suspended | inactive | entered-in-error
... subject 1..1 Reference(KT2_Patient) Patient treated by this care team
... encounter 0..0 Encounter created as part of
... participant 0..* BackboneElement Members of the team
... Slices for participant Content/Rules for all slices
.... participant:contactPerson 0..0 Members of the team
.... participant:patient 0..0 Members of the team
.... participant:healthcareProfessional 0..0 Members of the team
.... participant:kt2contactperson 0..* BackboneElement Members of the team
..... role 0..* CodeableConcept Type of involvement
Binding: Koppeltaal RelatedPerson Role ValueSet (extensible): Koppeltaal authorization roles for RelatedPersons in a CareTeam.
..... member 0..1 Reference(KT2_RelatedPerson) Who is involved
..... onBehalfOf 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2healthcareProfessional 0..* BackboneElement Members of the team
..... role 0..* CodeableConcept Type of involvement
Binding: Koppeltaal Practitioner Role ValueSet (extensible): SNOMED CT authorization roles for Practitioners in a CareTeam (extends ZorgverlenerRolCodelijst).
..... member 0..1 Reference(KT2_Practitioner) Who is involved
..... onBehalfOf 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
... reasonCode 0..0 Why the care team exists
... reasonReference 0..0 Problem
... managingOrganization 0..1 Reference(KT2_Organization) Organization responsible for the care team
... telecom 0..0 A contact detail for the care team (that applies to all members)
... note 0..0 Comments made about the CareTeam

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
CareTeam.participant:kt2contactperson.​role Base extensible Koppeltaal RelatedPerson Role ValueSet 📦0.16.2 This IG
CareTeam.participant:kt2healthcareProfessional.​role Base extensible Koppeltaal Practitioner Role ValueSet 📦0.16.2 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* NlcoreCareTeam CareTeam
... 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
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:resource-origin 0..1 Reference(KT2_Device) Extension
URL: http://koppeltaal.nl/fhir/StructureDefinition/resource-origin
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 1..* Identifier External Ids for this team
... status ?!Σ 1..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... name Σ 0..1 string CareTeamName
... subject Σ 1..1 Reference(KT2_Patient) Patient treated by this care team
... period Σ 0..1 Period Time period team covers
... Slices for participant C 0..* BackboneElement Members of the team
Slice: Unordered, Open by profile:member.resolve()
Constraints: ctm-1
.... participant: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
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: ParticipantRoles (example): Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc.
..... member Σ 0..1 Reference(Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2contactperson C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal RelatedPerson Role ValueSet (extensible): Koppeltaal authorization roles for RelatedPersons in a CareTeam.
..... member Σ 0..1 Reference(KT2_RelatedPerson) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2healthcareProfessional C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal Practitioner Role ValueSet (extensible): SNOMED CT authorization roles for Practitioners in a CareTeam (extends ZorgverlenerRolCodelijst).
..... member Σ 0..1 Reference(KT2_Practitioner) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
... managingOrganization Σ 0..1 Reference(KT2_Organization) Organization responsible for the care team

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:contactPerson.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:patient.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role:healthProfessionalRole Base required ZorgverlenerRolCodelijst 📦2020-09-01T00:00:00 FHIR implementation of zibs 2020 v0.12
CareTeam.participant:kt2contactperson.​role Base extensible Koppeltaal RelatedPerson Role ValueSet 📦0.16.2 This IG
CareTeam.participant:kt2healthcareProfessional.​role Base extensible Koppeltaal Practitioner Role ValueSet 📦0.16.2 This IG

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant, CareTeam.participant:kt2contactperson, CareTeam.participant:kt2healthcareProfessional CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* NlcoreCareTeam CareTeam
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:resource-origin 0..1 Reference(KT2_Device) Extension
URL: http://koppeltaal.nl/fhir/StructureDefinition/resource-origin
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!Σ 1..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... subject Σ 1..1 Reference(KT2_Patient) Patient treated by this care team
... Slices for participant C 0..* BackboneElement Members of the team
Slice: Unordered, Open by profile:member.resolve()
Constraints: ctm-1
.... participant:All Slices Content/Rules for all slices
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... participant:kt2contactperson C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal RelatedPerson Role ValueSet (extensible): Koppeltaal authorization roles for RelatedPersons in a CareTeam.
..... member Σ 0..1 Reference(KT2_RelatedPerson) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2healthcareProfessional C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal Practitioner Role ValueSet (extensible): SNOMED CT authorization roles for Practitioners in a CareTeam (extends ZorgverlenerRolCodelijst).
..... member Σ 0..1 Reference(KT2_Practitioner) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
... managingOrganization Σ 0..1 Reference(KT2_Organization) Organization responsible for the care team

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role:healthProfessionalRole Base required ZorgverlenerRolCodelijst 📦2020-09-01T00:00:00 FHIR implementation of zibs 2020 v0.12
CareTeam.participant:kt2contactperson.​role Base extensible Koppeltaal RelatedPerson Role ValueSet 📦0.16.2 This IG
CareTeam.participant:kt2healthcareProfessional.​role Base extensible Koppeltaal Practitioner Role ValueSet 📦0.16.2 This IG

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant, CareTeam.participant:kt2contactperson, CareTeam.participant:kt2healthcareProfessional CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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 NlcoreCareTeam

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* NlcoreCareTeam CareTeam
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:resource-origin 0..1 Reference(KT2_Device) Extension
URL: http://koppeltaal.nl/fhir/StructureDefinition/resource-origin
... identifier 1..* Identifier External Ids for this team
... status 1..1 code proposed | active | suspended | inactive | entered-in-error
... subject 1..1 Reference(KT2_Patient) Patient treated by this care team
... encounter 0..0 Encounter created as part of
... participant 0..* BackboneElement Members of the team
... Slices for participant Content/Rules for all slices
.... participant:contactPerson 0..0 Members of the team
.... participant:patient 0..0 Members of the team
.... participant:healthcareProfessional 0..0 Members of the team
.... participant:kt2contactperson 0..* BackboneElement Members of the team
..... role 0..* CodeableConcept Type of involvement
Binding: Koppeltaal RelatedPerson Role ValueSet (extensible): Koppeltaal authorization roles for RelatedPersons in a CareTeam.
..... member 0..1 Reference(KT2_RelatedPerson) Who is involved
..... onBehalfOf 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2healthcareProfessional 0..* BackboneElement Members of the team
..... role 0..* CodeableConcept Type of involvement
Binding: Koppeltaal Practitioner Role ValueSet (extensible): SNOMED CT authorization roles for Practitioners in a CareTeam (extends ZorgverlenerRolCodelijst).
..... member 0..1 Reference(KT2_Practitioner) Who is involved
..... onBehalfOf 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
... reasonCode 0..0 Why the care team exists
... reasonReference 0..0 Problem
... managingOrganization 0..1 Reference(KT2_Organization) Organization responsible for the care team
... telecom 0..0 A contact detail for the care team (that applies to all members)
... note 0..0 Comments made about the CareTeam

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
CareTeam.participant:kt2contactperson.​role Base extensible Koppeltaal RelatedPerson Role ValueSet 📦0.16.2 This IG
CareTeam.participant:kt2healthcareProfessional.​role Base extensible Koppeltaal Practitioner Role ValueSet 📦0.16.2 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* NlcoreCareTeam CareTeam
... 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
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:resource-origin 0..1 Reference(KT2_Device) Extension
URL: http://koppeltaal.nl/fhir/StructureDefinition/resource-origin
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 1..* Identifier External Ids for this team
... status ?!Σ 1..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... name Σ 0..1 string CareTeamName
... subject Σ 1..1 Reference(KT2_Patient) Patient treated by this care team
... period Σ 0..1 Period Time period team covers
... Slices for participant C 0..* BackboneElement Members of the team
Slice: Unordered, Open by profile:member.resolve()
Constraints: ctm-1
.... participant: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
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: ParticipantRoles (example): Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc.
..... member Σ 0..1 Reference(Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2contactperson C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal RelatedPerson Role ValueSet (extensible): Koppeltaal authorization roles for RelatedPersons in a CareTeam.
..... member Σ 0..1 Reference(KT2_RelatedPerson) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
.... participant:kt2healthcareProfessional C 0..* BackboneElement Members of the team
Constraints: ctm-1
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... role Σ 0..* CodeableConcept Type of involvement
Binding: Koppeltaal Practitioner Role ValueSet (extensible): SNOMED CT authorization roles for Practitioners in a CareTeam (extends ZorgverlenerRolCodelijst).
..... member Σ 0..1 Reference(KT2_Practitioner) Who is involved
..... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
..... period 0..1 Period Time period of participant
... managingOrganization Σ 0..1 Reference(KT2_Organization) Organization responsible for the care team

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:contactPerson.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:patient.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role Base example Participant Roles 📦4.0.1 FHIR Std.
CareTeam.participant:healthcareProfessional.​role:healthProfessionalRole Base required ZorgverlenerRolCodelijst 📦2020-09-01T00:00:00 FHIR implementation of zibs 2020 v0.12
CareTeam.participant:kt2contactperson.​role Base extensible Koppeltaal RelatedPerson Role ValueSet 📦0.16.2 This IG
CareTeam.participant:kt2healthcareProfessional.​role Base extensible Koppeltaal Practitioner Role ValueSet 📦0.16.2 This IG

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant, CareTeam.participant:kt2contactperson, CareTeam.participant:kt2healthcareProfessional CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

Subject element

If the CareTeam is involved in the care of a specific patient, the subject element MUST contain a reference to indicate that specific patient.

Otherwise the subject element remains absent.

Participant Role

For a healthcare professional the only applicable slice of CareTeam.participant is the slice kt2healthcareProfessional. This means the reference to the Practitioner should comply with the KT2_Practitioner profile. The role should comply to the codes defined in the KoppeltaalPractitionerRoleValueSet, which extends the ZorgverlenerRolCodelijst with SNOMED CT authorization roles.

For a RelatedPerson the applicable slice of CareTeam.participant is the slice kt2contactperson. This means the reference to the RelatedPerson should comply with the KT2_RelatedPerson profile. The role should comply to the codes defined in the KoppeltaalRelatedPersonRoleValueSet.

See Rol Code Mapping for detailed information on how roles map to authorization levels.

Validation: CareTeam operations

When performing an action related to a CareTeam, applications must verify that the CareTeam has a relationship with the associated patient and that the CareTeam is active. This is necessary because the status and participants of a CareTeam change over time. This validation must be performed for all operations involving a CareTeam. This includes but is not limited to:

  • Assigning digital interventions to a CareTeam participant
  • Opening digital interventions by a CareTeam participant
  • Notifying CareTeam participants of events

Applications MUST validate that:

  • CareTeam.subject equals the associated Patient
  • CareTeam.status = active
  • If CareTeam.period is populated, the current date-time must fall within this period

If these validations fail, the application MUST NOT perform the operation.