US Veterans Health Administration FHIR Map Set Implementation Guide
1.10.0 - 251101 United States of America flag

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

Resource Profile: DebtPortalChargeItemcharges - Mappings

Active as of 2025-11-04

Mappings for the DebtPortalChargeItemcharges 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
1835 for review V2F INTEGRATED BILLING ACTION - DATE ENTRY ADDED (350-12) source value ChargeItem[charges].enteredDate http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
1836 for review V2F INTEGRATED BILLING ACTION - ACTION TYPE > IB ACTION TYPE - CHARGE CATEGORY (350-.03 > 350.1-.03) source value ChargeItem[charges].code .text http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
1837 for review V2F INTEGRATED BILLING ACTION - AR BILL NUMBER (350-.11) source value ChargeItem[charges].supportingInformation[va-arbillnbr].identifier .value .type.text="Bill Number" http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2218 for review V2F INTEGRATED BILLING ACTION - AR TRANSACTION NUMBER (350-.12) source value AR TRANSACTION - TRANSACTION TYPE > ACCOUNTS RECEIVABLE TRANS.TYPE - IEN = 1 OR 35 ChargeItem[charges].supportingInformation[va-artransnbr].identifier .value .type.text="Transaction Number" http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2237 for review V2F INTEGRATED BILLING ACTION - IEN (350-.001) source value ChargeItem[charges].identifier .value=concat({sta3n},"-",{IEN (.001)})
.type.text="Sta3n - IBAction.IEN"
.system="http://va.gov/identifiers/{sta3n}/350		 The combination of Sta3n and IBAction-IEN make a unique identifier (per CDW documentation showing business keys) http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
1838 for review V2F fixed value ChargeItem[charges].status #billed Status values passed to AR include 'Billed', 'Cancelled', Co-Pay Exemption Cancellation', and 'Updated' (350-.05>350.21). For now hard code status as billed. http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
1839 for review V2F INTEGRATED BILLING ACTION - PATIENT (350-.02) reference ChargeItem[charges].subject /Patient http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2008 for review V2F IB-FB INTERFACE TRACKING - BILL/CLAIMS > BILL/CLAIMS - PROCEDURES > PROCEDURES - OUTPATIENT ENCOUNTER > OUTPATIENT ENCOUNTER - VISIT FILE ENTRY (360-1.02 > 399-304>399.0304-20>409.68-.05) reference Outpatient ChargeItem[charges].context /EncounterVisit Map path: 350 < 360-1.04 |360| 360-1.02 > 399-304 > 399.304-20 > 409.68-.05 > 9000010 http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2009 for review V2F IB-FB INTERFACE TRACKING - BILL/CLAIMS > BILL/CLAIMS - PTF ENTRY NUMBER (360-1.02 > 399-.08) reference Inpatient ChargeItem[charges].context /EncounterPTFEncounter Map path: 350 < 360-1.04 |360| 360-1.02 > 399-08 > 45 http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
1973 for review V2F INTEGRATED BILLING ACTION - DATE BILLED FROM (350-.14) source value ChargeItem[charges].occurrencePeriod .start http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
1974 for review V2F INTEGRATED BILLING ACTION - DATE BILLED TO (350-.15) source value ChargeItem[charges].occurrencePeriod .end http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2010 for review V2F PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-) reference ChargeItem[charges].service[va-rxorig] /MedicationDispenseOriginal http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2011 for review V2F PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-) reference ChargeItem[charges].service[va-rxrefill] /MedicationDispenseRefill http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2012 for review V2F PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-) reference ChargeItem[charges].service[va-rxpartial] /MedicationDispensePartial http://hl7.org/fhir/StructureDefinition/ChargeItem | 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 Patterndoco
.. ChargeItem
Event
... id
... meta
... implicitRules
... language
... text
... contained
... extension
... modifierExtension
... identifier
source value based on INTEGRATED BILLING ACTION - IEN (350-.001)
The combination of Sta3n and IBAction-IEN make a unique identifier (per CDW documentation showing business keys)
Event.identifier
.... id
.... extension
.... use
.... type
..... id
..... extension
..... coding
..... text
fixed value = Sta3n - IBAction.IEN
mapParameter line 2
.... system
fixed value = http://va.gov/identifiers/{sta3n}/35
mapParameter line 3
.... value
  • fixed value = concat({sta3n}
  • "-"
  • {IEN (.001)})
