HL7 v2.5.1 Specificationsv2.5.1

to moveEnter to openTry PID-5, ADT, 0004

PV1: Patient visit

The card at the end of the bed: which ward, which room, which consultant, admitted when. PID says who the patient is; PV1 says where they are and what kind of stay this is.

PV1 describes one visit. It says where the patient is, what kind of stay it is, who is responsible for them and what the visit is called.

The shape of one line

PV1segmentwhat kind of line this is
1PV1-1Set ID - PV1
IPV1-2Patient Class
3W^312^A^STJOSEPHPV1-3Assigned Patient Location
 PV1-4Admission Type
 PV1-5Preadmit Number
 PV1-6Prior Patient Location
1447312^OKONKWO^ADAEZE^^^^MDPV1-7Attending Doctor

required empty in this messageevery box is one | apart

Where PV1 appears

MessageSegment order
ADT^A01 admitMSH → EVN → PID → [PD1] → [{NK1}] → PV1 → [PV2]
ADT^A08 updateMSH → EVN → PID → [PD1] → PV1 → [PV2] → [{OBX}]
ORU^R01 resultMSH → {PID → [PV1] → {OBR → {OBX}}}
DFT^P03 chargeMSH → EVN → PID → [PV1] → [PV2] → {FT1}

PV1 appears in 82 of the 202 message structures the standard defines.

A whole message

PV1 from an inpatient admission to a medical ward
MSH|^~\&|EPIC|STJOSEPH|LABSYS|STJOSEPH|20240314093015||ADT^A01^ADT_A01|MSG00017|P|2.5.1
EVN||20240314093000
PID|1||1000345678^^^STJOSEPH^MR||CARTWRIGHT^ELEANOR^MAY^^^^L||19510822|F
PV1|1|I|3W^312^A^STJOSEPH^^N^3 WEST^BED A||||1447312^OKONKWO^ADAEZE^^^^MD|2288104^HALVORSEN^PETER^^^^MD||MED||||1|||1447312^OKONKWO^ADAEZE^^^^MD|I|V100034567|SELF|||||||||||||||||||SJ||A|||20240314093000
PV2|||||||||20240321||||||||||||N

Every field

SEQLENDTOPTRP/#TBL#ITEM#Element nameCardinality
PV1-14SIO00131Set ID - PV10..1
PV1-21ISR000400132Patient Class1..1
80PLO00133Assigned Patient Location0..1

PV1-3 is a PL, which holds 11 components separated by carets.

SEQLENDTOPTTBL#Component name
PL.120ISO0302Point of Care
PL.220ISO0303Room
PL.320ISO0304Bed
PL.4227HDOFacility
PL.520ISO0306Location Status
PL.620ISC0305Person Location Type
PL.720ISO0307Building
PL.820ISO0308Floor
PL.9199STOLocation Description
PL.10427EIOComprehensive Location Identifier
PL.11227HDOAssigning Authority for Location
PV1-42ISO000700134Admission Type0..1
250CXO00135Preadmit Number0..1

PV1-5 is a CX, which holds 10 components separated by carets.

SEQLENDTOPTTBL#Component name
CX.115STRID Number
CX.21STOCheck Digit
CX.33IDO0061Check Digit Scheme
CX.4227HDO0363Assigning Authority
CX.55IDO0203Identifier Type Code
CX.6227HDOAssigning Facility
CX.78DTOEffective Date
CX.88DTOExpiration Date
CX.9705CWEOAssigning Jurisdiction
CX.10705CWEOAssigning Agency or Department
80PLO00136Prior Patient Location0..1

PV1-6 is a PL, which holds 11 components separated by carets.

SEQLENDTOPTTBL#Component name
PL.120ISO0302Point of Care
PL.220ISO0303Room
PL.320ISO0304Bed
PL.4227HDOFacility
PL.520ISO0306Location Status
PL.620ISC0305Person Location Type
PL.720ISO0307Building
PL.820ISO0308Floor
PL.9199STOLocation Description
PL.10427EIOComprehensive Location Identifier
PL.11227HDOAssigning Authority for Location
250XCNOY001000137Attending Doctor0..*

PV1-7 is a XCN, which holds 23 components separated by carets.

