Care Coordination Management, published by Helex OÜ. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/helexlab/ig-ccm/ and changes regularly. See the Directory of published versions
Resource Profile: CareTeamCcm
| Official URL: http://helex.org/ig/ccm/StructureDefinition/care-team-ccm | Version: 0.0.1 | |||
| Draft as of 2025-12-05 | Computable Name: CareTeamCcm | |||
CCM CareTeam profile linking a patient with a ResearchStudy and tracking lifecycle via progress entries.
Usages:
- Refer to this Profile: CarePlanCcm
- Examples for this Profile: CareTeam/care-team-ccm-example
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.
| Name | Flags | Card. | Type | Description & Constraints Filter:   |
|---|---|---|---|---|
  CareTeam |
0..* | CareTeam | Planned participants in the coordination and delivery of care | |
  implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
| contained |
0..* | Resource | Contained, inline Resources | |
 modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored |
| status |
?!SΣ | 1..1 | code | proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates the status of the care team. |
 subject |
SΣ | 1..1 | Reference(PatientCcm) | Who care team is for |
  period |
SΣ | 0..1 | Period | Time period team covers |
 start |
SΣC | 1..1 | dateTime | Starting time with inclusive boundary |
 end |
SΣC | 0..1 | dateTime | End time with inclusive boundary, if not ongoing |
 participant |
SC | 0..* | BackboneElement | Members of the team Constraints: ctm-1, ctm-2 |
 modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| role |
SΣC | 0..1 | 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 |
SΣC | 1..1 | Reference(PractitionerCcm) | Who is involved |
| onBehalfOf |
SΣC | 0..1 | Reference(OrganizationCcm) | Organization of the practitioner |
 Slices for coverage[x] |
1..1 | Period | When the member is generally available within this care team Slice: Unordered, Closed by type:$this | |
  coverage[x]:coveragePeriod |
S | 1..1 | Period | When the member is generally available within this care team |
| Documentation for this format | ||||
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.status | Base | required | Care Team Status | 📍5.0.0 | FHIR Std. |
| CareTeam.participant.role | Base | example | Participant Roles | 📍5.0.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | CareTeam.participant | CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner |
onBehalfOf.exists() implies (member.resolve() is Practitioner)
|
| ctm-2 | warning | CareTeam.participant | CareTeam.participant.role or CareTeam.participant.member exists |
role.exists() or member.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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 CareTeam
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| CareTeam |
0..* | CareTeam | Planned participants in the coordination and delivery of care | |
 identifier |
0..0 | External Ids for this team | ||
| status |
S | 1..1 | code | proposed | active | suspended | inactive | entered-in-error |
| category |
0..0 | Type of team | ||
| name |
0..0 | Name of the team, such as crisis assessment team | ||
| subject |
S | 1..1 | Reference(PatientCcm) | Who care team is for |
| period |
S | 0..1 | Period | Time period team covers |
| start |
S | 1..1 | dateTime | Starting time with inclusive boundary |
| end |
S | 0..1 | dateTime | End time with inclusive boundary, if not ongoing |
| participant |
S | 0..* | BackboneElement | Members of the team |
| role |
S | 0..1 | CodeableConcept | Type of involvement |
| member |
S | 1..1 | Reference(PractitionerCcm) | Who is involved |
| onBehalfOf |
S | 0..1 | Reference(OrganizationCcm) | Organization of the practitioner |
| Slices for coverage[x] |
1..1 | Period | When the member is generally available within this care team Slice: Unordered, Open by type:$this | |
| coverage[x]:coveragePeriod |
S | 1..1 | Period | When the member is generally available within this care team |
| reason |
0..0 | Why the care team exists | ||
| managingOrganization |
0..0 | 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 | ||
| Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| CareTeam |
0..* | CareTeam | Planned participants in the coordination and delivery of care | |||||
| 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: AllLanguages (required): IETF language tag for a human language
| |||||
| 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 | |||||
 extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored | ||||
