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: DebtPortalChargeItemcharges - Mappings

Active as of 2025-03-31

Mappings for the DebtPortalChargeItemcharges 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
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].identifier[va-billno] 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].identifier[va-artransno] 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 /EncounterOutpatient 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 /EncounterInpatientEncounter 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 for Veterans Health Information Systems Technology and Architecture (VistA) ()

DebtPortalChargeItemcharges
ChargeItem
   identifier (va-billno)1837: source value based on INTEGRATED BILLING ACTION - AR BILL NUMBER (350-.11)
   identifier (va-artransno)2218: 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
   status1838: 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.

   code
      text1836: source value based on INTEGRATED BILLING ACTION - ACTION TYPE > IB ACTION TYPE - CHARGE CATEGORY (350-.03 > 350.1-.03)
   subject1839: reference based on INTEGRATED BILLING ACTION - PATIENT (350-.02)
   context2008: reference based on 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) if Outpatient, 2009: 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-304 > 399.304-20 > 409.68-.05 > 9000010

,

Map path: 350 < 360-1.04 |360| 360-1.02 > 399-08 > 45

   occurrence[x]
   occurrence[x] (occurrencePeriod)
      start1973: source value based on INTEGRATED BILLING ACTION - DATE BILLED FROM (350-.14)
      end1974: source value based on INTEGRATED BILLING ACTION - DATE BILLED TO (350-.15)
   enteredDate1835: source value based on INTEGRATED BILLING ACTION - DATE ENTRY ADDED (350-12)
   service (va-rxorig)2010: reference based on PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-)
   service (va-rxrefill)2011: reference based on PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-)
   service (va-rxpartial)2012: reference based on PRESCRIPTION - IB NUMBER > INTEGRATED BILLING ACTION (52-106 > 350-)

Mappings for Clinical Data Warehouse (CDW) ()

DebtPortalChargeItemcharges
ChargeItem
   identifier (va-billno)IB.IBAction.ARBillNumber
   identifier (va-artransno)IB.IBAction.ARTransactionNumber
   code
      textIB.IBAction.IBActionTypeIEN Dim.IBActionType.AccountsReceivableCategory,Dim.IBActionType.ARCategoryIEN
   subjectIB.IBAction.PatientIEN
   occurrence[x]
   occurrence[x] (occurrencePeriod)
      startIB.IBAction.BillFromDateTime
      endIB.IBAction.BillToDateTime
   enteredDateIB.IBAction.EnteredDateTime

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

DebtPortalChargeItemcharges
ChargeItemEvent
   identifierEvent.identifier
   identifier (va-billno)Event.identifier
   identifier (va-artransno)Event.identifier
   definitionUriEvent.instantiates
   definitionCanonicalEvent.instantiates
   statusEvent.status
   partOfEvent.partOf
   codeEvent.code
   subjectEvent.subject
   contextEvent.context
   occurrence[x]Event.occurrence[x]
   occurrence[x] (occurrencePeriod)Event.occurrence[x]
   performerEvent.performer
      functionEvent.performer.function
      actorEvent.performer.actor
   performingOrganizationEvent.performer.actor
   reasonEvent.reasonCode
   serviceEvent.reasonReference
   service (va-rxorig)Event.reasonReference
   service (va-rxrefill)Event.reasonReference
   service (va-rxpartial)Event.reasonReference
   noteEvent.note
   supportingInformationEvent.supportingInfo

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

DebtPortalChargeItemcharges
ChargeItemFT1
   identifierFT1.2
   identifier (va-billno)FT1.2
   identifier (va-artransno)FT1.2
   definitionUriVaries by domain
   definitionCanonicalVaries by domain
   statusVaries by domain
   partOfVaries by domain
   codeFT1.7
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   subjectPAT in proximity to FT1 segment
   contextPV1 in proximity to FT1 segment
   occurrence[x]Varies by domain
   occurrence[x] (occurrencePeriod)Varies by domain
      startDR.1
      endDR.2
   performerEVN.5 or by domain
      functionVaries by domain
      actorEVN.5 or by domain
   performingOrganizationN/A
   requestingOrganizationN/A
   costCenterFT1.13
   quantityFT1.10
   factorOverrideFT1.26
   priceOverrideFT1.22
   entererEVN.5 or by domain
   reasonEVN.4 or by domain
   serviceEVN.4 or by domain
   service (va-rxorig)EVN.4 or by domain
   service (va-rxrefill)EVN.4 or by domain
   service (va-rxpartial)EVN.4 or by domain
   noteNTE

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

DebtPortalChargeItemcharges
ChargeItemEntity. Role, or Act, Act[moodCode=EVN]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifier.identifier
   identifier (va-billno).identifier
   identifier (va-artransno).identifier
   definitionUri.outboundRelationship[typeCode=DEFN].target
   definitionCanonical.outboundRelationship[typeCode=DEFN].target
   status.status
   partOf.inboundRelationship[typeCode=COMP].source[moodCode=EVN]
   code.code
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   subject.participation[typeCode=SBJ].role
   context.inboundRelationship(typeCode=COMP].source[classCode<=PCPR, moodCode=EVN]
   occurrence[x].effectiveTime
   occurrence[x] (occurrencePeriod).effectiveTime
      idn/a
      extensionn/a
      start./low
      end./high
   performer.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
      idn/a
      extensionn/a
      modifierExtensionN/A
      function.participation.functionCode
      actor.player
   performingOrganization.scoper
   requestingOrganization.scoper
   bodysite.targetBodySiteCode
   enterer.player
   reason.reasonCode
   service.outboundRelationship[typeCode=RSON].target
   service (va-rxorig).outboundRelationship[typeCode=RSON].target
   service (va-rxrefill).outboundRelationship[typeCode=RSON].target
   service (va-rxpartial).outboundRelationship[typeCode=RSON].target
   product[x].participation[typeCode=CSM].role
   note.inboundRelationship(typeCode=SUBJ].source[classCode=ANNGEN, moodCode=EVN].value[xsi:type=ST]

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

DebtPortalChargeItemcharges
ChargeItem
   identifierFiveWs.identifier
   identifier (va-billno)FiveWs.identifier
   identifier (va-artransno)FiveWs.identifier
   statusFiveWs.status
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   contextFiveWs.context
   occurrence[x]FiveWs.done[x]
   occurrence[x] (occurrencePeriod)FiveWs.done[x]
   performer
      actorFiveWs.actor
   entererFiveWs.actor
   reasonFiveWs.why[x]
   serviceFiveWs.why[x]
   service (va-rxorig)FiveWs.why[x]
   service (va-rxrefill)FiveWs.why[x]
   service (va-rxpartial)FiveWs.why[x]