Back to Details

hl7-pam-parser

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

HL7 IHE PAM Message Parser and Explainer

HL7 IHE PAM 消息解析与说明

Overview

概述

This skill parses and explains HL7 v2.5 IHE PAM (Patient Administration Management) messages - the standard healthcare interoperability format for patient administration events. The parser identifies message types, extracts segments and fields, validates structure according to IHE PAM 2.10 specifications, and provides human-readable explanations.
When to use this skill:
  • Parse and explain any HL7 ADT message (raw HL7 text)
  • Identify HL7 message type and event code (ADT^A01, ADT^A02, etc.)
  • Extract and label all segments and fields (MSH, EVN, PID, PV1, PV2)
  • Validate HL7 message structure and required fields
  • Understand IHE PAM business rules and field mappings
  • Debug HL7 message issues or data quality problems
  • Document HL7 message examples with explanations
本技能可解析并解释HL7 v2.5 IHE PAM（患者管理）消息，这是患者管理事件的标准医疗互操作格式。解析器可识别消息类型、提取段和字段、根据IHE PAM 2.10规范验证结构，并提供人类可读的解释。
适用场景：
  • 解析并解释任意HL7 ADT消息（原始HL7文本）
  • 识别HL7消息类型和事件代码（ADT^A01、ADT^A02等）
  • 提取并标记所有段和字段（MSH、EVN、PID、PV1、PV2）
  • 验证HL7消息结构和必填字段
  • 理解IHE PAM业务规则和字段映射
  • 调试HL7消息问题或数据质量问题
  • 为HL7消息示例编写带解释的文档

HL7 v2.5 Message Format

HL7 v2.5 消息格式

HL7 messages use specific delimiters:
Field delimiter:        |  (pipe)
Component delimiter:    ^  (caret)
Repetition delimiter:   ~  (tilde)
Escape character:       \  (backslash)
Subcomponent delimiter: &  (ampersand)
Basic Structure:
MSH|^~\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|Timestamp||MessageType|MessageControlId|ProcessingId|VersionId
EVN|EventTypeCode|RecordedDateTime|...
PID|SetId||PatientId||PatientName||BirthDate|Sex|...
PV1|SetId|PatientClass|AssignedPatientLocation|...
Segment Terminators: Each segment ends with carriage return (
\r
) or newline (
\n
)
HL7消息使用特定分隔符：
Field delimiter:        |  (pipe)
Component delimiter:    ^  (caret)
Repetition delimiter:   ~  (tilde)
Escape character:       \  (backslash)
Subcomponent delimiter: &  (ampersand)
基础结构：
MSH|^~\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|Timestamp||MessageType|MessageControlId|ProcessingId|VersionId
EVN|EventTypeCode|RecordedDateTime|...
PID|SetId||PatientId||PatientName||BirthDate|Sex|...
PV1|SetId|PatientClass|AssignedPatientLocation|...
段终止符： 每个段以回车符（
\r
）或换行符（
\n
）结尾

IHE PAM Message Types

IHE PAM 消息类型

ADT Messages (Admit, Discharge, Transfer)

ADT 消息（入院、出院、转院）

ADT^A01 - Admit/Visit Notification

ADT^A01 - 入院/就诊通知

Purpose: Patient admission to inpatient care or registration
Required Segments:
  • MSH (Message Header)
  • EVN (Event Type)
  • PID (Patient Identification)
  • PV1 (Patient Visit)
Example:
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260122140000||ADT^A01^ADT_A01|MSG001|P|2.5
EVN|A01|20260122140000|||USER001
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M|||15 RUE DE LA PAIX^^PARIS^^75001^FRA||(33)612345678
PV1|1|I|CHU_PARIS^CARDIO^LIT_001^CHU_PARIS||||PR_MARTIN^MARTIN^SOPHIE|||CARDIO||||||||||VIS20260122001|||||||||||||||||||||||||20260122140000
Explanation:
  • Event: A01 (Patient Admission)
  • Patient: DUPONT JEAN (M.), born 15/03/1975
  • Patient ID: PAT12345
  • Visit: VIS20260122001
  • Location: CHU_PARIS, Cardiology, Bed LIT_001
  • Admission: 22/01/2026 14:00:00
  • Patient Class: I (Inpatient)
  • Attending: Dr. MARTIN SOPHIE
