Composition

Base profile: https://www.hl7.org/fhir/composition.html

Currently, the Composition resource is used to facilitate inbound transcription. While its functionality is limited for now, additional capabilities will be introduced in future releases, so stay tuned for updates.

Basic Functionality:

  • The Composition resource allows text to be added either to the Additional Visit Notes section of an in-progress visit or, if no visit is in progress, a Chart Note can be created for the patient.
  • In both scenarios, the end user will be presented with a reconciliation interface to review and edit the text before it is incorporated into the note.

Key Considerations:

  • To add text to an in-progress visit, you must provide the encounter reference.
  • If there is no encounter or if the referenced encounter has a status of "finished," the Visit Note can no longer be edited.
  • In such cases, when there is no encounter or the encounter is marked as "finished," the system will automatically create a new Chart Note for the patient.

The following attributes are supported:

Field Name

Notes

status

preliminary - this is the only supported value at this time

type

{
"system": "http://loinc.org",
"code": "11488-4",
"display": "Consult note"
}
this is the only supported type at this time

category

{
"system": "http://loinc.org",
"code": "LP173421-1",
"display": "Report"
}
this is the only supported category at this time

subject

reference to Patient

encounter

reference to Encounter

date

datetime

author

reference to the Practitioner

title

This is a string which will become the Title of the Chart Note.

section

2 Sections are currently supported:

{
"title": "Plan of treatment (narrative)",
"code": {
"text": "Use this section as the body of your text",
"coding": [
{
"system": "http://loinc.org",
"code": "18776-5",
"display": "Plan of treatment (narrative)",
}

{
"title": "Instructions",
"code": {
"text": "Use this section to communicate notes from the transcriptionist to the end user",
"coding": [
{
"system": "http://loinc.org",
"code": "69730-0",
"display": "Instructions"
}

The Following Operations are supported:

  • Composition CREATE

The following attributes are required:

Name

Type

Description

status *

code

preliminary is the only supported value at this time

type *

code

{
"system": "http://loinc.org",
"code": "11488-4",
"display": "Consult note"
}
this is the only supported type at this time

category *

code

{
"system": "http://loinc.org",
"code": "LP173421-1",
"display": "Report"
}
this is the only supported category at this time

subject *

reference

Patient Reference

date*

datetime

datetime

author *

reference

Practitioner Reference