Health New Zealand Te Whatu Ora Shared Care FHIR API
0.4.3 - release

Health New Zealand Te Whatu Ora Shared Care FHIR API - Local Development build (v0.4.3) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Resource Profile: CMS Communication

Official URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/CMSCommunication | Version: 0.0.1
Active as of 2025-11-25 | Computable Name: CMSCommunication

A communication Resource used to record the SMS/EMAIL communication performed by Systems

Record all the SMS/EMAIL communication performed by any system

Usages:

- Examples for this Profile: Communication/EmailCommunicationExample, Communication/OutreachCommunicationExample and Communication/SMSCommunicationExample
- CapabilityStatements using this Profile: Shared Care FHIR Server Capability Statement

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.

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

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Communication |  | 0..* | Communication | A record of information transmitted from a sender to a receiver
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:Campaign |  | 0..1 | (Complex) | Campaign details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
extension:ContactPoint |  | 1..1 | (Complex) | Send to and from communication to contact points URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
extension:CallbackUrl |  | 0..1 | url | Callback Url URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
extension:StatusDateTime |  | 1..1 | dateTime | Status DateTime URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
extension:Reply |  | 0..1 | (Complex) | For sms reply URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | Unique identifier
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | The value that is unique Example General: 123456
basedOn | Σ | 0..1 | Reference(Resource) | Request fulfilled by this communication
status | ?!Σ | 1..1 | code | preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown Binding: EventStatus (required): The status of the communication.
statusReason | Σ | 0..1 | CodeableConcept | Reason for current status Binding: Valueset for Communication Delivery Status (required)
category |  | 0..1 | CodeableConcept | Message category Binding: CommunicationCategory (example): Codes for general categories of communications such as alerts, instructions, etc.
medium |  | 1..* | CodeableConcept | A channel of communication Binding: Valueset for Participation Mode (required)
subject | Σ | 0..1 | Reference(Patient) | Focus of message
sent |  | 0..1 | dateTime | Must be in UTC timezone on the FHIR server
recipient |  | 0..* | Reference(Patient | Practitioner) | Message recipient
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Communication.identifier.use | required | IdentifierUse `http://hl7.org/fhir/ValueSet/identifier-use|4.0.1` From the FHIR Standard
Communication.status | required | EventStatus `http://hl7.org/fhir/ValueSet/event-status|4.0.1` From the FHIR Standard
Communication.statusReason | required | CommunicationDeliveryStatusValueSet(a valid code from Codes for CommunicationStatus) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-communication-delivery-status-valueset` From this IG
Communication.category | example | CommunicationCategory `http://hl7.org/fhir/ValueSet/communication-category` From the FHIR Standard
Communication.medium | required | ParticipationModeValueSet(a valid code from ParticipationMode) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-participation-mode-valueset` From this IG

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Communication | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Communication | 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 | Communication | 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 | Communication | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Communication | 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 Communication

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Communication |  | 0..* | Communication | A record of information transmitted from a sender to a receiver
meta |  |  |  |
profile |  | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to
contained |  | 0..0 |  |
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:Campaign |  | 0..1 | (Complex) | Campaign details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
extension:ContactPoint |  | 1..1 | (Complex) | Send to and from communication to contact points URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
extension:CallbackUrl |  | 0..1 | url | Callback Url URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
extension:StatusDateTime |  | 1..1 | dateTime | Status DateTime URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
extension:Reply |  | 0..1 | (Complex) | For sms reply URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
identifier |  | 1..* | Identifier | Unique identifier
use |  | 1..1 | code | usual | official | temp | secondary | old (If known)
system |  | 1..1 | uri | The namespace for the identifier value
value |  | 1..1 | string | The value that is unique
basedOn |  | 0..1 | Reference(Resource) | Request fulfilled by this communication
statusReason |  | 0..1 | CodeableConcept | Reason for current status Binding: Valueset for Communication Delivery Status (required)
category |  | 0..1 | CodeableConcept | Message category
medium |  | 1..* | CodeableConcept | A channel of communication Binding: Valueset for Participation Mode (required)
subject |  | 0..1 | Reference(Patient) | Focus of message
sent |  | 0..1 | dateTime | Must be in UTC timezone on the FHIR server
recipient |  | 0..* | Reference(Patient | Practitioner) | Message recipient
payload |  |  |  |
Slices for content[x] |  | 1..1 | string, Attachment, Reference(Resource) | Message part content Slice: Unordered, Open by type:$this
content[x]:contentAttachment |  | 0..1 | Attachment | Message part content
Slices for extension |  |  |  | Content/Rules for all slices
extension:AttachmentExtension |  | 0..1 | (Complex) | Attachment details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-attachment-extension
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
Communication.statusReason | required | CommunicationDeliveryStatusValueSet(a valid code from Codes for CommunicationStatus) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-communication-delivery-status-valueset` From this IG
Communication.medium | required | ParticipationModeValueSet(a valid code from ParticipationMode) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-participation-mode-valueset` From this IG

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Communication |  | 0..* | Communication | A record of information transmitted from a sender to a receiver
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 | Σ | 0..1 | uri | Identifies where the resource comes from
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.
tag | Σ | 0..* | Coding | Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
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 This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:Campaign |  | 0..1 | (Complex) | Campaign details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
extension:ContactPoint |  | 1..1 | (Complex) | Send to and from communication to contact points URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
extension:CallbackUrl |  | 0..1 | url | Callback Url URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
extension:StatusDateTime |  | 1..1 | dateTime | Status DateTime URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
extension:Reply |  | 0..1 | (Complex) | For sms reply URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | Unique identifier
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | The value that is unique Example General: 123456
period | Σ | 0..1 | Period | Time period when id is/was valid for use
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
instantiatesCanonical | Σ | 0..* | canonical(PlanDefinition | ActivityDefinition | Measure | OperationDefinition | Questionnaire) | Instantiates FHIR protocol or definition
instantiatesUri | Σ | 0..* | uri | Instantiates external protocol or definition
basedOn | Σ | 0..1 | Reference(Resource) | Request fulfilled by this communication
partOf | Σ | 0..* | Reference(Resource) | Part of this action
inResponseTo |  | 0..* | Reference(Communication) | Reply to
status | ?!Σ | 1..1 | code | preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown Binding: EventStatus (required): The status of the communication.
statusReason | Σ | 0..1 | CodeableConcept | Reason for current status Binding: Valueset for Communication Delivery Status (required)
category |  | 0..1 | CodeableConcept | Message category Binding: CommunicationCategory (example): Codes for general categories of communications such as alerts, instructions, etc.
priority | Σ | 0..1 | code | routine | urgent | asap | stat Binding: RequestPriority (required): Codes indicating the relative importance of a communication.
medium |  | 1..* | CodeableConcept | A channel of communication Binding: Valueset for Participation Mode (required)
subject | Σ | 0..1 | Reference(Patient) | Focus of message
topic |  | 0..1 | CodeableConcept | Description of the purpose/content Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.
about |  | 0..* | Reference(Resource) | Resources that pertain to this communication
encounter | Σ | 0..1 | Reference(Encounter) | Encounter created as part of
sent |  | 0..1 | dateTime | Must be in UTC timezone on the FHIR server
received |  | 0..1 | dateTime | When received
recipient |  | 0..* | Reference(Patient | Practitioner) | Message recipient
sender |  | 0..1 | Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson | HealthcareService) | Message sender
reasonCode | Σ | 0..* | CodeableConcept | Indication for message Binding: SNOMEDCTClinicalFindings (example): Codes for describing reasons for the occurrence of a communication.
reasonReference | Σ | 0..* | Reference(Condition | Observation | DiagnosticReport | DocumentReference) | Why was communication done?
payload |  | 0..* | BackboneElement | Message payload
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
Slices for content[x] |  | 1..1 |  | Message part content Slice: Unordered, Open by type:$this
contentString |  |  | string |
contentAttachment |  |  | Attachment |
contentReference |  |  | Reference(Resource) |
content[x]:contentAttachment |  | 0..1 | Attachment | Message part content
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:AttachmentExtension |  | 0..1 | (Complex) | Attachment details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-attachment-extension
contentType | Σ | 0..1 | code | Mime type of the content, with charset etc. Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png
language | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
Example General: en-AU
data |  | 0..1 | base64Binary | Data inline, base64ed
url | Σ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png
size | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided)
hash | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed)
title | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo
creation | Σ | 0..1 | dateTime | Date attachment was first created
note |  | 0..* | Annotation | Comments made about the communication
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Communication.meta.security | extensible | All Security Labels `http://hl7.org/fhir/ValueSet/security-labels` From the FHIR Standard
Communication.meta.tag | example | CommonTags `http://hl7.org/fhir/ValueSet/common-tags` From the FHIR Standard
Communication.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
Communication.identifier.use | required | IdentifierUse `http://hl7.org/fhir/ValueSet/identifier-use|4.0.1` From the FHIR Standard
Communication.identifier.type | extensible | Identifier Type Codes `http://hl7.org/fhir/ValueSet/identifier-type` From the FHIR Standard
Communication.status | required | EventStatus `http://hl7.org/fhir/ValueSet/event-status|4.0.1` From the FHIR Standard
Communication.statusReason | required | CommunicationDeliveryStatusValueSet(a valid code from Codes for CommunicationStatus) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-communication-delivery-status-valueset` From this IG
Communication.category | example | CommunicationCategory `http://hl7.org/fhir/ValueSet/communication-category` From the FHIR Standard
Communication.priority | required | RequestPriority `http://hl7.org/fhir/ValueSet/request-priority|4.0.1` From the FHIR Standard
Communication.medium | required | ParticipationModeValueSet(a valid code from ParticipationMode) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-participation-mode-valueset` From this IG
Communication.topic | example | CommunicationTopic `http://hl7.org/fhir/ValueSet/communication-topic` From the FHIR Standard
Communication.reasonCode | example | SNOMEDCTClinicalFindings `http://hl7.org/fhir/ValueSet/clinical-findings` From the FHIR Standard
Communication.payload.content[x]:contentAttachment.contentType | required | Mime Types(a valid code from `urn:ietf:bcp:13`) `http://hl7.org/fhir/ValueSet/mimetypes|4.0.1` From the FHIR Standard
Communication.payload.content[x]:contentAttachment.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Communication | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Communication | 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 | Communication | 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 | Communication | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Communication | 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 Communication