用途： 患者入院接受住院护理或挂号
必填段：
  • MSH（消息头）
  • EVN（事件类型）
  • PID（患者标识）
  • PV1（患者就诊）
示例：
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260122140000||ADT^A01^ADT_A01|MSG001|P|2.5
EVN|A01|20260122140000|||USER001
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M|||15 RUE DE LA PAIX^^PARIS^^75001^FRA||(33)612345678
PV1|1|I|CHU_PARIS^CARDIO^LIT_001^CHU_PARIS||||PR_MARTIN^MARTIN^SOPHIE|||CARDIO||||||||||VIS20260122001|||||||||||||||||||||||||20260122140000
说明：
  • 事件： A01（患者入院）
  • 患者： DUPONT JEAN（男），1975年3月15日出生
  • 患者ID： PAT12345
  • 就诊ID： VIS20260122001
  • 位置： 巴黎公立医院，心脏病科，床位LIT_001
  • 入院时间： 2026年1月22日 14:00:00
  • 患者类型： I（住院患者）
  • 主治医师： MARTIN SOPHIE医生

ADT^A02 - Transfer a Patient

ADT^A02 - 患者转院

Purpose: Patient transfer between units, rooms, or services
Required Segments:
  • MSH, EVN, PID, PV1
  • PV2 (optional but recommended for prior location)
Example:
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260123090000||ADT^A02^ADT_A02|MSG002|P|2.5
EVN|A02|20260123090000|||USER002
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M
PV1|1|I|CHU_PARIS^NEURO^LIT_102^CHU_PARIS||||PR_DURAND^DURAND^PAUL|||NEURO||||||||||VIS20260122001
PV2||||||||||||||||||||||CHU_PARIS^CARDIO^LIT_001^CHU_PARIS
Explanation:
  • Event: A02 (Patient Transfer)
  • Patient: PAT12345 (DUPONT JEAN)
  • From: Cardiology, Bed LIT_001 (PV2-1: prior location)
  • To: Neurology, Bed LIT_102 (PV1-3: assigned location)
  • Transfer Time: 23/01/2026 09:00:00
用途： 患者在科室、病房或服务部门之间转移
必填段：
  • MSH、EVN、PID、PV1
  • PV2（可选，建议用于记录原位置）
示例：
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260123090000||ADT^A02^ADT_A02|MSG002|P|2.5
EVN|A02|20260123090000|||USER002
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M
PV1|1|I|CHU_PARIS^NEURO^LIT_102^CHU_PARIS||||PR_DURAND^DURAND^PAUL|||NEURO||||||||||VIS20260122001
PV2||||||||||||||||||||||CHU_PARIS^CARDIO^LIT_001^CHU_PARIS
说明：
  • 事件： A02（患者转院）
  • 患者： PAT12345（DUPONT JEAN）
  • 转出： 心脏病科，床位LIT_001（PV2-1：原位置）
  • 转入： 神经科，床位LIT_102（PV1-3：分配位置）
  • 转移时间： 2026年1月23日 09:00:00

ADT^A03 - Discharge a Patient

ADT^A03 - 患者出院

Purpose: Patient discharge from hospital
Required Segments:
  • MSH, EVN, PID, PV1
Example:
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260125180000||ADT^A03^ADT_A03|MSG003|P|2.5
EVN|A03|20260125180000|||USER003
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M
PV1|1|I|CHU_PARIS^CARDIO^LIT_001^CHU_PARIS||||PR_MARTIN^MARTIN^SOPHIE|||CARDIO||||||||||VIS20260122001|||||||||||||||||||||||||||20260125180000|||||HOME
Explanation:
  • Event: A03 (Patient Discharge)
  • Patient: PAT12345 (DUPONT JEAN)
  • Discharge Time: 25/01/2026 18:00:00 (PV1-45)
  • Discharge Disposition: HOME (PV1-36)
  • Visit: VIS20260122001
用途： 患者从医院出院
必填段：
  • MSH、EVN、PID、PV1
示例：
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260125180000||ADT^A03^ADT_A03|MSG003|P|2.5
EVN|A03|20260125180000|||USER003
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M
PV1|1|I|CHU_PARIS^CARDIO^LIT_001^CHU_PARIS||||PR_MARTIN^MARTIN^SOPHIE|||CARDIO||||||||||VIS20260122001|||||||||||||||||||||||||||20260125180000|||||HOME
说明：
  • 事件： A03（患者出院）
  • 患者： PAT12345（DUPONT JEAN）
  • 出院时间： 2026年1月25日 18:00:00（PV1-45）
  • 出院去向： 回家（PV1-36）
  • 就诊ID： VIS20260122001

