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

Active as of 2025-09-02

Mappings for the DebtPortalPatient 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
1819 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - STREET ADDRESS #1 (430-9 > 340-1.01) source value Patient.contact.address .line .use=#billing http://va.gov/fhir/StructureDefinition/Patient
1820 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - STREET ADDRESS #2 (430-9 > 340-1.02) source value Patient.contact.address .line http://va.gov/fhir/StructureDefinition/Patient
1821 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - STREET ADDRESS #3 (430-9 > 340-1.03) source value Patient.contact.address .line http://va.gov/fhir/StructureDefinition/Patient
1822 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - CITY (430-9 > 340-1.04) source value Patient.contact.address .city http://va.gov/fhir/StructureDefinition/Patient
1823 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - STATE (430-9 > 340-1.05) source value Patient.contact.address .state http://va.gov/fhir/StructureDefinition/Patient
1824 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - ZIP CODE (430-9 > 340-1.06) source value Patient.contact.address .postalCode http://va.gov/fhir/StructureDefinition/Patient
1825 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - PHONE NUMBER (430-9 > 340-1.07) source value Patient.contact.telecom .value http://va.gov/fhir/StructureDefinition/Patient
1826 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - FOREIGN COUNTRY CODE (430-9 > 340-1.08) source value Patient.contact.address .country http://va.gov/fhir/StructureDefinition/Patient
1827 for review V2F ACCOUNTS RECEIVABLE - DEBTOR > AR DEBTOR - DEBTOR (430-9 > 340-.01) source value Patient.contact.name .text .family=LAST
.given=FIRST & MIDDLE
.suffix=SUFFIX
Add NAME to subpath of VARIABLE POINTER http://va.gov/fhir/StructureDefinition/Patient

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameRIM MappingCDA (R2)FiveWs Pattern MappingHL7 v2 MappingLOINC code for the elementdoco
.. Patient
Patient[classCode=PAT]
ClinicalDocument.recordTarget.patientRole
... id
... meta
... implicitRules
... text
Act.text?
... contained
N/A
... Slices for extension
.... extension:race
..... id
n/a
..... Slices for extension
...... extension:ombCategory
....... id
n/a
....... extension
....... url
N/A
....... value[x]
N/A
........ id
n/a
........ extension
n/a
........ system
./codeSystem
C*E.3
........ version
./codeSystemVersion
C*E.7
........ code
./code
C*E.1
........ display
CV.displayName
C*E.2 - but note this is not well followed
........ userSelected
CD.codingRationale
Sometimes implied by being first
...... extension:detailed
....... id
n/a
....... extension
n/a
....... url
N/A
....... value[x]
N/A
...... extension:text
....... id
n/a
....... extension
....... url
N/A
....... value[x]
N/A
..... url
N/A
..... value[x]
N/A
.... extension:ethnicity
..... id
n/a
..... Slices for extension
...... extension:ombCategory
....... id
n/a
....... extension
....... url
N/A
....... value[x]
N/A
........ id
n/a
........ extension
n/a
........ system
./codeSystem
C*E.3
........ version
./codeSystemVersion
C*E.7
........ code
./code
C*E.1
........ display
CV.displayName
C*E.2 - but note this is not well followed
........ userSelected
CD.codingRationale
Sometimes implied by being first
...... extension:detailed
....... id
n/a
....... extension
n/a
....... url
N/A
....... value[x]
N/A
...... extension:text
....... id
n/a
....... extension
....... url
N/A
....... value[x]
N/A
..... url
N/A
..... value[x]
N/A
.... extension:birthsex
player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
.... extension:genderIdentity
..... id
n/a
..... extension
..... url
N/A
..... value[x]
N/A
.... extension:patient-religion
..... id
n/a
..... extension
..... url
N/A
..... value[x]
N/A
... modifierExtension
N/A
... identifier
id
.id
FiveWs.identifier
PID-3
.... id
n/a
.... extension
n/a
.... use
Role.code or implied by context
N/A
.... type
Role.code or implied by context
CX.5
..... id
n/a
..... extension
n/a
..... coding
  • union(.
  • ./translation)
  • C*E.1-8
  • C*E.10-22
