/
CommunicationRequest - FHIR

CommunicationRequest - FHIR

 

 

 

 

FHIR resource link

https://www.hl7.org/fhir/communicationrequest.html

https://build.fhir.org/communicationrequest.html

FHIR definition

A request to convey information; e.g. the CDS system proposes that an alert be sent to a responsible provider, the CDS system proposes that the public health agency be notified about a reportable condition.

This resource is a record of a request for a communication to be performed. A communication is a conveyance of information from one entity, a sender, to another entity, a receiver. The requester requests the sender to send the payload to the recipient.

PSI use cases

Communication use cases include:

  • A schedule to send reminder or alert delivered to a patient or a practitioner which was previously scheduled.

required properties

see below

Extensions

Implemented: none

Under consideration:

  • enforcing mandatory fields

Sample payload

(minimum set)

{ "resourceType": "CommunicationRequest", "id": "924", "meta": { "versionId": "1", "lastUpdated": "2022-09-22T13:41:48.095+00:00" }, "status": "active", "priority": "routine", "medium": [ { "coding": [ { "code": "APPWRIT" } ], "text": "whatsapp" } ], "subject": { "reference": "Patient/202", "type": "Patient" }, "recipient": [ { "reference": "Patient/202", "type": "Patient" } ], "sender": { "reference": "Organization/736", "type": "Organization" }, "payload": [ { "contentString": "" }, { "contentString": "Hi a test message from FHIR" } ], "occurrenceDateTime": "2022-09-23" }

 

Notes for CommunicationRequest FHIR resource, per property

Property

Required by PSI?

Notes

Property

Required by PSI?

Notes

PSI tags

Yes [psi/fhir]

Country ISO-3 code

Project Code

PENDING: implementation of this property

status

REQUIRED[fhir]

draft | active | on-hold | revoked | completed | entered-in-error | unknown
EventStatus (Required)

  • active: pending to be send

  • revoked: canceled (no need to send this message)

  • completed: message sent

Flow:

  • active--> completed

  • active → revoked

priority

optional[fhir]

routine | urgent | asap | stat
RequestPriority (Required)

medium

REQUIRED[PSI/fhir]

A channel of communication. We can use one of these codes: SMSWRIT or APPWRIT. In the future we could use another codes (https://terminology.hl7.org/3.1.0/ValueSet-v3-ParticipationMode.html)

example for social media (code APPWRIT):

[{ "coding": { "code": "SMSWRIT" }, "text": "SMS" }]

sender

REQUIRED[PSI/fhir]

Focus of message. Reference

"sender": { "reference": "Organization/447", "type": "Organization" },

 

subject

REQUIRED[PSI/fhir]

Refers to the patient (client) resource id that the voucher was assigned to

 

sent

REQUIRED[PSI/fhir]

When sent (datetime YYYY-MM-DDThh:mm:ss+zz:zz)

occurrenceDateTime

optional[fhir]

REQUIRED[PSI]

When scheduled (datetime YYYY-MM-DDThh:mm:ss+zz:z)

Required One of both: occurrenceDateTime or occurrencePeriod

occurrencePeriod

optional[fhir]

REQUIRED[PSI]

When scheduled (Period)

Required One of both: occurrenceDateTime or occurrencePeriod

recipient

REQUIRED [psi]

Message recipient. Reference Array.

 

payload

REQUIRED[PSI/fhir]

Message payload template(the message body).

We have to send 2 elements.

  • The first one is reserved to give information about term or plattform that contains the message/template.

  • The second one can be a text or a template. Related the template we have to explain all the possibilities and how to write them.

topic

 

Keyword to be able to relocate the message at a later state

 

 

Related content