ADT^A04 - Register a Patient

ADT^A04 - 患者挂号

Purpose: Pre-admission or outpatient registration
Required Segments:
  • MSH, EVN, PID, PV1
用途： 预入院或门诊挂号
必填段：
  • MSH、EVN、PID、PV1

ADT^A05 - Pre-admit a Patient

ADT^A05 - 患者预入院

Purpose: Pre-admission notification
用途： 预入院通知

ADT^A06 - Change Outpatient to Inpatient

ADT^A06 - 门诊转住院

Purpose: Convert outpatient visit to inpatient admission
用途： 将门诊就诊转为住院入院

ADT^A07 - Change Inpatient to Outpatient

ADT^A07 - 住院转门诊

Purpose: Convert inpatient admission to outpatient visit
用途： 将住院入院转为门诊就诊

ADT^A08 - Update Patient Information

ADT^A08 - 更新患者信息

Purpose: Update patient demographics
Example:
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260122150000||ADT^A08^ADT_A08|MSG004|P|2.5
EVN|A08|20260122150000|||USER001
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M|||15 RUE DE LA PAIX^^PARIS^^75001^FRA||(33)612345678|||||||1234567890123||FRA
PV1|1|O||||||||||||||||||||VIS20260122001
Explanation:
  • Event: A08 (Update Patient Information)
  • Patient: PAT12345 demographics updated
  • Updated Fields: Address, phone, national identifier (NIR)
用途： 更新患者人口统计信息
示例：
MSH|^~\&|HEXAFLUX|CHU_PARIS|TARGET|DEST|20260122150000||ADT^A08^ADT_A08|MSG004|P|2.5
EVN|A08|20260122150000|||USER001
PID|1||PAT12345^^^CHU_PARIS^PI||DUPONT^JEAN^^M.||19750315|M|||15 RUE DE LA PAIX^^PARIS^^75001^FRA||(33)612345678|||||||1234567890123||FRA
PV1|1|O||||||||||||||||||||VIS20260122001
说明：
  • 事件： A08（更新患者信息）
  • 患者： PAT12345的人口统计信息已更新
  • 更新字段： 地址、电话、国家身份号码（NIR）

ADT^A11 - Cancel Admit

ADT^A11 - 取消入院

Purpose: Cancel a previous admission
用途： 取消之前的入院记录

ADT^A12 - Cancel Transfer

ADT^A12 - 取消转院

Purpose: Cancel a previous transfer
用途： 取消之前的转院记录

ADT^A13 - Cancel Discharge

ADT^A13 - 取消出院

Purpose: Cancel a previous discharge
用途： 取消之前的出院记录

Segment Definitions

段定义

MSH - Message Header (Required)

MSH - 消息头（必填）

Purpose: Message metadata and routing information
Field Structure:
MSH|^~\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|Timestamp||MessageType^EventCode^MessageStructure|MessageControlId|ProcessingId|VersionId
Key Fields:
  • MSH-3: Sending Application
  • MSH-4: Sending Facility
  • MSH-5: Receiving Application
  • MSH-6: Receiving Facility
  • MSH-7: Date/Time of Message (YYYYMMDDHHmmss)
  • MSH-9: Message Type (ADT^A01^ADT_A01)
  • MSH-10: Message Control ID (unique identifier)
  • MSH-11: Processing ID (P=Production, T=Training, D=Debugging)
  • MSH-12: Version ID (2.5)
用途： 消息元数据和路由信息
字段结构：
MSH|^~\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|Timestamp||MessageType^EventCode^MessageStructure|MessageControlId|ProcessingId|VersionId
关键字段：
  • MSH-3：发送方应用
  • MSH-4：发送方机构
  • MSH-5：接收方应用
  • MSH-6：接收方机构
  • MSH-7：消息发送时间（YYYYMMDDHHmmss）
  • MSH-9：消息类型（ADT^A01^ADT_A01）
  • MSH-10：消息控制ID（唯一标识）
  • MSH-11：处理ID（P=生产，T=测试，D=调试）
  • MSH-12：版本ID（2.5）