SEQLENDTOPTTBL#Component name
XCN.115STOID Number
XCN.2194FNOFamily Name
XCN.330STOGiven Name
XCN.430STOSecond and Further Given Names or Initials Thereof
XCN.520STOSuffix (e.g., JR or III)
XCN.620STOPrefix (e.g., DR)
XCN.75ISB0360Degree (e.g., MD)
XCN.84ISC0297Source Table
XCN.9227HDO0363Assigning Authority
XCN.101IDO0200Name Type Code
XCN.111STOIdentifier Check Digit
XCN.123IDC0061Check Digit Scheme
XCN.135IDO0203Identifier Type Code
XCN.14227HDOAssigning Facility
XCN.151IDO0465Name Representation Code
XCN.16483CEO0448Name Context
XCN.1753DRBName Validity Range
XCN.181IDO0444Name Assembly Order
XCN.1926TSOEffective Date
XCN.2026TSOExpiration Date
XCN.21199STOProfessional Suffix
XCN.22705CWEOAssigning Jurisdiction
XCN.23705CWEOAssigning Agency or Department
250XCNOY001000138Referring Doctor0..*

PV1-8 is a XCN, which holds 23 components separated by carets.

SEQLENDTOPTTBL#Component name
XCN.115STOID Number
XCN.2194FNOFamily Name
XCN.330STOGiven Name
XCN.430STOSecond and Further Given Names or Initials Thereof
XCN.520STOSuffix (e.g., JR or III)
XCN.620STOPrefix (e.g., DR)
XCN.75ISB0360Degree (e.g., MD)
XCN.84ISC0297Source Table
XCN.9227HDO0363Assigning Authority
XCN.101IDO0200Name Type Code
XCN.111STOIdentifier Check Digit
XCN.123IDC0061Check Digit Scheme
XCN.135IDO0203Identifier Type Code
XCN.14227HDOAssigning Facility
XCN.151IDO0465Name Representation Code
XCN.16483CEO0448Name Context
XCN.1753DRBName Validity Range
XCN.181IDO0444Name Assembly Order
XCN.1926TSOEffective Date
XCN.2026TSOExpiration Date
XCN.21199STOProfessional Suffix
XCN.22705CWEOAssigning Jurisdiction
XCN.23705CWEOAssigning Agency or Department
250XCNBY001000139Consulting Doctor deprecated0..*

PV1-9 is a XCN, which holds 23 components separated by carets.

SEQLENDTOPTTBL#Component name
XCN.115STOID Number
XCN.2194FNOFamily Name
XCN.330STOGiven Name
XCN.430STOSecond and Further Given Names or Initials Thereof
XCN.520STOSuffix (e.g., JR or III)
XCN.620STOPrefix (e.g., DR)
XCN.75ISB0360Degree (e.g., MD)
XCN.84ISC0297Source Table
XCN.9227HDO0363Assigning Authority
XCN.101IDO0200Name Type Code
XCN.111STOIdentifier Check Digit
XCN.123IDC0061Check Digit Scheme
XCN.135IDO0203Identifier Type Code
XCN.14227HDOAssigning Facility
XCN.151IDO0465Name Representation Code
XCN.16483CEO0448Name Context
XCN.1753DRBName Validity Range
XCN.181IDO0444Name Assembly Order
XCN.1926TSOEffective Date
XCN.2026TSOExpiration Date
XCN.21199STOProfessional Suffix
XCN.22705CWEOAssigning Jurisdiction
XCN.23705CWEOAssigning Agency or Department
PV1-103ISO006900140Hospital Service0..1
80PLO00141Temporary Location0..1

PV1-11 is a PL, which holds 11 components separated by carets.

SEQLENDTOPTTBL#Component name
PL.120ISO0302Point of Care
PL.220ISO0303Room
PL.320ISO0304Bed
PL.4227HDOFacility
PL.520ISO0306Location Status
PL.620ISC0305Person Location Type
PL.720ISO0307Building
PL.820ISO0308Floor
PL.9199STOLocation Description
PL.10427EIOComprehensive Location Identifier
PL.11227HDOAssigning Authority for Location
PV1-122ISO008700142Preadmit Test Indicator0..1
PV1-132ISO009200143Re-admission Indicator0..1
PV1-146ISO002300144Admit Source0..1
PV1-152ISOY000900145Ambulatory Status0..*
PV1-162ISO009900146VIP Indicator0..1
250XCNOY001000147Admitting Doctor0..*

PV1-17 is a XCN, which holds 23 components separated by carets.

