US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: DebtPortalPaymentReconciliation - Mappings

Active as of 2025-03-31

Mappings for the DebtPortalPaymentReconciliation resource profile.

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

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

Mapping Sources

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).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).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
1978-1 for review V2F fixed value PaymentReconciliation.identifier .type.text Transaction Number generated from mapParameter line 1 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
1983-1 for review V2F fixed value PaymentReconciliation.paymentAmount .currency #USD generated from mapParameter line 1 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
1979-1 for review V2F fixed value PaymentReconciliation.extension[http://hl7.org/fhir/5.0/StructureDefinition/extension-PaymentReconciliation.allocation.identifier].valueIdentifier .type.text Bill Number generated from mapParameter line 1 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
1986-1 for review V2F fixed value PaymentReconciliation.detail[va-principal-collected] .type.text Principal Collected generated from mapParameter line 1 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
1987-1 for review V2F fixed value PaymentReconciliation.detail[va-interest-collected] .type.text Interest Collected generated from mapParameter line 1 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
1988-1 for review V2F fixed value PaymentReconciliation.detail[va-admin-collected] .type.text Administrative Charge Collected generated from mapParameter line 1 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
1989-1 for review V2F fixed value PaymentReconciliation.detail[va-marshal-collected] .type.text Marshal Fee Collected generated from mapParameter line 1 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
1990-1 for review V2F fixed value PaymentReconciliation.detail[va-courtcost-collected] .type.text Court Cost Collected generated from mapParameter line 1 http://hl7.org/fhir/StructureDefinition/PaymentReconciliation | 4.0.1

Mappings for Veterans Health Information Systems Technology and Architecture (VistA) ()

DebtPortalPaymentReconciliation
PaymentReconciliation
   extension
   extension (extension-PaymentReconciliation-paymentIssuer)
      value[x]2032: 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

   extension (extension-PaymentReconciliation-allocation-identifier)
      value[x]
         type
            text1979-1: fixed value = Bill Number

generated from mapParameter line 1

         value1979: source value based on AR TRANSACTION - BILL NUMBER (433-.03)
   extension (extension-PaymentReconciliation-allocation-target)
      value[x]2041: reference
   identifier
      type
         text1978-1: fixed value = Transaction Number

generated from mapParameter line 1

      value1978: source value based on AR TRANSACTION - TRANSACTION NUMBER (433-.01)
   status1980: fixed value = #active
   created1984: source value based on AR TRANSACTION - DATE ENTERED (433-19)
   disposition1982: 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

   paymentDate1981: source value based on AR TRANSACTION - TRANSACTION DATE (433-11)
   paymentAmount
      value1983: source value based on AR TRANSACTION - TRANS. AMOUNT (433-15)
      currency1983-1: fixed value = #USD

generated from mapParameter line 1

   paymentIdentifier1985: source value based on AR TRANSACTION - RECEIPT # (433-13)
   detail
      type
   detail (va-principal-collected)
      type
         text1986-1: fixed value = Principal Collected

generated from mapParameter line 1

      amount1986: source value based on AR TRANSACTION - PRIN.COLLECTED (433-31)
   detail (va-interest-collected)
      type
         text1987-1: fixed value = Interest Collected

generated from mapParameter line 1

      amount1987: source value based on AR TRANSACTION - INTEREST COLLECTED (433-32)
   detail (va-admin-collected)
      type
         text1988-1: fixed value = Administrative Charge Collected

generated from mapParameter line 1

      amount1988: source value based on AR TRANSACTION - ADMIN.COLLECTED (433-33)
   detail (va-marshal-collected)
      type
         text1989-1: fixed value = Marshal Fee Collected

generated from mapParameter line 1

      amount1989: source value based on AR TRANSACTION - MARSHAL FEE COLLECTED (433-34)
   detail (va-courtcost-collected)
      type
         text1990-1: fixed value = Court Cost Collected

generated from mapParameter line 1

      amount1990: source value based on AR TRANSACTION - COURT COST COLLECTED (433-35)

Mappings for Clinical Data Warehouse (CDW) ()

DebtPortalPaymentReconciliation
PaymentReconciliation
   extension
   extension (extension-PaymentReconciliation-paymentIssuer)
      value[x]IB.ARTransaction.AccountsReceivableIEN,IB.ARTransaction.PatientIEN,IB.ARTransactionComment.PatientIEN,IB.ARTransactionDescription.PatientIEN,IB.ARTransactionFiscalYear.PatientIEN IB.AccountsReceivable.ARDebtorIEN
   extension (extension-PaymentReconciliation-allocation-identifier)
      value[x]
         valueIB.ARTransaction.AccountsReceivableIEN,IB.ARTransaction.PatientIEN,IB.ARTransactionComment.PatientIEN,IB.ARTransactionDescription.PatientIEN,IB.ARTransactionFiscalYear.PatientIEN
   identifier
      valueIB.ARTransaction.TransactionNumber
   createdIB.ARTransaction.EnteredDateTime
   dispositionIB.ARTransaction.ARTransactionTypeIEN Dim.ARTransactionType.ARTransactionType
   paymentDateIB.ARTransaction.TransactionDateTime,IB.ARTransactionComment.TransactionDateTime,IB.ARTransactionDescription.TransactionDateTime,IB.ARTransactionFiscalYear.TransactionDateTime
   paymentAmount
      valueIB.ARTransaction.TransactionAmount
   paymentIdentifierIB.ARTransaction.ReceiptNumber
   detail
   detail (va-principal-collected)
      amountIB.ARTransaction.PrincipaAmountCollected
   detail (va-interest-collected)
      amountIB.ARTransaction.InterestAmountCollected
   detail (va-admin-collected)
      amountIB.ARTransaction.AdministrativeAmountCollected
   detail (va-marshal-collected)
      amountIB.ARTransaction.MarshalFeeAmountCollected
   detail (va-courtcost-collected)
      amountIB.ARTransaction.CourtCostCollected

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

DebtPortalPaymentReconciliation
PaymentReconciliationEvent
   identifierEvent.identifier
   statusEvent.status
   createdEvent.occurrence[x]
   paymentIssuerEvent.performer.actor
   dispositionEvent.note

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

DebtPortalPaymentReconciliation
PaymentReconciliation
   identifierFiveWs.identifier
   statusFiveWs.status
   periodFiveWs.done[x]
   createdFiveWs.recorded
   paymentIssuerFiveWs.source
   requestFiveWs.why[x]

Mappings for Canadian Dental Association eclaims standard (http://www.cda-adc.ca/en/services/cdanet/)

DebtPortalPaymentReconciliation
PaymentReconciliation
   requestA02|G01
   requestorB01
   processNote
      textG32

Mappings for RIM Mapping (http://hl7.org/v3)

DebtPortalPaymentReconciliation
PaymentReconciliationEntity. Role, or Act
   textAct.text?
   containedN/A
   extension
   extension (extension-PaymentReconciliation-paymentIssuer)n/a, N/A
      idn/a
      urlN/A
      value[x]N/A
   extension (extension-PaymentReconciliation-allocation-identifier)n/a, N/A
      idn/a
      urlN/A
      value[x]N/A
         idn/a
         extensionn/a
         useRole.code or implied by context
         typeRole.code or implied by context
            idn/a
            extensionn/a
            codingunion(., ./translation)
            text./originalText[mediaType/code="text/plain"]/data
         systemII.root or Role.id.root
         valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
         periodRole.effectiveTime or implied by context
         assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   extension (extension-PaymentReconciliation-allocation-target)n/a, N/A
      idn/a
      urlN/A
      value[x]N/A
   modifierExtensionN/A
   identifier
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   paymentAmount
      idn/a
      extensionn/a
   detail
      idn/a
      extensionn/a
      modifierExtensionN/A
      type
   detail (va-principal-collected)
      idn/a
      extensionn/a
      modifierExtensionN/A
      type
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
   detail (va-interest-collected)
      idn/a
      extensionn/a
      modifierExtensionN/A
      type
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
   detail (va-admin-collected)
      idn/a
      extensionn/a
      modifierExtensionN/A
      type
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
   detail (va-marshal-collected)
      idn/a
      extensionn/a
      modifierExtensionN/A
      type
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
   detail (va-courtcost-collected)
      idn/a
      extensionn/a
      modifierExtensionN/A
      type
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
   processNote
      idn/a
      extensionn/a
      modifierExtensionN/A