EVN - Event Type (Required)

EVN - 事件类型（必填）

Purpose: Event-specific information
Field Structure:
EVN|EventTypeCode|RecordedDateTime|EventDateTime|EventReasonCode|OperatorId
Key Fields:
  • EVN-1: Event Type Code (A01, A02, A03, etc.)
  • EVN-2: Recorded Date/Time (when event was recorded)
  • EVN-3: Event Occurred Date/Time (when event actually occurred)
  • EVN-5: Operator ID (user who triggered the event)
用途： 事件相关信息
字段结构：
EVN|EventTypeCode|RecordedDateTime|EventDateTime|EventReasonCode|OperatorId
关键字段：
  • EVN-1：事件类型代码（A01、A02、A03等）
  • EVN-2：记录时间（事件被记录的时间）
  • EVN-3：事件发生时间（事件实际发生的时间）
  • EVN-5：操作员ID（触发事件的用户）

PID - Patient Identification (Required)

PID - 患者标识（必填）

Purpose: Patient demographic information
Field Structure (30+ fields):
PID|SetId||PatientId^^^AssigningAuthority^IdType~AltId||LastName^FirstName^MiddleName^Suffix^Prefix||BirthDate|Sex|PatientAlias|Race|PatientAddress||PhoneHome|PhoneBusiness|PrimaryLanguage|MaritalStatus|Religion|PatientAccountNumber|SSN|DriverLicense|MotherIdentifier|EthnicGroup|BirthPlace|MultipleBirth|BirthOrder|Citizenship|VeteranStatus|Nationality|DeathDateTime|DeathIndicator
Key Fields:
  • PID-1: Set ID
  • PID-3: Patient Identifier List (PatientId^^^Facility^PI)
  • PID-5: Patient Name (LastName^FirstName^MiddleName^Suffix^Prefix)
  • PID-7: Date of Birth (YYYYMMDD)
  • PID-8: Sex (M/F/O/U)
  • PID-11: Patient Address (Street^^City^^PostalCode^Country)
  • PID-13: Phone Number - Home
  • PID-14: Phone Number - Business
  • PID-22: Ethnic Group
  • PID-29: Death Date and Time
  • PID-30: Death Indicator (Y/N)
用途： 患者人口统计信息
字段结构（30+个字段）：
PID|SetId||PatientId^^^AssigningAuthority^IdType~AltId||LastName^FirstName^MiddleName^Suffix^Prefix||BirthDate|Sex|PatientAlias|Race|PatientAddress||PhoneHome|PhoneBusiness|PrimaryLanguage|MaritalStatus|Religion|PatientAccountNumber|SSN|DriverLicense|MotherIdentifier|EthnicGroup|BirthPlace|MultipleBirth|BirthOrder|Citizenship|VeteranStatus|Nationality|DeathDateTime|DeathIndicator
关键字段：
  • PID-1：设置ID
  • PID-3：患者标识列表（PatientId^^^机构^PI）
  • PID-5：患者姓名（姓氏^名字^中间名^后缀^前缀）
  • PID-7：出生日期（YYYYMMDD）
  • PID-8：性别（M/F/O/U）
  • PID-11：患者地址（街道^^城市^^邮编^国家）
  • PID-13：家庭电话号码
  • PID-14：工作电话号码
  • PID-22：族群
  • PID-29：死亡日期和时间
  • PID-30：死亡标识（Y/N）

PV1 - Patient Visit (Required)

PV1 - 患者就诊（必填）

Purpose: Visit/encounter information
Field Structure (52 fields):
PV1|SetId|PatientClass|AssignedLocation^Room^Bed^Facility|AdmissionType|PreadmitNumber|PriorLocation|AttendingDoctor^LastName^FirstName|ReferringDoctor|ConsultingDoctor|HospitalService|TemporaryLocation|PreadmitTestIndicator|ReadmissionIndicator|AdmitSource|AmbulatoryStatus|VIPIndicator|AdmittingDoctor|PatientType|VisitNumber|FinancialClass
Key Fields:
  • PV1-1: Set ID
  • PV1-2: Patient Class (I=Inpatient, O=Outpatient, E=Emergency, R=Recurring)
  • PV1-3: Assigned Patient Location (Facility^Service^Room^Bed)
  • PV1-4: Admission Type (E=Emergency, R=Routine, etc.)
  • PV1-6: Prior Patient Location (for transfers)
  • PV1-7: Attending Doctor (DoctorId^LastName^FirstName)
  • PV1-10: Hospital Service
  • PV1-19: Visit Number (unique visit identifier)
  • PV1-36: Discharge Disposition (HOME, SNF, EXP, etc.)
  • PV1-44: Admit Date/Time
  • PV1-45: Discharge Date/Time
