coverage search by id

cerner · May 7, 2024 · af09b06 · af09b06
1 parent 3d33831
commit af09b06
Show file tree

Hide file tree

Showing 2 changed files with 105 additions and 3 deletions.
diff --git a/content/millennium/r4/financial/support/coverage.md b/content/millennium/r4/financial/support/coverage.md
@@ -54,8 +54,6 @@ _Implementation Notes_
 
 * Public Healthcare represents an insurance policy funded by a public health system such as a provincial or national health plan. If there are any public coverages, they will return with an id prefixed with 'PH' or 'PHP' and will be returned in the payload with the rest of the coverages (private coverages).
 
-* Search with `_id` is not supported.
-
 ### Authorization Types
 
 <%= authorization_types(provider: true, patient: false, system: true) %>
@@ -64,6 +62,7 @@ _Implementation Notes_
 
  Name         | Required?            | Type          | Description
 --------------|----------------------|---------------|--------------------------------------------------------
+ `_id`        | Required if `patient` or `encounter` is not present | [`reference`]     | The logical resource id associated with the resource.
  `patient`    | This or `-encounter` | [`reference`] | Retrieve coverages for a patient. Example: `12345`
  `-encounter` | This or `patient`    | [`reference`] | Retrieve coverages for an encounter. Example: `143242`
 
@@ -84,6 +83,19 @@ _Implementation Notes_
 
 <%= disclaimer %>
 
+### Example - Id-level Private Coverage
+
+#### Request
+
+    GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?_id=12724066-491651736-491651736
+
+#### Response
+
+<%= headers status: 200 %>
+<%= json(:r4_coverage_id_bundle_entry) %>
+
+<%= disclaimer %>
+
 ### Example - Patient-level Public Coverage
 
 #### Request

diff --git a/lib/resources/example_json/r4_examples_coverage.rb b/lib/resources/example_json/r4_examples_coverage.rb
@@ -17,6 +17,30 @@ module Resources
                      '</p><p><b>Coverage Start Date</b>: Aug 14, 2015  7:07 P.M. UTC</p><p><b>Payor</b>: '\
                      'SELF PAY</p><p><b>Class</b>: plan: Value: 2800235 Name: Self Pay</p></div>'
       },
+      'identifier': [
+        {
+          'type': {
+            'coding': [
+              {
+                'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
+                'code': 'MB'
+              }
+            ]
+          },
+          'value': '123'
+        },
+        {
+          'type': {
+            'coding': [
+              {
+                'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
+                'code': 'MB'
+              }
+            ]
+          },
+          'value': '123'
+        }
+      ],
       'status': 'active',
       'subscriber': {
         'reference': 'Patient/12724066',
@@ -134,6 +158,72 @@ module Resources
       ]
     }.freeze
 
+    R4_COVERAGE_ID_BUNDLE_ENTRY ||= {
+      'resourceType': 'Coverage',
+      'id': '12724066-491651736-491651736',
+      'meta': {
+        'versionId': '4-4',
+        'lastUpdated': '2024-01-10T19:33:27.000Z'
+      },
+      'text': {
+        'status': 'generated',
+        'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Subscriber</b>: SMART II, NANCY</p><p><b>Beneficiary</b>: SMART II, NANCY</p><p><b>Relationship</b>: Self</p><p><b>Coverage Start Date</b>: Jun  6, 2021 12:00 A.M. UTC</p><p><b>Payor</b>: MEDICARE</p><p><b>Class</b>:</p><dl><dt>Plan</dt><dd><b>Value</b>: 3132243</dd><dd><b>Name</b>: Medicare Part B</dd></dl></div>'
+      },
+      'identifier': [
+        {
+          'extension': [
+            {
+              'valueCode': 'unknown',
+              'url': 'http://hl7.org/fhir/StructureDefinition/data-absent-reason'
+            }
+          ]
+        }
+      ],
+      'status': 'active',
+      'subscriber': {
+        'reference': 'Patient/12724066',
+        'display': 'SMART II, NANCY'
+      },
+      'beneficiary': {
+        'reference': 'Patient/12724066',
+        'display': 'SMART II, NANCY'
+      },
+      'relationship': {
+        'coding': [
+          {
+            'system': 'http://terminology.hl7.org/CodeSystem/subscriber-relationship',
+            'code': 'self',
+            'display': 'Self',
+            'userSelected': false
+          }
+        ],
+        'text': 'Self'
+      },
+      'period': {
+        'start': '2021-06-06T00:00:00.000Z'
+      },
+      'payor': [
+        {
+          'reference': 'Organization/589783',
+          'display': 'MEDICARE'
+        }
+      ],
+      'class': [
+        {
+          'type': {
+            'coding': [
+              {
+                'system': 'http://terminology.hl7.org/CodeSystem/coverage-class',
+                'code': 'plan'
+              }
+            ]
+          },
+          'value': '3132243',
+          'name': 'Medicare Part B'
+        }
+      ]
+    }.freeze
+
     R4_COVERAGE_ENCOUNTER_SOCIAL_HEALTHCARE_BUNDLE_ENTRY ||= {
       'resourceType': 'Coverage',
       'id': 'PH-98371617-97701467',
@@ -207,7 +297,7 @@ module Resources
       },
       'text': {
         'status': 'generated',
-        'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p>'\
+        'div': '<div xmlns=\'http://www.w3.org/1999/xhtml\'><p><b>Coverage</b></p><p><b>Status</b>: Active</p>'\
         '<p><b>Beneficiary</b>: SMART, NANCY</p><p><b>Coverage Start Date</b>: Mar 16, 2021  8:04 P.M. UTC</p>'\
         '<p><b>Payor</b>: Government</p><p><b>Class</b>:</p><dl><dt>Charging Category</dt><dd><b>Value</b>:'\
          '2572940471</dd><dd><b>Name</b>: 10-OPC, Class II</dd></dl><p><b>Type</b>: public healthcare</p></div>'