US Veterans Health Administration FHIR Map Set Implementation Guide
1.4.0 - 250501 United States of America flag

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

Resource Profile: DebtPortalChargeItemcharges - Mappings

Active as of 2025-05-02

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 mappings in CDW and VPR.

Mapping Sources

Use Case: Debt Portal (Source)Use Case: Debt Portal (Source)PATIENT (2)PRESCRIPTION (52)  AR 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)][360-1.04 == 350 && Outpatient][360-1.04 == 350 && Outpatient][360-1.04 == 350 && Outpatient][360-1.04 == 350 && 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.identifier .value .type.text="Bill Number" http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
1837-1 for review V2F fixed value ChargeItem[charges].supportingInformation.identifier .type.text Bill Number generated from mapParameter line 1 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
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 .type.text="Transaction Number" http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2218-1 for review V2F fixed value AR TRANSACTION - TRANSACTION TYPE > ACCOUNTS RECEIVABLE TRANS.TYPE - IEN = 1 OR 35 ChargeItem[charges].identifier .type.text Transaction Number generated from mapParameter line 1 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 360-1.04 == 350 && 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 360-1.04 == 350 && 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 - (52-) reference 52-106 == 350 ChargeItem[charges].service[va-rxorig] /MedicationDispenseOriginal http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2011 for review V2F PRESCRIPTION - (52-) reference 52-106 == 350 ChargeItem[charges].service[va-rxrefill] /MedicationDispenseRefill http://hl7.org/fhir/StructureDefinition/ChargeItem | 4.0.1
2012 for review V2F PRESCRIPTION - (52-) reference 52-106 == 350 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
   identifier2218: 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
      type
         text2218-1: fixed value = Transaction Number if AR TRANSACTION - TRANSACTION TYPE > ACCOUNTS RECEIVABLE TRANS.TYPE - IEN = 1 OR 35

generated from mapParameter line 1

   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 360-1.04 == 350 && Outpatient, 2009: reference based on IB-FB INTERFACE TRACKING - BILL/CLAIMS > BILL/CLAIMS - PTF ENTRY NUMBER (360-1.02 > 399-.08) if 360-1.04 == 350 && 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 - (52-) if 52-106 == 350
   service (va-rxrefill)2011: reference based on PRESCRIPTION - (52-) if 52-106 == 350
   service (va-rxpartial)2012: reference based on PRESCRIPTION - (52-) if 52-106 == 350
   supportingInformation
      identifier
         type
            text1837-1: fixed value = Bill Number

generated from mapParameter line 1

         value1837: source value based on INTEGRATED BILLING ACTION - AR BILL NUMBER (350-.11)

Mappings for Clinical Data Warehouse (CDW) ()

DebtPortalChargeItemcharges
ChargeItem
   identifierIB.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
   supportingInformation
      identifier
         valueIB.IBAction.ARBillNumber

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

DebtPortalChargeItemcharges
ChargeItemEvent
   identifierEvent.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
      useN/A
      typeCX.5
         codingC*E.1-8, C*E.10-22
         textC*E.9. But note many systems use C*E.2 for this
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   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
   supportingInformation
      identifier
         useN/A
         typeCX.5
            codingC*E.1-8, C*E.10-22
            textC*E.9. But note many systems use C*E.2 for this
         systemCX.4 / EI-2-4
         valueCX.1 / EI.1
         periodCX.7 + CX.8
         assignerCX.4 / (CX.4,CX.9,CX.10)

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
      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
   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]
   supportingInformation
      idn/a
      extensionn/a
      referenceN/A
      typeN/A
      identifier.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
      displayN/A

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

DebtPortalChargeItemcharges
ChargeItem
   identifierFiveWs.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]