Merge branch 'cerner:main' into condition_procedure_lastUpdated

content/millennium/r4/clinical/medications/immunization.md

@@ -77,6 +77,7 @@ Search for immunizations that meet supplied query parameters:
  `_id`            | Conditionally      | [`token`]     | The logical resource ID associated with the resource. This parameter is required if the `patient` parameter is not used. Example: `M12345`
  `patient`        | Conditionally      | [`reference`] | The patient for the vaccination record. This parameter is required if the `_id` parameter is not used. Example: `12345`
  `date`           | No                 | [`date`]      | The date range for the immunization administration or administrations. Example: `date=ge2020-01-01T08:00:00.000Z&date=le2020-01-31T17:00:00.000Z`
+ `_lastUpdated`   | No                 | [`date`]      | Date on which the immunization was last updated. Example: `_lastUpdated=gt2014-09-24` or `_lastUpdated=gt2014-09-24T12:00:00.000Z`
  `target-disease` | No                 | [`token`]     | The target disease that the dose is being administered against. Example: `http://hl7.org/fhir/sid/cvx|213`
  `_revinclude`    | No                 | [`token`]     | The Provenance resource entries that are returned as part of the bundle.
 
@@ -94,6 +95,10 @@ _Implementation Notes_
   - For two `date` occurrences: 
     - It must be provided with `le` and `ge` prefixes to search for vaccination records within a specific range. 
     - The time component is optional, but must be consistent. If one date has a time component, so must the other.
+- When  searching with `_lastUpdated` parameter: 
+  - It can be provided with only a single reference, and must use the `gt` prefix
+  - The time component is optional.
+  - The `date` and `_lastUpdated` parameters may not be provided together.
 - When searching with the `target-disease` parameter:
   - Searching by Cerner Millennium proprietary codes is not supported.
 - When searching with the `_revinclude` parameter:

content/millennium/r4/clinical/summary/allergy-intolerance.md

@@ -84,6 +84,7 @@ Search for AllergyIntolerances that meet supplied query parameters:
  `patient`          | This or `_id`      | [`reference`] | Who the sensitivity is for. Example: `patient=12345`
  `clinical-status`  | No                 | [`token`]     | The clinical status of the allergy or intolerance. Example: `active`, `inactive`, `resolved`
  `_revinclude`      | No                 | [`token`]     | Provenance resource entries to be returned as part of the bundle. Example: `_revinclude=Provenance:target`
+ `_lastUpdated`     | No                 | [`date`]      | Date range in which the allergy or intolerance was last updated. Either 1 or 2 date/times can be given. Example: `_lastUpdated=gt2014-09-24` or `_lastUpdated=lt2015-09-24T12:00:00.000Z`
 
 Notes:
 
@@ -97,6 +98,8 @@ Notes:
 
 - When `_revinclude` is provided in a request to the closed endpoint, the OAuth2 token must include the scope corresponding to the Authorization Type, such as `user/Provenance.read`, `patient/Provenance.read` or `system/Provenance.read`.
 
+- The `_lastUpdated` parameters may be provided up to two times, and must use the `eq`, `ge`, `gt`, `le`, or `lt` prefixes. When a value is provided without a prefix, an implied `eq` prefix is used. When provided twice, the lower value must have a `ge` or `gt` prefix and the higher value must have an `le` or `lt` prefix.
+
 ### Headers
 
 <%= headers fhir_json: true %>
@@ -308,6 +311,7 @@ The common [errors] and [OperationOutcomes] may be returned.
 
 [`reference`]: https://hl7.org/fhir/r4/search.html#reference
 [`token`]: https://hl7.org/fhir/R4/search.html#token
+[`date`]: http://hl7.org/fhir/R4/search.html#date
 [errors]: ../../../#client-errors
 [OperationOutcomes]: ../../../#operation-outcomes
 [Precision Extension]: https://fhir-ehr.cerner.com/r4/StructureDefinition/precision?_format=json

content/millennium/r4/foundation/documents/document-reference.md

@@ -126,6 +126,15 @@ _Implementation Notes_
 <%= headers status: 200 %>
 <%= json(:R4_DOCUMENT_REFERENCE_BUNDLE) %>
 
+### Example with Nil Status Request
+
+    GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference?patient=12769853
+
+#### Response
+
+<%= headers status: 200 %>
+<%= json(:R4_DOCUMENT_REFERENCE_NIL_STATUS_BUNDLE) %>
+
 ### Example with RevInclude
 
 ### Authorization Types
@@ -192,6 +201,15 @@ _Implementation Notes_
 <%= headers status: 200 %>
 <%= json(:R4_DOCUMENT_REFERENCE) %>
 
+### Example with Nil Status Request
+
+    GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference/206098371
+
+#### Response
+
+<%= headers status: 200 %>
+<%= json(:R4_DOCUMENT_REFERENCE_NIL_STATUS) %>
+
 #### Patient Authorization Request
 
     GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference/198381924

