Health New Zealand Te Whatu Ora Shared Care FHIR API
0.4.5 - release
Health New Zealand Te Whatu Ora Shared Care FHIR API
0.4.5 - release
Health New Zealand Te Whatu Ora Shared Care FHIR API - Local Development build (v0.4.5) 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-08-11 | 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". | ||||
   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". | ||||
| 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
