Facade DocumentReference

http://fhir.patientsknowbest.com/structuredefinition/facade-documentreference

https://www.hl7.org/fhir/STU3/documentreference.html

Overview

A DocumentReference is used to capture information about documents authored outside PKB and then subsequently sent to us. For example, a discharge summary sent in an MDM T02.

Relevant PKB entities

Mappings

FHIR

PKB

Notes

FHIR

PKB

Notes

Resource id

[[Document.Data Point ID]]

 

Resource meta

[[Document.Status]] code mappings (PKB → FHIR):

  • UNREAD → UNREAD

  • READ → READ

[[Data Point.Privacy Label]] code mappings (PKB → FHIR):

  • GENERAL_HEALTH → GENERAL_HEALTH

  • MENTAL_HEALTH → MENTAL_HEALTH

  • SEXUAL_HEALTH → SEXUAL_HEALTH

  • SOCIAL_CARE → SOCIAL_CARE

 

DocumentReference.extension

The "Resolve()" notation indicates a lookup will be performed into the optional, customer-provided code set. If a match is found, the corresponding display value will be used.

See here for more information.

DocumentReference.identifier

  • identifier: Identifier

    • value = [[Document.External Data Point ID]]

    • assigner: Reference

      • reference = the relative URL of the Organization resource

      • display = [[Organisation.Name]]

The assigner reference will represent the PKB Organisation even if the source PKB Team is known, since external IDs are tracked at the level of the Organisation.

DocumentReference.status

<conditional>
If there is another DocumentReference with the same [[Document.External Data Point ID]] for the same [[Source.Source Organisation]] but a more recent [[Document.Persisted Timestamp]]:   "superseded"
Else:   "current"

 

DocumentReference.type

[[Document.Document Type]] code mappings (PKB → FHIR):

  • ADMISSION_TCI_LETTER → ADMISSION_TCI_LETTER

  • ALERT_NOTIFICATION → ALERT_NOTIFICATION 

  • APPOINTMENT_LETTER → APPOINTMENT_LETTER

  • BIRTH_REPORT → BIRTH_REPORT

  • CLINIC_LETTER → CLINIC_LETTER

  • DISCHARGE_LETTER → DISCHARGE_LETTER

  • DISCHARGE_SUMMARY → DISCHARGE_SUMMARY

  • MULTI_DISCIPLINARY_TEAM_MEETING_NOTES → MULTI_DISCIPLINARY_TEAM_MEETING_NOTES

  • REFERRAL_LETTER → REFERRAL_LETTER

 

DocumentReference.subject

  • subject: Reference

    • reference = the relative URL of the Patient resource

    • display = [[User.Title]] [[User.Given Name]] [[User.Family Name]]

 

DocumentReference.created

[[Document.Timestamp]]

 

DocumentReference.indexed

[[Document.Persisted Timestamp]]

 

DocumentReference.content

  • content: BackboneElement

    • attachment: Attachment

      • creation = [[Document.Timestamp]]