SEQLENDTOPTTBL#Component name
XCN.115STOID Number
XCN.2194FNOFamily Name
XCN.330STOGiven Name
XCN.430STOSecond and Further Given Names or Initials Thereof
XCN.520STOSuffix (e.g., JR or III)
XCN.620STOPrefix (e.g., DR)
XCN.75ISB0360Degree (e.g., MD)
XCN.84ISC0297Source Table
XCN.9227HDO0363Assigning Authority
XCN.101IDO0200Name Type Code
XCN.111STOIdentifier Check Digit
XCN.123IDC0061Check Digit Scheme
XCN.135IDO0203Identifier Type Code
XCN.14227HDOAssigning Facility
XCN.151IDO0465Name Representation Code
XCN.16483CEO0448Name Context
XCN.1753DRBName Validity Range
XCN.181IDO0444Name Assembly Order
XCN.1926TSOEffective Date
XCN.2026TSOExpiration Date
XCN.21199STOProfessional Suffix
XCN.22705CWEOAssigning Jurisdiction
XCN.23705CWEOAssigning Agency or Department
PV1-182ISO001800148Patient Type0..1
250CXO00149Visit Number0..1

PV1-19 is a CX, which holds 10 components separated by carets.

SEQLENDTOPTTBL#Component name
CX.115STRID Number
CX.21STOCheck Digit
CX.33IDO0061Check Digit Scheme
CX.4227HDO0363Assigning Authority
CX.55IDO0203Identifier Type Code
CX.6227HDOAssigning Facility
CX.78DTOEffective Date
CX.88DTOExpiration Date
CX.9705CWEOAssigning Jurisdiction
CX.10705CWEOAssigning Agency or Department
50FCOY006400150Financial Class0..*

PV1-20 is a FC, which holds 2 components separated by carets.

SEQLENDTOPTTBL#Component name
FC.120ISR0064Financial Class Code
FC.226TSOEffective Date
PV1-212ISO003200151Charge Price Indicator0..1
PV1-222ISO004500152Courtesy Code0..1
PV1-232ISO004600153Credit Rating0..1
PV1-242ISOY004400154Contract Code0..*
PV1-258DTOY00155Contract Effective Date0..*
PV1-2612NMOY00156Contract Amount0..*
PV1-273NMOY00157Contract Period0..*
PV1-282ISO007300158Interest Code0..1
PV1-294ISO011000159Transfer to Bad Debt Code0..1
PV1-308DTO00160Transfer to Bad Debt Date0..1
PV1-3110ISO002100161Bad Debt Agency Code0..1
PV1-3212NMO00162Bad Debt Transfer Amount0..1
PV1-3312NMO00163Bad Debt Recovery Amount0..1
PV1-341ISO011100164Delete Account Indicator0..1
PV1-358DTO00165Delete Account Date0..1
PV1-363ISO011200166Discharge Disposition0..1
47DLDO011300167Discharged to Location0..1

PV1-37 is a DLD, which holds 2 components separated by carets.

SEQLENDTOPTTBL#Component name
DLD.120ISR0113Discharge Location
DLD.226TSOEffective Date
250CEO011400168Diet Type0..1

PV1-38 is a CE, which holds 6 components separated by carets.

SEQLENDTOPTTBL#Component name
CE.120STOIdentifier
CE.2199STOText
CE.320IDO0396Name of Coding System
CE.420STOAlternate Identifier
CE.5199STOAlternate Text
CE.620IDO0396Name of Alternate Coding System
PV1-392ISO011500169Servicing Facility0..1
PV1-401ISB011600170Bed Status deprecated0..1
PV1-412ISO011700171Account Status0..1
80PLO00172Pending Location0..1

PV1-42 is a PL, which holds 11 components separated by carets.

SEQLENDTOPTTBL#Component name
PL.120ISO0302Point of Care
PL.220ISO0303Room
PL.320ISO0304Bed
PL.4227HDOFacility
PL.520ISO0306Location Status
PL.620ISC0305Person Location Type
PL.720ISO0307Building
PL.820ISO0308Floor
PL.9199STOLocation Description
PL.10427EIOComprehensive Location Identifier
PL.11227HDOAssigning Authority for Location
80PLO00173Prior Temporary Location0..1

PV1-43 is a PL, which holds 11 components separated by carets.