用途： 就诊/接诊信息
字段结构（52个字段）：
PV1|SetId|PatientClass|AssignedLocation^Room^Bed^Facility|AdmissionType|PreadmitNumber|PriorLocation|AttendingDoctor^LastName^FirstName|ReferringDoctor|ConsultingDoctor|HospitalService|TemporaryLocation|PreadmitTestIndicator|ReadmissionIndicator|AdmitSource|AmbulatoryStatus|VIPIndicator|AdmittingDoctor|PatientType|VisitNumber|FinancialClass
关键字段：
  • PV1-1：设置ID
  • PV1-2：患者类型（I=住院，O=门诊，E=急诊，R=复诊）
  • PV1-3：分配的患者位置（机构^科室^病房^床位）
  • PV1-4：入院类型（E=急诊，R=常规等）
  • PV1-6：患者原位置（转院时使用）
  • PV1-7：主治医师（医生ID^姓氏^名字）
  • PV1-10：医院服务科室
  • PV1-19：就诊ID（唯一就诊标识）
  • PV1-36：出院去向（HOME、SNF、EXP等）
  • PV1-44：入院日期/时间
  • PV1-45：出院日期/时间

PV2 - Patient Visit - Additional Info (Optional)

PV2 - 患者就诊 - 附加信息（可选）

Purpose: Extended visit information
Key Fields:
  • PV2-1: Prior Pending Location (for transfers)
  • PV2-3: Admit Reason
  • PV2-8: Expected Discharge Date
  • PV2-9: Expected Discharge Disposition
  • PV2-47: Expected LOA Return Date/Time
用途： 扩展就诊信息
关键字段：
  • PV2-1：原待分配位置（转院时使用）
  • PV2-3：入院原因
  • PV2-8：预计出院日期
  • PV2-9：预计出院去向
  • PV2-47：预计请假返回日期/时间

IHE PAM Mandatory Fields

IHE PAM 必填字段

Required for All ADT Messages

所有ADT消息必填

  • MSH-3: Sending Application
  • MSH-4: Sending Facility
  • MSH-7: Date/Time of Message
  • MSH-9: Message Type
  • MSH-10: Message Control ID
  • MSH-12: Version ID (2.5)
  • EVN-1: Event Type Code
  • EVN-2: Recorded Date/Time
  • PID-3: Patient Identifier
  • PID-5: Patient Name
  • PID-7: Date of Birth
  • PID-8: Sex
  • MSH-3：发送方应用
  • MSH-4：发送方机构
  • MSH-7：消息发送时间
  • MSH-9：消息类型
  • MSH-10：消息控制ID
  • MSH-12：版本ID（2.5）
  • EVN-1：事件类型代码
  • EVN-2：记录时间
  • PID-3：患者标识
  • PID-5：患者姓名
  • PID-7：出生日期
  • PID-8：性别

Required for Admission/Transfer Messages (A01, A02)

入院/转院消息（A01、A02）必填

  • PV1-2: Patient Class
  • PV1-3: Assigned Patient Location
  • PV1-19: Visit Number
  • PV1-44: Admit Date/Time
  • PV1-2：患者类型
  • PV1-3：分配的患者位置
  • PV1-19：就诊ID
  • PV1-44：入院日期/时间

Required for Discharge Messages (A03)

出院消息（A03）必填

  • PV1-36: Discharge Disposition
  • PV1-45: Discharge Date/Time
  • PV1-36：出院去向
  • PV1-45：出院日期/时间

Parsing Logic

解析逻辑

