JZ_MZ_WanChengJZ 门急诊完成接诊 接口文档
接口:POST /smartor/serviceExternal/generalInterface
消息类型:JZ_MZ_WanChengJZ
文档生成日期:2026-10-20
说明:字段名区分大小写,请严格按文档中的拼音字段名传参。
一、接口说明
| 项目 |
内容 |
| 接口地址 |
/smartor/serviceExternal/generalInterface |
| 请求方式 |
POST |
| Content-Type |
application/json;charset=UTF-8 |
| 认证方式 |
无需登录(/smartor/serviceExternal/** 已配置 permitAll) |
| 消息类型 |
JZ_MZ_WanChengJZ |
| 业务含义 |
门急诊完成接诊 |
| 处理入口 |
addFinshJZInfo |
| 是否落库 |
是(实际落库) |
| 业务说明 |
接收门急诊完成接诊信息,写入门诊就诊记录,并按随访天数生成随访任务。 |
二、请求报文
2.1 报文结构
| 字段 |
类型 |
必填 |
说明 |
| XiaoXiTou |
object |
是 |
消息头 |
| YeWuXX |
object |
是 |
业务信息,必须包含 XiaoXiID |
2.2 消息头 XiaoXiTou
| 字段 |
类型 |
必填 |
说明 |
| FaSongFCSJC |
String |
否 |
发送方程序简称,默认 ZJHES |
| FaSongJGID |
String |
是 |
发送机构 ID,对应系统 orgid;部分消息类型用它覆盖业务中的机构 ID |
| FaSongJGMC |
String |
否 |
发送机构名称 |
| FaSongSJ |
String |
否 |
发送时间,建议 yyyy-MM-dd HH:mm:ss |
| FaSongXTJC |
String |
否 |
发送系统简称,默认 SUIFANGXT |
| FaSongXTMC |
String |
否 |
发送系统名称,默认 随访系统 |
| XiaoXiID |
String |
否 |
消息 ID;本接口响应回显取的是 YeWuXX.XiaoXiID |
| XiaoXiLX |
String |
是 |
消息类型,决定业务分支,缺失或为空时接口报错 |
| XiaoXiMC |
String |
否 |
消息名称 |
| ZuHuID |
String |
否 |
医院 ID |
| ZuHuMC |
String |
否 |
医院名称 |
2.3 业务信息 YeWuXX
| 字段 |
类型 |
必填 |
说明 |
| XiaoXiID |
String |
是(建议) |
消息 ID,原样放入响应 Data.XiaoXiID;缺失时返回 null |
| BingRenXX |
object |
是 |
患者信息;ZuZhiJGID 可省略,代码使用消息头 FaSongJGID |
| JiuZhenXX |
object |
是 |
就诊信息,至少包含科室、就诊日期 |
| ZhenDuanList |
array |
是 |
诊断列表,不能为空 |
| WenZhenList |
array |
是 |
问诊列表,不能为空 |
2.4 请求示例
{
"XiaoXiTou": {
"FaSongJGID": "47255004333112711A1001",
"FaSongJGMC": "丽水市中医院",
"FaSongSJ": "2026-10-20 10:00:00",
"XiaoXiLX": "JZ_MZ_WanChengJZ",
"XiaoXiID": "MSG-20261020-0001"
},
"YeWuXX": {
"XiaoXiID": "MSG-20261020-0001",
"BingRenXX": {
"BingRenID": "BR0002",
"XingMing": "李四",
"JiuZhenYWID": "MZ20261020002",
"JiuZhenKH": "MZ0002",
"BingAnHao": "BA20261020002",
"ZhengJianHM": "330102198505051234",
"XingBieDM": "2",
"ChuShengRQ": "1985-05-05 10:00:00",
"LianXiDH": "13700000000"
},
"JiuZhenXX": {
"JiuZhenKSID": "D002",
"JiuZhenKSMC": "妇科",
"JiuZhenRQ": "2026-10-20 10:30:00",
"sfrq": "2026-11-20 00:00:00"
},
"ZhenDuanList": [
{
"ZhenDuanYSID": "D1002",
"ZhenDuanYSXM": "赵医生",
"ZhenDuanID": "O20.0",
"ZhenDuanMC": "先兆流产",
"ZhenDuanLBDM": "1",
"ZhenDuanLBMC": "主诊断",
"Icd10": "O20.0"
}
],
"WenZhenList": [
{
"WenZhenLXMC": "主诉",
"NeiRong": "停经50天,阴道流血1天"
},
{
"WenZhenLXMC": "现病史",
"NeiRong": "患者停经50天,1天前出现阴道流血……"
},
{
"WenZhenLXMC": "随访天数",
"NeiRong": "30"
},
{
"WenZhenLXMC": "随访天数单位",
"NeiRong": "天"
}
]
}
}
三、业务字段说明
3.1 BingRenXX 患者基本信息
机构 ID 会被消息头 FaSongJGID 覆盖。
| 字段 |
类型 |
必填 |
说明 |
| ZuZhiJGID |
String |
是 |
组织机构 ID(写入 orgid) |
| ZuZhiJGMC |
String |
否 |
组织机构名称 |
| BingRenID |
String |
是 |
病人 ID,写入 patid_his/patno |
| XingMing |
String |
是 |
患者姓名 |
| JiuZhenYWID |
String |
是 |
就诊业务 ID,与 BingAnHao 共同定位住院/门诊记录 |
| JiuZhenKH |
String |
否 |
就诊卡号;证件号码为空时作为患者档案唯一标识 |
| BingAnHao |
String |
是 |
病案号(代码按病案号匹配,不使用住院号) |
| ZhengJianLXMC |
String |
否 |
证件类型名称,写入档案 idcardtype |
| ZhengJianHM |
String |
是(建议) |
证件号码,患者档案唯一标识;为空时使用 JiuZhenKH |
| XingBieDM |
String |
否 |
性别代码,必须为数字字符串(如 1/2),代码执行 Long.valueOf |
| ChuShengRQ |
String |
是(建议) |
出生日期,代码按 yyyy-MM-dd hh:mm:ss 解析,建议传完整时间 |
| DangQianKSID |
String |
是 |
当前科室 ID,写入住院/出院科室 |
| DangQianKSMC |
String |
是 |
当前科室名称 |
| DangQianBQID |
String |
是 |
当前病区 ID |
| DangQianBQMC |
String |
是 |
当前病区名称 |
| DangQianCWMC |
String |
否 |
床位名称,写入住院 bedNo |
| RuYuanSJ |
Date |
是(入院/入科) |
入院时间,格式 yyyy-MM-dd HH:mm:ss |
| LianXiDH |
String |
是(建议) |
联系电话,写入患者档案手机号 |
| LianXiRDH |
String |
否 |
联系人电话;LianXiDH 为空时作为患者手机号 |
| GuoJiMC |
String |
否 |
国籍名称,写入档案 nativePlace |
| MinZuMC |
String |
否 |
民族名称,写入档案 nation |
| XianZhuZXX |
String |
否 |
现住址;优先于 DiZhiXXList 写入档案 |
| CaoZuoRID |
String |
否 |
操作人 ID |
| CaoZuoRXM |
String |
否 |
操作人姓名 |
| ZeRenHSID |
String |
否 |
责任护士 ID |
| ZeRenHSXM |
String |
否 |
责任护士姓名 |
| ZhuZhiYSID |
String |
否 |
主治医生 ID |
| ZhuZhiYSXM |
String |
否 |
主治医生姓名 |
| JingGuanYSID |
String |
否 |
经管医生 ID |
| JingGuanYSXM |
String |
否 |
经管医生姓名 |
| DuanHaoXX |
String |
否 |
短号信息 |
| BingRenLXDM |
String |
否 |
病人类型代码,手术记录写入 inhospstate |
3.2 JiuZhenXX 就诊信息
| 字段 |
类型 |
必填 |
说明 |
| JiuZhenKSID |
String |
是 |
就诊科室 ID |
| JiuZhenKSMC |
String |
是 |
就诊科室名称 |
| JiuZhenRQ |
Date |
是 |
就诊日期,yyyy-MM-dd HH:mm:ss,写入门诊 admitdate |
| sfrq |
Date |
否 |
随访日期,写入门诊 fudate |
| CaoZuoRID |
String |
否 |
操作人 ID |
| CaoZuoRXM |
String |
否 |
操作人姓名 |
3.3 ZhenDuanList 诊断列表
ZhenDuanLBMC=主诊断 的记录用于门诊主诊断。
| 字段 |
类型 |
必填 |
说明 |
| ZhenDuanYSID |
String |
否 |
诊断医生 ID |
| ZhenDuanYSXM |
String |
否 |
诊断医生姓名 |
| ZhenDuanID |
String |
否 |
诊断 ID |
| ZhenDuanMC |
String |
是 |
诊断名称 |
| ZhenDuanLBDM |
String |
否 |
诊断类别代码 |
| ZhenDuanLBMC |
String |
是 |
诊断类别名称;等于 主诊断 时写入门诊主诊断 |
| Icd10 |
String |
是(建议) |
ICD10 编码 |
3.4 WenZhenList 问诊列表
用于现病史、主诉、随访天数及单位。
| 字段 |
类型 |
必填 |
说明 |
| WenZhenLXMC |
String |
是(若传) |
问诊类型名称:现病史、主诉、随访天数、随访天数单位 |
| NeiRong |
String |
是(若传) |
问诊内容;随访天数 必须为整数,单位支持 天/周/月/年 |
四、处理逻辑
- 读取患者、就诊、诊断、问诊信息。
- 使用
FaSongJGID 作为机构 ID,新增/更新患者档案。
- 按
BingAnHao + JiuZhenYWID 查询门诊记录,存在则更新,不存在则新增。
- 主诊断写入诊断名称、医生、ICD10,并置
fuflag=1。
现病史 写入 hpi,主诉 写入 mainsuit。
- 若传了
随访天数 且 fuflag=1,按天/周/月/年换算后生成随访任务。
- 丽水市妇幼保健院(
orgid = 47226079133110211G1001)完成接诊后,按 pat_specific_archive_generate_config 配置生成妇科/儿科专科档案;其他机构不生成。详见 doc/api/妇幼专科档案生成接口文档_20261104.md。
五、响应说明
成功响应:
{
"Code": "0",
"Message": "success",
"Data": {
"XiaoXiID": "MSG-20261020-0001",
"ChuangJianSJ": 1760928000000
}
}
失败响应(业务返回 false 或处理异常):
{
"Code": "500",
"Message": "error",
"Data": {
"XiaoXiID": "MSG-20261020-0001",
"ChuangJianSJ": 1760928000000
}
}
| 字段 |
类型 |
说明 |
| Code |
String |
"0" 成功,"500" 失败 |
| Message |
String |
success / error |
| Data.XiaoXiID |
String |
原样返回请求 YeWuXX.XiaoXiID |
| Data.ChuangJianSJ |
long |
服务器当前时间(毫秒时间戳) |
六、注意事项
ZhenDuanList、WenZhenList 代码未做空判断,缺失会报错。
随访天数 必须是整数,随访天数单位 支持 天、周、月、年。
- 门诊记录匹配键为
BingAnHao + JiuZhenYWID。
- 报文缺少
XiaoXiTou、XiaoXiLX、YeWuXX 时可能在响应组装阶段直接抛异常,返回 HTTP 500。
- 日期时间除特别说明外统一使用
yyyy-MM-dd HH:mm:ss。
本文档根据当前代码生成;若后端逻辑调整,请同步更新文档。