Health New Zealand Te Whatu Ora Shared Care FHIR API
0.4.7 - release
Health New Zealand Te Whatu Ora Shared Care FHIR API
0.4.7 - release
Health New Zealand Te Whatu Ora Shared Care FHIR API - Local Development build (v0.4.7) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/nz-sharedcare-communication-person | Version: 0.0.1 | |||
| Active as of 2026-10-13 | Computable Name: CommunicationPerson | |||
A person resource used to record contact preferences for a person who is part of an HNZ cohort.
Records communication preferences for a person who is part of an HNZ cohort
Usages:
You can also check for usages in the FHIR IG Statistics
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints Filter:  |
|---|---|---|---|---|
  Person |
0..* | Person | A generic person record | |
  implicitRules |
0..1 | uri | A set of rules under which this content was created | |
 modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |
 active |
0..1 | boolean | This person's record is in active use | |
| Documentation for this format | ||||
| Id | Grade | Path(s) | Description | Expression |
This structure is derived from Person
| Path | Status | Usage | ValueSet | Version | Source |
| Person.meta.source | Base | required | Information source when using the telecom information source extension | 📦1.0.0 | This IG |
| Person.meta.tag:PurposeOfUse | Base | required | NZ purpose of use | 📦20240725 | This IG |
| Person.meta.tag:LastUpdatedBy | Base | required | System that last updated the record | 📦1.0.0 | This IG |
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Person |
0..* | Person | A generic person record | |||||
| id |
0..1 | id | Logical id of this artifact | |||||
  meta |
0..1 | Meta | Metadata about the resource | |||||
 id |
0..1 | string | Unique id for inter-element referencing | |||||
 extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| versionId |
0..1 | id | Version specific identifier | |||||
| lastUpdated |
0..1 | instant | When the resource version last changed | |||||
| source |
1..1 | uri | Identifies where the resource comes from Binding: Information source when using the telecom information source extension (required) | |||||
| profile |
1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to | |||||
| security |
0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | |||||
  Slices for tag |
2..* | Coding | Tags applied to this resource Slice: Unordered, Open by pattern:$this Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones". Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |||||
   tag:PurposeOfUse |
1..1 | Coding | Tags applied to this resource Binding: NZ purpose of use (required) | |||||
 tag:LastUpdatedBy |
1..1 | Coding | Tags applied to this resource Binding: System that last updated the record (required) | |||||
| 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.
| |||||
| 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 | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |||||
| identifier |
0..* | Identifier | A human identifier for this person | |||||
| name |
0..* | HumanName | A name associated with the person | |||||
| telecom |
0..* | ContactPoint | A contact detail for the person | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| Slices for extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| extension:SmartContactDetailScore |
0..* | (Complex) | HNZ Person Telecom Score URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-score-extension-id | |||||
| extension:SmartContactCountShared |
0..1 | integer | HNZ Person Telecom Count Shared URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-count-shared-extension-id | |||||
| extension:SmartContactLastContacted |
0..1 | dateTime | HNZ Person Telecom Last Contacted URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-last-contacted-extension-id | |||||
| extension:SmartContactPhoneType |
0..1 | Coding | HNZ Person Telecom Phone Type URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-phone-type-extension-id Binding: Telecom phone type indicator (required) | |||||
| extension:SmartContactInvalidIndicator |
0..1 | (Complex) | HNZ Person Telecom Invalid Indicator URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-invalid-indicator-extension-id | |||||
| system |
C | 0..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. | ||||
| value |
0..1 | string | The actual contact point details | |||||
| use |
0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point. | |||||
| rank |
0..1 | positiveInt | Specify preferred order of use (1 = highest) | |||||
| period |
0..1 | Period | Time period when the contact point was/is in use | |||||
 managingOrganization |