When asked to parse an HL7 IHE PAM message:
  1. Split by segment terminator: 
    segments = message.split('\r')
    or 
    split('\n')
  2. Parse MSH segment (always first):
    • Extract delimiters from MSH-2: 
      ^~\&
    • Field delimiter: 
      |
    • Component delimiter: 
      ^
    • Repetition delimiter: 
      ~
    • Escape character: 
      \
    • Subcomponent delimiter: 
      &
  3. Identify message type: Check MSH-9
    • ADT^A01 = Admission
    • ADT^A02 = Transfer
    • ADT^A03 = Discharge
    • etc.
  4. Parse each segment:
    • Split by field delimiter 
      |
    • Parse components with 
      ^
    • Parse repetitions with 
      ~
    • Parse subcomponents with 
      &
  5. Extract key fields:
    • Patient ID (PID-3)
    • Patient name (PID-5)
    • Birth date (PID-7)
    • Visit number (PV1-19)
    • Location (PV1-3)
    • Dates (PV1-44, PV1-45)
  6. Validate structure:
    • Check required segments present
    • Check required fields populated
    • Validate date formats (YYYYMMDD, YYYYMMDDHHmmss)
    • Validate code values (patient class, sex, etc.)
  7. Generate explanation:
    • Identify message purpose
    • Explain event type
    • List key patient information
    • Describe visit/encounter details
    • Provide clinical context
当要求解析HL7 IHE PAM消息时：
  1. 按段终止符拆分：
    segments = message.split('\r')
    或 
    split('\n')
  2. 解析MSH段（始终是第一个段）：
    • 从MSH-2提取分隔符：
      ^~\&
    • 字段分隔符：
      |
    • 组件分隔符：
      ^
    • 重复分隔符：
      ~
    • 转义字符：
      \
    • 子组件分隔符：
      &
  3. 识别消息类型：检查MSH-9
    • ADT^A01 = 入院
    • ADT^A02 = 转院
    • ADT^A03 = 出院
    • 其他依次类推
  4. 解析每个段：
    • 按字段分隔符
      |
      拆分
    • 用
      ^
      解析组件
    • 用
      ~
      解析重复项
    • 用
      &
      解析子组件
  5. 提取关键字段：
    • 患者ID（PID-3）
    • 患者姓名（PID-5）
    • 出生日期（PID-7）
    • 就诊ID（PV1-19）
    • 位置（PV1-3）
    • 日期（PV1-44、PV1-45）
  6. 验证结构：
    • 检查必填段是否存在
    • 检查必填字段是否已填写
    • 验证日期格式（YYYYMMDD、YYYYMMDDHHmmss）
    • 验证代码值（患者类型、性别等）
  7. 生成说明：
    • 说明消息用途
    • 解释事件类型
    • 列出关键患者信息
    • 描述就诊/接诊详情
    • 提供临床背景

Example Output Format

输出格式示例

When parsing a message, provide:
markdown
undefined
解析消息时，请提供以下内容：
markdown
undefined

HL7 IHE PAM Message Analysis

HL7 IHE PAM 消息分析

Raw Message:
[original HL7 message with visible delimiters]
Message Identification:
  • Message Type: ADT^A01
  • Event Code: A01 (Admit/Visit Notification)
  • Message Control ID: [MSH-10]
  • Timestamp: [formatted MSH-7]
  • Version: 2.5
MSH - Message Header:
  • Sending Application: [MSH-3]
  • Sending Facility: [MSH-4]
  • Receiving Application: [MSH-5]
  • Receiving Facility: [MSH-6]
  • Processing ID: [MSH-11] (Production/Test)
EVN - Event Type:
  • Event Code: [EVN-1]
  • Recorded DateTime: [formatted EVN-2]
  • Event Occurred: [formatted EVN-3]
  • Operator: [EVN-5]
PID - Patient Identification:
  • Patient ID: [PID-3]
  • Patient Name: [formatted PID-5]
  • Date of Birth: [formatted PID-7]
  • Sex: [PID-8]
  • Address: [formatted PID-11]
  • Phone: [PID-13]
  • [other relevant fields]
PV1 - Patient Visit:
  • Patient Class: [PV1-2] ([description])
  • Assigned Location: [formatted PV1-3]
  • Attending Doctor: [formatted PV1-7]
  • Hospital Service: [PV1-10]
  • Visit Number: [PV1-19]
  • Admit DateTime: [formatted PV1-44]
  • [other relevant fields based on message type]
PV2 - Additional Visit Info (if present):
  • Prior Location: [PV2-1]
  • [other relevant fields]
