Da Vinci Clinical Data Exchange (CDex), published by HL7 International / Payer/Provider Information Exchange Work Group. This guide is not an authorized publication; it is the continuous build for version 2.1.0-preview built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-ecdx/ and changes regularly. See the Directory of published versions
Page standards status: Informative |
This page documents an optional solicited attachments transaction for requesting additional claims or prior authorization data from a Provider using FHIR Questionnaire.* The Payer uses the Task-based CDex Task Attachment Request Profile to request a Provider to complete a questionnaire. The Provider launches Da Vinci DTR to complete the questionnaire and, as documented in the Sending Attachments page, submits the completed questionnaire to the Payer using the $submit-attachment
operation. In contrast to Requesting Attachments Using Attachment Codes, a HIPAA-based request model using attachment codes, it supports using Questionnaire to define in more detail what data is missing. As a result, it avoids unnecessary documents. In addition, it leverages Da Vinci DTR functionality to fill out the Questionnaire reducing the time involved in reviewing documentation requirements.
* See the Conforming to CDex Attachments page for how systems declare what they support for the various actors and roles in CDex Attachments.
The Task Based Approach page documents why a Data Consumer should use Task for requesting attachments. For more background on Task-based transactions, see the Requesting Exchange using Task section of the Da Vinci HRex Implementation Guide. For CDex attachment requests transactions, the Payer SHALL use the CDex Task Attachment Request Profile to solicit information from a Provider. For a detailed description of all the mandatory, must support, and optional elements, as well as formal definitions and profile views, see the CDex Task Data Request Profile page.
In contrast to Requesting Attachments Using Attachment Codes, when a Payer references a FHIR Questionnaire as an input parameter, the Task represents a request for the Provider to complete the questionnaire (form). The CDex Task Attachment Request Profile defines a specific Task.code
that directs the Provider to launch a Da Vinci - Coverage Requirements Discovery (DTR) application to use the Payer provided Questionnaire and results from any CQL execution to generate and complete a QuestionnaireResponse. Figure 17 below summarizes the steps for requesting and completing a questionnaire using CDex Attachments and DTR, and the sequence diagram in the following section illustrates these transactions in more detail:
Step 1: The Payer POSTs a Task directly to the Provider. The Task is a request to complete a questionnaire.
Step 2: if the Task.code is “attachment-request-questionnaire”, the Provider launches DTR and shares the Task as a launch parameter (i.e., DTR has access to read and update the Task and access to other resources to complete the QuestionnaireResponse in Step 3)
Step 3: DTR fetches the Task, which contains the link to the Questionnaire. Then fetches the Questionnaire (and any CQL rules defined within it) and proceeds to complete the QuestionnaireResponse. Refer to the Da Vinci DTR Implementation Guide for more information on how it generates a QuestionnaireResponse.
Step 4: DTR creates and updates the QuestionnaireResponse directly to the Data Source’s FHIR Server and updates Task.output
to reference the QuestionnaireResponse it created..
Step 5: When the QuestionnaireResponse is completed, the Provider “pushes” the QuestionnaireResponse directly to the Payer-defined endpoint using the $submit-attachments operation. See the Sending Attachments page for Implementation Guide for more information on this transaction.
Step 6: The Provider updates the Task to “completed” when complete - e.g., when the data has been submitted or the information gathered.
The sequence diagram in the Figure 18 below depicts the the FHIR RESTful transactions and processes involved between the Payer, Provider, and DTR application application needed to request, fill, and return a questionnaire using using CDex Attachments. It references a “DTR Launch”. If the DTR is a native EHR application, the launch is implementation specific. If DTR is a SMART on FHIR Application, the next (DTR SMART App Launch) section documents the launch sequence and parameters.
The sequence diagram in Figure 19 below depicts the transactions between the DTR Client, FHIR Server, and DTR application needed to launch a DTR SMART App.
Preconditions and Assumptions:
Step 1 (Optional): The DTR App registers with DTR Client (may be out of band)
Step 2,3: If the Task.code is “attachment-request-questionnaire” (or “data-request-questionnaire” for a Task-based approach), a User initiates Smart Version 2.0.0 EHR launch flow to launch DTR (for example, clicks a button to launch DTR) and DTR Client sends a launch request to the DTR App
Step 4: DTR App retrieves the .well-known/smart-configuration
from FHIR Server.
Step 5: DTR App request authorization code requesting the following scopes:
Step 6,7: Assuming the authorization is granted, The DTR app requests an access token
Step 8: DTR App obtains an access token and the launch contexts in the “fhirContext” array, including a local reference to the Task in step 2.
Step 9: The DTR App uses the Task reference obtained in step 8 to fetch it, the Questionnaire, and other resources to fill out a QuestionnaireResponse. See the previous section (or this section on the Task Based Approach page) for more detailed transactions.
The Requesting Attachments Using Attachment Codes page documents the data elements needed to associate an attachment to a claim or prior authorization. However, there is no “Attachment Code” Data element when using Questionnaires to collect attachments-related data.
In the following sections, A detailed look at an example Solicited attachment transaction illustrates how:
In this scenario, a Provider creates a prior authorization and sends it to the Payer. The Payer reviews the prior authorization and responds with a request to fill out a questionnaire for attachments-related data using the CDex Attachment Request Profile. After receiving the attachment request, the Provider launches DTR, which completes a QuestionnaireResponse. The Provider returns the QuestionnaireResponse using the $submit-attachment
operation, posting it to the endpoint supplied in the request. The flow diagram in figure 20 below illustrates the scenario.
In addition to the information needed to submit and associate the attachments to the claim successfully, the Payer supplies the following details about what information is necessary to complete the adjudication of the claim:
The table below summarizes the mapping between the CDex Request Attachment Profile elements and the $submit-attachment
parameters:
Data Element | CDex $submit-attachment Parameter | CDex Request Attachment Task Profile Element |
---|---|---|
Tracking ID | TrackingId | Task.identifier |
Use | AttachTo | Task.reasonCode |
Payer ID | PayerId | Task.requester.identifier |
Payer URL | (operation endpoint) | “PayerUrl” Task.input |
Organization ID | OrganizationId | PractitionerRole.practitioner.identifier |
Provider ID | ProviderId | PractitionerRole.organization.identifier |
Line Item(s) | Attachment.LineItem | “attachmentsNeeded” Task.input.extension |
Attachment Code | Attachment.Code | “attachmentsNeeded” Task.input |
Date of Service | ServiceDate | “service-date” Task.input |
Member ID | MemberId | Patient.identifier |
Questionnaire | - | “questionnaireNeeded” Task.input |
QuestionnaireResponse | Attachment.Content | - |
The data element mapping table is available as a CSV and Excel file.
In the first FHIR transaction, the Payer POSTs the CDex Task Attachment Request Profile to the Provider endpoint.
POST [base]/Task
Request Body
0 {
1 "resourceType" : "Task",
The following data elements are used to verify the patient’s identity. (This guide does not cover how the Provider system verifies the patient’s identity.) They are communicated in a contained Patient resource using the CDex Patient Demographics Profile. The contained Patient is referenced in Task.for.reference
using a fixed reference value of “#patient”.
Data | HRex Patient Demographics Profile. |
---|---|
Member ID or Patient Account No.* | Patient.identifier |
Patient Name | Patient.name |
Patient DOB (optional) | Patient.birthDate |
* Patient Account Number is a Provider assigned identifier
2 "meta" : {
3 "extension" : [{
4 "url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
5 "valueString" : "CDex Inline Task Example 22"
6 },
7 {
8 "url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
9 "valueMarkdown" : "Task example used to create inline [requesting attachments using questionnaire transaction](requesting-attachments-questionnaire.html#complete-solicited-attachment-transaction)"
10 }],
11 "profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-task-attachment-request"]
12 },
13 "contained" : [{
14 "resourceType" : "Patient",
15 "id" : "patient",
16 "meta" : {
17 "profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-patient-demographics"]
18 },
19 "identifier" : [{
20 "use" : "usual",
21 "type" : {
22 "coding" : [{
23 "system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
24 "code" : "MB",
25 "display" : "Member Number"
26 }],
27 "text" : "Member Number"
28 },
29 "system" : "http://example.org/cdex/payer/member-ids",
30 "value" : "Member123"
31 },
32 {
33 "use" : "usual",
34 "type" : {
35 "coding" : [{
36 "system" : "http://hl7.org/fhir/us/carin-bb/CodeSystem/C4BBIdentifierType",
The Payer communicates the provider ID as either a unique organization/location identifier (e.g., Type 2 NPI) or unique provider identifier (e.g., Type 1 NPI) or both in a contained PractitionerRole resource using the CDex PractitionerRole Profile. This contained PractitionerRole is referenced in Task.owner.reference
using a fixed reference value of “#practitionerrole”.
37 "code" : "pat",
38 "display" : "Patient Account Number"
39 }],
40 "text" : "Patient Account Number"
41 },
42 "system" : "http://example.org/cdex/provider/patient-ids",
43 "value" : "PA-123"
44 }],
45 "name" : [{
46 "family" : "Shaw",
47 "given" : ["Amy"]
48 }],
49 "birthDate" : "1987-02-20"
50 },
51 {
The mandatory Task.identifier
tracking-id slice element represents the Payer tracking identifier. The tracking-id (also called the “re-association tracking control number”) is an identifier that ties the attachments back to the claim or prior authorization. The Provider will echo it back to the Payer when submitting the attachments.
53 "id" : "practitionerrole",
54 "meta" : {
55 "profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-practitionerrole"]
56 },
57 "practitioner" : {
58 "identifier" : {
59 "system" : "http://hl7.org/fhir/sid/us-npi",
60 "value" : "9941339100"
61 }
62 },
63 "organization" : {
64 "identifier" : {
These required Task infrastructure elements:
convey the task status, and the intent of the request. The Task.status value of “request” is typical when POSTing the Task-based attachment request. Note that the status will change as the Task moves through different states in the workflow. Task.intent is fixed to “order”.
65 "system" : "http://hl7.org/fhir/sid/us-npi",
66 "value" : "1234567893"
The Task.code communicates that the Payer is requesting attachments for a claim or prior authorization using a code or data request questionnaire. If the code is “attachment-request-code”, the provider system returns attachment(s) identified by the attachment code(s) in the “code” input parameter. If the code is “attachment-request-questionnaire”, as it is in this scenario, the provider system uses Documentation Templates and Rules (DTR) to complete the Questionnaire referenced in the “questionnaire” input parameter. When either code is present, the provider system uses the $submit-attachment operation to return the information to the endpoint provided in “payer-url” input parameter.
67 }
68 }
69 }],
70 "identifier" : [{
71 "type" : {
72 "coding" : [{
73 "system" : "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
The attachment request will be directed to the same Provider who submitted the claim or prior authorization. Business identifiers are used to identify the Patient, the Payer, and the Provider who submitted the claim, and these identifiers are echoed back to the Payer when submitting the attachments.
As discussed above, the Patient id is in the contained Patient resource, referenced by the Task.for element, and the Provider id is in the contained PractitionerRole resource referenced by the Task.owner element. The Provider id can be a Practitioner identifier (i,e., a Type1 NPI) or the Practitioner’s Organization identifier (i,e., a Type2 NPI) or both.
(note the various Task dates in the request fragment below)
Actor | CDex Request Attachment Task Profile Element |
---|---|
payer ID | Task.requester.identifier |
provider ID | (contained)PractitionerRole.practitioner.identifier and/or PractitionerRole.Organization.identifier |
patient member ID or Patient Account No | (contained)Patient.identifier |
74 "code" : "tracking-id",
75 "display" : "Tracking Id"
76 }],
77 "text" : "Re-Association Tracking Control Number"
78 },
79 "system" : "http://example.org/payer",
80 "value" : "trackingid1012"
81 }],
82 "status" : "requested",
83 "intent" : "order",
84 "code" : {
85 "coding" : [{
86 "system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
87 "code" : "attachment-request-questionnaire"
The Task communicates whether the attachments are for a claim or prior authorization, and the Payer identifies the claim or prior authorization with its business Identifier.
Data | CDex Request Attachment Task Profile Element |
---|---|
Claim or Prior Authorization | Task.reasonCode |
Claim or Prior Authorization ID | Task.reasonReference.identifier |
88 }],
89 "text" : "Attachment Request Questionnaire"
90 },
91 "for" : {
92 "reference" : "#patient"
93 },
94 "authoredOn" : "2022-06-17T16:16:06Z",
95 "lastModified" : "2022-06-17T16:16:06Z",
96 "requester" : {
97 "identifier" : {
98 "system" : "http://example.org/cdex/payer/payer-ids",
99 "value" : "Payer123"
100 }
101 },
102 "owner" : {
103 "reference" : "#practitionerrole"
The Payer communicates the due date for submitting the attachment in the Task.restriction.period
element. Note that Task.restriction.period.end
is the due date representing the time by which the Provider should have submitted the attachments.
102 "owner" : {
103 "reference" : "#practitionerrole"
104 },
105 "reasonCode" : {
106 "coding" : [{
In this scenario, the Payer supplies the URL of a questionnaire (FHIR Questionnaire) to communicate what attachments-related data is needed. Line item numbers may also be supplied to match the attachment to a line item in the claim or prior authorization. This information is represented in the “questionnaire” Task input element. The Provider launches the Documentation Templates and Rules (DTR) application to complete the Questionnaire. The code snippet below contains a URL to a Home Oxygen Therapy Questionnaire.
107 "system" : "http://hl7.org/fhir/claim-use",
108 "code" : "preauthorization",
109 "display" : "Preauthorization"
110 }],
111 "text" : "preauthorization"
112 },
113 "reasonReference" : {
114 "identifier" : {
115 "system" : "http://example.org/cdex/payer/claim-ids",
116 "value" : "Preauth123"
117 }
118 },
119 "restriction" : {
The Payer supplies the URL endpoint as a Task input parameter. The Provider System will use this information as the endpoint for the $submit-attachment
Operation to send the completed QuestionnaireResponse. Note that the endpoint is not necessarily a FHIR RESTful server endpoint.
120 "period" : {
121 "end" : "2022-06-21"
122 }
123 },
124 "input" : [{
125 "extension" : [{
126 "url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-paLineNumber",
127 "valueInteger" : 1
128 }],
129 "type" : {
130 "coding" : [{
This optional Task.input element represents the request’s purpose of use (POU). In this example, it is to support a request for a claim, “CLMATTCH”. When requesting attachments for prior authorization, it would be “COVAUTH”.
129 "type" : {
130 "coding" : [{
131 "system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
132 "code" : "questionnaires-needed"
133 }]
134 },
135 "valueCanonical" : "http://example.org/cdex-questionnaire-inline-example1|2.1.0-preview"
136 },
137 {
138 "type" : {
139 "coding" : [{
140 "system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
141 "code" : "payer-url"
142 }]
143 },
144 "valueUrl" : "http://example.org/cdex/payer/$submit-attachment"
145 },
146 {
147 "type" : {
148 "coding" : [{
149 "system" : "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
The Payer used a Questionnaire to ask for specific attachments-related data. They indicated it with a Task code “attachment-request-questionnaire” and supplied the URL of the questionnaire (FHIR Questionnaire) as an input parameter. Becasue these conditions are met, the Payer launches Da Vinci DTR, a SMART on FHIR App or native EHR application. If the Provider launches a DTR within an EHR native application, skip to the step DTR App Updates Task below. If the Provider Launches DTR as a SMART on FHIR Application, it follows the Smart Version 2.0.0 EHR launch flow with the Task as the launch content. The next several steps describe the DTR SMART App functionality.
As part of the DTR launch, the local reference to the Task is passed to the DTR App. The DTR App fetches the Task and inspects it for the Questionnaire URL.
Request
GET [base]/Task/cdex-task-example22
Response Body
0 {
1 "resourceType" : "Task",
...
112 },
113 "reasonReference" : {
114 "identifier" : {
115 "system" : "http://example.org/cdex/payer/claim-ids",
116 "value" : "Preauth123"
117 }
118 },
119 "restriction" : {
....
Upon discovery of the Questionnaire URL, the DTR App fetches the Questionnaire.
Request
GET http://example.org/FHIR/Questionnare/cdex-questionnaire-example1
Response Body
0 {
1 "resourceType" : "Questionnaire",
2 "id" : "cdex-questionnaire-example1",
3 "meta" : {
4 "extension" : [{
5 "url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
6 "valueString" : "CDex Questionnaire Example1"
7 },
8 {
9 "url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
10 "valueMarkdown" : "This example is a simple data request Questionnaire used in the Task Based and Attachments transactions. It is adapted from the Da Vinci DTR IG."
11 }],
12 "profile" : ["http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-std-questionnaire"]
13 },
14 "text" : {
15 "status" : "generated",
16 "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><b>Structure</b><table border=\"1\" cellpadding=\"0\" cellspacing=\"0\" style=\"border: 1px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top;\"><tr style=\"border: 2px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top\"><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The linkID for the item\">LinkID</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Text for the item\">Text</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Minimum and Maximum # of times the item can appear in the instance\">Cardinality</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The type of the item\">Type</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Additional information about the item\">Description & Constraints</a><span style=\"float: right\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/></a></span></th></tr><tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck1.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_q_root.gif\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"QuestionnaireRoot\" class=\"hierarchy\"/> HomeOxygenTherapyQuestionnaire</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Questionnaire</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">http://example.org/cdex-questionnaire-example1#2.1.0-preview</td></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" id=\"item.1\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-text.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Text\" class=\"hierarchy\"/> 1</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/codesystem-item-type.html#item-type-text\">text</a></td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck00.png)\" id=\"item.2\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin_end.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-coding.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Coding\" class=\"hierarchy\"/> 2</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Order Reason</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/codesystem-item-type.html#item-type-choice\">choice</a></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Options: <a href=\"#opt-item.2\">4 options</a></td></tr>\r\n<tr><td colspan=\"5\" class=\"hierarchy\"><br/><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/> Documentation for this format</a></td></tr></table><hr/><p><b>Options Sets</b></p><a name=\"opt-item.2\"> </a><p><b>Answer options for 2 </b></p><ul><li style=\"font-size: 11px\">http://example.org#1 ("Initial or original order for certification")</li><li style=\"font-size: 11px\">http://example.org#2 ("Change in status")</li><li style=\"font-size: 11px\">http://example.org#3 ("Revision or change in equipment")</li><li style=\"font-size: 11px\">http://example.org#4 ("Replacement")</li></ul></div>"
17 },
18 "url" : "http://example.org/cdex-questionnaire-example1",
19 "identifier" : [{
20 "system" : "urn:ietf:rfc:3986",
21 "value" : "urn:oid:2.16.840.1.113883.4.642.40.21.35.1"
22 }],
23 "version" : "2.1.0-preview",
24 "name" : "HomeOxygenTherapyQuestionnaire",
25 "title" : "Home Oxygen Therapy Questionnaire",
26 "status" : "active",
27 "subjectType" : ["Patient"],
28 "date" : "2022-01-17",
29 "publisher" : "HL7 International / Payer/Provider Information Exchange Work Group",
30 "contact" : [{
31 "name" : "HL7 International / Payer/Provider Information Exchange Work Group",
32 "telecom" : [{
33 "system" : "url",
34 "value" : "http://www.hl7.org/Special/committees/claims"
35 },
36 {
37 "system" : "email",
38 "value" : "pie@lists.hl7.org"
39 }]
40 }],
41 "jurisdiction" : [{
42 "coding" : [{
43 "system" : "urn:iso:std:iso:3166",
44 "code" : "US"
45 }]
46 }],
47 "copyright" : "Used by permission of HL7 International all rights reserved Creative Commons License",
48 "item" : [{
49 "linkId" : "1",
50 "text" : "Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)",
51 "type" : "text",
52 "required" : true
53 },
54 {
55 "linkId" : "2",
56 "text" : "Order Reason",
57 "type" : "choice",
58 "required" : true,
59 "answerOption" : [{
60 "valueCoding" : {
61 "system" : "http://example.org",
62 "code" : "1",
63 "display" : "Initial or original order for certification"
64 }
65 },
66 {
67 "valueCoding" : {
68 "system" : "http://example.org",
69 "code" : "2",
70 "display" : "Change in status"
71 }
72 },
73 {
74 "valueCoding" : {
75 "system" : "http://example.org",
76 "code" : "3",
77 "display" : "Revision or change in equipment"
78 }
79 },
80 {
81 "valueCoding" : {
82 "system" : "http://example.org",
83 "code" : "4",
84 "display" : "Replacement"
85 }
86 }]
87 }]
88 }
To complete the Questionnaire, the DTR App retrieves FHIR resources from EHRs, runs rules (CQL), and completes a QuestionnaireResponse. See the Da Vinci DTR Implementation Guide for more information.
The completed QuestionnaireResponse is saved in the Provider’s FHIR Server.
Request
POST [base]/$QuestionnaireResponse
Request Body
0 {
1 "resourceType" : "QuestionnaireResponse",
2 "id" : "cdex-questionnaireresponse-example1",
3 "meta" : {
4 "extension" : [{
5 "url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
6 "valueString" : "CDex QuestionnaireResponse Example1"
7 },
8 {
9 "url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
10 "valueMarkdown" : "This Questionnaire Response example demonstrates the response to a CDEX Data Query or Attachments that uses a Questionnaire to request the data. It is adapted from the Da Vinci DTR IG."
11 }],
12 "profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-sdc-questionnaireresponse"]
13 },
14 "text" : {
15 "status" : "generated",
16 "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><table border=\"1\" cellpadding=\"0\" cellspacing=\"0\" style=\"border: 1px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top;\"><tr style=\"border: 2px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top\"><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The linkId for the item\">LinkId</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Text for the item\">Text</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Minimum and Maximum # of times the the itemcan appear in the instance\">Definition</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The type of the item\">Answer</a><span style=\"float: right\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/></a></span></th></tr><tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck1.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_q_root.gif\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"QuestionnaireResponseRoot\" class=\"hierarchy\"/> cdex-questionnaireresponse-example1</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Questionnaire:<a href=\"Questionnaire-cdex-questionnaire-example1.html\">Home Oxygen Therapy Questionnaire</a></td></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-string.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Item\" class=\"hierarchy\"/> 1</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Examplitis</td></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck00.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin_end.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-string.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Item\" class=\"hierarchy\"/> 2</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Order Reason</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><span><span>example.org 4: Replacement</span></span></td></tr>\r\n<tr><td colspan=\"4\" class=\"hierarchy\"><br/><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/> Documentation for this format</a></td></tr></table></div>"
17 },
18 "questionnaire" : "http://example.org/cdex-questionnaire-example1",
19 "status" : "completed",
20 "subject" : {
21 "identifier" : {
22 "use" : "usual",
23 "type" : {
24 "coding" : [{
25 "system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
26 "code" : "MB",
27 "display" : "Member Number"
28 }],
29 "text" : "Member Number"
30 },
31 "system" : "http://example.org/cdex/payer/member-ids",
32 "value" : "Member123"
33 },
34 "display" : "Amy Shaw"
35 },
36 "authored" : "2022-06-17",
37 "author" : {
38 "identifier" : {
39 "system" : "http://hl7.org/fhir/sid/us-npi",
40 "value" : "9941339100"
41 }
42 },
43 "item" : [{
44 "linkId" : "1",
45 "text" : "Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)",
46 "answer" : [{
47 "valueString" : "Examplitis"
48 }]
49 },
50 {
51 "linkId" : "2",
52 "text" : "Order Reason",
53 "answer" : [{
54 "valueCoding" : {
55 "system" : "http://example.org",
56 "code" : "4",
57 "display" : "Replacement"
58 }
59 }]
60 }]
61 }
The DTR SMART App or EHR native application Updates Task.output to Reference the completed QuestionnaireResponse.
PUT [base]/Task/cdex-task-example-22
Request Body
0 {
1 "resourceType": "Task",
2 "id": "cdex-task-example22",
...
202 "output": [
203 {
204 "type": {
205 "coding": [
206 {
207 "system": "http://hl7.org/fhir/uv/sdc/CodeSystem/temp",
208 "code": "questionnaire-response"
209 }
210 ]
211 },
212 "valueReference": {
213 "reference": "QuestionnaireResponse/cdex-questionnaireresponse-example1"
214 }
215 }
216 ]
When the Task is completed, the Provider POSTs the $submit-attachment
operation and its payload to the Payer’s endpoint. As stated above, the Payer communicates the operation endpoint to the Payer in the CDex Task Attachment Request Profile. The operation payload contains the completed QuestionnaireResponse and echoes many data elements sent in the request. The table in the introduction to this section summarizes the mapping between the CDex Request Attachment Profile elements and the $submit-attachment
parameters. The documentation below describes and demonstrates the $submit-attachment
parameters.
Data Element | CDex Request Attachment Task Profile Element | CDex #submit-attachment Parameter |
---|---|---|
Payer URL | “payer-url”Task.input | (operation endpoint) |
Request
POST [base]/$submit-attachment
Request Body
The QuestionnaireResponse along with the metadata needed to associate it to the claim or prior authorization are in the $submit-attachments payload, a Parameters resource.
0 {
1 "resourceType" : "Parameters",
2 "meta" : {
The TrackingId parameter represents the identifier that ties the attachments to the claim or prior authorization. It is often referred to as the “re-association tracking control number”. The operation must indicate whether the attachments are for claim or prior authorization. These data elements are taken from the CDex request as follows:
Data Element | CDex Request Attachment Task Profile Element | CDex #submit-attachment Parameter |
---|---|---|
TrackingID | Task.identifier | TrackingId |
Use | Task.reasonCode | AttachTo |
3 "extension" : [{
4 "url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
5 "valueString" : "CDex Parameters Example 5"
6 },
7 {
8 "url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
9 "valueMarkdown" : "**Completed QuestionnaireResponse Attachment Example:** Parameters Resource example showing how it is used to submit a solicited attachment using the `$submit-attachment` operation. The attachment parameter payload is a QuestionnaireResponse completed using DTR in response to a Questionnaire sent in the Attachments request."
10 }],
11 "profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-parameters-submit-attachment"]
12 },
13 "parameter" : [{
As documented above, The Payer uses business identifiers to identify itself, the Patient, and Provider (i.e., the practitioner) and Organization (i.e., the provider organization) who submitted the claim or prior authorization. The Provider uses these same identifiers when submitting the attachments.
Data Element | CDex Request Attachment Task Profile Element | CDex #submit-attachment Parameter |
---|---|---|
Payer ID | Task.requester.identifier | PayerId |
Organization ID | PractitionerRole.organization.identifier | OrganizationId |
Provider ID | PractitionerRole.practitioner.identifier | ProviderId |
Member ID | Patient.identifier | MemberId |
14 "name" : "TrackingId",
15 "valueIdentifier" : {
16 "system" : "http://example.org/payer",
17 "value" : "trackingid1012"
18 }
19 },
20 {
21 "name" : "AttachTo",
22 "valueCode" : "preauthorization"
23 },
24 {
25 "name" : "PayerId",
26 "valueIdentifier" : {
27 "system" : "http://example.org/cdex/payer/payer-ids",
28 "value" : "payer123"
29 }
30 },
31 {
32 "name" : "OrganizationId",
33 "valueIdentifier" : {
34 "system" : "http://hl7.org/fhir/sid/us-npi",
35 "value" : "1234567893"
36 }
37 },
38 {
39 "name" : "ProviderId",
40 "valueIdentifier" : {
41 "system" : "http://hl7.org/fhir/sid/us-npi",
The completed QuestionnaireResponse and the corresponding line item numbers are communicated as named parts of the multi-part Attachment parameter. The Attachment.content parameter represents the QuestionnaireResponse as an inline FHIR resource. The Attachment.LineItem parameter lists the line item numbers associated with it.
Data Element | CDex Request Attachment Task Profile Element | CDex #submit-attachment Parameter |
---|---|---|
line item(s) | “code”Task.input.extension | Attachment.LineItem |
QuestionnaireResponse | - | Attachment.content |
42 "value" : "9941339100"
43 }
44 },
45 {
46 "name" : "MemberId",
47 "valueIdentifier" : {
48 "system" : "http://example.org/cdex/payer/member-ids",
49 "value" : "Member123"
50 }
51 },
52 {
53 "name" : "Attachment",
54 "part" : [{
55 "name" : "LineItem",
56 "valueString" : "1"
57 },
58 {
59 "name" : "Content",
60 "resource" : {
61 "resourceType" : "QuestionnaireResponse",
62 "id" : "cdex-questionnaireresponse-example1",
63 "questionnaire" : "http://example.org/cdex-questionnaire-example1",
64 "status" : "completed",
65 "subject" : {
66 "identifier" : {
67 "use" : "usual",
68 "type" : {
69 "coding" : [{
70 "system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
71 "code" : "MB",
72 "display" : "Member Number"
73 }],
74 "text" : "Member Number"
75 },
76 "system" : "http://example.org/cdex/payer/member-ids",
77 "value" : "Member123"
78 },
79 "display" : "Amy Shaw"
80 },
81 "authored" : "2022-06-17",
82 "author" : {
83 "identifier" : {
84 "system" : "http://hl7.org/fhir/sid/us-npi",
85 "value" : "9941339100"
86 }
87 },
88 "item" : [{
89 "linkId" : "1",
90 "text" : "Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)",
91 "answer" : [{
92 "valueString" : "Examplitis"
93 }]
94 },
95 {
96 "linkId" : "2",
97 "text" : "Order Reason",
98 "answer" : [{
99 "valueCoding" : {
100 "system" : "http://example.org",
101 "code" : "4",
102 "display" : "Replacement"
103 }
104 }]
105 }]
106 }
107 }]
108 }]
109 }
The example below shows the complete solicited attachment transaction. A Payer uses the CDex Task Attachment Request Profile to request the attachment using an attachment code, and the Provider uses the $submit-attachment
operation to submit the attachments to the Payer:
Request
POST [base]/Task
Request Headers
Accept: application/fhir+json
Content-Type: application/fhir+json
...(other headers)
Request Body
{
"resourceType" : "Task",
"meta" : {
"extension" : [{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
"valueString" : "CDex Inline Task Example 22"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
"valueMarkdown" : "Task example used to create inline [requesting attachments using questionnaire transaction](requesting-attachments-questionnaire.html#complete-solicited-attachment-transaction)"
}],
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-task-attachment-request"]
},
"contained" : [{
"resourceType" : "Patient",
"id" : "patient",
"meta" : {
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-patient-demographics"]
},
"identifier" : [{
"use" : "usual",
"type" : {
"coding" : [{
"system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
"code" : "MB",
"display" : "Member Number"
}],
"text" : "Member Number"
},
"system" : "http://example.org/cdex/payer/member-ids",
"value" : "Member123"
},
{
"use" : "usual",
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/carin-bb/CodeSystem/C4BBIdentifierType",
"code" : "pat",
"display" : "Patient Account Number"
}],
"text" : "Patient Account Number"
},
"system" : "http://example.org/cdex/provider/patient-ids",
"value" : "PA-123"
}],
"name" : [{
"family" : "Shaw",
"given" : ["Amy"]
}],
"birthDate" : "1987-02-20"
},
{
"resourceType" : "PractitionerRole",
"id" : "practitionerrole",
"meta" : {
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-practitionerrole"]
},
"practitioner" : {
"identifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "9941339100"
}
},
"organization" : {
"identifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "1234567893"
}
}
}],
"identifier" : [{
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
"code" : "tracking-id",
"display" : "Tracking Id"
}],
"text" : "Re-Association Tracking Control Number"
},
"system" : "http://example.org/payer",
"value" : "trackingid1012"
}],
"status" : "requested",
"intent" : "order",
"code" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
"code" : "attachment-request-questionnaire"
}],
"text" : "Attachment Request Questionnaire"
},
"for" : {
"reference" : "#patient"
},
"authoredOn" : "2022-06-17T16:16:06Z",
"lastModified" : "2022-06-17T16:16:06Z",
"requester" : {
"identifier" : {
"system" : "http://example.org/cdex/payer/payer-ids",
"value" : "Payer123"
}
},
"owner" : {
"reference" : "#practitionerrole"
},
"reasonCode" : {
"coding" : [{
"system" : "http://hl7.org/fhir/claim-use",
"code" : "preauthorization",
"display" : "Preauthorization"
}],
"text" : "preauthorization"
},
"reasonReference" : {
"identifier" : {
"system" : "http://example.org/cdex/payer/claim-ids",
"value" : "Preauth123"
}
},
"restriction" : {
"period" : {
"end" : "2022-06-21"
}
},
"input" : [{
"extension" : [{
"url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-paLineNumber",
"valueInteger" : 1
}],
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
"code" : "questionnaires-needed"
}]
},
"valueCanonical" : "http://example.org/cdex-questionnaire-inline-example1|2.1.0-preview"
},
{
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
"code" : "payer-url"
}]
},
"valueUrl" : "http://example.org/cdex/payer/$submit-attachment"
},
{
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
"code" : "purpose-of-use"
}]
},
"valueCodeableConcept" : {
"coding" : [{
"system" : "http://terminology.hl7.org/CodeSystem/v3-ActReason",
"code" : "COVAUTH",
"display" : "coverage authorization"
}]
}
}]
}
Response Headers
HTTP/1.1 200 OK
Server: CDEX Example Provider Server
Location: http://example.org/FHIR/Task/cdex-task-example22/_history/1
...(other headers)
If the Provider Launches DTR as a SMART on FHIR Application in SMART’s EHR launch flow, proceed to step 3 If the Provider launches a DTR within an EHR native application, skip to step 7
Request
GET [base]/Task/cdex-task-example22
Response Headers
HTTP/1.1 200 OK
Server: CDEX Example Provider Server
Location: http://example.org/FHIR/Task/cdex-task-example22/_history/1
...(other headers)
Response Body
{
"resourceType" : "Task",
"id" : "cdex-task-example22",
"meta" : {
"extension" : [{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
"valueString" : "CDex Task Example 22"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
"valueMarkdown" : "**Request Additional Data using a Questionnaire:** Prior Authorization Attachment Request with a POU of \"coverage authorization\" sent by payer to a provider requesting a data request questionnaire be completed."
}],
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-task-attachment-request"]
},
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Generated Narrative: Task</b><a name=\"cdex-task-example22\"> </a><a name=\"hccdex-task-example22\"> </a></p><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\">ResourceTask "cdex-task-example22" </p><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-cdex-task-attachment-request.html\">CDex Task Attachment Request Profile</a></p></div><p><b>identifier</b>: Re-Association Tracking Control Number/trackingid1012</p><p><b>status</b>: in-progress</p><p><b>intent</b>: order</p><p><b>code</b>: Attachment Request Questionnaire <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"http://hl7.org/fhir/us/davinci-pas/STU2/CodeSystem-PASTempCodes.html\">PAS Temporary Codes</a>#attachment-request-questionnaire)</span></p><p><b>for</b>: <a name=\"hcpatient\"> </a></p><blockquote><p/><p><a name=\"patient\"> </a></p><p><a name=\"hcpatient\"> </a></p><p><b>identifier</b>: Member Number/Member123\u00a0(use:\u00a0usual), Patient Account Number/PA-123\u00a0(use:\u00a0usual)</p><p><b>name</b>: Amy Shaw </p><p><b>birthDate</b>: 1987-02-20</p></blockquote><p><b>authoredOn</b>: 2022-06-17 16:16:06+0000</p><p><b>lastModified</b>: 2022-06-17 16:16:06+0000</p><p><b>requester</b>: <span><code>http://example.org/cdex/payer/payer-ids</code>/Payer123</span></p><p><b>owner</b>: <a name=\"hcpractitionerrole\"> </a></p><blockquote><p/><p><a name=\"practitionerrole\"> </a></p><p><a name=\"hcpractitionerrole\"> </a></p><p><b>practitioner</b>: <span><a href=\"http://terminology.hl7.org/5.3.0/NamingSystem-npi.html\" title=\"National Provider Identifier\">United States National Provider Identifier</a>/9941339100</span></p><p><b>organization</b>: <span><a href=\"http://terminology.hl7.org/5.3.0/NamingSystem-npi.html\" title=\"National Provider Identifier\">United States National Provider Identifier</a>/1234567893</span></p></blockquote><p><b>reasonCode</b>: preauthorization <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"http://hl7.org/fhir/R4/codesystem-claim-use.html\">Use</a>#preauthorization "Preauthorization")</span></p><p><b>reasonReference</b>: <span><code>http://example.org/cdex/payer/claim-ids</code>/Preauth123</span></p><h3>Restrictions</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Period</b></td></tr><tr><td style=\"display: none\">*</td><td>?? --> 2022-06-21</td></tr></table><blockquote><p><b>input</b></p><p><b>PALineNumber</b>: 1</p><p><b>type</b>: Questionnaires Needed <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"http://hl7.org/fhir/us/davinci-pas/STU2/CodeSystem-PASTempCodes.html\">PAS Temporary Codes</a>#questionnaires-needed)</span></p><p><b>value</b>: <a href=\"Questionnaire-cdex-questionnaire-example1.html\">Home Oxygen Therapy Questionnaire</a></p></blockquote><blockquote><p><b>input</b></p><p><b>type</b>: Payer URL <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"http://hl7.org/fhir/us/davinci-pas/STU2/CodeSystem-PASTempCodes.html\">PAS Temporary Codes</a>#payer-url)</span></p><p><b>value</b>: <a href=\"http://example.org/cdex/payer/$submit-attachment\">http://example.org/cdex/payer/$submit-attachment</a></p></blockquote><blockquote><p><b>input</b></p><p><b>type</b>: Purpose Of Use <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"CodeSystem-cdex-temp.html\">CDex Temporary Code System</a>#purpose-of-use)</span></p><p><b>value</b>: coverage authorization <span style=\"background: LightGoldenRodYellow; margin: 4px; border: 1px solid khaki\"> (<a href=\"http://terminology.hl7.org/5.5.0/CodeSystem-v3-ActReason.html\">ActReason</a>#COVAUTH)</span></p></blockquote><hr/><blockquote><p style=\"border: 1px #661aff solid; background-color: #e6e6ff; padding: 10px;\"><b>Amy Shaw </b> (no stated gender), DoB: 1987-02-20 ( Member Number/Member123\u00a0(use:\u00a0usual))</p><hr/><table class=\"grid\"><tr><td style=\"background-color: #f3f5da\" title=\"Other Id (see the one above)\">Other Id:</td><td colspan=\"3\">Patient Account Number/PA-123\u00a0(use:\u00a0usual)</td></tr></table></blockquote><hr/><blockquote><p><b>Generated Narrative: PractitionerRole #practitionerrole</b><a name=\"practitionerrole\"> </a><a name=\"hcpractitionerrole\"> </a></p><p><b>practitioner</b>: <span><a href=\"http://terminology.hl7.org/5.3.0/NamingSystem-npi.html\" title=\"National Provider Identifier\">United States National Provider Identifier</a>/9941339100</span></p><p><b>organization</b>: <span><a href=\"http://terminology.hl7.org/5.3.0/NamingSystem-npi.html\" title=\"National Provider Identifier\">United States National Provider Identifier</a>/1234567893</span></p></blockquote></div>"
},
"contained" : [{
"resourceType" : "Patient",
"id" : "patient",
"meta" : {
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-patient-demographics"]
},
"identifier" : [{
"use" : "usual",
"type" : {
"coding" : [{
"system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
"code" : "MB",
"display" : "Member Number"
}],
"text" : "Member Number"
},
"system" : "http://example.org/cdex/payer/member-ids",
"value" : "Member123"
},
{
"use" : "usual",
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/carin-bb/CodeSystem/C4BBIdentifierType",
"code" : "pat",
"display" : "Patient Account Number"
}],
"text" : "Patient Account Number"
},
"system" : "http://example.org/cdex/provider/patient-ids",
"value" : "PA-123"
}],
"name" : [{
"family" : "Shaw",
"given" : ["Amy"]
}],
"birthDate" : "1987-02-20"
},
{
"resourceType" : "PractitionerRole",
"id" : "practitionerrole",
"meta" : {
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-practitionerrole"]
},
"practitioner" : {
"identifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "9941339100"
}
},
"organization" : {
"identifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "1234567893"
}
}
}],
"identifier" : [{
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
"code" : "tracking-id",
"display" : "Tracking Id"
}],
"text" : "Re-Association Tracking Control Number"
},
"system" : "http://example.org/payer",
"value" : "trackingid1012"
}],
"status" : "in-progress",
"intent" : "order",
"code" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
"code" : "attachment-request-questionnaire"
}],
"text" : "Attachment Request Questionnaire"
},
"for" : {
"reference" : "#patient"
},
"authoredOn" : "2022-06-17T16:16:06Z",
"lastModified" : "2022-06-17T16:16:06Z",
"requester" : {
"identifier" : {
"system" : "http://example.org/cdex/payer/payer-ids",
"value" : "Payer123"
}
},
"owner" : {
"reference" : "#practitionerrole"
},
"reasonCode" : {
"coding" : [{
"system" : "http://hl7.org/fhir/claim-use",
"code" : "preauthorization",
"display" : "Preauthorization"
}],
"text" : "preauthorization"
},
"reasonReference" : {
"identifier" : {
"system" : "http://example.org/cdex/payer/claim-ids",
"value" : "Preauth123"
}
},
"restriction" : {
"period" : {
"end" : "2022-06-21"
}
},
"input" : [{
"extension" : [{
"url" : "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-paLineNumber",
"valueInteger" : 1
}],
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
"code" : "questionnaires-needed"
}]
},
"valueCanonical" : "http://example.org/cdex-questionnaire-example1",
"_valueCanonical" : {
"extension" : [{
"url" : "http://hl7.org/fhir/StructureDefinition/display",
"valueString" : "Home Oxygen Therapy Questionnaire"
}]
}
},
{
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
"code" : "payer-url"
}]
},
"valueUrl" : "http://example.org/cdex/payer/$submit-attachment"
},
{
"type" : {
"coding" : [{
"system" : "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
"code" : "purpose-of-use"
}]
},
"valueCodeableConcept" : {
"coding" : [{
"system" : "http://terminology.hl7.org/CodeSystem/v3-ActReason",
"code" : "COVAUTH",
"display" : "coverage authorization"
}]
}
}]
}
Request
GET http://example.org/FHIR/Questionnare/cdex-questionnaire-example1
Response Headers
HTTP/1.1 200 OK
Server: CDEX Example Provider Server
Location: http://example.org/FHIR/Questionnare/cdex-questionnaire-example1
...(other headers)
Response Body
{
"resourceType" : "Questionnaire",
"id" : "cdex-questionnaire-example1",
"meta" : {
"extension" : [{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
"valueString" : "CDex Questionnaire Example1"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
"valueMarkdown" : "This example is a simple data request Questionnaire used in the Task Based and Attachments transactions. It is adapted from the Da Vinci DTR IG."
}],
"profile" : ["http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-std-questionnaire"]
},
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><b>Structure</b><table border=\"1\" cellpadding=\"0\" cellspacing=\"0\" style=\"border: 1px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top;\"><tr style=\"border: 2px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top\"><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The linkID for the item\">LinkID</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Text for the item\">Text</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Minimum and Maximum # of times the item can appear in the instance\">Cardinality</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The type of the item\">Type</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Additional information about the item\">Description & Constraints</a><span style=\"float: right\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/></a></span></th></tr><tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck1.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_q_root.gif\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"QuestionnaireRoot\" class=\"hierarchy\"/> HomeOxygenTherapyQuestionnaire</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Questionnaire</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">http://example.org/cdex-questionnaire-example1#2.1.0-preview</td></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" id=\"item.1\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-text.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Text\" class=\"hierarchy\"/> 1</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/codesystem-item-type.html#item-type-text\">text</a></td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck00.png)\" id=\"item.2\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin_end.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-coding.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Coding\" class=\"hierarchy\"/> 2</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Order Reason</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/codesystem-item-type.html#item-type-choice\">choice</a></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Options: <a href=\"#opt-item.2\">4 options</a></td></tr>\r\n<tr><td colspan=\"5\" class=\"hierarchy\"><br/><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/> Documentation for this format</a></td></tr></table><hr/><p><b>Options Sets</b></p><a name=\"opt-item.2\"> </a><p><b>Answer options for 2 </b></p><ul><li style=\"font-size: 11px\">http://example.org#1 ("Initial or original order for certification")</li><li style=\"font-size: 11px\">http://example.org#2 ("Change in status")</li><li style=\"font-size: 11px\">http://example.org#3 ("Revision or change in equipment")</li><li style=\"font-size: 11px\">http://example.org#4 ("Replacement")</li></ul></div>"
},
"url" : "http://example.org/cdex-questionnaire-example1",
"identifier" : [{
"system" : "urn:ietf:rfc:3986",
"value" : "urn:oid:2.16.840.1.113883.4.642.40.21.35.1"
}],
"version" : "2.1.0-preview",
"name" : "HomeOxygenTherapyQuestionnaire",
"title" : "Home Oxygen Therapy Questionnaire",
"status" : "active",
"subjectType" : ["Patient"],
"date" : "2022-01-17",
"publisher" : "HL7 International / Payer/Provider Information Exchange Work Group",
"contact" : [{
"name" : "HL7 International / Payer/Provider Information Exchange Work Group",
"telecom" : [{
"system" : "url",
"value" : "http://www.hl7.org/Special/committees/claims"
},
{
"system" : "email",
"value" : "pie@lists.hl7.org"
}]
}],
"jurisdiction" : [{
"coding" : [{
"system" : "urn:iso:std:iso:3166",
"code" : "US"
}]
}],
"copyright" : "Used by permission of HL7 International all rights reserved Creative Commons License",
"item" : [{
"linkId" : "1",
"text" : "Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)",
"type" : "text",
"required" : true
},
{
"linkId" : "2",
"text" : "Order Reason",
"type" : "choice",
"required" : true,
"answerOption" : [{
"valueCoding" : {
"system" : "http://example.org",
"code" : "1",
"display" : "Initial or original order for certification"
}
},
{
"valueCoding" : {
"system" : "http://example.org",
"code" : "2",
"display" : "Change in status"
}
},
{
"valueCoding" : {
"system" : "http://example.org",
"code" : "3",
"display" : "Revision or change in equipment"
}
},
{
"valueCoding" : {
"system" : "http://example.org",
"code" : "4",
"display" : "Replacement"
}
}]
}]
}
Request
POST [base]/QuestionnaireResponse
Request Headers
Accept: application/fhir+json
Content-Type: application/fhir+json
...(other headers)
Request Body
{
"resourceType" : "QuestionnaireResponse",
"id" : "cdex-questionnaireresponse-example1",
"meta" : {
"extension" : [{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
"valueString" : "CDex QuestionnaireResponse Example1"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
"valueMarkdown" : "This Questionnaire Response example demonstrates the response to a CDEX Data Query or Attachments that uses a Questionnaire to request the data. It is adapted from the Da Vinci DTR IG."
}],
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-sdc-questionnaireresponse"]
},
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><table border=\"1\" cellpadding=\"0\" cellspacing=\"0\" style=\"border: 1px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top;\"><tr style=\"border: 2px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top\"><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The linkId for the item\">LinkId</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Text for the item\">Text</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Minimum and Maximum # of times the the itemcan appear in the instance\">Definition</a></th><th style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"The type of the item\">Answer</a><span style=\"float: right\"><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/></a></span></th></tr><tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck1.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_q_root.gif\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"QuestionnaireResponseRoot\" class=\"hierarchy\"/> cdex-questionnaireresponse-example1</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"></td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Questionnaire:<a href=\"Questionnaire-cdex-questionnaire-example1.html\">Home Oxygen Therapy Questionnaire</a></td></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-string.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Item\" class=\"hierarchy\"/> 1</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)</td><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : left; background-color: #F7F7F7; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Examplitis</td></tr>\r\n<tr style=\"border: 1px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck00.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin_end.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon-q-string.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Item\" class=\"hierarchy\"/> 2</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Order Reason</td><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : left; background-color: white; border: 1px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><span><span>example.org 4: Replacement</span></span></td></tr>\r\n<tr><td colspan=\"4\" class=\"hierarchy\"><br/><a href=\"http://hl7.org/fhir/R4/formats.html#table\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/> Documentation for this format</a></td></tr></table></div>"
},
"questionnaire" : "http://example.org/cdex-questionnaire-example1",
"status" : "completed",
"subject" : {
"identifier" : {
"use" : "usual",
"type" : {
"coding" : [{
"system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
"code" : "MB",
"display" : "Member Number"
}],
"text" : "Member Number"
},
"system" : "http://example.org/cdex/payer/member-ids",
"value" : "Member123"
},
"display" : "Amy Shaw"
},
"authored" : "2022-06-17",
"author" : {
"identifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "9941339100"
}
},
"item" : [{
"linkId" : "1",
"text" : "Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)",
"answer" : [{
"valueString" : "Examplitis"
}]
},
{
"linkId" : "2",
"text" : "Order Reason",
"answer" : [{
"valueCoding" : {
"system" : "http://example.org",
"code" : "4",
"display" : "Replacement"
}
}]
}]
}
Response Headers
HTTP/1.1 200 OK
Server: CDEX Example Provider Server
Location: http://example.org/FHIR/QuestionnaireResponse/cdex-questionnaireresponse-inline-example1/_history/1
...(other headers)
Request
PUT [base]/Task/cdex-task-example-22
Request Headers
Accept: application/fhir+json
Content-Type: application/fhir+json
...(other headers)
Request Body
{
"resourceType": "Task",
"id": "cdex-task-example22",
"meta": {
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/instance-name",
"valueString": "Inline Task Example22 Updateid"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/instance-description",
"valueMarkdown": "Task example used to create inline scenarios for this guide"
}
],
"profile": [
"http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-task-attachment-request"
]
},
"contained": [
{
"resourceType": "Patient",
"id": "patient",
"meta": {
"profile": [
"http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-patient-demographics"
]
},
"identifier": [
{
"use": "usual",
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MB",
"display": "Member Number"
}
],
"text": "Member Number"
},
"system": "http://example.org/cdex/payer/member-ids",
"value": "Member123"
},
{
"use": "usual",
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/carin-bb/CodeSystem/C4BBIdentifierType",
"code": "pat",
"display": "Patient Account Number"
}
],
"text": "Patient Account Number"
},
"system": "http://example.org/cdex/provider/patient-ids",
"value": "PA-123"
}
],
"name": [
{
"family": "Shaw",
"given": [
"Amy"
]
}
],
"birthDate": "1987-02-20"
},
{
"resourceType": "PractitionerRole",
"id": "practitionerrole",
"meta": {
"profile": [
"http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-practitionerrole"
]
},
"practitioner": {
"identifier": {
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "9941339100"
}
},
"organization": {
"identifier": {
"system": "http://hl7.org/fhir/sid/us-npi",
"value": "1234567893"
}
}
}
],
"identifier": [
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
"code": "tracking-id",
"display": "Tracking Id"
}
],
"text": "Re-Association Tracking Control Number"
},
"system": "http://example.org/payer",
"value": "trackingid1012"
}
],
"status": "in-progress",
"intent": "order",
"code": {
"coding": [
{
"system": "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
"code": "attachment-request-questionnaire"
}
],
"text": "Attachment Request Questionnaire"
},
"for": {
"reference": "#patient"
},
"authoredOn": "2022-06-17T16:16:06+00:00",
"lastModified": "2022-06-17T16:17:06+00:00",
"requester": {
"identifier": {
"system": "http://example.org/cdex/payer/payer-ids",
"value": "Payer123"
}
},
"owner": {
"reference": "#practitionerrole"
},
"reasonCode": {
"coding": [
{
"system": "http://hl7.org/fhir/claim-use",
"code": "preauthorization",
"display": "Preauthorization"
}
],
"text": "preauthorization"
},
"reasonReference": {
"identifier": {
"system": "http://example.org/cdex/payer/claim-ids",
"value": "Preauth123"
}
},
"restriction": {
"period": {
"end": "2022-06-21"
}
},
"input": [
{
"extension": [
{
"url": "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-paLineNumber",
"valueInteger": 1
}
],
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/uv/sdc/CodeSystem/temp",
"code": "questionnaire"
}
]
},
"valueCanonical": "http://example.org/cdex-questionnaire-inline-example1|2.1.0-preview"
},
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes",
"code": "payer-url"
}
]
},
"valueUrl": "http://example.org/cdex/payer/$submit-attachment"
},
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp",
"code": "purpose-of-use"
}
]
},
"valueCodeableConcept": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
"code": "COVAUTH",
"display": "coverage authorization"
}
]
}
}
],
"output": [
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/uv/sdc/CodeSystem/temp",
"code": "questionnaire-response"
}
]
},
"valueReference": {
"reference": "QuestionnaireResponse/cdex-questionnaireresponse-example1"
}
}
]
}
Response Headers
HTTP/1.1 200 OK
Server: CDEX Example Provider Server
Location: http://example.org/FHIR/Task/cdex-task-example22/_history/2
...(other headers)
$submit-attachment
Operation to Payer endpointRequest
POST [base]/$submit-attachment
Request Headers
Request Headers
Accept: application/fhir+json
Content-Type: application/fhir+json
...(other headers)
Request Body
{
"resourceType" : "Parameters",
"meta" : {
"extension" : [{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-name",
"valueString" : "CDex Parameters Example 5"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/instance-description",
"valueMarkdown" : "**Completed QuestionnaireResponse Attachment Example:** Parameters Resource example showing how it is used to submit a solicited attachment using the `$submit-attachment` operation. The attachment parameter payload is a QuestionnaireResponse completed using DTR in response to a Questionnaire sent in the Attachments request."
}],
"profile" : ["http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-parameters-submit-attachment"]
},
"parameter" : [{
"name" : "TrackingId",
"valueIdentifier" : {
"system" : "http://example.org/payer",
"value" : "trackingid1012"
}
},
{
"name" : "AttachTo",
"valueCode" : "preauthorization"
},
{
"name" : "PayerId",
"valueIdentifier" : {
"system" : "http://example.org/cdex/payer/payer-ids",
"value" : "payer123"
}
},
{
"name" : "OrganizationId",
"valueIdentifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "1234567893"
}
},
{
"name" : "ProviderId",
"valueIdentifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "9941339100"
}
},
{
"name" : "MemberId",
"valueIdentifier" : {
"system" : "http://example.org/cdex/payer/member-ids",
"value" : "Member123"
}
},
{
"name" : "Attachment",
"part" : [{
"name" : "LineItem",
"valueString" : "1"
},
{
"name" : "Content",
"resource" : {
"resourceType" : "QuestionnaireResponse",
"id" : "cdex-questionnaireresponse-example1",
"questionnaire" : "http://example.org/cdex-questionnaire-example1",
"status" : "completed",
"subject" : {
"identifier" : {
"use" : "usual",
"type" : {
"coding" : [{
"system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
"code" : "MB",
"display" : "Member Number"
}],
"text" : "Member Number"
},
"system" : "http://example.org/cdex/payer/member-ids",
"value" : "Member123"
},
"display" : "Amy Shaw"
},
"authored" : "2022-06-17",
"author" : {
"identifier" : {
"system" : "http://hl7.org/fhir/sid/us-npi",
"value" : "9941339100"
}
},
"item" : [{
"linkId" : "1",
"text" : "Relevant Patient Diagnoses (conditions that might be expected to improve with oxygen therapy)",
"answer" : [{
"valueString" : "Examplitis"
}]
},
{
"linkId" : "2",
"text" : "Order Reason",
"answer" : [{
"valueCoding" : {
"system" : "http://example.org",
"code" : "4",
"display" : "Replacement"
}
}]
}]
}
}]
}]
}
Response Headers
HTTP/1.1 200 OK
Server: CDEX Example Payer Server
Content-Type: application/fhir+json;charset=utf-8
...(other headers)
Refer to the Signatures section in the Sending Attachments page.