PackagesCanonicalsLogsProblems
    Packages
    hl7.fhir.us.davinci-cdex.r4b@2.1.0-snapshot
    http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-task-attachment-request
description: Payers use this [Task](http://hl7.org/StructureDefinition/Task) based profile to request additional documentation (\"attachments\") for claims or prior authorizations. It constrains the Task resource to minimal necessary data elements needed to request attachments and respond in a way that is compatible with existing X12 277 RFAI and 278 response transactions to allow for association and requests for (typically PDF and CCDA) documents using LOINC and X12 standard codes. It also supports requests for more detailed missing data using Questionnaire, CQL, and QuestionnaireResponse, as supported by Da Vinci DTR.\n\nIt constrains the following elements to be *mandatory* (min=1):\n\n- A [contained](http://hl7.org/fhir/R4B/references.html) Patient Resource defined by the [CDex Patient Demographics Profile](StructureDefinition-cdex-patient-demographics.html) and communicating additional patient demographic data elements.\n- A [contained](http://hl7.org/fhir/R4B/references.html) PractitionerRole Resource defined by the [CDex PractitionerRole Profile](StructureDefinition-cdex-practitionerrole.html) to communicate 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.\n- A `Task.identifier` element representing the payers tracking identifier (referred to as the “re-association tracking control numbers”)\n- A `Task.status` with a required binding to HRex [Task Status ValueSet](http://hl7.org/fhir/us/davinci-hrex/ValueSet-hrex-task-status.html) (this element is a mandatory Task element). For guidance when the provider cannot complete the Task, refer to the [When The Task Cannot Be Completed section](task-based-approach.html#when-the-task-cannot-be-completed).\n- A `Task.intent` element that is fixed to \"order\" (this element is a mandatory Task element)\n- A `Task.code` of either \"attachment-request-code\" or \"attachment-request-questionnaire\"  communicating that the Payer is requesting attachments for a claim or prior authorization using a code or data request questionnaire.\n  - If the code is \"attachment-request-code\", the provider system returns attachment(s) identified by the attachment code(s) in the \"AttachmentsNeeded\" input parameter.\n  - If the code is \"attachment-request-questionnaire\", the provider system uses [Documentation Templates and Rules (DTR)](https://hl7.org/fhir/us/davinci-dtr/index.html) to complete the Questionnaire(s) referenced in the \"QuestionnairesNeeded\" input parameter.\n  - When either code is present, the provider system uses the $submit-attachment operation to return the information to the endpoint provided in the \"PayerUrl\" input parameter.    \n- A `Task.requester`.identifier element representing the Payer ID\n- A `Task.owner`.reference element that is fixed to \"\\#practionerrole\" -  a reference to the contained PractitionerRole Resource that represents the Provider ID.\n- A `Task.for`.reference element that is fixed to \"\\#patient\" - a reference to the contained Patient Resource that represents patient demographic data.\n- A `Task.reasonCode` to communicate whether the attachments are for a claim or prior authorization.\n- A `Task.reasonReference`.reference referencing the claim or prior authorization ID (business Identifier).\n- A \"PayerUrl\" `Task.input` element representing the Payer endpoint URL the provider uses when submitting attachments with the `[$submit-attachment`](OperationDefinition-submit-attachment.html) operation.\n\nIt constrains the following elements to be [*must support*](attachments-conformance.html#cdex-must-support-definition) (min=0):\n\n- A `Task.Restriction.period` element representing the due date for submitting the attachments\n- A `Task.statusReason.text` to communicate the reason for the status (for example, if the Task is rejected or failed)\n- A \"AttachmentsNeeded\" `Task.input` element to communicate to the provider what attachments are needed using LOINC or X12 attachment codes.*\n- A \"AttachmentsNeeded\" or \"QuestionnairesNeeded\" `Task.input` element extension that communicates claim or prior authorization line item numbers associated with the attachment or questionnaire.\n- A \"signature\" `Task.input` element. This is a flag to indicate whether the requested data requires a signature. For more information about requiring and requesting signatures, refer to the [Signatures section](sending-attachments.html#signatures).\n- A \"service-date\" `Task.input` element representing the date of service or starting date of the service for the claim or prior authorization. It **SHALL** be present if the attachment is for a claim.\n\nIt defines the following *optional* elements:\n\n- A \"QuestionnairesNeeded\" Task.input element to communicate to the provider a URL of a data request [FHIR Questionnaire](http://hl7.org/fhir/questionnaire.html) that conforms to the [DTR Standard Questionnaire Profile](http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-std-questionnaire) or the [DTR Questionnaire for Adaptive Form Profile](http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-questionnaire-adapt).*\n  - A questionnaireDisplay extension to communicate the display name of the Questionnaire\n- A \"POU\" `Task.input` element that is used to indicate the purpose of use (POU) for the requested data using an extensible [CDex Purpose of Use Value Set](ValueSet-cdex-POU.html). Refer to the [Purpose of Use section](task-based-approach.html#purpose-of-use) For more information about sending purpose POU codes.\n- A \"multiple-submits\" `Task.input` element that is a flag to indicate whether the requested data can be sent in multiple submissions\n- A \"AttachmentsNeeded\" `Task.output` element that references the result(s) of the data request code.\n- A \"QuestionnairesNeeded\" `Task.output` element which references the [FHIR QuestionnaireResponse](http://hl7.org/fhir/questionnaireresponse.html) resulting from the data request Questionnaire. The QuestionnaireResponse conforms to the [CDex SDC QuestionnaireResponse Profile](StructureDefinition-cdex-sdc-questionnaireresponse.html) or the [SDC Adaptive Questionnaire Response Profile](http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse-adapt).\n\n\\* Either a \"AttachmentsNeeded\" or a \"QuestionnairesNeeded\" `Task.input` element is required
package_name: hl7.fhir.us.davinci-cdex.r4b
derivation: constraint
name: CDexTaskAttachmentRequest
type: Task
elements:
  restriction:
    mustSupport: true
    index: 29
    elements:
      period: {short: Attachments due date, mustSupport: true, index: 30}
  reasonCode:
    mustSupport: true
    index: 21
    elements:
      coding:
        mustSupport: true
        index: 22
        slicing:
          rules: open
          discriminator:
          - {path: $this, type: value}
          min: 1
          slices:
            use:
              match: {}
              schema:
                binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/davinci-cdex/ValueSet/cdex-claim-use'}
                mustSupport: true
                array: true
                min: 1
                _required: true
                index: 23
                elements:
                  system: {mustSupport: true, index: 24}
                  code: {short: claim | preauthorization, mustSupport: true, index: 25}
                required: [code]
      text:
        short: claim | preauthorization
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/davinci-cdex/ValueSet/cdex-claim-use'}
        mustSupport: true
        index: 26
    required: [coding]
  statusReason:
    mustSupport: true
    index: 8
    elements:
      text: {mustSupport: true, index: 9}
    required: [text]
  output:
    index: 78
    slicing:
      rules: open
      discriminator:
      - {path: type, type: pattern}
      min: null
      slices:
        AttachmentsNeeded:
          match:
            type:
              coding:
              - {code: attachments-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
          schema:
            short: Requested attachments
            index: 79
            elements:
              type:
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: attachments-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
                index: 80
              value:
                short: AttachmentsNeeded reference
                choices: [valueReference]
                index: 82
              valueReference: {type: Reference, short: AttachmentsNeeded reference, choiceOf: value, index: 83}
        QuestionnairesNeeded:
          match:
            type:
              coding:
              - {code: questionnaires-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
          schema:
            index: 84
            elements:
              type:
                type: CodeableConcept
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: questionnaires-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
                index: 85
              value:
                short: Reference to the QuestionnaireResponse
                choices: [valueReference]
                index: 87
              valueReference:
                type: Reference
                short: Reference to the QuestionnaireResponse
                choiceOf: value
                refers: ['http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-sdc-questionnaireresponse', 'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse-adapt']
                index: 88
            required: [valueReference, value]
  contained:
    mustSupport: true
    array: true
    min: 2
    index: 0
    slicing:
      rules: open
      discriminator:
      - {path: $this, type: type}
      min: 2
      slices:
        practitionerrole:
          match: {}
          schema: {short: Contained PractitionerRole resource, type: PractitionerRole, mustSupport: true, _required: true, index: 1}
          min: 1
          max: 1
        patient:
          match: {}
          schema: {short: Contained Patient resource, type: Patient, mustSupport: true, _required: true, index: 2}
          min: 1
          max: 1
  for:
    type: Reference
    short: Contained Patient.
    mustSupport: true
    refers: ['http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-patient-demographics']
    index: 15
    elements:
      reference:
        short: Contained resource reference
        pattern: {type: String, value: '#patient'}
        mustSupport: true
        index: 16
    required: [reference]
  requester:
    type: Reference
    short: Payer asking for attachments
    mustSupport: true
    refers: ['http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/hrex-organization']
    index: 17
    elements:
      identifier: {short: Payer ID, mustSupport: true, index: 18}
    required: [identifier]
  status:
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/davinci-hrex/ValueSet/hrex-task-status'}
    mustSupport: true
    index: 7
  code:
    short: attachment-request-code | attachment-request-questionnaire
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/davinci-pas/ValueSet/PASTaskCodes'}
    mustSupport: true
    index: 11
    elements:
      coding:
        mustSupport: true
        index: 12
        elements:
          system:
            pattern: {type: Uri, value: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
            mustSupport: true
            index: 13
          code: {mustSupport: true, index: 14}
        required: [code]
    required: [coding]
  identifier:
    mustSupport: true
    index: 3
    slicing:
      rules: open
      discriminator:
      - {path: $this, type: pattern}
      min: 1
      slices:
        tracking-id:
          match:
            type:
              coding:
              - {code: tracking-id, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
          schema:
            short: Re-association tracking control number
            mustSupport: true
            _required: true
            pattern:
              type: Identifier
              value:
                type:
                  coding:
                  - {code: tracking-id, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
            index: 4
            elements:
              system: {mustSupport: true, index: 5}
              value: {mustSupport: true, index: 6}
            required: [value]
  intent:
    pattern: {type: Code, value: order}
    mustSupport: true
    index: 10
  input:
    mustSupport: true
    array: true
    min: 2
    index: 31
    slicing:
      rules: open
      discriminator:
      - {path: type, type: pattern}
      min: 2
      slices:
        AttachmentsNeeded:
          match:
            type:
              coding:
              - {code: attachments-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
          schema:
            short: Attachment Code
            mustSupport: true
            binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/us/davinci-cdex/ValueSet/cdex-loinc-attachment-codes'}
            index: 32
            extensions: {}
            elements:
              extension:
                mustSupport: true
                index: 33
                elements:
                  url:
                    pattern: {type: Uri, value: 'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-paLineNumber'}
                    mustSupport: true
                    index: 34
                  value:
                    mustSupport: true
                    choices: [valueInteger]
                    index: 36
                  valueInteger: {type: integer, mustSupport: true, choiceOf: value, index: 37}
                required: [value, valueInteger]
              type:
                mustSupport: true
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: attachments-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
                index: 38
              value:
                short: Attachment code value
                mustSupport: true
                choices: [valueCodeableConcept]
                index: 40
              valueCodeableConcept: {type: CodeableConcept, short: Attachment code value, mustSupport: true, choiceOf: value, index: 41}
        QuestionnairesNeeded:
          match:
            type:
              coding:
              - {code: questionnaires-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
          schema:
            short: Data Request questionnaire
            index: 42
            extensions: {}
            elements:
              extension:
                mustSupport: true
                index: 43
                elements:
                  url:
                    pattern: {type: Uri, value: 'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-paLineNumber'}
                    mustSupport: true
                    index: 44
                  value:
                    mustSupport: true
                    choices: [valueInteger]
                    index: 46
                  valueInteger: {type: integer, mustSupport: true, choiceOf: value, index: 47}
                required: [value, valueInteger]
              type:
                type: CodeableConcept
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: questionnaires-needed, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
                index: 48
              value:
                short: URL
                choices: [valueCanonical]
                index: 50
              valueCanonical: {type: canonical, short: URL, choiceOf: value, index: 51}
              value[x]:
                extensions:
                  questionnaireDisplay: {url: 'http://hl7.org/fhir/StructureDefinition/display', min: 0, max: 1, type: Extension, index: 52}
                elements:
                  extension:
                    type: Extension
                    url: http://hl7.org/fhir/StructureDefinition/display
                    index: 52
                    slicing:
                      slices:
                        questionnaireDisplay:
                          match: {}
                          schema: {type: Extension, url: 'http://hl7.org/fhir/StructureDefinition/display', index: 52}
                          min: 0
                          max: 1
            required: [valueCanonical, value, type]
        PayerUrl:
          match:
            type:
              coding:
              - {code: payer-url, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
          schema:
            short: Payer Url
            mustSupport: true
            _required: true
            index: 53
            elements:
              type:
                mustSupport: true
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: payer-url, system: 'http://hl7.org/fhir/us/davinci-pas/CodeSystem/PASTempCodes'}
                index: 54
              value:
                short: Payer url value
                mustSupport: true
                choices: [valueUrl]
                index: 56
              valueUrl: {type: url, short: Payer url value, mustSupport: true, choiceOf: value, index: 57}
        service-date:
          match:
            type:
              coding:
              - {code: service-date, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
          schema:
            short: Service Date
            mustSupport: true
            index: 58
            elements:
              type:
                mustSupport: true
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: service-date, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
                index: 59
              value:
                short: Service Date value
                constraint:
                  cdex-2: {human: Date must be to day., severity: error, expression: $this.toString().length() = 10}
                mustSupport: true
                choices: [valueDate]
                index: 61
              valueDate:
                type: date
                short: Service Date value
                constraint:
                  cdex-2: {human: Date must be to day., severity: error, expression: $this.toString().length() = 10}
                mustSupport: true
                choiceOf: value
                index: 62
        signature:
          match:
            type:
              coding:
              - {code: signature-flag, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
          schema:
            short: Signature flag
            mustSupport: true
            index: 63
            elements:
              type:
                mustSupport: true
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: signature-flag, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
                index: 64
              value:
                short: Signature flag value
                mustSupport: true
                choices: [valueBoolean]
                index: 66
              valueBoolean: {type: boolean, short: Signature flag value, mustSupport: true, choiceOf: value, index: 67}
        POU:
          match:
            type:
              coding:
              - {code: purpose-of-use, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
          schema:
            short: Purpose of use code'
            index: 68
            elements:
              type:
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: purpose-of-use, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
                index: 69
              value:
                short: Purpose of use value
                choices: [valueCodeableConcept]
                index: 71
              valueCodeableConcept: {type: CodeableConcept, short: Purpose of use value, choiceOf: value, index: 72}
        multiple-submits:
          match:
            type:
              coding:
              - {code: multiple-submits-flag, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
          schema:
            short: Multiple submits flag
            index: 73
            elements:
              type:
                pattern:
                  type: CodeableConcept
                  value:
                    coding:
                    - {code: multiple-submits-flag, system: 'http://hl7.org/fhir/us/davinci-cdex/CodeSystem/cdex-temp'}
                index: 74
              value:
                short: Multiple submits flag value
                choices: [valueBoolean]
                index: 76
              valueBoolean: {type: boolean, short: Multiple submits flag value, choiceOf: value, index: 77}
  owner:
    type: Reference
    short: Provider who submitted claim or preauthorization
    mustSupport: true
    refers: ['http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-practitionerrole']
    index: 19
    elements:
      reference:
        short: Contained resource reference
        pattern: {type: String, value: '#practitionerrole'}
        mustSupport: true
        index: 20
    required: [reference]
  reasonReference:
    mustSupport: true
    index: 27
    elements:
      identifier: {short: Claim or prior authorization ID, mustSupport: true, index: 28}
    required: [identifier]
package_version: 2.1.0-snapshot
class: profile
kind: resource
url: http://hl7.org/fhir/us/davinci-cdex/StructureDefinition/cdex-task-attachment-request
base: http://hl7.org/fhir/StructureDefinition/Task
version: 2.1.0-snapshot
required: [owner, requester, for, identifier, reasonCode, code, reasonReference]