mapParameter line 1
.... period
.... assigner
... definitionUri
Event.instantiates
... definitionCanonical
Event.instantiates
... status
fixed value = #billed
Status values passed to AR include 'Billed', 'Cancelled', Co-Pay Exemption Cancellation', and 'Updated' (350-.05>350.21). For now hard code status as billed.
Event.status
... partOf
Event.partOf
... code
Event.code
.... id
.... extension
.... coding
.... text
source value based on INTEGRATED BILLING ACTION - ACTION TYPE > IB ACTION TYPE - CHARGE CATEGORY (350-.03 > 350.1-.03)
IB.IBAction.IBActionTypeIEN Dim.IBActionType.AccountsReceivableCategory Dim.IBActionType.ARCategoryIEN
... subject
reference based on INTEGRATED BILLING ACTION - PATIENT (350-.02)
IB.IBAction.PatientIEN
Event.subject
... context
reference based on IB-FB INTERFACE TRACKING - BILL/CLAIMS > BILL/CLAIMS - PTF ENTRY NUMBER (360-1.02 > 399-.08) if Inpatient
Map path: 350 < 360-1.04 |360| 360-1.02 > 399-08 > 45
Event.context
... Slices for occurrence[x]
Event.occurrence[x]
.... occurrence[x]:occurrencePeriod
Event.occurrence[x]
..... id
..... extension
..... start
source value based on INTEGRATED BILLING ACTION - DATE BILLED FROM (350-.14)
IB.IBAction.BillFromDateTime
..... end
source value based on INTEGRATED BILLING ACTION - DATE BILLED TO (350-.15)
IB.IBAction.BillToDateTime
... performer
Event.performer
.... id
.... extension
.... modifierExtension
.... function
Event.performer.function
.... actor
Event.performer.actor
... performingOrganization
Event.performer.actor
... requestingOrganization
... costCenter
... quantity
... bodysite
... factorOverride
... priceOverride
... overrideReason
... enterer
... enteredDate
source value based on INTEGRATED BILLING ACTION - DATE ENTRY ADDED (350-12)
IB.IBAction.EnteredDateTime
... reason
Event.reasonCode
... Slices for service
Event.reasonReference
.... service:va-rxorig
reference based on PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-)
Event.reasonReference
.... service:va-rxrefill
reference based on PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-)
Event.reasonReference
.... service:va-rxpartial
reference based on PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-)
Event.reasonReference
... product[x]
... account
... note
Event.note
... Slices for supportingInformation
Event.supportingInfo
.... supportingInformation:va-arbillnbr
Event.supportingInfo
..... id
..... extension
..... reference
..... type
..... identifier
...... id
...... extension
...... use
...... type
....... id
....... extension
....... coding
....... text
fixed value = Bill Number
mapParameter line 1
...... system
...... value
source value based on INTEGRATED BILLING ACTION - AR BILL NUMBER (350-.11)
IB.IBAction.ARBillNumber
...... period
...... assigner
..... display
.... supportingInformation:va-artransnbr
Event.supportingInfo
..... id
..... extension
..... reference
..... type
..... identifier
...... id
...... extension
...... use
...... type
....... id
....... extension
....... coding
....... text
fixed value = Transaction Number if AR TRANSACTION - TRANSACTION TYPE > ACCOUNTS RECEIVABLE TRANS.TYPE - IEN = 1 OR 35
mapParameter line 1
...... system
...... value
source value based on INTEGRATED BILLING ACTION - AR TRANSACTION NUMBER (350-.12) if AR TRANSACTION - TRANSACTION TYPE > ACCOUNTS RECEIVABLE TRANS.TYPE - IEN = 1 OR 35
IB.IBAction.ARTransactionNumber
...... period
...... assigner
..... display

doco Documentation for this format