| status |
?!SΣ | 1..1 | code | proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates the status of the care team. | ||||
| subject |
SΣ | 1..1 | Reference(PatientCcm) | Who care team is for | ||||
| period |
SΣ | 0..1 | Period | Time period team covers | ||||
| id |
0..1 | id | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| start |
SΣC | 1..1 | dateTime | Starting time with inclusive boundary | ||||
| end |
SΣC | 0..1 | dateTime | End time with inclusive boundary, if not ongoing | ||||
| participant |
SC | 0..* | BackboneElement | Members of the team Constraints: ctm-1, ctm-2 | ||||
| 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 |
SΣC | 0..1 | 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 |
SΣC | 1..1 | Reference(PractitionerCcm) | Who is involved | ||||
| onBehalfOf |
SΣC | 0..1 | Reference(OrganizationCcm) | Organization of the practitioner | ||||
| Slices for coverage[x] |
1..1 | Period | When the member is generally available within this care team Slice: Unordered, Closed by type:$this | |||||
| coverage[x]:coveragePeriod |
S | 1..1 | Period | When the member is generally available within this care team | ||||
| Documentation for this format | ||||||||
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| CareTeam.status | Base | required | Care Team Status | 📍5.0.0 | FHIR Std. |
| CareTeam.participant.role | Base | example | Participant Roles | 📍5.0.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | CareTeam.participant | CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner |
onBehalfOf.exists() implies (member.resolve() is Practitioner)
|
| ctm-2 | warning | CareTeam.participant | CareTeam.participant.role or CareTeam.participant.member exists |
role.exists() or member.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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 CareTeam
Summary
Mandatory: 2 elements(4 nested mandatory elements)
Must-Support: 10 elements
Prohibited: 7 elements
Structures
This structure refers to these other structures:
- PatientCcm (http://helex.org/ig/ccm/StructureDefinition/patient-ccm)
- PractitionerCcm (http://helex.org/ig/ccm/StructureDefinition/practitioner-ccm)
- OrganizationCcm (http://helex.org/ig/ccm/StructureDefinition/organization-ccm)
Slices
This structure defines the following Slices:
- The element 1 is sliced based on the value of CareTeam.participant.coverage[x]
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| CareTeam |
0..* | CareTeam | Planned participants in the coordination and delivery of care | |
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
| contained |
0..* | Resource | Contained, inline Resources | |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored |
| status |
?!SΣ | 1..1 | code | proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates the status of the care team. |
| subject |
SΣ | 1..1 | Reference(PatientCcm) | Who care team is for |
| period |
SΣ | 0..1 | Period | Time period team covers |
| start |
SΣC | 1..1 | dateTime | Starting time with inclusive boundary |
| end |
SΣC | 0..1 | dateTime | End time with inclusive boundary, if not ongoing |
| participant |
SC | 0..* | BackboneElement | Members of the team Constraints: ctm-1, ctm-2 |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
| role |
SΣC | 0..1 | 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 |
SΣC | 1..1 | Reference(PractitionerCcm) | Who is involved |
| onBehalfOf |
SΣC | 0..1 | Reference(OrganizationCcm) | Organization of the practitioner |
| Slices for coverage[x] |
1..1 | Period | When the member is generally available within this care team Slice: Unordered, Closed by type:$this | |
| coverage[x]:coveragePeriod |
S | 1..1 | Period | When the member is generally available within this care team |
| Documentation for this format | ||||
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.status | Base | required | Care Team Status | 📍5.0.0 | FHIR Std. |
| CareTeam.participant.role | Base | example | Participant Roles | 📍5.0.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | CareTeam.participant | CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner |
onBehalfOf.exists() implies (member.resolve() is Practitioner)
|
| ctm-2 | warning | CareTeam.participant | CareTeam.participant.role or CareTeam.participant.member exists |
role.exists() or member.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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 CareTeam
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| CareTeam |
0..* | CareTeam | Planned participants in the coordination and delivery of care | |
| identifier |
0..0 | External Ids for this team | ||
| status |
S | 1..1 | code | proposed | active | suspended | inactive | entered-in-error |
| category |
0..0 | Type of team | ||
| name |
0..0 | Name of the team, such as crisis assessment team | ||
| subject |
S | 1..1 | Reference(PatientCcm) | Who care team is for |
| period |
S | 0..1 | Period | Time period team covers |
| start |
S | 1..1 | dateTime | Starting time with inclusive boundary |
| end |
S | 0..1 | dateTime | End time with inclusive boundary, if not ongoing |
| participant |
S | 0..* | BackboneElement | Members of the team |
| role |
S | 0..1 | CodeableConcept | Type of involvement |
| member |
S | 1..1 | Reference(PractitionerCcm) | Who is involved |
| onBehalfOf |
S | 0..1 | Reference(OrganizationCcm) | Organization of the practitioner |
| Slices for coverage[x] |
1..1 | Period | When the member is generally available within this care team Slice: Unordered, Open by type:$this | |
| coverage[x]:coveragePeriod |
S | 1..1 | Period | When the member is generally available within this care team |
| reason |
0..0 | Why the care team exists | ||
| managingOrganization |
0..0 | 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 | ||
| Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| CareTeam |
0..* | CareTeam | Planned participants in the coordination and delivery of care | |||||
| 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: AllLanguages (required): IETF language tag for a human language
| |||||
| 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 | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored | ||||
| status |
?!SΣ | 1..1 | code | proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates the status of the care team. | ||||
| subject |
SΣ | 1..1 | Reference(PatientCcm) | Who care team is for | ||||
| period |
SΣ | 0..1 | Period | Time period team covers | ||||
| id |
0..1 | id | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| start |
SΣC | 1..1 | dateTime | Starting time with inclusive boundary | ||||
| end |
SΣC | 0..1 | dateTime | End time with inclusive boundary, if not ongoing | ||||
| participant |
SC | 0..* | BackboneElement | Members of the team Constraints: ctm-1, ctm-2 | ||||
| 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 |
SΣC | 0..1 | 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 |
SΣC | 1..1 | Reference(PractitionerCcm) | Who is involved | ||||
| onBehalfOf |
SΣC | 0..1 | Reference(OrganizationCcm) | Organization of the practitioner | ||||
| Slices for coverage[x] |
1..1 | Period | When the member is generally available within this care team Slice: Unordered, Closed by type:$this | |||||
| coverage[x]:coveragePeriod |
S | 1..1 | Period | When the member is generally available within this care team | ||||
| Documentation for this format | ||||||||
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| CareTeam.status | Base | required | Care Team Status | 📍5.0.0 | FHIR Std. |
| CareTeam.participant.role | Base | example | Participant Roles | 📍5.0.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | CareTeam.participant | CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner |
onBehalfOf.exists() implies (member.resolve() is Practitioner)
|
| ctm-2 | warning | CareTeam.participant | CareTeam.participant.role or CareTeam.participant.member exists |
role.exists() or member.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().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(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 CareTeam
Summary
Mandatory: 2 elements(4 nested mandatory elements)
Must-Support: 10 elements
Prohibited: 7 elements
Structures
This structure refers to these other structures:
- PatientCcm (http://helex.org/ig/ccm/StructureDefinition/patient-ccm)
- PractitionerCcm (http://helex.org/ig/ccm/StructureDefinition/practitioner-ccm)
- OrganizationCcm (http://helex.org/ig/ccm/StructureDefinition/organization-ccm)
Slices
This structure defines the following Slices:
- The element 1 is sliced based on the value of CareTeam.participant.coverage[x]
Other representations of profile: CSV, Excel, Schematron