Summary

Mandatory: 7 elements(1 nested mandatory element)
Prohibited: 1 element

Extensions

This structure refers to these extensions:

- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-attachment-extension

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of Communication.payload.content[x]

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Communication |  | 0..* | Communication | A record of information transmitted from a sender to a receiver
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:Campaign |  | 0..1 | (Complex) | Campaign details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
extension:ContactPoint |  | 1..1 | (Complex) | Send to and from communication to contact points URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
extension:CallbackUrl |  | 0..1 | url | Callback Url URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
extension:StatusDateTime |  | 1..1 | dateTime | Status DateTime URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
extension:Reply |  | 0..1 | (Complex) | For sms reply URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | Unique identifier
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | The value that is unique Example General: 123456
basedOn | Σ | 0..1 | Reference(Resource) | Request fulfilled by this communication
status | ?!Σ | 1..1 | code | preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown Binding: EventStatus (required): The status of the communication.
statusReason | Σ | 0..1 | CodeableConcept | Reason for current status Binding: Valueset for Communication Delivery Status (required)
category |  | 0..1 | CodeableConcept | Message category Binding: CommunicationCategory (example): Codes for general categories of communications such as alerts, instructions, etc.
medium |  | 1..* | CodeableConcept | A channel of communication Binding: Valueset for Participation Mode (required)
subject | Σ | 0..1 | Reference(Patient) | Focus of message
sent |  | 0..1 | dateTime | Must be in UTC timezone on the FHIR server
recipient |  | 0..* | Reference(Patient | Practitioner) | Message recipient
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Communication.identifier.use | required | IdentifierUse `http://hl7.org/fhir/ValueSet/identifier-use|4.0.1` From the FHIR Standard
Communication.status | required | EventStatus `http://hl7.org/fhir/ValueSet/event-status|4.0.1` From the FHIR Standard
Communication.statusReason | required | CommunicationDeliveryStatusValueSet(a valid code from Codes for CommunicationStatus) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-communication-delivery-status-valueset` From this IG
Communication.category | example | CommunicationCategory `http://hl7.org/fhir/ValueSet/communication-category` From the FHIR Standard
Communication.medium | required | ParticipationModeValueSet(a valid code from ParticipationMode) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-participation-mode-valueset` From this IG

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Communication | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Communication | 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 | Communication | 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 | Communication | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Communication | 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 Communication

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Communication |  | 0..* | Communication | A record of information transmitted from a sender to a receiver
meta |  |  |  |
profile |  | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to
contained |  | 0..0 |  |
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:Campaign |  | 0..1 | (Complex) | Campaign details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
extension:ContactPoint |  | 1..1 | (Complex) | Send to and from communication to contact points URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
extension:CallbackUrl |  | 0..1 | url | Callback Url URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
extension:StatusDateTime |  | 1..1 | dateTime | Status DateTime URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
extension:Reply |  | 0..1 | (Complex) | For sms reply URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
identifier |  | 1..* | Identifier | Unique identifier
use |  | 1..1 | code | usual | official | temp | secondary | old (If known)
system |  | 1..1 | uri | The namespace for the identifier value
value |  | 1..1 | string | The value that is unique
basedOn |  | 0..1 | Reference(Resource) | Request fulfilled by this communication
statusReason |  | 0..1 | CodeableConcept | Reason for current status Binding: Valueset for Communication Delivery Status (required)
category |  | 0..1 | CodeableConcept | Message category
medium |  | 1..* | CodeableConcept | A channel of communication Binding: Valueset for Participation Mode (required)
subject |  | 0..1 | Reference(Patient) | Focus of message
sent |  | 0..1 | dateTime | Must be in UTC timezone on the FHIR server
recipient |  | 0..* | Reference(Patient | Practitioner) | Message recipient
payload |  |  |  |
Slices for content[x] |  | 1..1 | string, Attachment, Reference(Resource) | Message part content Slice: Unordered, Open by type:$this
content[x]:contentAttachment |  | 0..1 | Attachment | Message part content
Slices for extension |  |  |  | Content/Rules for all slices
extension:AttachmentExtension |  | 0..1 | (Complex) | Attachment details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-attachment-extension
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
Communication.statusReason | required | CommunicationDeliveryStatusValueSet(a valid code from Codes for CommunicationStatus) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-communication-delivery-status-valueset` From this IG
Communication.medium | required | ParticipationModeValueSet(a valid code from ParticipationMode) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-participation-mode-valueset` From this IG

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Communication |  | 0..* | Communication | A record of information transmitted from a sender to a receiver
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 | Σ | 0..1 | uri | Identifies where the resource comes from
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.
tag | Σ | 0..* | Coding | Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
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 This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Slices for extension |  | 2..* | Extension | Extension Slice: Unordered, Open by value:url
extension:Campaign |  | 0..1 | (Complex) | Campaign details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
extension:ContactPoint |  | 1..1 | (Complex) | Send to and from communication to contact points URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
extension:CallbackUrl |  | 0..1 | url | Callback Url URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
extension:StatusDateTime |  | 1..1 | dateTime | Status DateTime URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
extension:Reply |  | 0..1 | (Complex) | For sms reply URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | Unique identifier
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | The value that is unique Example General: 123456
period | Σ | 0..1 | Period | Time period when id is/was valid for use
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
instantiatesCanonical | Σ | 0..* | canonical(PlanDefinition | ActivityDefinition | Measure | OperationDefinition | Questionnaire) | Instantiates FHIR protocol or definition
instantiatesUri | Σ | 0..* | uri | Instantiates external protocol or definition
basedOn | Σ | 0..1 | Reference(Resource) | Request fulfilled by this communication
partOf | Σ | 0..* | Reference(Resource) | Part of this action
inResponseTo |  | 0..* | Reference(Communication) | Reply to
status | ?!Σ | 1..1 | code | preparation | in-progress | not-done | on-hold | stopped | completed | entered-in-error | unknown Binding: EventStatus (required): The status of the communication.
statusReason | Σ | 0..1 | CodeableConcept | Reason for current status Binding: Valueset for Communication Delivery Status (required)
category |  | 0..1 | CodeableConcept | Message category Binding: CommunicationCategory (example): Codes for general categories of communications such as alerts, instructions, etc.
priority | Σ | 0..1 | code | routine | urgent | asap | stat Binding: RequestPriority (required): Codes indicating the relative importance of a communication.
medium |  | 1..* | CodeableConcept | A channel of communication Binding: Valueset for Participation Mode (required)
subject | Σ | 0..1 | Reference(Patient) | Focus of message
topic |  | 0..1 | CodeableConcept | Description of the purpose/content Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.
about |  | 0..* | Reference(Resource) | Resources that pertain to this communication
encounter | Σ | 0..1 | Reference(Encounter) | Encounter created as part of
sent |  | 0..1 | dateTime | Must be in UTC timezone on the FHIR server
received |  | 0..1 | dateTime | When received
recipient |  | 0..* | Reference(Patient | Practitioner) | Message recipient
sender |  | 0..1 | Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson | HealthcareService) | Message sender
reasonCode | Σ | 0..* | CodeableConcept | Indication for message Binding: SNOMEDCTClinicalFindings (example): Codes for describing reasons for the occurrence of a communication.
reasonReference | Σ | 0..* | Reference(Condition | Observation | DiagnosticReport | DocumentReference) | Why was communication done?
payload |  | 0..* | BackboneElement | Message payload
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
Slices for content[x] |  | 1..1 |  | Message part content Slice: Unordered, Open by type:$this
contentString |  |  | string |
contentAttachment |  |  | Attachment |
contentReference |  |  | Reference(Resource) |
content[x]:contentAttachment |  | 0..1 | Attachment | Message part content
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:AttachmentExtension |  | 0..1 | (Complex) | Attachment details URL: https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-attachment-extension
contentType | Σ | 0..1 | code | Mime type of the content, with charset etc. Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed. Example General: text/plain; charset=UTF-8, image/png
language | Σ | 0..1 | code | Human language of the content (BCP-47) Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
Example General: en-AU
data |  | 0..1 | base64Binary | Data inline, base64ed
url | Σ | 0..1 | url | Uri where the data can be found Example General: http://www.acme.com/logo-small.png
size | Σ | 0..1 | unsignedInt | Number of bytes of content (if url provided)
hash | Σ | 0..1 | base64Binary | Hash of the data (sha-1, base64ed)
title | Σ | 0..1 | string | Label to display in place of the data Example General: Official Corporate Logo
creation | Σ | 0..1 | dateTime | Date attachment was first created
note |  | 0..* | Annotation | Comments made about the communication
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Communication.meta.security | extensible | All Security Labels `http://hl7.org/fhir/ValueSet/security-labels` From the FHIR Standard
Communication.meta.tag | example | CommonTags `http://hl7.org/fhir/ValueSet/common-tags` From the FHIR Standard
Communication.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
Communication.identifier.use | required | IdentifierUse `http://hl7.org/fhir/ValueSet/identifier-use|4.0.1` From the FHIR Standard
Communication.identifier.type | extensible | Identifier Type Codes `http://hl7.org/fhir/ValueSet/identifier-type` From the FHIR Standard
Communication.status | required | EventStatus `http://hl7.org/fhir/ValueSet/event-status|4.0.1` From the FHIR Standard
Communication.statusReason | required | CommunicationDeliveryStatusValueSet(a valid code from Codes for CommunicationStatus) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-communication-delivery-status-valueset` From this IG
Communication.category | example | CommunicationCategory `http://hl7.org/fhir/ValueSet/communication-category` From the FHIR Standard
Communication.priority | required | RequestPriority `http://hl7.org/fhir/ValueSet/request-priority|4.0.1` From the FHIR Standard
Communication.medium | required | ParticipationModeValueSet(a valid code from ParticipationMode) `https://fhir-ig.digital.health.nz/shared-care/ValueSet/hnz-participation-mode-valueset` From this IG
Communication.topic | example | CommunicationTopic `http://hl7.org/fhir/ValueSet/communication-topic` From the FHIR Standard
Communication.reasonCode | example | SNOMEDCTClinicalFindings `http://hl7.org/fhir/ValueSet/clinical-findings` From the FHIR Standard
Communication.payload.content[x]:contentAttachment.contentType | required | Mime Types(a valid code from `urn:ietf:bcp:13`) `http://hl7.org/fhir/ValueSet/mimetypes|4.0.1` From the FHIR Standard
Communication.payload.content[x]:contentAttachment.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Communication | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Communication | 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 | Communication | 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 | Communication | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Communication | 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 Communication

Summary

Mandatory: 7 elements(1 nested mandatory element)
Prohibited: 1 element

Extensions

This structure refers to these extensions:

- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-campaign-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-contact-point-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-callback-url-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-status-date-time-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-system-reply-extension
- https://fhir-ig.digital.health.nz/shared-care/StructureDefinition/hnz-attachment-extension

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of Communication.payload.content[x]

Other representations of profile: CSV, Excel, Schematron