...... id
n/a
...... extension
n/a
...... system
./codeSystem
C*E.3
...... version
./codeSystemVersion
C*E.7
...... code
./code
C*E.1
...... display
CV.displayName
C*E.2 - but note this is not well followed
...... userSelected
CD.codingRationale
Sometimes implied by being first
..... text
./originalText[mediaType/code="text/plain"]/data
C*E.9. But note many systems use C*E.2 for this
.... system
II.root or Role.id.root
CX.4 / EI-2-4
.... value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
.... period
Role.effectiveTime or implied by context
CX.7 + CX.8
.... assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
... active
statusCode
n/a
FiveWs.status
... name
name
.patient.name
  • PID-5
  • PID-9
.... id
n/a
.... extension
n/a
.... use
unique(./use)
  • XPN.7
  • but often indicated by which field contains the name
.... text
./formatted
implied by XPN.11
.... family
./part[partType = FAM]
XPN.1/FN.1
.... given
./part[partType = GIV]
XPN.2 + XPN.3
.... prefix
./part[partType = PFX]
XPN.5
.... suffix
./part[partType = SFX]
XPN/4
.... period
./usablePeriod[type="IVL<TS>"]
XPN.13 + XPN.14
... Slices for telecom
telecom
.telecom
  • PID-13
  • PID-14
  • PID-40
.... telecom:All Slices
..... id
n/a
..... extension
n/a
..... system
./scheme
XTN.3
..... value
./url
XTN.1 (or XTN.12)
..... use
unique(./use)
XTN.2 - but often indicated by field
..... rank
n/a
n/a
..... period
./usablePeriod[type="IVL<TS>"]
N/A
.... telecom:va-home
telecom
.telecom
  • PID-13
  • PID-14
  • PID-40
..... id
n/a
..... extension
n/a
..... system
./scheme
XTN.3
..... value
./url
XTN.1 (or XTN.12)
..... use
unique(./use)
XTN.2 - but often indicated by field
..... rank
n/a
n/a
..... period
./usablePeriod[type="IVL<TS>"]
N/A
.... telecom:va-work
telecom
.telecom
  • PID-13
  • PID-14
  • PID-40
..... id
n/a
..... extension
n/a
..... system
./scheme
XTN.3
..... value
./url
XTN.1 (or XTN.12)
..... use
unique(./use)
XTN.2 - but often indicated by field
..... rank
n/a
n/a
..... period
./usablePeriod[type="IVL<TS>"]
N/A
.... telecom:va-mobile
telecom
.telecom
  • PID-13
  • PID-14
  • PID-40
..... id
n/a
..... extension
n/a
..... system
./scheme
XTN.3
..... value
./url
XTN.1 (or XTN.12)
..... use
unique(./use)
XTN.2 - but often indicated by field
..... rank
n/a
n/a
..... period
./usablePeriod[type="IVL<TS>"]
N/A
... gender
player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
.patient.administrativeGenderCode
PID-8
... birthDate
player[classCode=PSN|ANM and determinerCode=INSTANCE]/birthTime
.patient.birthTime
PID-7
21112-8
... Slices for deceased[x]
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime
n/a
PID-30 (bool) and PID-29 (datetime)
.... deceased[x]:deceasedDateTime
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime
n/a
PID-30 (bool) and PID-29 (datetime)
... Slices for address
addr
.addr
PID-11
.... address:All Slices
..... id
n/a
..... extension
n/a
..... use
unique(./use)
XAD.7
..... type
unique(./use)
XAD.18
..... text
./formatted
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
..... line
AD.part[parttype = AL]
XAD.1 and XAD.2 have different meanings for a company address than for a person address)
..... city
AD.part[parttype = CTY]
XAD.3
..... district
AD.part[parttype = CNT | CPA]
XAD.9
..... state
AD.part[parttype = STA]
XAD.4
..... postalCode
AD.part[parttype = ZIP]
XAD.5
..... country
AD.part[parttype = CNT]
XAD.6
..... period
./usablePeriod[type="IVL<TS>"]
XAD.12 / XAD.13 + XAD.14
.... address:va-home
addr
.addr
PID-11
..... id
n/a
..... extension
n/a
..... use
unique(./use)
XAD.7
..... type
unique(./use)
XAD.18
..... text
./formatted
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
..... line
AD.part[parttype = AL]
XAD.1 and XAD.2 have different meanings for a company address than for a person address)
..... city
AD.part[parttype = CTY]
XAD.3
..... district
AD.part[parttype = CNT | CPA]
XAD.9
..... state
AD.part[parttype = STA]
XAD.4
..... postalCode
AD.part[parttype = ZIP]
XAD.5
..... country
AD.part[parttype = CNT]
XAD.6
..... period
./usablePeriod[type="IVL<TS>"]
XAD.12 / XAD.13 + XAD.14
...... id
n/a
...... extension
n/a
...... start
./low
DR.1
...... end
./high
DR.2
... maritalStatus
player[classCode=PSN]/maritalStatusCode
.patient.maritalStatusCode
PID-16
... multipleBirth[x]
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthInd
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber
n/a
  • PID-24 (bool)
  • PID-25 (integer)
