HL7V3ToJson - 医院信息平台交互标准 (V3)

基于 WS/T 846-2024 国家卫生行业标准，将 HL7 V3 消息从 XML 格式转换为更简洁、易用的 JSON 格式，方便医院信息平台各系统间对接和接口测试。

目录

• 项目概述
• 前置依赖
• 目录结构
• 文件统计
• 消息类型汇总
• 通用字段说明
• OID标识符对照表
• 使用说明
• 版本信息

项目概述

本项目将《医院信息平台交互标准》（WS/T 846-2024）系列 PDF 文档中定义的 XML 消息格式，转换为结构化的 JSON 格式，包含以下两类数据：

• json-examples/：带有字段注释的 JSON 示例，用于理解和学习消息结构
• json-demo/：纯净测试数据，可直接用于接口开发和自动化测试

同时提供 Java 版的 JSON/XML 互转工具和 Python 数据生成脚本。

标准文档

说明：WS/T 846 系列标准共 11 个部分，其中第 1 部分为总则，第 9 部分（费用信息交互服务）尚未发布，本项目覆盖其余 9 个部分。

前置依赖

JSON 数据使用

无依赖，直接使用任意 HTTP 客户端或编程语言解析 JSON 文件即可。

Java 转换器

HospitalConverter 和 SimpleConverter 无需第三方依赖，仅使用 JDK 内置库。