0..1 | Reference(Organization) | The organization that is the custodian of the person record | |||||
| active |
0..1 | boolean | This person's record is in active use | |||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Person.meta.source | Base | required | Information source when using the telecom information source extension | 📦1.0.0 | This IG |
| Person.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std. |
| Person.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std. |
| Person.meta.tag:PurposeOfUse | Base | required | NZ purpose of use | 📦20240725 | This IG |
| Person.meta.tag:LastUpdatedBy | Base | required | System that last updated the record | 📦1.0.0 | This IG |
| Person.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Person.telecom.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std. |
| Person.telecom.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std. |
| Person.link.assurance | Base | required | IdentityAssuranceLevel | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
This structure is derived from Person
Summary
Mandatory: 0 element(4 nested mandatory elements)
Prohibited: 6 elements
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Person |
0..* | Person | A generic person record | |
| implicitRules |
0..1 | uri | A set of rules under which this content was created | |
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |
| active |
0..1 | boolean | This person's record is in active use | |
| Documentation for this format | ||||
| Id | Grade | Path(s) | Description | Expression |
Differential View
This structure is derived from Person
| Path | Status | Usage | ValueSet | Version | Source |
| Person.meta.source | Base | required | Information source when using the telecom information source extension | 📦1.0.0 | This IG |
| Person.meta.tag:PurposeOfUse | Base | required | NZ purpose of use | 📦20240725 | This IG |
| Person.meta.tag:LastUpdatedBy | Base | required | System that last updated the record | 📦1.0.0 | This IG |
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Person |
0..* | Person | A generic person record | |||||
| id |
0..1 | id | Logical id of this artifact | |||||
| meta |
0..1 | Meta | Metadata about the resource | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| versionId |
0..1 | id | Version specific identifier | |||||
| lastUpdated |
0..1 | instant | When the resource version last changed | |||||
| source |
1..1 | uri | Identifies where the resource comes from Binding: Information source when using the telecom information source extension (required) | |||||
| profile |
1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to | |||||
| security |
0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System. | |||||
| Slices for tag |
2..* | Coding | Tags applied to this resource Slice: Unordered, Open by pattern:$this Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones". Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |||||
| tag:PurposeOfUse |
1..1 | Coding | Tags applied to this resource Binding: NZ purpose of use (required) | |||||
| tag:LastUpdatedBy |
1..1 | Coding | Tags applied to this resource Binding: System that last updated the record (required) | |||||
| 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.
| |||||
| 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 | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |||||
| identifier |
0..* | Identifier | A human identifier for this person | |||||
| name |
0..* | HumanName | A name associated with the person | |||||
| telecom |
0..* | ContactPoint | A contact detail for the person | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| Slices for extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| extension:SmartContactDetailScore |
0..* | (Complex) | HNZ Person Telecom Score URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-score-extension-id | |||||
| extension:SmartContactCountShared |
0..1 | integer | HNZ Person Telecom Count Shared URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-count-shared-extension-id | |||||
| extension:SmartContactLastContacted |
0..1 | dateTime | HNZ Person Telecom Last Contacted URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-last-contacted-extension-id | |||||
| extension:SmartContactPhoneType |
0..1 | Coding | HNZ Person Telecom Phone Type URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-phone-type-extension-id Binding: Telecom phone type indicator (required) | |||||
| extension:SmartContactInvalidIndicator |
0..1 | (Complex) | HNZ Person Telecom Invalid Indicator URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-telecom-invalid-indicator-extension-id | |||||
| system |
C | 0..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point. | ||||
| value |
0..1 | string | The actual contact point details | |||||
| use |
0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point. | |||||
| rank |
0..1 | positiveInt | Specify preferred order of use (1 = highest) | |||||
| period |
0..1 | Period | Time period when the contact point was/is in use | |||||
| managingOrganization |
0..1 | Reference(Organization) | The organization that is the custodian of the person record | |||||
| active |
0..1 | boolean | This person's record is in active use | |||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Person.meta.source | Base | required | Information source when using the telecom information source extension | 📦1.0.0 | This IG |
| Person.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std. |
| Person.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std. |
| Person.meta.tag:PurposeOfUse | Base | required | NZ purpose of use | 📦20240725 | This IG |
| Person.meta.tag:LastUpdatedBy | Base | required | System that last updated the record | 📦1.0.0 | This IG |
| Person.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Person.telecom.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std. |
| Person.telecom.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std. |
| Person.link.assurance | Base | required | IdentityAssuranceLevel | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
This structure is derived from Person
Summary
Mandatory: 0 element(4 nested mandatory elements)
Prohibited: 6 elements
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Other representations of profile: CSV, Excel, Schematron