lib/resources/example_json/r4_examples_document_reference.rb

@@ -98,6 +98,19 @@ module Resources
       }
     }.freeze
 
+    R4_DOCUMENT_REFERENCE_NIL_STATUS ||= {
+      "resourceType": 'OperationOutcome',
+      "issue": [
+        {
+          "severity": 'error',
+          "code": 'not-found',
+          "details": {
+            "text": 'Resource not found'
+          }
+        }
+      ]
+    }.freeze
+
     R4_DOCUMENT_REFERENCE_SEARCH_BY_ENCOUNTER_FILTER_PATIENT_DOCUMENTS ||= {
       "resourceType": 'DocumentReference',
       "id": '198381924',
@@ -510,6 +523,129 @@ module Resources
       ]
     }.freeze
 
+    R4_DOCUMENT_REFERENCE_NIL_STATUS_BUNDLE ||= {
+      'resourceType': 'Bundle',
+      'id': '271fc608-6a12-48f3-a9f8-2d1bfe395328',
+      'type': 'searchset',
+      'link': [
+        {
+          'relation': 'self',
+          'url': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference?patient=12769853'
+        }
+      ],
+      'entry': [
+        {
+          'fullUrl': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference/198381924',
+          'resource': R4_DOCUMENT_REFERENCE
+        },
+        {
+          'fullUrl': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/DocumentReference/198381926',
+          'resource': {
+            "resourceType": 'DocumentReference',
+            "id": '198381926',
+            "meta": {
+              "versionId": '1',
+              "lastUpdated": '2022-07-07T09:43:56.000Z'
+            },
+            "text": {
+              "status": 'generated',
+              "div": '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Document Reference</b></p>'\
+              '<p><b>Patient Name</b>: '\
+              'GETEST, PatientOneHundredSixtySix</p><p><b>Document Type</b>: '\
+              'Waveform Strip</p><p><b>Document Category</b>: '\
+              'Unknown</p><p><b>Document Title</b>: test1</p><p><b>Service Start Date</b>: '\
+              'Jul  7, 2022  9:43 A.M. UTC</p><p><b>Service End Date</b>: '\
+              'Jul  7, 2022  9:43 A.M. UTC</p><p><b>Document Status</b>: Final</p></div>'
+            },
+            "identifier": [
+              {
+                "system": 'https://fhir.cerner.com/ceuuid',
+                "value": 'CE87caf4b7-9397-4667-9897-702218017c9e-198381926-2022070709435600'
+              }
+            ],
+            "status": 'current',
+            "docStatus": 'final',
+            "type": {
+              "coding": [
+                {
+                  "system": 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/72',
+                  "code": '2574499721',
+                  "display": 'Waveform Strip',
+                  "userSelected": true
+                },
+                {
+                  "system": 'http://terminology.hl7.org/CodeSystem/v3-NullFlavor',
+                  "code": 'UNK',
+                  "display": 'unknown'
+                }
+              ],
+              "text": 'Waveform Strip'
+            },
+            "category": [
+              {
+                "coding": [
+                  {
+                    "system": 'http://terminology.hl7.org/CodeSystem/data-absent-reason',
+                    "code": 'unknown',
+                    "display": 'Unknown'
+                  }
+                ],
+                "text": 'Unknown'
+              }
+            ],
+            "subject": {
+              "reference": 'Patient/12769853',
+              "display": 'GETEST, PatientOneHundredSixtySix'
+            },
+            "date": '2022-07-07T09:43:56Z',
+            "content": [
+              {
+                "attachment": {
+                  "contentType": 'application/pdf',
+                  "url": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Binary/XR-198381926',
+                  "title": 'test1',
+                  "creation": '2022-07-07T09:43:56.000Z'
+                },
+                "format": {
+                  "system": 'http://terminology.hl7.org/CodeSystem/data-absent-reason',
+                  "code": 'unknown',
+                  "display": 'Unknown'
+                }
+              }
+            ],
+            "context": {
+              "encounter": [
+                {
+                  "reference": 'Encounter/97966172'
+                }
+              ],
+              "period": {
+                "start": '2022-07-07T09:43:56.000Z',
+                "end": '2022-07-07T09:43:56.000Z'
+              }
+            }
+          }
+        },
+        {
+          "fullUrl": 'urn:uuid:98ae7843-46b7-4792-8613-a0b9cf196b27',
+          "resource": {
+            "resourceType": 'OperationOutcome',
+            "issue": [
+              {
+                "severity": 'warning',
+                "code": 'suppressed',
+                "diagnostics": 'Other search results were found but could not be compliantly expressed and hence have'\
+                 ' been suppressed'
+              }
+            ]
+          },
+          "search": {
+            "mode": 'outcome'
+          }
+        }
+      ]
+    }.freeze
+
     R4_DOCUMENT_REFERENCE_PATIENT_ACCESS_BUNDLE ||= {
       'resourceType': 'Bundle',
       'id': '74e2c51e-96af-4f95-abd1-bbbe566e386b',