# 下载 org.json 依赖（仅编译 HospitalXmlJsonConverter 时需要）
curl -L -o json.jar 'https://repo1.maven.org/maven2/org/json/json/20231013/json-20231013.jar'
编译全部类
javac -cp json.jar -d out/ src/main/java/com/hospital/converter/*.java
运行
java -cp out:json.jar com.hospital.converter.HospitalXmlJsonConverter json2xml input.json output.xml

Python 脚本

python3 scripts/generate_test_data.py

目录结构

HL7V3ToJson/
├── README.md                              # 项目说明（中文）
├── README_EN.md                           # 项目说明（英文）
│
├── json-examples/                         # JSON示例文件（含字段说明）
│   ├── README.md                          # 目录说明
│   ├── 字段说明.md                        # 完整字段说明文档
│   ├── 第2部分_个人信息/                   # 个人信息服务 (10个文件)
│   │   ├── 注册请求.json
│   │   ├── 注册应答成功.json
│   │   ├── 注册应答异常.json
│   │   ├── 更新请求.json
│   │   ├── 查询请求.json
│   │   ├── 查询应答成功.json
│   │   ├── 查询应答异常.json
│   │   ├── 合并请求.json
│   │   ├── 字段说明.json
│   │   └── 字段说明.md
│   ├── 第3部分_医疗机构/                   # 医疗机构服务 (8个文件)
│   │   ├── 注册请求.json
│   │   ├── 更新请求.json
│   │   ├── 查询请求.json
│   │   ├── 查询应答.json
│   │   ├── 通用应答.json
│   │   ├── 字段说明.json
│   │   ├── 字段说明.md
│   │   └── schema.json
│   ├── 第4部分_医护人员/                   # 医护人员服务 (7个文件)
│   │   ├── 注册请求.json
│   │   ├── 更新请求.json
│   │   ├── 查询请求.json
│   │   ├── 查询应答.json
│   │   ├── 通用应答.json
│   │   ├── 字段说明.json
│   │   └── 字段说明.md
│   ├── 第5部分_术语/                       # 术语服务 (7个文件)
│   │   ├── 注册请求.json
│   │   ├── 更新请求.json
│   │   ├── 查询请求.json
│   │   ├── 查询应答.json
│   │   ├── 通用应答.json
│   │   ├── 字段说明.json
│   │   └── 字段说明.md
│   ├── 第6部分_文档/                       # 文档服务 (6个文件)
│   │   ├── 注册请求.json
│   │   ├── 查询请求.json
│   │   ├── 查询应答.json
│   │   ├── 通用应答.json
│   │   ├── 字段说明.json
│   │   └── 字段说明.md
│   ├── 第7部分_就诊信息/                   # 就诊信息服务 (22个文件)
│   │   ├── 就诊卡新增请求.json
│   │   ├── 就诊卡更新请求.json
│   │   ├── 就诊卡查询请求.json
│   │   ├── 就诊卡查询应答.json
│   │   ├── 门诊挂号新增请求.json
│   │   ├── 门诊挂号更新请求.json
│   │   ├── 门诊挂号查询请求.json
│   │   ├── 门诊挂号查询应答.json
│   │   ├── 住院登记请求.json
│   │   ├── 住院更新请求.json
│   │   ├── 住院查询请求.json
│   │   ├── 住院查询应答.json
│   │   ├── 住院转科新增请求.json
│   │   ├── 住院转科更新请求.json
│   │   ├── 住院转科查询请求.json
│   │   ├── 住院转科查询应答.json
│   │   ├── 出院登记新增请求.json
│   │   ├── 出院登记更新请求.json
│   │   ├── 出院信息查询请求.json
│   │   ├── 出院信息查询应答.json
│   │   ├── 字段说明.json
│   │   └── 字段说明.md
│   ├── 第8部分_医嘱/                       # 医嘱服务 (7个文件)
│   │   ├── 开立请求.json
│   │   ├── 查询请求.json
│   │   ├── 查询应答.json
│   │   ├── 通用应答.json
│   │   ├── 字段说明.json
│   │   ├── 字段说明.md
│   │   └── schema.json
│   ├── 第10部分_预约/                      # 预约服务 (8个文件)
│   │   ├── 申请请求.json
│   │   ├── 申请应答.json
│   │   ├── 取消请求.json
│   │   ├── 取消应答.json
│   │   ├── 查询请求.json
│   │   ├── 查询应答.json
│   │   ├── 字段说明.json
│   │   └── 字段说明.md
│   └── 第11部分_状态/                      # 状态服务 (6个文件)
│       ├── 更新请求.json
│       ├── 更新应答.json
│       ├── 查询请求.json
│       ├── 查询应答.json
│       ├── 字段说明.json
│       └── 字段说明.md
│
├── json-demo/                             # 纯净测试数据（可用于接口测试）
│   ├── README.md
│   ├── 字段说明.md
│   ├── 第2部分_个人信息/                   # 8个JSON文件
│   ├── 第3部分_医疗机构/                   # 5个JSON文件
│   ├── 第4部分_医护人员/                   # 5个JSON文件
│   ├── 第5部分_术语/                       # 5个JSON文件
│   ├── 第6部分_文档/                       # 4个JSON文件
│   ├── 第7部分_就诊信息/                   # 20个JSON文件
│   ├── 第8部分_医嘱/                       # 4个JSON文件
│   ├── 第10部分_预约/                      # 6个JSON文件
│   └── 第11部分_状态/                      # 4个JSON文件
│
├── java-converter/                        # Java JSON/XML互转工具
│   ├── README.md
│   ├── converter.sh
│   └── src/main/java/com/hospital/converter/
│       ├── HospitalConverter.java         # 基础转换器（无外部依赖）
│       ├── SimpleConverter.java           # 简化转换器
│       └── HospitalXmlJsonConverter.java  # 完整转换器（需 org.json）
│
└── scripts/                               # 工具脚本
    ├── xml_to_json.py                     # XML转JSON脚本
    ├── generate_test_data.py              # 测试数据生成器
    ├── fill_values.py                     # 字段填充工具
    ├── generate_comprehensive_json.py     # 综合JSON生成器
    ├── generate_part7_json.py             # 第7部分专用生成器
    ├── extract_and_generate.py            # PDF提取与生成
    ├── analyze_pdfs.py                    # PDF分析工具
    └── add_sample_values.py               # 示例值填充

文件统计

消息类型汇总

第2部分：个人信息服务

第3部分：医疗机构服务

第4部分：医护人员服务

第5部分：术语服务

第6部分：文档服务

第7部分：就诊信息服务

第8部分：医嘱服务

第10部分：预约服务

第11部分：状态服务

通用字段说明

消息头 (messageHeader)

应答消息 (acknowledgement)

OID标识符对照表

使用说明

1. 查看JSON示例

# 查看医嘱开立请求示例（含字段说明）
cat json-examples/第8部分_医嘱/开立请求.json
查看纯净测试数据
cat json-demo/第8部分_医嘱/开立请求.json

2. 使用测试数据进行接口测试

# 使用curl测试接口
curl -X POST http://your-api/order/create \
  -H "Content-Type: application/json" \
  -d @json-demo/第8部分_医嘱/开立请求.json

3. 使用Java转换器

cd java-converter/src/main/java
编译（无需第三方依赖）
javac com/hospital/converter/HospitalConverter.java
JSON转XML
java com.hospital.converter.HospitalConverter json2xml input.json output.xml
XML转JSON
java com.hospital.converter.HospitalConverter xml2json input.xml output.json

4. 使用Python脚本

# 生成测试数据
python3 scripts/generate_test_data.py

版本信息

• 标准版本: WS/T 846-2024
• 发布日期: 2024-10-28
• 实施日期: 2025-04-01
• 项目状态: 已完成