SEQLENDTOPTTBL#Component name
PL.120ISO0302Point of Care
PL.220ISO0303Room
PL.320ISO0304Bed
PL.4227HDOFacility
PL.520ISO0306Location Status
PL.620ISC0305Person Location Type
PL.720ISO0307Building
PL.820ISO0308Floor
PL.9199STOLocation Description
PL.10427EIOComprehensive Location Identifier
PL.11227HDOAssigning Authority for Location
26TSO00174Admit Date/Time0..1

PV1-44 is a TS, which holds 2 components separated by carets.

SEQLENDTOPTTBL#Component name
TS.124DTMRTime
TS.21IDB0529Degree of Precision
26TSOY00175Discharge Date/Time0..*

PV1-45 is a TS, which holds 2 components separated by carets.

SEQLENDTOPTTBL#Component name
TS.124DTMRTime
TS.21IDB0529Degree of Precision
PV1-4612NMO00176Current Patient Balance0..1
PV1-4712NMO00177Total Charges0..1
PV1-4812NMO00178Total Adjustments0..1
PV1-4912NMO00179Total Payments0..1
250CXO020300180Alternate Visit ID0..1

PV1-50 is a CX, which holds 10 components separated by carets.

SEQLENDTOPTTBL#Component name
CX.115STRID Number
CX.21STOCheck Digit
CX.33IDO0061Check Digit Scheme
CX.4227HDO0363Assigning Authority
CX.55IDO0203Identifier Type Code
CX.6227HDOAssigning Facility
CX.78DTOEffective Date
CX.88DTOExpiration Date
CX.9705CWEOAssigning Jurisdiction
CX.10705CWEOAssigning Agency or Department
PV1-511ISO032601226Visit Indicator0..1
250XCNBY001001274Other Healthcare Provider deprecated0..*

PV1-52 is a XCN, which holds 23 components separated by carets.

SEQLENDTOPTTBL#Component name
XCN.115STOID Number
XCN.2194FNOFamily Name
XCN.330STOGiven Name
XCN.430STOSecond and Further Given Names or Initials Thereof
XCN.520STOSuffix (e.g., JR or III)
XCN.620STOPrefix (e.g., DR)
XCN.75ISB0360Degree (e.g., MD)
XCN.84ISC0297Source Table
XCN.9227HDO0363Assigning Authority
XCN.101IDO0200Name Type Code
XCN.111STOIdentifier Check Digit
XCN.123IDC0061Check Digit Scheme
XCN.135IDO0203Identifier Type Code
XCN.14227HDOAssigning Facility
XCN.151IDO0465Name Representation Code
XCN.16483CEO0448Name Context
XCN.1753DRBName Validity Range
XCN.181IDO0444Name Assembly Order
XCN.1926TSOEffective Date
XCN.2026TSOExpiration Date
XCN.21199STOProfessional Suffix
XCN.22705CWEOAssigning Jurisdiction
XCN.23705CWEOAssigning Agency or Department

Open this PV1 message in HL7 Studio

Field notes

Vendor behaviour

What follows describes patterns common to these systems' standard interfaces. Every installation is configured, so confirm against the interface specification for the site you are integrating with.

Epic

Epic populates PV1-3 with the point of care, room and bed as separate components, and the values correspond to the department and bed records in the system, not to anything printed on a door. PV1-19 carries the contact serial number, which is stable for the encounter and is the correct key for updating an existing visit.

Cerner

Cerner feeds distinguish the encounter identifier in PV1-19 from the financial number, and the two are separate concepts in Millennium. Treating PV1-19 as a billing key on a Cerner interface produces encounters that appear to merge and split across a stay.

Mapping to FHIR

PV1 maps to FHIR Encounter, and the two line up well because both are modelling a stay. Patient class becomes Encounter.class, the assigned location becomes an Encounter.location entry, and the doctor fields become Encounter.participant entries distinguished by participant type. The visit number becomes Encounter.identifier and is what makes the mapping idempotent across the A01, A02 and A03 that describe the same stay.

HL7 v2FHIR R4Note
PV1-2Encounter.classvia the v2-to-FHIR class ConceptMap
PV1-3Encounter.location.locationresolve the PL components to a Location resource
PV1-7Encounter.participanttype ATND
PV1-8Encounter.participanttype REF
PV1-17Encounter.participanttype ADM
PV1-19Encounter.identifierthe key that decides update or create
PV1-44, PV1-45Encounter.periodstart and end
PV1-36Encounter.hospitalization.dischargeDisposition

Parsing pitfalls

Message types carrying PV1

PV1 appears in 82 message structures, belonging to 45 message types.