US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001 United States of America flag

US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.9.0 See the Directory of published versions

Resource Profile: DebtPortalPaymentReconciliation - Mappings

Active as of 2025-09-30

Mappings for the DebtPortalPaymentReconciliation resource profile.

Scroll down for the Raw FHIR, CDW & SDA mappings (if any).

Note that the CDW, SDA and VPR XML mappings are derived from a look-up based on the VistA source.

Mapping Sources

Use Case: Debt Portal (Source)Use Case: Debt Portal (Source)PATIENT (2)PRESCRIPTION (52)106IB NUMBERAR DEBTOR (340).01DEBTOR.03STATEMENT DAY1.01STREET ADDRESS #11.02STREET ADDRESS #21.03STREET ADDRESS #31.04CITY1.05STATE1.06ZIP CODE1.07PHONE NUMBER1.08FOREIGN COUNTRY CODEINTEGRATED BILLING ACTION (350).001IEN.02PATIENT.03ACTION TYPE.07TOTAL CHARGE.09PARENT CHARGE.1CANCELLATION REASON.11AR BILL NUMBER.12AR TRANSACTION NUMBER.14DATE BILLED FROM.15DATE BILLED TO12DATE ENTRY ADDEDIB-FB INTERFACE TRACKING (360)1.02BILL/CLAIMSBILL/CLAIMS (399).08PTF ENTRY NUMBER304PROCEDURESACCOUNTS RECEIVABLE (430).01BILL NO.3ORIGINAL AMOUNT7PATIENT8CURRENT STATUS9DEBTOR10DATE BILL PREPARED11CURRENT BALANCE12SITE35AMENDED AMOUNT71PRINCIPAL BALANCE72INTEREST BALANCE73ADMINISTRATIVE COST BALANCE74MARSHAL FEE75COURT COST77TOTAL PAID PRINCIPAL78TOTAL PAID INTEREST79TOTAL PAID ADMINISTRATIVE COST79.1TOTAL PAID MARSHAL FEE79.2TOTAL PAID COURT COSTAR TRANSACTION (433).01TRANSACTION NUMBER.03BILL NUMBER11TRANSACTION DATE12TRANSACTION TYPE13RECEIPT #15TRANS. AMOUNT19DATE ENTERED25MARSHAL FEE26COURT COST27INT.CHARGE28ADM.CHARGE31PRIN.COLLECTED32INTEREST COLLECTED33ADMIN.COLLECTED34MARSHAL FEE COLLECTED35COURT COST COLLECTEDACCOUNTS RECEIVABLE TRANS.TYPE (430.3).001TRANSACTION TYPE IEN.01NAMEIB ACTION TYPE (350.1).03CHARGE CATEGORYPROCEDURES (399.0304)20OUTPATIENT ENCOUNTEROUTPATIENT ENCOUNTER (409.68).05VISIT FILE ENTRYIB CHARGE REMOVE REASONS (350.3).01NAME[type is PATIENT (#2)][Outpatient][Outpatient][Outpatient][Inpatient][NOT NULL and INTEGRATED BILLING ACTION - PARENT CHARGE (350-.09) <> INTEGRATED BILLING ACTION - IEN (350-.001)][IEN = 12 OR 13][IEN = 34 OR 2]

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
1978 for review V2F AR TRANSACTION - TRANSACTION NUMBER (433-.01) source value PaymentReconciliation.identifier .value .type.text="Transaction Number" http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1980 for review V2F fixed value PaymentReconciliation.status #active http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1984 for review V2F AR TRANSACTION - DATE ENTERED (433-19) source value PaymentReconciliation.created http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
2032 for review V2F AR TRANSACTION - BILL NUMBER > ACCOUNTS RECEIVABLE - DEBTOR (433-.03 > 430-9) reference PaymentReconciliation.extension[http://hl7.org/fhir/5.0/StructureDefinition/extension-PaymentReconciliation.paymentIssuer].valueReference Patient 2/20/25 validated Bill Number from AR Transaction is the correct map as this field points to Accounts Receivable and the patient (debtor) link is in Accounts Receivable http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 5.0.0
1982 for review V2F AR TRANSACTION - TRANSACTION TYPE > ACCOUNTS RECEIVABLE TRANS.TYPE - NAME (433-12 > 430.3-.01) source value IEN = 34 OR 2 PaymentReconciliation.disposition Transaction type name = PAYMENT (IN FULL) when IEN = 34 Transaction type name = PAYMENT (IN PART) when IEN = 2 http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1981 for review V2F AR TRANSACTION - TRANSACTION DATE (433-11) source value PaymentReconciliation.paymentDate http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1983 for review V2F AR TRANSACTION - TRANS. AMOUNT (433-15) source value PaymentReconciliation.paymentAmount .value .currency=#USD http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1985 for review V2F AR TRANSACTION - RECEIPT # (433-13) source value PaymentReconciliation.paymentIdentifier http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1979 for review V2F AR TRANSACTION - BILL NUMBER (433-.03) source value PaymentReconciliation.extension[http://hl7.org/fhir/5.0/StructureDefinition/extension-PaymentReconciliation.allocation.identifier].valueIdentifier .value .type.text="Bill Number" http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
2041 for review V2F reference PaymentReconciliation.extension[http://hl7.org/fhir/5.0/StructureDefinition/extension-PaymentReconciliation.allocation.target].valueReference Invoice http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1986 for review V2F AR TRANSACTION - PRIN.COLLECTED (433-31) source value PaymentReconciliation.detail[va-principal-collected] .amount .type.text="Principal Collected" http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1987 for review V2F AR TRANSACTION - INTEREST COLLECTED (433-32) source value PaymentReconciliation.detail[va-interest-collected] .amount .type.text="Interest Collected" http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1988 for review V2F AR TRANSACTION - ADMIN.COLLECTED (433-33) source value PaymentReconciliation.detail[va-admin-collected] .amount .type.text="Administrative Charge Collected" http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1989 for review V2F AR TRANSACTION - MARSHAL FEE COLLECTED (433-34) source value PaymentReconciliation.detail[va-marshal-collected] .amount .type.text="Marshal Fee Collected" http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1
1990 for review V2F AR TRANSACTION - COURT COST COLLECTED (433-35) source value PaymentReconciliation.detail[va-courtcost-collected] .amount .type.text="Court Cost Collected" http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameVeterans Health Information Systems Technology and Architecture (VistA)Clinical Data Warehouse (CDW)Workflow PatternCanadian Dental Association eclaims standarddoco
.. PaymentReconciliation
Event
... id
... meta
... implicitRules
... text
... contained
... Slices for extension
.... extension:extension-PaymentReconciliation-paymentIssuer
..... id
..... extension
..... url
..... value[x]
reference based on AR TRANSACTION - BILL NUMBER > ACCOUNTS RECEIVABLE - DEBTOR (433-.03 > 430-9)
2/20/25 validated Bill Number from AR Transaction is the correct map as this field points to Accounts Receivable and the patient (debtor) link is in Accounts Receivable
IB.ARTransaction.AccountsReceivableIEN IB.ARTransaction.PatientIEN IB.ARTransactionComment.PatientIEN IB.ARTransactionDescription.PatientIEN IB.ARTransactionFiscalYear.PatientIEN IB.AccountsReceivable.ARDebtorIEN
.... extension:extension-PaymentReconciliation-allocation-identifier
..... id
..... extension
..... url
..... value[x]
...... id
...... extension
...... use
...... type
....... id
....... extension
....... coding
....... text
fixed value = Bill Number
mapParameter line 1
...... system
...... value
source value based on AR TRANSACTION - BILL NUMBER (433-.03)
IB.ARTransaction.AccountsReceivableIEN IB.ARTransaction.PatientIEN IB.ARTransactionComment.PatientIEN IB.ARTransactionDescription.PatientIEN IB.ARTransactionFiscalYear.PatientIEN
...... period
...... assigner
.... extension:extension-PaymentReconciliation-allocation-target
..... id
..... extension
..... url
..... value[x]
reference
... modifierExtension
... identifier
Event.identifier
.... id
.... extension
.... use
.... type
..... id
..... extension
..... coding
..... text
fixed value = Transaction Number
mapParameter line 1
.... system
.... value
source value based on AR TRANSACTION - TRANSACTION NUMBER (433-.01)
IB.ARTransaction.TransactionNumber
.... period
.... assigner
... status
fixed value = #active
Event.status
... period
... created
source value based on AR TRANSACTION - DATE ENTERED (433-19)
IB.ARTransaction.EnteredDateTime
Event.occurrence[x]
... paymentIssuer
Event.performer.actor
... request
A02|G01
... requestor
B01
... outcome
... disposition
source value based on AR TRANSACTION - TRANSACTION TYPE > ACCOUNTS RECEIVABLE TRANS.TYPE - NAME (433-12 > 430.3-.01) if IEN = 34 OR 2
Transaction type name = PAYMENT (IN FULL) when IEN = 34 Transaction type name = PAYMENT (IN PART) when IEN = 2
IB.ARTransaction.ARTransactionTypeIEN Dim.ARTransactionType.ARTransactionType
Event.note
... paymentDate
source value based on AR TRANSACTION - TRANSACTION DATE (433-11)
IB.ARTransaction.TransactionDateTime IB.ARTransactionComment.TransactionDateTime IB.ARTransactionDescription.TransactionDateTime IB.ARTransactionFiscalYear.TransactionDateTime
... paymentAmount
.... id
.... extension
.... value
source value based on AR TRANSACTION - TRANS. AMOUNT (433-15)
IB.ARTransaction.TransactionAmount
.... currency
fixed value = #USD
mapParameter line 1
... paymentIdentifier
source value based on AR TRANSACTION - RECEIPT # (433-13)
IB.ARTransaction.ReceiptNumber
... Slices for detail
.... detail:All Slices
..... id
..... extension
..... modifierExtension
..... identifier
..... predecessor
..... type
..... request
..... submitter
..... response
..... date
..... responsible
..... payee
..... amount
.... detail:va-principal-collected
..... id
..... extension
..... modifierExtension
..... identifier
..... predecessor
..... type
...... id
...... extension
...... coding
...... text
fixed value = Principal Collected
mapParameter line 1
..... request
..... submitter
..... response
..... date
..... responsible
..... payee
..... amount
source value based on AR TRANSACTION - PRIN.COLLECTED (433-31)
IB.ARTransaction.PrincipaAmountCollected
.... detail:va-interest-collected
..... id
..... extension
..... modifierExtension
..... identifier
..... predecessor
..... type
...... id
...... extension
...... coding
...... text
fixed value = Interest Collected
mapParameter line 1
..... request
..... submitter
..... response
..... date
..... responsible
..... payee
..... amount
source value based on AR TRANSACTION - INTEREST COLLECTED (433-32)
IB.ARTransaction.InterestAmountCollected
.... detail:va-admin-collected
..... id
..... extension
..... modifierExtension
..... identifier
..... predecessor
..... type
...... id
...... extension
...... coding
...... text
fixed value = Administrative Charge Collected
mapParameter line 1
..... request
..... submitter
..... response
..... date
..... responsible
..... payee
..... amount
source value based on AR TRANSACTION - ADMIN.COLLECTED (433-33)
IB.ARTransaction.AdministrativeAmountCollected
.... detail:va-marshal-collected
..... id
..... extension
..... modifierExtension
..... identifier
..... predecessor
..... type
...... id
...... extension
...... coding
...... text
fixed value = Marshal Fee Collected
mapParameter line 1
..... request
..... submitter
..... response
..... date
..... responsible
..... payee
..... amount
source value based on AR TRANSACTION - MARSHAL FEE COLLECTED (433-34)
IB.ARTransaction.MarshalFeeAmountCollected
.... detail:va-courtcost-collected
..... id
..... extension
..... modifierExtension
..... identifier
..... predecessor
..... type
...... id
...... extension
...... coding
...... text
fixed value = Court Cost Collected
mapParameter line 1
..... request
..... submitter
..... response
..... date
..... responsible
..... payee
..... amount
source value based on AR TRANSACTION - COURT COST COLLECTED (433-35)
IB.ARTransaction.CourtCostCollected
... formCode
... processNote
.... id
.... extension
.... modifierExtension
.... type
.... text
G32

doco Documentation for this format