This page is part of the FHIR Specification (v4.6.0: R5 Draft Ballot - see ballot notes). 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 Group | Maturity Level: 2 | Trial Use | Security Category: Patient | Compartments: Practitioner |
This resource provides the details including amount of a payment and allocates the payment items being paid.
The PaymentReconciliation resource provides the bulk payment details associated with a payment by the payor for receivable amounts, such as for goods and services rendered by a provider to patients covered by insurance plans offered by that payor. These are the payment reconciliation details which may align to the individual payment amounts indicated on discrete ClaimResponses or Invoices for example.
Bulk payments need to provide a means to associate the amounts paid against specific Claims, Invoices, and other financial exchanges and adjustments, to the bulk payment itself in order to reconcile accounts receivable.
The PaymentReconciliation resource is a "event" resource from a FHIR workflow perspective - see Workflow Event.
Additional information regarding electronic payment notice content and usage may be found at:
The PaymentReconciliation resource serves to correlate a payment amount to the adjudicated claim amounts appearing on one or more ClaimResponses. PaymentReconciliation provides the bulk payment details associated with a payment by the payor for goods and services rendered by a provider to patients covered by insurance plans offered by that payor.
The PaymentNotice resource is used to indicate that a payment has, or is about to occur. The resource is used commonly when tracking of payment occurences is required for regulatory or business purposes.
The ClaimResponse resource is an insurer's adjudication and/or authorization of a set of healthcare-related goods and services for a patient against the patient's insurance coverages and does not indicate that payment has occured.
For reporting out to patients or transferring data to patient centered applications, such as patient health Record (PHR) application, the ExplanationOfBenefit should be used instead.
The eClaim domain includes a number of related resources
PaymentReconciliation | Provides the bulk payment details associated with a payment by the payor for goods and services rendered by a provider to patients covered by insurance plans offered by that payor. |
ClaimResponse | A payor's adjudication and/or authorization response to the suite of services provided in a Claim. Typically the ClaimResponse references the Claim but does not duplicate the clinical or financial information provided in the claim. |
ExplanationOfBenefit | This resource combines the information from the Claim and the ClaimResponse, stripping out any provider or payor proprietary information, into a unified information model suitable for use for: patient reporting; transferring information to a Patient Health Record system; and, supporting complete claim and adjudication information exchange with regulatory and analytics organizations and other parts of the provider's organization. |
PaymentNotice | An indication that a payment has occured, is about to occur, or has been cancelled. |
This resource is referenced by PaymentNotice.
This resource implements the Event pattern.
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
PaymentReconciliation | TU | DomainResource | PaymentReconciliation resource Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | 0..* | Identifier | Business Identifier for a payment reconciliation | |
status | ?!Σ | 1..1 | code | active | cancelled | draft | entered-in-error Financial Resource Status Codes (Required) |
period | Σ | 0..1 | Period | Period covered |
created | Σ | 1..1 | dateTime | Creation date |
paymentIssuer | Σ | 0..1 | Reference(Organization) | Party generating payment |
request | 0..1 | Reference(Task) | Reference to requesting resource | |
requestor | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Responsible practitioner | |
outcome | 0..1 | code | queued | complete | error | partial PaymentOutcome (Required) | |
disposition | 0..1 | string | Disposition message | |
paymentDate | Σ | 1..1 | date | When payment issued |
paymentAmount | Σ | 1..1 | Money | Total amount of Payment |
paymentIdentifier | 0..1 | Identifier | Business identifier for the payment | |
detail | 0..* | BackboneElement | Settlement particulars | |
identifier | 0..1 | Identifier | Business identifier of the payment detail | |
predecessor | 0..1 | Identifier | Business identifier of the prior payment detail | |
type | 1..1 | CodeableConcept | Category of payment Payment Type Codes (Example) | |
request | 0..1 | Reference(Any) | Request giving rise to the payment | |
submitter | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Submitter of the request | |
response | 0..1 | Reference(Any) | Response committing to a payment | |
date | 0..1 | date | Date of commitment to pay | |
responsible | 0..1 | Reference(PractitionerRole) | Contact for the response | |
payee | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Recipient of the payment | |
amount | 0..1 | Money | Amount allocated to this payable | |
formCode | 0..1 | CodeableConcept | Printed form identifier Forms (Example) | |
processNote | 0..* | BackboneElement | Note concerning processing | |
type | 0..1 | code | display | print | printoper NoteType (Required) | |
text | 0..1 | string | Note explanatory text | |
Documentation for this format |
UML Diagram (Legend)
XML Template
<PaymentReconciliation xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Business Identifier for a payment reconciliation --></identifier> <status value="[code]"/><!-- 1..1 active | cancelled | draft | entered-in-error --> <period><!-- 0..1 Period Period covered --></period> <created value="[dateTime]"/><!-- 1..1 Creation date --> <paymentIssuer><!-- 0..1 Reference(Organization) Party generating payment --></paymentIssuer> <request><!-- 0..1 Reference(Task) Reference to requesting resource --></request> <requestor><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Responsible practitioner --></requestor> <outcome value="[code]"/><!-- 0..1 queued | complete | error | partial --> <disposition value="[string]"/><!-- 0..1 Disposition message --> <paymentDate value="[date]"/><!-- 1..1 When payment issued --> <paymentAmount><!-- 1..1 Money Total amount of Payment --></paymentAmount> <paymentIdentifier><!-- 0..1 Identifier Business identifier for the payment --></paymentIdentifier> <detail> <!-- 0..* Settlement particulars --> <identifier><!-- 0..1 Identifier Business identifier of the payment detail --></identifier> <predecessor><!-- 0..1 Identifier Business identifier of the prior payment detail --></predecessor> <type><!-- 1..1 CodeableConcept Category of payment --></type> <request><!-- 0..1 Reference(Any) Request giving rise to the payment --></request> <submitter><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Submitter of the request --></submitter> <response><!-- 0..1 Reference(Any) Response committing to a payment --></response> <date value="[date]"/><!-- 0..1 Date of commitment to pay --> <responsible><!-- 0..1 Reference(PractitionerRole) Contact for the response --></responsible> <payee><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Recipient of the payment --></payee> <amount><!-- 0..1 Money Amount allocated to this payable --></amount> </detail> <formCode><!-- 0..1 CodeableConcept Printed form identifier --></formCode> <processNote> <!-- 0..* Note concerning processing --> <type value="[code]"/><!-- 0..1 display | print | printoper --> <text value="[string]"/><!-- 0..1 Note explanatory text --> </processNote> </PaymentReconciliation>
JSON Template
{ "resourceType" : "PaymentReconciliation", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // Business Identifier for a payment reconciliation "status" : "<code>", // R! active | cancelled | draft | entered-in-error "period" : { Period }, // Period covered "created" : "<dateTime>", // R! Creation date "paymentIssuer" : { Reference(Organization) }, // Party generating payment "request" : { Reference(Task) }, // Reference to requesting resource "requestor" : { Reference(Organization|Practitioner|PractitionerRole) }, // Responsible practitioner "outcome" : "<code>", // queued | complete | error | partial "disposition" : "<string>", // Disposition message "paymentDate" : "<date>", // R! When payment issued "paymentAmount" : { Money }, // R! Total amount of Payment "paymentIdentifier" : { Identifier }, // Business identifier for the payment "detail" : [{ // Settlement particulars "identifier" : { Identifier }, // Business identifier of the payment detail "predecessor" : { Identifier }, // Business identifier of the prior payment detail "type" : { CodeableConcept }, // R! Category of payment "request" : { Reference(Any) }, // Request giving rise to the payment "submitter" : { Reference(Organization|Practitioner|PractitionerRole) }, // Submitter of the request "response" : { Reference(Any) }, // Response committing to a payment "date" : "<date>", // Date of commitment to pay "responsible" : { Reference(PractitionerRole) }, // Contact for the response "payee" : { Reference(Organization|Practitioner|PractitionerRole) }, // Recipient of the payment "amount" : { Money } // Amount allocated to this payable }], "formCode" : { CodeableConcept }, // Printed form identifier "processNote" : [{ // Note concerning processing "type" : "<code>", // display | print | printoper "text" : "<string>" // Note explanatory text }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:PaymentReconciliation; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:PaymentReconciliation.identifier [ Identifier ], ... ; # 0..* Business Identifier for a payment reconciliation fhir:PaymentReconciliation.status [ code ]; # 1..1 active | cancelled | draft | entered-in-error fhir:PaymentReconciliation.period [ Period ]; # 0..1 Period covered fhir:PaymentReconciliation.created [ dateTime ]; # 1..1 Creation date fhir:PaymentReconciliation.paymentIssuer [ Reference(Organization) ]; # 0..1 Party generating payment fhir:PaymentReconciliation.request [ Reference(Task) ]; # 0..1 Reference to requesting resource fhir:PaymentReconciliation.requestor [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Responsible practitioner fhir:PaymentReconciliation.outcome [ code ]; # 0..1 queued | complete | error | partial fhir:PaymentReconciliation.disposition [ string ]; # 0..1 Disposition message fhir:PaymentReconciliation.paymentDate [ date ]; # 1..1 When payment issued fhir:PaymentReconciliation.paymentAmount [ Money ]; # 1..1 Total amount of Payment fhir:PaymentReconciliation.paymentIdentifier [ Identifier ]; # 0..1 Business identifier for the payment fhir:PaymentReconciliation.detail [ # 0..* Settlement particulars fhir:PaymentReconciliation.detail.identifier [ Identifier ]; # 0..1 Business identifier of the payment detail fhir:PaymentReconciliation.detail.predecessor [ Identifier ]; # 0..1 Business identifier of the prior payment detail fhir:PaymentReconciliation.detail.type [ CodeableConcept ]; # 1..1 Category of payment fhir:PaymentReconciliation.detail.request [ Reference(Any) ]; # 0..1 Request giving rise to the payment fhir:PaymentReconciliation.detail.submitter [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Submitter of the request fhir:PaymentReconciliation.detail.response [ Reference(Any) ]; # 0..1 Response committing to a payment fhir:PaymentReconciliation.detail.date [ date ]; # 0..1 Date of commitment to pay fhir:PaymentReconciliation.detail.responsible [ Reference(PractitionerRole) ]; # 0..1 Contact for the response fhir:PaymentReconciliation.detail.payee [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Recipient of the payment fhir:PaymentReconciliation.detail.amount [ Money ]; # 0..1 Amount allocated to this payable ], ...; fhir:PaymentReconciliation.formCode [ CodeableConcept ]; # 0..1 Printed form identifier fhir:PaymentReconciliation.processNote [ # 0..* Note concerning processing fhir:PaymentReconciliation.processNote.type [ code ]; # 0..1 display | print | printoper fhir:PaymentReconciliation.processNote.text [ string ]; # 0..1 Note explanatory text ], ...; ]
Changes since R3
PaymentReconciliation | |
PaymentReconciliation.status |
|
PaymentReconciliation.outcome |
|
PaymentReconciliation.processNote.type |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 1 test that all execute ok. 1 fail round-trip testing and 1 r3 resources are invalid (0 errors).)
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
PaymentReconciliation | TU | DomainResource | PaymentReconciliation resource Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | 0..* | Identifier | Business Identifier for a payment reconciliation | |
status | ?!Σ | 1..1 | code | active | cancelled | draft | entered-in-error Financial Resource Status Codes (Required) |
period | Σ | 0..1 | Period | Period covered |
created | Σ | 1..1 | dateTime | Creation date |
paymentIssuer | Σ | 0..1 | Reference(Organization) | Party generating payment |
request | 0..1 | Reference(Task) | Reference to requesting resource | |
requestor | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Responsible practitioner | |
outcome | 0..1 | code | queued | complete | error | partial PaymentOutcome (Required) | |
disposition | 0..1 | string | Disposition message | |
paymentDate | Σ | 1..1 | date | When payment issued |
paymentAmount | Σ | 1..1 | Money | Total amount of Payment |
paymentIdentifier | 0..1 | Identifier | Business identifier for the payment | |
detail | 0..* | BackboneElement | Settlement particulars | |
identifier | 0..1 | Identifier | Business identifier of the payment detail | |
predecessor | 0..1 | Identifier | Business identifier of the prior payment detail | |
type | 1..1 | CodeableConcept | Category of payment Payment Type Codes (Example) | |
request | 0..1 | Reference(Any) | Request giving rise to the payment | |
submitter | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Submitter of the request | |
response | 0..1 | Reference(Any) | Response committing to a payment | |
date | 0..1 | date | Date of commitment to pay | |
responsible | 0..1 | Reference(PractitionerRole) | Contact for the response | |
payee | 0..1 | Reference(Practitioner | PractitionerRole | Organization) | Recipient of the payment | |
amount | 0..1 | Money | Amount allocated to this payable | |
formCode | 0..1 | CodeableConcept | Printed form identifier Forms (Example) | |
processNote | 0..* | BackboneElement | Note concerning processing | |
type | 0..1 | code | display | print | printoper NoteType (Required) | |
text | 0..1 | string | Note explanatory text | |
Documentation for this format |
XML Template
<PaymentReconciliation xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Business Identifier for a payment reconciliation --></identifier> <status value="[code]"/><!-- 1..1 active | cancelled | draft | entered-in-error --> <period><!-- 0..1 Period Period covered --></period> <created value="[dateTime]"/><!-- 1..1 Creation date --> <paymentIssuer><!-- 0..1 Reference(Organization) Party generating payment --></paymentIssuer> <request><!-- 0..1 Reference(Task) Reference to requesting resource --></request> <requestor><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Responsible practitioner --></requestor> <outcome value="[code]"/><!-- 0..1 queued | complete | error | partial --> <disposition value="[string]"/><!-- 0..1 Disposition message --> <paymentDate value="[date]"/><!-- 1..1 When payment issued --> <paymentAmount><!-- 1..1 Money Total amount of Payment --></paymentAmount> <paymentIdentifier><!-- 0..1 Identifier Business identifier for the payment --></paymentIdentifier> <detail> <!-- 0..* Settlement particulars --> <identifier><!-- 0..1 Identifier Business identifier of the payment detail --></identifier> <predecessor><!-- 0..1 Identifier Business identifier of the prior payment detail --></predecessor> <type><!-- 1..1 CodeableConcept Category of payment --></type> <request><!-- 0..1 Reference(Any) Request giving rise to the payment --></request> <submitter><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Submitter of the request --></submitter> <response><!-- 0..1 Reference(Any) Response committing to a payment --></response> <date value="[date]"/><!-- 0..1 Date of commitment to pay --> <responsible><!-- 0..1 Reference(PractitionerRole) Contact for the response --></responsible> <payee><!-- 0..1 Reference(Organization|Practitioner|PractitionerRole) Recipient of the payment --></payee> <amount><!-- 0..1 Money Amount allocated to this payable --></amount> </detail> <formCode><!-- 0..1 CodeableConcept Printed form identifier --></formCode> <processNote> <!-- 0..* Note concerning processing --> <type value="[code]"/><!-- 0..1 display | print | printoper --> <text value="[string]"/><!-- 0..1 Note explanatory text --> </processNote> </PaymentReconciliation>
JSON Template
{ "resourceType" : "PaymentReconciliation", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // Business Identifier for a payment reconciliation "status" : "<code>", // R! active | cancelled | draft | entered-in-error "period" : { Period }, // Period covered "created" : "<dateTime>", // R! Creation date "paymentIssuer" : { Reference(Organization) }, // Party generating payment "request" : { Reference(Task) }, // Reference to requesting resource "requestor" : { Reference(Organization|Practitioner|PractitionerRole) }, // Responsible practitioner "outcome" : "<code>", // queued | complete | error | partial "disposition" : "<string>", // Disposition message "paymentDate" : "<date>", // R! When payment issued "paymentAmount" : { Money }, // R! Total amount of Payment "paymentIdentifier" : { Identifier }, // Business identifier for the payment "detail" : [{ // Settlement particulars "identifier" : { Identifier }, // Business identifier of the payment detail "predecessor" : { Identifier }, // Business identifier of the prior payment detail "type" : { CodeableConcept }, // R! Category of payment "request" : { Reference(Any) }, // Request giving rise to the payment "submitter" : { Reference(Organization|Practitioner|PractitionerRole) }, // Submitter of the request "response" : { Reference(Any) }, // Response committing to a payment "date" : "<date>", // Date of commitment to pay "responsible" : { Reference(PractitionerRole) }, // Contact for the response "payee" : { Reference(Organization|Practitioner|PractitionerRole) }, // Recipient of the payment "amount" : { Money } // Amount allocated to this payable }], "formCode" : { CodeableConcept }, // Printed form identifier "processNote" : [{ // Note concerning processing "type" : "<code>", // display | print | printoper "text" : "<string>" // Note explanatory text }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:PaymentReconciliation; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:PaymentReconciliation.identifier [ Identifier ], ... ; # 0..* Business Identifier for a payment reconciliation fhir:PaymentReconciliation.status [ code ]; # 1..1 active | cancelled | draft | entered-in-error fhir:PaymentReconciliation.period [ Period ]; # 0..1 Period covered fhir:PaymentReconciliation.created [ dateTime ]; # 1..1 Creation date fhir:PaymentReconciliation.paymentIssuer [ Reference(Organization) ]; # 0..1 Party generating payment fhir:PaymentReconciliation.request [ Reference(Task) ]; # 0..1 Reference to requesting resource fhir:PaymentReconciliation.requestor [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Responsible practitioner fhir:PaymentReconciliation.outcome [ code ]; # 0..1 queued | complete | error | partial fhir:PaymentReconciliation.disposition [ string ]; # 0..1 Disposition message fhir:PaymentReconciliation.paymentDate [ date ]; # 1..1 When payment issued fhir:PaymentReconciliation.paymentAmount [ Money ]; # 1..1 Total amount of Payment fhir:PaymentReconciliation.paymentIdentifier [ Identifier ]; # 0..1 Business identifier for the payment fhir:PaymentReconciliation.detail [ # 0..* Settlement particulars fhir:PaymentReconciliation.detail.identifier [ Identifier ]; # 0..1 Business identifier of the payment detail fhir:PaymentReconciliation.detail.predecessor [ Identifier ]; # 0..1 Business identifier of the prior payment detail fhir:PaymentReconciliation.detail.type [ CodeableConcept ]; # 1..1 Category of payment fhir:PaymentReconciliation.detail.request [ Reference(Any) ]; # 0..1 Request giving rise to the payment fhir:PaymentReconciliation.detail.submitter [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Submitter of the request fhir:PaymentReconciliation.detail.response [ Reference(Any) ]; # 0..1 Response committing to a payment fhir:PaymentReconciliation.detail.date [ date ]; # 0..1 Date of commitment to pay fhir:PaymentReconciliation.detail.responsible [ Reference(PractitionerRole) ]; # 0..1 Contact for the response fhir:PaymentReconciliation.detail.payee [ Reference(Organization|Practitioner|PractitionerRole) ]; # 0..1 Recipient of the payment fhir:PaymentReconciliation.detail.amount [ Money ]; # 0..1 Amount allocated to this payable ], ...; fhir:PaymentReconciliation.formCode [ CodeableConcept ]; # 0..1 Printed form identifier fhir:PaymentReconciliation.processNote [ # 0..* Note concerning processing fhir:PaymentReconciliation.processNote.type [ code ]; # 0..1 display | print | printoper fhir:PaymentReconciliation.processNote.text [ string ]; # 0..1 Note explanatory text ], ...; ]
Changes since Release 3
PaymentReconciliation | |
PaymentReconciliation.status |
|
PaymentReconciliation.outcome |
|
PaymentReconciliation.processNote.type |
|
See the Full Difference for further information
This analysis is available as XML or JSON.
See R3 <--> R4 Conversion Maps (status = 1 test that all execute ok. 1 fail round-trip testing and 1 r3 resources are invalid (0 errors).)
See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis a
Path | Definition | Type | Reference |
---|---|---|---|
PaymentReconciliation.status | Required | FinancialResourceStatusCodes | |
PaymentReconciliation.outcome | Required | PaymentOutcome | |
PaymentReconciliation.detail.type | Example | PaymentTypeCodes | |
PaymentReconciliation.formCode | Example | Form Codes | |
PaymentReconciliation.processNote.type | Required | NoteType |
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Expression | In Common |
created N | date | The creation date | PaymentReconciliation.created | |
disposition N | string | The contents of the disposition message | PaymentReconciliation.disposition | |
identifier | token | The business identifier of the ExplanationOfBenefit | PaymentReconciliation.identifier | |
outcome N | token | The processing outcome | PaymentReconciliation.outcome | |
payment-issuer | reference | The organization which generated this resource | PaymentReconciliation.paymentIssuer (Organization) | |
request | reference | The reference to the claim | PaymentReconciliation.request (Task) | |
requestor | reference | The reference to the provider who submitted the claim | PaymentReconciliation.requestor (Practitioner, Organization, PractitionerRole) | |
status N | token | The status of the payment reconciliation | PaymentReconciliation.status |