US Veterans Health Administration FHIR Map Set Implementation Guide
1.8.0 - 250901 United States of America flag

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

Resource Profile: DebtPortalChargeItemcharges - Mappings

Active as of 2025-09-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.

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

</tr> </table>
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=Sta3n&"-"&{IEN (.001)}
.type.text="Sta3n - IBAction.IEN"
.system="http://va.gov/identifiers//350</td>
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 /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 to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameWorkflow PatternHL7 v2 MappingRIM MappingFiveWs Pattern Mappingdoco
.. ChargeItem
Event
FT1
Act[moodCode=EVN]
... id
... meta
... implicitRules
... language
... text
Act.text?
... contained
N/A
... extension
N/A
... modifierExtension
N/A
... identifier
Event.identifier
FT1.2
.identifier
FiveWs.identifier
.... id
n/a
.... extension
n/a
.... use
N/A
Role.code or implied by context
.... type
CX.5
Role.code or implied by context
..... id
n/a
..... extension
n/a
..... coding
  • C*E.1-8
  • C*E.10-22
  • union(.
  • ./translation)
..... text
C*E.9. But note many systems use C*E.2 for this
./originalText[mediaType/code="text/plain"]/data
.... system
CX.4 / EI-2-4
II.root or Role.id.root
.... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
.... period
CX.7 + CX.8
Role.effectiveTime or implied by context
.... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
... definitionUri
Event.instantiates
Varies by domain
.outboundRelationship[typeCode=DEFN].target
... definitionCanonical
Event.instantiates
Varies by domain
.outboundRelationship[typeCode=DEFN].target
... status
Event.status
Varies by domain
.status
FiveWs.status
... partOf
Event.partOf
Varies by domain
.inboundRelationship[typeCode=COMP].source[moodCode=EVN]
... code
Event.code
FT1.7
.code
FiveWs.what[x]
.... id
n/a
.... extension
n/a
.... coding
  • C*E.1-8
  • C*E.10-22
  • union(.
  • ./translation)
.... text
C*E.9. But note many systems use C*E.2 for this
./originalText[mediaType/code="text/plain"]/data
... subject
Event.subject
PAT in proximity to FT1 segment
.participation[typeCode=SBJ].role
FiveWs.subject
... context
Event.context
PV1 in proximity to FT1 segment
  • .inboundRelationship(typeCode=COMP].source[classCode<=PCPR
  • moodCode=EVN]
FiveWs.context
... Slices for occurrence[x]
Event.occurrence[x]
Varies by domain
.effectiveTime
FiveWs.done[x]
.... occurrence[x]:occurrencePeriod
Event.occurrence[x]
Varies by domain
.effectiveTime
FiveWs.done[x]
..... id
n/a
..... extension
n/a
..... start
DR.1
./low
..... end
DR.2
./high
... performer
Event.performer
EVN.5 or by domain
.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... function
Event.performer.function
Varies by domain
.participation.functionCode
.... actor
Event.performer.actor
EVN.5 or by domain
.player
FiveWs.actor
... performingOrganization
Event.performer.actor
N/A
.scoper
... requestingOrganization
N/A
.scoper
... costCenter
FT1.13
... quantity
FT1.10
... bodysite
.targetBodySiteCode
... factorOverride
FT1.26
... priceOverride
FT1.22
... overrideReason
... enterer
EVN.5 or by domain
.player
FiveWs.actor
... enteredDate
... reason
Event.reasonCode
EVN.4 or by domain
.reasonCode
FiveWs.why[x]
... Slices for service
Event.reasonReference
EVN.4 or by domain
.outboundRelationship[typeCode=RSON].target
FiveWs.why[x]
.... service:va-rxorig
Event.reasonReference
EVN.4 or by domain
.outboundRelationship[typeCode=RSON].target
FiveWs.why[x]
.... service:va-rxrefill
Event.reasonReference
EVN.4 or by domain
.outboundRelationship[typeCode=RSON].target
FiveWs.why[x]
.... service:va-rxpartial
Event.reasonReference
EVN.4 or by domain
.outboundRelationship[typeCode=RSON].target
FiveWs.why[x]
... product[x]
.participation[typeCode=CSM].role
... account
... note
Event.note
NTE
  • .inboundRelationship(typeCode=SUBJ].source[classCode=ANNGEN
  • type=ST]
... Slices for supportingInformation
Event.supportingInfo
.... supportingInformation:va-arbillnbr
Event.supportingInfo
..... id
n/a
..... extension
n/a
..... reference
N/A
..... type
N/A
..... identifier
.identifier
...... id
n/a
...... extension
n/a
...... use
N/A
Role.code or implied by context
...... type
CX.5
Role.code or implied by context
....... id
n/a
....... extension
n/a
....... coding
  • C*E.1-8
  • C*E.10-22
  • union(.
  • ./translation)
....... text
C*E.9. But note many systems use C*E.2 for this
./originalText[mediaType/code="text/plain"]/data
...... system
CX.4 / EI-2-4
II.root or Role.id.root
...... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
...... period
CX.7 + CX.8
Role.effectiveTime or implied by context
...... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
..... display
N/A
.... supportingInformation:va-artransnbr
Event.supportingInfo
..... id
n/a
..... extension
n/a
..... reference
N/A
..... type
N/A
..... identifier
.identifier
...... id
n/a
...... extension
n/a
...... use
N/A
Role.code or implied by context
...... type
CX.5
Role.code or implied by context
....... id
n/a
....... extension
n/a
....... coding
  • C*E.1-8
  • C*E.10-22
  • union(.
  • ./translation)
....... text
C*E.9. But note many systems use C*E.2 for this
./originalText[mediaType/code="text/plain"]/data
...... system
CX.4 / EI-2-4
II.root or Role.id.root
...... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
...... period
CX.7 + CX.8
Role.effectiveTime or implied by context
...... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
..... display
N/A

doco Documentation for this format