diff --git a/content/millennium/dstu2/encounters/encounter.md b/content/millennium/dstu2/encounters/encounter.md index 0515a7ee2..01970918f 100644 --- a/content/millennium/dstu2/encounters/encounter.md +++ b/content/millennium/dstu2/encounters/encounter.md @@ -9,11 +9,11 @@ title: Encounter | DSTU 2 API ## Overview -The Encounter resource provides admissions or visits during which health care services were provided to a patient. An encounter has a class to distinguish between different health care settings such as inpatient, outpatient, emergency, etc. A patient may have one medical record number with multiple encounter numbers per facility or organization. There is substantial variance between organizations in the definition of an encounter and what events are aggregated together to constitute an encounter. +The Encounter resource provides admissions or visits during which health care services were provided to a patient. An encounter has a class to distinguish between different health care settings such as inpatient, outpatient, emergency, and so on. A patient may have one medical record number with multiple encounter numbers per facility or organization. There is substantial variance between organizations in the definition of an encounter and what events are aggregated together to constitute an encounter. The following fields are returned if valued: -* [Encounter id](http://hl7.org/fhir/dstu2/resource-definitions.html#Resource.id){:target="_blank"} +* [Encounter ID](http://hl7.org/fhir/dstu2/resource-definitions.html#Resource.id){:target="_blank"} * [Encounter identifier (eg: FIN)](http://hl7.org/fhir/DSTU2/encounter-definitions.html#Encounter.identifier){:target="_blank"} * [Status](http://hl7.org/fhir/DSTU2/encounter-definitions.html#Encounter.status){:target="_blank"} * [Class](http://hl7.org/fhir/DSTU2/encounter-definitions.html#Encounter.class){:target="_blank"} @@ -75,10 +75,10 @@ _Implementation Notes_ ### Parameters - Name | Required? | Type | Description + Name | Required | Type | Description -----------|-----------------|---------------|--------------------------------------------------------------------------- - `_id` | This or patient | [`token`] | The logical resource id associated with the Encounter. Example: `7891` - `patient` | This or _id | [`reference`] | The patient present at the encounter. Example: `12345` + `_id` | Conditional | [`token`] | The logical resource ID associated with the Encounter. This parameter is required if `patient` is not used. Example: `7891` + `patient` | Conditional | [`reference`] | The Patient present at the Encounter. This parameter is required if `_id` is not used. Example: `12345` ### Headers @@ -101,9 +101,9 @@ _Implementation Notes_ The common [errors] and [OperationOutcomes] may be returned. -## Retrieve by id +## Retrieve by ID -List an individual Encounter by its id: +List an individual Encounter by the associated ID: GET /Encounter/:id @@ -135,12 +135,10 @@ _Implementation Notes_ ### Encounter Combines Example -Cerner Millennium supports the ability to logically merge an encounter record into another encounter record when both records are describing the same ecounter. This is known -as an "encounter combine". If necessary, this merging can later be undone by performing an "encounter uncombine". When the requested encounter record has been combined into another -record, an inactive Encounter entry will be returned which has a reference to the current Encounter entry in the partOf field. Entries for combined encounters will only be returned when retrieving -the entries directly by id. They will not be returned when searching with other parameters. - -The ability to perform encounter combine or uncombine operations is not available through the Cerner Ignite platform. +Cerner Millennium supports the ability to logically merge an encounter record into another encounter record when both records are describing the same encounter. This is known +as an encounter combine. If necessary, this merging can later be undone by performing an encounter uncombine. When the requested encounter record has been combined into another +record, an inactive encounter entry is returned which has a reference to the current encounter entry in the `partOf` field. Entries for combined encounters will only be returned when retrieving +the entries directly by ID. They will not be returned when searching with other parameters. #### Request diff --git a/content/millennium/r4/base/management/encounter.md b/content/millennium/r4/base/management/encounter.md index 3df4708a6..1c145a506 100644 --- a/content/millennium/r4/base/management/encounter.md +++ b/content/millennium/r4/base/management/encounter.md @@ -9,7 +9,7 @@ title: Encounter | R4 API ## Overview -The Encounter resource provides admissions or visits during which health care services were provided to a patient. An encounter has a class to distinguish between different health care settings such as inpatient, outpatient, emergency, etc. A patient may have one medical record number with multiple encounter numbers per facility or organization. There is substantial variance between organizations in the definition of an encounter and what events are aggregated together to constitute an encounter. +The Encounter resource provides admissions or visits during which health care services were provided to a patient. An encounter has a class to distinguish between different health care settings such as inpatient, outpatient, emergency, and so on. A patient may have one medical record number with multiple encounter numbers per facility or organization. There is substantial variance between organizations in the definition of an encounter and what events are aggregated together to constitute an encounter. The following [HL7® FHIR® US Core Implementation Guide STU 4.0.0](https://hl7.org/fhir/us/core/STU4/){:target="_blank"} Profiles are supported by this resource: @@ -17,7 +17,7 @@ The following [HL7® FHIR® US Core Implementation Guide STU 4.0.0](https://hl7. The following fields are returned if valued: -* [Encounter id](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.id){:target="_blank"} +* [Encounter ID](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.id){:target="_blank"} * [Encounter identifier (eg: FIN)](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.identifier){:target="_blank"} * [Status](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.status){:target="_blank"} * [Class](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.class){:target="_blank"} @@ -48,7 +48,7 @@ The following fields are returned if valued: * [Name](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.location.location){:target="_blank"} * [Location status](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.location.status){:target="_blank"} * [Service provider (Organization)](https://hl7.org/fhir/r4/encounter-definitions.html#Encounter.serviceProvider){:target="_blank"} -* [Extensions including client organization, custom attribute, estimated financial responsibility amount, estimated financial responsibility not collected reason, military service connected indicator, and payment collection status](#extensions){:target="_blank"} +* [Extensions](#extensions) ### Contained Location Bindings @@ -82,7 +82,7 @@ All URLs for custom extensions are defined as `https://fhir-ehr.cerner.com/r4/St ## Search -Search for Encounters that meet supplied query parameters: +Search for encounters that meet supplied query parameters: GET /Encounter?:parameters @@ -98,23 +98,24 @@ _Implementation Notes_ ### Parameters -Name | Required? | Type | Description ---------------|--------------------------------------------------------------------------------|---------------|--------------------------------------------------------------------------------------------------- - `_id` | This or `patient` or `subject` or `account` or `identifier` or `pageContext` | [`token`] | The logical resource id associated with the Encounter. Example: `7891` -`patient` | This or `subject` or `account` or `_id` or `identifier` or `pageContext` | [`reference`] | The patient present at the encounter. Example: `12345` -`subject` | This or `patient` or `account` or `_id` or `identifier` or `pageContext` | [`reference`] | The patient present at the encounter. Example: `subject=Patient/12345` or `subject:Patient=12345` -`account` | This or `patient` or `subject` or `_id` or `identifier` or `pageContext` | [`reference`] | The account associated with the encounters. Example: `F703726` -`identifier` | This or `patient` or `subject` or `account` or `_id` or `pageContext` | [`token`] | An encounter's identifier. Example: `urn:oid:1.2.243.58|110219457` -`date` | No | [`dateTime`] | Datetime range into which the encounter's period datetime falls. Must be prefixed by 'ge', 'gt', 'le' or 'lt'. -[`_count`] | No | [`number`] | The maximum number of results to return. -`status` | No | [`token`] | The status of the encounter. Example: `planned` -`_revinclude` | No | [`token`] | Provenance resource entries to be returned as part of the bundle. Example:_revinclude=Provenance:target +Name | Required | Type | Description +--------------|------------------|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------ + `_id` | Conditional | [`token`] | The logical resource ID associated with the Encounter. This parameter is required if `patient` or `subject` or `account` or `identifier` is not used. Example: `7891` +`patient` | Conditional | [`reference`] | The patient present at the Encounter. This parameter is required if `subject` or `account` or `_id` or `identifier` is not used. Example: `12345` +`subject` | Conditional | [`reference`] | The patient present at the Encounter. This parameter is required if `patient` or `account` or `_id` or `identifier` is not used. Example: `subject=Patient/12345` or `subject:Patient=12345` +`account` | Conditional | [`reference`] | The account associated with the Encounters. This parameter is required if `patient` or `subject` or `_id` or `identifier` is not used. Example: `F703726` +`identifier` | Conditional | [`token`] | An Encounter's identifier. This parameter is required if `patient` or `subject` or `account` or `_id` is not used. Example: `urn:oid:1.2.243.58|110219457` +`date` | No | [`dateTime`] | Datetime range into which the Encounter's period datetime falls. Must be prefixed by 'ge', 'gt', 'le' or 'lt'. +[`_count`] | No | [`number`] | The maximum number of results to return. +`status` | No | [`token`] | The status of the Encounter. Example: `planned` +`_revinclude` | No | [`token`] | Provenance resource entries to be returned as part of the bundle. Example: `_revinclude=Provenance:target` Notes: -* `_revinclude` parameter may be provided once with the value `Provenance:target`. Example: `_revinclude=Provenance:target` -* `_revinclude` parameter may be provided with the `_id/patient/subject/account` parameter. Example: `_id=74771957,4732066&_revinclude=Provenance:target` -* `_revinclude` is provided in a request to the closed endpoint, the OAuth2 token must include the `user/Provenance.read` scope. Currently, `patient/Provenance.read` is not supported and hence `_revinclude` cannot be utilized for patient persona. +* When using the `_revinclude` parameter: + * It may be provided once with the value `Provenance:target`. Example: `_revinclude=Provenance:target` + * It may be provided with the `_id/patient/subject/account` parameter. Example: `_id=74771957,4732066&_revinclude=Provenance:target` +* If `_revinclude` is provided in a request to the closed endpoint, the OAuth2 token must include the `user/Provenance.read` scope. Currently, `patient/Provenance.read` is not supported and hence `_revinclude` cannot be utilized for patient persona. * `_count` and `status` must be provided with patient * `status` valid parameters are `planned`, `in-progress`, `finished`, `cancelled` * The `date` parameter may be provided: @@ -160,6 +161,7 @@ Notes: #### Request GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?_id=1361920&_revinclude=Provenance:target + #### Response <%= headers status: 200 %> @@ -180,9 +182,9 @@ Notes: The common [errors] and [OperationOutcomes] may be returned. -## Retrieve by id +## Retrieve by ID -List an individual Encounter by its id: +List an individual encounter by the associated ID: GET /Encounter/:id @@ -214,12 +216,10 @@ _Implementation Notes_ ### Encounter Combines Example -Cerner Millennium supports the ability to logically merge an encounter record into another encounter record when both records are describing the same ecounter. This is known -as an "encounter combine". If necessary, this merging can later be undone by performing an "encounter uncombine". When the requested encounter record has been combined into another -record, an inactive Encounter entry will be returned which has a reference to the current Encounter entry in the partOf field. Entries for combined encounters will only be returned when retrieving -the entries directly by id. They will not be returned when searching with other parameters. - -The ability to perform encounter combine or uncombine operations is not available through the Cerner Ignite platform. +Cerner Millennium supports the ability to logically merge an encounter record into another encounter record when both records are describing the same encounter. This is known +as an encounter combine. If necessary, this merging can later be undone by performing an encounter uncombine. When the requested encounter record has been combined into another +record, an inactive encounter entry is returned which has a reference to the current encounter entry in the `partOf` field. Entries for combined encounters will only be returned when retrieving +the entries directly by ID. They will not be returned when searching with other parameters. #### Request @@ -246,7 +246,7 @@ The common [errors] and [OperationOutcomes] may be returned. ## Create -Create an individual Encounter. +Create an individual encounter. POST /Encounter @@ -284,7 +284,7 @@ Etag: W/"0" Last-Modified: Wed, 27 Mar 2019 15:59:30 GMT Location: https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/1621910 Vary: Origin -X-Request-Id: 1638e30e497b93ff4383b2ff0eaeea68 +X-Request-Id: 2d38b49013e3496c806d60954922b464 The `ETag` response header indicates the current `If-Match` version to use on subsequent updates. @@ -338,7 +338,7 @@ Date: Tue, 26 Mar 2019 15:42:29 GMT Etag: W/"10" Last-Modified: Tue, 26 Mar 2019 15:42:27 GMT Vary: Origin -X-Request-Id: 47306a14c8a2c3afd4ab85aa9594101d +X-Request-Id: 0ba2de3d01494af99b79efdb57baff18 The `ETag` response header indicates the current `If-Match` version to use on subsequent updates. diff --git a/lib/resources/r4/encounter.yaml b/lib/resources/r4/encounter.yaml index e135e6bc0..b5a30ebb2 100644 --- a/lib/resources/r4/encounter.yaml +++ b/lib/resources/r4/encounter.yaml @@ -221,7 +221,7 @@ fields: terminology: - display: Encounter Priority system: http://hl7.org/fhir/encounter-priority - info_link: http://hl7.org/fhir/v3/ActPriority/vs.html + info_link: https://hl7.org/fhir/R4/v3/ActPriority/vs.html - display: Millennium Encounter Admit Type system: https://fhir.cerner.com/<EHR source id>/codeSet/3 info_link: https://fhir.cerner.com/millennium/r4/proprietary-codes-and-systems/#code-set-3-encounter-admission-type