Business Context: [Explain what this message represents, the workflow event, and clinical significance]
IHE PAM Compliance:
  • Required segments: [✓ or ✗ for MSH, EVN, PID, PV1]
  • Required fields: [list of mandatory field validation results]
  • Field formats: [✓ or ✗ for dates, codes, etc.]
undefined
原始消息：
[原始HL7消息，分隔符可见]
消息标识：
  • 消息类型：ADT^A01
  • 事件代码：A01（入院/就诊通知）
  • 消息控制ID：[MSH-10]
  • 时间戳：[格式化后的MSH-7]
  • 版本：2.5
MSH - 消息头：
  • 发送方应用：[MSH-3]
  • 发送方机构：[MSH-4]
  • 接收方应用：[MSH-5]
  • 接收方机构：[MSH-6]
  • 处理ID：[MSH-11]（生产/测试）
EVN - 事件类型：
  • 事件代码：[EVN-1]
  • 记录时间：[格式化后的EVN-2]
  • 事件发生时间：[格式化后的EVN-3]
  • 操作员：[EVN-5]
PID - 患者标识：
  • 患者ID：[PID-3]
  • 患者姓名：[格式化后的PID-5]
  • 出生日期：[格式化后的PID-7]
  • 性别：[PID-8]
  • 地址：[格式化后的PID-11]
  • 电话：[PID-13]
  • [其他相关字段]
PV1 - 患者就诊：
  • 患者类型：[PV1-2]（[描述]）
  • 分配位置：[格式化后的PV1-3]
  • 主治医师：[格式化后的PV1-7]
  • 服务科室：[PV1-10]
  • 就诊ID：[PV1-19]
  • 入院时间：[格式化后的PV1-44]
  • [根据消息类型展示其他相关字段]
PV2 - 附加就诊信息（如果存在）：
  • 原位置：[PV2-1]
  • [其他相关字段]
业务背景： [解释该消息代表的含义、工作流事件和临床意义]
IHE PAM 合规性：
  • 必填段：[MSH、EVN、PID、PV1的校验结果，✓或✗]
  • 必填字段：[必填字段校验结果列表]
  • 字段格式：[日期、代码等的校验结果，✓或✗]
undefined

Common ADT Event Codes

常见ADT事件代码

CodeEvent NamePurpose
A01Admit/Visit NotificationPatient admission to inpatient care
A02Transfer a PatientTransfer between units/rooms
A03Discharge a PatientPatient discharge from hospital
A04Register a PatientPre-admission or outpatient registration
A05Pre-admit a PatientNotification of planned admission
A06Change Outpatient to InpatientStatus change
A07Change Inpatient to OutpatientStatus change
A08Update Patient InformationDemographics update
A09Patient Departing - TrackingPatient left facility temporarily
A10Patient Arriving - TrackingPatient returned to facility
A11Cancel AdmitCancel previous admission
A12Cancel TransferCancel previous transfer
A13Cancel DischargeCancel previous discharge
A21Patient Goes on Leave of AbsenceTemporary leave
A22Patient Returns from Leave of AbsenceReturn from leave
A28Add Person InformationAdd new person to database
A31Update Person InformationUpdate person demographics
代码事件名称用途
A01入院/就诊通知患者入院接受住院护理
A02患者转院在科室/病房之间转移
A03患者出院患者从医院出院
A04患者挂号预入院或门诊挂号
A05患者预入院计划入院通知
A06门诊转住院状态变更
A07住院转门诊状态变更
A08更新患者信息人口统计信息更新
A09患者外出 - 追踪患者临时离开机构
A10患者返回 - 追踪患者返回机构
A11取消入院取消之前的入院记录
A12取消转院取消之前的转院记录
A13取消出院取消之前的出院记录
A21患者请假临时离开
A22患者销假请假返回
A28添加人员信息向数据库添加新人员
A31更新人员信息更新人员人口统计信息

Patient Class Codes

患者类型代码

CodeDescription
IInpatient
OOutpatient
EEmergency
PPreadmit
RRecurring patient
BObstetrics
CCommercial Account
NNot Applicable
UUnknown
代码描述
I住院患者
O门诊患者
E急诊患者
P预入院患者
R复诊患者
B产科患者
C商业账户
N不适用
U未知

Discharge Disposition Codes

出院去向代码

