Interface: PL

HL7 v2 Person Location (PL): structured location per HL7 Chapter 2. All 11 v1 components are optional. Fields are OMITTED when the underlying component is absent (exactOptionalPropertyTypes). facility uses the nested HD shape; assigningAuthorityForLocation is flattened to a plain string in v1 (HL7 spec treats it as HD-shaped).

Component positions (HL7 1-indexed; this interface is 0-indexed by key):

1. pointOfCare: e.g. "ICU", "ED"
2. room
3. bed
4. facility: nested HD (3 subcomponents form an HD composite)
5. locationStatus: O=Occupied, U=Unoccupied, K=Contaminated, C=Closed, H=Housekeeping, I=Isolated
6. personLocationType: C=Clinic, D=Department, H=Home, N=Nursing Unit, O=Office, R=Revenue Location
7. building
8. floor
9. locationDescription: free-text
10. comprehensiveLocationId
11. assigningAuthorityForLocation (v1: flattened to string)

Example

import type { PL } from "@cosyte/hl7";
const bed: PL = {
  pointOfCare: "ICU",
  room: "101",
  bed: "A",
  facility: { namespaceId: "HOSP", universalId: "1.2.3", universalIdType: "UUID" },
};

Properties

assigningAuthorityForLocation?

readonly optional assigningAuthorityForLocation?: string

---

bed?

readonly optional bed?: string

---

building?

readonly optional building?: string

---

comprehensiveLocationId?

readonly optional comprehensiveLocationId?: string

---

facility?

readonly optional facility?: HD

---

floor?

readonly optional floor?: string

---

locationDescription?

readonly optional locationDescription?: string

---

locationStatus?

readonly optional locationStatus?: string

---

personLocationType?

readonly optional personLocationType?: string

---

pointOfCare?

readonly optional pointOfCare?: string

---

room?

readonly optional room?: string