R4 Draft for Comment

This page is part of the FHIR Specification (v3.2.0: R4 Ballot 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Financial Management Work GroupMaturity Level: 2 Trial Use Compartments: Patient, Practitioner

Detailed Descriptions for the elements in the ClaimResponse resource.

ClaimResponse
Definition

This resource provides the adjudication details from the processing of a Claim resource.

Control1..1
Alternate NamesRemittance Advice
ClaimResponse.identifier
Definition

The Response business identifier.

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
ClaimResponse.status
Definition

The status of the resource instance.

Control0..1
Terminology BindingFinancial Resource Status Codes (Required)
Typecode
Is Modifiertrue
Summarytrue
Comments

This element is labeled as a modifier because the status contains the code cancelled and entered-in-error that mark the response as not currently valid.

ClaimResponse.patient
Definition

Patient Resource.

Control0..1
TypeReference(Patient)
ClaimResponse.created
Definition

The date when the enclosed suite of services were performed or completed.

Control0..1
TypedateTime
ClaimResponse.insurer
Definition

The Insurer who produced this adjudicated response.

Control0..1
TypeReference(Organization)
ClaimResponse.requestProvider
Definition

The practitioner who is responsible for the services rendered to the patient.

Control0..1
TypeReference(Practitioner)
ClaimResponse.requestOrganization
Definition

The organization which is responsible for the services rendered to the patient.

Control0..1
TypeReference(Organization)
ClaimResponse.request
Definition

Original request resource referrence.

Control0..1
TypeReference(Claim)
ClaimResponse.outcome
Definition

Transaction: error, complete, partial processing.

Control0..1
Terminology BindingClaim Processing Codes (Required)
Typecode
ClaimResponse.disposition
Definition

A description of the status of the adjudication.

Control0..1
Typestring
ClaimResponse.payeeType
Definition

Party to be reimbursed: Subscriber, provider, other.

Control0..1
Terminology BindingClaim Payee Type Codes (Example)
TypeCodeableConcept
ClaimResponse.item
Definition

The first tier service adjudications for submitted services.

Control0..*
ClaimResponse.item.itemSequence
Definition

A service line number.

Control1..1
TypepositiveInt
ClaimResponse.item.noteNumber
Definition

A list of note references to the notes provided below.

Control0..*
TypepositiveInt
ClaimResponse.item.adjudication
Definition

The adjudication results.

Control0..*
ClaimResponse.item.adjudication.category
Definition

Code indicating: Co-Pay, deductible, eligible, benefit, tax, etc.

Control1..1
Terminology BindingAdjudication Value Codes (Example)
TypeCodeableConcept
ClaimResponse.item.adjudication.reason
Definition

Adjudication reason such as limit reached.

Control0..1
Terminology BindingAdjudication Reason Codes (Example)
TypeCodeableConcept
ClaimResponse.item.adjudication.amount
Definition

Monetary amount associated with the code.

Control0..1
TypeMoney
ClaimResponse.item.adjudication.value
Definition

A non-monetary value for example a percentage. Mutually exclusive to the amount element above.

Control0..1
Typedecimal
ClaimResponse.item.detail
Definition

The second tier service adjudications for submitted services.

Control0..*
ClaimResponse.item.detail.detailSequence
Definition

A service line number.

Control1..1
TypepositiveInt
ClaimResponse.item.detail.noteNumber
Definition

A list of note references to the notes provided below.

Control0..*
TypepositiveInt
ClaimResponse.item.detail.adjudication
Definition

The adjudications results.

Control0..*
TypeSee ClaimResponse.item.adjudication
ClaimResponse.item.detail.subDetail
Definition

The third tier service adjudications for submitted services.

Control0..*
ClaimResponse.item.detail.subDetail.subDetailSequence
Definition

A service line number.

Control1..1
TypepositiveInt
ClaimResponse.item.detail.subDetail.noteNumber
Definition

A list of note references to the notes provided below.

Control0..*
TypepositiveInt
ClaimResponse.item.detail.subDetail.adjudication
Definition

The adjudications results.

Control0..*
TypeSee ClaimResponse.item.adjudication
ClaimResponse.addItem
Definition

The first tier service adjudications for payor added services.

Control0..*
ClaimResponse.addItem.itemSequence
Definition

List of input service items which this service line is intended to replace.

Control0..*
TypepositiveInt
ClaimResponse.addItem.detailSequence
Definition

The sequence number of the addition within the line item submitted which contains the error. This value is omitted when the error is not related to an Addition.

Control0..*
TypepositiveInt
ClaimResponse.addItem.subdetailSequence
Definition

The sequence number of the addition within the line item submitted which contains the error. This value is omitted when the error is not related to an Addition.

Control0..*
TypepositiveInt
ClaimResponse.addItem.service
Definition

A code to indicate the Professional Service or Product supplied.

Control0..1
Terminology BindingUSCLS Codes (Example)
TypeCodeableConcept
ClaimResponse.addItem.modifier
Definition

Item typification or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or for medical whether the treatment was outside the clinic or out of office hours.

Control0..*
Terminology BindingModifier type Codes (Example)
TypeCodeableConcept
Requirements

May impact on adjudication.

ClaimResponse.addItem.fee
Definition

The fee charged for the professional service or product..

Control0..1
TypeMoney
ClaimResponse.addItem.noteNumber
Definition

A list of note references to the notes provided below.

Control0..*
TypepositiveInt
ClaimResponse.addItem.adjudication
Definition

The adjudications results.

Control0..*
TypeSee ClaimResponse.item.adjudication
ClaimResponse.error
Definition

Mutually exclusive with Services Provided (Item).

Control0..*
ClaimResponse.error.itemSequence
Definition

The sequence number of the line item submitted which contains the error. This value is omitted when the error is elsewhere.

Control0..1
TypepositiveInt
ClaimResponse.error.detailSequence
Definition

The sequence number of the addition within the line item submitted which contains the error. This value is omitted when the error is not related to an Addition.

Control0..1
TypepositiveInt
ClaimResponse.error.subDetailSequence
Definition

The sequence number of the addition within the line item submitted which contains the error. This value is omitted when the error is not related to an Addition.

Control0..1
TypepositiveInt
ClaimResponse.error.code
Definition

An error code,from a specified code system, which details why the claim could not be adjudicated.

Control1..1
Terminology BindingAdjudication Error Codes (Example)
TypeCodeableConcept
ClaimResponse.totalCost
Definition

The total cost of the services reported.

Control0..1
TypeMoney
Requirements

This is a check value that the receiver calculates and returns.

ClaimResponse.unallocDeductable
Definition

The amount of deductible applied which was not allocated to any particular service line.

Control0..1
TypeMoney
ClaimResponse.totalBenefit
Definition

Total amount of benefit payable (Equal to sum of the Benefit amounts from all detail lines and additions less the Unallocated Deductible).

Control0..1
TypeMoney
ClaimResponse.payment
Definition

Payment details for the claim if the claim has been paid.

Control0..1
ClaimResponse.payment.type
Definition

Whether this represents partial or complete payment of the claim.

Control0..1
Terminology BindingExample Payment Type Codes (Example)
TypeCodeableConcept
ClaimResponse.payment.adjustment
Definition

Adjustment to the payment of this transaction which is not related to adjudication of this transaction.

Control0..1
TypeMoney
ClaimResponse.payment.adjustmentReason
Definition

Reason for the payment adjustment.

Control0..1
Terminology BindingPayment Adjustment Reason Codes (Example)
TypeCodeableConcept
ClaimResponse.payment.date
Definition

Estimated payment data.

Control0..1
Typedate
ClaimResponse.payment.amount
Definition

Payable less any payment adjustment.

Control0..1
TypeMoney
ClaimResponse.payment.identifier
Definition

Payment identifier.

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..1
TypeIdentifier
ClaimResponse.reserved
Definition

Status of funds reservation (For provider, for Patient, None).

Control0..1
Terminology BindingFunds Reservation Codes (Example)
TypeCoding
ClaimResponse.form
Definition

The form to be used for printing the content.

Control0..1
Terminology BindingForm Codes (Example)
TypeCodeableConcept
ClaimResponse.processNote
Definition

Note text.

Control0..*
ClaimResponse.processNote.number
Definition

An integer associated with each note which may be referred to from each service line item.

Control0..1
TypepositiveInt
ClaimResponse.processNote.type
Definition

The note purpose: Print/Display.

Control0..1
Terminology BindingNoteType (Required)
Typecode
ClaimResponse.processNote.text
Definition

The note text.

Control0..1
Typestring
ClaimResponse.processNote.language
Definition

The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. "en" for English, or "en-US" for American English versus "en-EN" for England English.

Control0..1
Terminology BindingCommon Languages (Extensible but limited to ??)
TypeCodeableConcept
ClaimResponse.communicationRequest
Definition

Request for additional supporting or authorizing information, such as: documents, images or resources.

Control0..*
TypeReference(CommunicationRequest)
ClaimResponse.insurance
Definition

Financial instrument by which payment information for health care.

Control0..*
Requirements

Health care programs and insurers are significant payors of health service costs.

ClaimResponse.insurance.sequence
Definition

A service line item.

Control1..1
TypepositiveInt
Requirements

To maintain order of the coverages.

ClaimResponse.insurance.focal
Definition

The instance number of the Coverage which is the focus for adjudication. The Coverage against which the claim is to be adjudicated.

Control1..1
Typeboolean
Requirements

To identify which coverage is being adjudicated.

ClaimResponse.insurance.coverage
Definition

Reference to the program or plan identification, underwriter or payor.

Control1..1
TypeReference(Coverage)
Requirements

Need to identify the issuer to target for processing and for coordination of benefit processing.

ClaimResponse.insurance.businessArrangement
Definition

The contract number of a business agreement which describes the terms and conditions.

Control0..1
Typestring
ClaimResponse.insurance.preAuthRef
Definition

A list of references from the Insurer to which these services pertain.

Control0..*
Typestring
Requirements

To provide any pre-determination or prior authorization reference.

ClaimResponse.insurance.claimResponse
Definition

The Coverages adjudication details.

Control0..1
TypeReference(ClaimResponse)
Requirements

Used by downstream payers to determine what balance remains and the net payable.