... photo
player[classCode=PSN|ANM and determinerCode=INSTANCE]/desc
n/a
OBX-5 - needs a profile
... contact
player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]
n/a
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... relationship
code
n/a
  • NK1-7
  • NK1-3
.... name
name
n/a
NK1-2
..... id
n/a
..... extension
n/a
..... use
unique(./use)
  • XPN.7
  • but often indicated by which field contains the name
..... text
./formatted
implied by XPN.11
..... family
./part[partType = FAM]
XPN.1/FN.1
..... given
./part[partType = GIV]
XPN.2 + XPN.3
..... prefix
./part[partType = PFX]
XPN.5
..... suffix
./part[partType = SFX]
XPN/4
..... period
./usablePeriod[type="IVL<TS>"]
XPN.13 + XPN.14
.... telecom
telecom
n/a
  • NK1-5
  • NK1-6
  • NK1-40
..... id
n/a
..... extension
n/a
..... system
./scheme
XTN.3
..... value
./url
XTN.1 (or XTN.12)
..... use
unique(./use)
XTN.2 - but often indicated by field
..... rank
n/a
n/a
..... period
./usablePeriod[type="IVL<TS>"]
N/A
.... address
addr
n/a
NK1-4
..... id
n/a
..... extension
n/a
..... use
unique(./use)
XAD.7
..... type
unique(./use)
XAD.18
..... text
./formatted
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
..... line
AD.part[parttype = AL]
XAD.1 and XAD.2 have different meanings for a company address than for a person address)
..... city
AD.part[parttype = CTY]
XAD.3
..... district
AD.part[parttype = CNT | CPA]
XAD.9
..... state
AD.part[parttype = STA]
XAD.4
..... postalCode
AD.part[parttype = ZIP]
XAD.5
..... country
AD.part[parttype = CNT]
XAD.6
..... period
./usablePeriod[type="IVL<TS>"]
XAD.12 / XAD.13 + XAD.14
.... gender
player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
n/a
NK1-15
.... organization
scoper
n/a
  • NK1-13
  • NK1-30
  • NK1-31
  • NK1-32
  • NK1-41
.... period
effectiveTime
n/a
... communication
LanguageCommunication
patient.languageCommunication
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... language
player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code
.languageCode
  • PID-15
  • LAN-2
.... preferred
preferenceInd
.preferenceInd
PID-15
... generalPractitioner
subjectOf.CareEvent.performer.AssignedEntity
n/a
PD1-4
... managingOrganization
scoper
.providerOrganization
.... id
n/a
.... extension
n/a
.... reference
N/A
.... type
N/A
.... identifier
.identifier
.... display
N/A
... link
outboundLink
n/a
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... other
id
n/a
  • PID-3
  • MRG-1
.... type
typeCode
n/a

doco Documentation for this format