CodeDescription
HOMEHome or self care
SNFSkilled nursing facility
RHRehabilitation facility
EXPExpired (deceased)
HOSHospice
AADVICELeft against medical advice
OTHOther
代码描述
HOME回家或自我护理
SNF专业护理机构
RH康复机构
EXP身故
HOS临终关怀
AADVICE违背医疗建议离院
OTH其他

Validation Rules

验证规则

Message Structure

消息结构

  • First segment MUST be MSH
  • MSH-1 MUST be 
    |
  • MSH-2 MUST be 
    ^~\&
    (encoding characters)
  • Segments MUST be separated by CR or LF
  • Fields MUST be separated by 
    |
  • 第一个段必须是MSH
  • MSH-1必须是
    |
  • MSH-2必须是
    ^~\&
    （编码字符）
  • 段必须用CR或LF分隔
  • 字段必须用
    |
    分隔

Required Segments by Message Type

不同消息类型的必填段

  • A01, A04, A05: MSH, EVN, PID, PV1
  • A02: MSH, EVN, PID, PV1 (PV2 recommended for prior location)
  • A03: MSH, EVN, PID, PV1
  • A08: MSH, EVN, PID (PV1 optional)
  • A11, A12, A13: MSH, EVN, PID
  • A01、A04、A05：MSH、EVN、PID、PV1
  • A02：MSH、EVN、PID、PV1（建议添加PV2记录原位置）
  • A03：MSH、EVN、PID、PV1
  • A08：MSH、EVN、PID（PV1可选）
  • A11、A12、A13：MSH、EVN、PID

Date/Time Formats

日期/时间格式

  • Date: YYYYMMDD
  • DateTime: YYYYMMDDHHmmss or YYYYMMDDHHmmss.SSSS
  • Time: HHmmss
  • 日期：YYYYMMDD
  • 日期时间：YYYYMMDDHHmmss或YYYYMMDDHHmmss.SSSS
  • 时间：HHmmss

Patient Identifier Format

患者标识格式

  • PID-3: PatientId^^^AssigningAuthority^IdentifierType
  • Example: PAT12345^^^CHU_PARIS^PI
  • PID-3：PatientId^^^分配机构^标识类型
  • 示例：PAT12345^^^CHU_PARIS^PI

Name Format

姓名格式

  • PID-5: LastName^FirstName^MiddleName^Suffix^Prefix^Degree
  • Example: DUPONT^JEAN^^M.
  • PID-5：姓氏^名字^中间名^后缀^前缀^学位
  • 示例：DUPONT^JEAN^^M.

Location Format

位置格式

  • PV1-3: PointOfCare^Room^Bed^Facility^LocationStatus^PersonLocationType^Building
  • Example: CHU_PARIS^CARDIO^LIT_001^CHU_PARIS
  • PV1-3：护理点^病房^床位^机构^位置状态^人员位置类型^楼宇
  • 示例：CHU_PARIS^CARDIO^LIT_001^CHU_PARIS

Reference Documentation

参考文档

IHE PAM Specification:
HL7 v2.5 Standard:
Related Tools:
IHE PAM 规范：
HL7 v2.5 标准：
相关工具：

Quick Reference

快速参考

Delimiters

分隔符

|  Field delimiter
^  Component delimiter
~  Repetition delimiter
\  Escape character
&  Subcomponent delimiter
|  字段分隔符
^  组件分隔符
~  重复分隔符
\  转义字符
&  子组件分隔符

Common Fields

常用字段

MSH-9  : Message Type (ADT^A01^ADT_A01)
MSH-10 : Message Control ID
EVN-1  : Event Type Code (A01, A02, etc.)
EVN-2  : Recorded DateTime
PID-3  : Patient ID
PID-5  : Patient Name
PID-7  : Birth Date
PID-8  : Sex
PV1-2  : Patient Class (I/O/E)
PV1-3  : Assigned Location
PV1-19 : Visit Number
PV1-44 : Admit DateTime
PV1-45 : Discharge DateTime
MSH-9  : 消息类型 (ADT^A01^ADT_A01)
MSH-10 : 消息控制ID
EVN-1  : 事件类型代码 (A01, A02, 等)
EVN-2  : 记录时间
PID-3  : 患者ID
PID-5  : 患者姓名
PID-7  : 出生日期
PID-8  : 性别
PV1-2  : 患者类型 (I/O/E)
PV1-3  : 分配位置
PV1-19 : 就诊ID
PV1-44 : 入院时间
PV1-45 : 出院时间