/smartor/serviceExternal/generalInterface 通用接口文档生成日期:2026-10-20
对应代码:ServiceExternalController#generalInterface、ServiceExternalServiceImpl#generalInterface/getType及各业务处理方法
说明:本文档按当前代码实际解析的字段整理,字段名区分大小写,请严格按文档中的拼音字段名传参。
按消息类型拆分的独立文档见:doc/api/generalInterface/00_接口文档索引.md(含同名 PDF)。
| 项目 | 内容 |
|---|---|
| 接口地址 | /smartor/serviceExternal/generalInterface |
| 请求方式 | POST |
| Content-Type | application/json;charset=UTF-8 |
| 认证方式 | 无需登录(SecurityConfig 中 /smartor/serviceExternal/** 已配置 permitAll) |
| 请求体 | 单个 JSON 对象,由 XiaoXiTou(消息头)+ YeWuXX(业务信息)组成 |
| 响应体 | 固定结构:Code、Message、Data |
| 业务分发字段 | XiaoXiTou.XiaoXiLX(消息类型) |
| 服务地址示例 | http://服务IP:端口/smartor/serviceExternal/generalInterface |
该接口是 HIS/第三方系统向随访系统推送数据的**统一入口**,通过 XiaoXiTou.XiaoXiLX 区分 41 种业务消息,分别处理:
JG_*)BR_DA_*、JZ_ZY_*、BL_JL_*)JZ_MZ_WanChengJZ)JC_*、JY_*)SM_*)GY_ZD_JiBingML)fu_task)其中 22 种消息会实际落库,另外 19 种消息当前不落库(多数仅记录日志后直接返回成功,见第三章)。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiTou | object | 是 | 消息头,缺失时接口报错 |
| YeWuXX | object | 是 | 业务信息;缺失时响应组装阶段报错;**必须包含 XiaoXiID** |
{
"XiaoXiTou": {
"FaSongJGID": "47255004333112711A1001",
"FaSongJGMC": "丽水市中医院",
"FaSongSJ": "2026-10-20 10:00:00",
"XiaoXiLX": "JZ_ZY_RuYuanDJ",
"XiaoXiID": "5FA92AFB-9833-4608-87C7-F56A654AC171"
},
"YeWuXX": {
"XiaoXiID": "5FA92AFB-9833-4608-87C7-F56A654AC171"
}
}
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 | 否 | 医院名称 |
YeWuXX 公共字段| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 消息 ID,原样放入响应 Data.XiaoXiID;缺失时返回 null |
| BingRenXX | object | 视消息类型 | 患者基本信息,见 4.1 |
| DiZhiXXList | array | 视消息类型 | 患者地址列表,见 4.2 |
| LianXiRList | array | 视消息类型 | 患者联系人列表,见 4.3 |
| ZhenDuanList | array | 视消息类型 | 诊断列表,见 4.4 |
| JiuZhenXX | object | 视消息类型 | 就诊/住院过程信息,见 4.5 |
| RuKeXX | object | 仅入科 | 入科信息,见 4.6 |
| ChuYuanJL | object | 视消息类型 | 出院记录,内部使用 SuiFangJH,见 4.7 |
| BingRenKZXXList | array | 否 | 患者扩展信息(短号),见 4.8 |
| WenZhenList | array | 仅完成接诊 | 问诊信息,见 4.9 |
| 其他业务对象 | object/array | 视消息类型 | KeShiXX、YongHuXX、ZuZhiJGXX、BingQuXX、JiBingMLXX、JianChaSQ、JianChaBG、ShouShuSQ、ShouShuCX 等,见第五章 |
XiaoXiLX)总表| 序号 | XiaoXiLX | 业务含义 | 处理方法 | 是否落库 |
|---|---|---|---|---|
| 1 | BR_DA_DangAnJL |
患者档案建立 | 仅记录日志 | 否(直接返回成功) |
| 2 | BR_DA_DangAnXG |
患者档案修改 | 仅记录日志 | 否(直接返回成功) |
| 3 | JZ_MZ_ZhenDuanXXLR |
门诊诊断信息录入 | 仅记录日志 | 否(直接返回成功) |
| 4 | JZ_ZY_ZhenDuanXXLR |
住院诊断信息录入 | 仅记录日志 | 否(直接返回成功) |
| 5 | YZ_MZ_YiZhuSQ |
门诊医嘱申请 | 仅记录日志 | 否(直接返回成功) |
| 6 | YZ_ZY_YiZhuZX |
住院医嘱执行 | 仅记录日志 | 否(直接返回成功) |
| 7 | YZ_MZ_YiZhuXG |
门诊医嘱修改 | 仅记录日志 | 否(直接返回成功) |
| 8 | YZ_MZ_YiZhuCX |
门诊医嘱撤销 | 仅记录日志 | 否(直接返回成功) |
| 9 | YZ_MZ_YiZhuCS |
门诊医嘱删除 | 仅记录日志 | 否(直接返回成功) |
| 10 | JC_SQ_ShenQing |
检查申请 | addInspectService |
是(检查主表) |
| 11 | JC_SQ_XiuGai |
检查申请修改 | addInspectService |
是(检查主表) |
| 12 | JC_SQ_CheXiao |
检查撤销 | 仅记录日志 | 否(直接返回成功) |
| 13 | JC_BG_BaoGao |
检查报告 | addInspectBGService |
是(检查报告明细) |
| 14 | JY_SQ_ShenQing |
检验申请 | addInspectService |
是(检查主表,projecttype=1) |
| 15 | JY_SQ_CheXiao |
检验撤销 | 仅记录日志 | 否(直接返回成功) |
| 16 | JY_SQ_XiuGai |
检验申请修改 | addInspectService |
是(检查主表) |
| 17 | JY_SQ_BiaoBenCJ |
检验标本采集 | 仅记录日志 | 否(直接返回成功) |
| 18 | JY_SQ_QuXiaoBBCJ |
取消检验标本采集 | 仅记录日志 | 否(直接返回成功) |
| 19 | SM_SQ_ShenQing |
手术申请 | addOperationInfo |
是(手术主表+明细) |
| 20 | SM_SQ_ShouShuAP |
手术安排 | 仅记录日志 | 否(直接返回成功) |
| 21 | SM_SQ_CheXiao |
手术撤销 | cancelOperationInfo |
是(软删除手术及任务) |
| 22 | TJ_YW_BaoGaoXX |
体检报告 | 仅记录日志 | 否(直接返回成功) |
| 23 | TJ_YW_QuXiaoBG |
取消体检报告 | 仅记录日志 | 否(直接返回成功) |
| 24 | JG_ZZ_JiGou |
组织机构 | addOrganInfo |
是(base_organization) |
| 25 | JG_ZZ_KeShi |
科室 | addDeptInfo |
是(sys_dept) |
| 26 | JG_YH_JiBenXX |
用户基本信息 | addUserInfo |
是(sys_user) |
| 27 | JG_YH_KeShiYH |
科室用户关系 | addUserDeptInfo |
是(sys_user_dept) |
| 28 | fu_task |
随访任务 | addTaskInfo |
否(当前为空实现) |
| 29 | GY_ZD_JiBingML |
疾病目录 | addDiseaseInfo |
是(icd10) |
| 30 | YP_ZD_YaoPinCDJG |
药品产地价格 | 仅记录日志 | 否(直接返回成功) |
| 31 | JZ_MZ_WanChengJZ |
门急诊完成接诊 | addFinshJZInfo |
是(门诊就诊+任务) |
| 32 | JZ_ZY_RuYuanDJ |
入院登记 | addInHospInfo |
是(档案+住院记录) |
| 33 | JZ_ZY_QuXiaoRY |
取消入院登记 | cancelInHospInfo |
是(住院记录置删除) |
| 34 | JZ_ZY_ChuYuan |
患者出院 | addOutHospInfo |
是(住院记录+出院信息) |
| 35 | BL_JL_ChuYuanJL |
患者出院记录 | addOutHospJLInfo |
是(住院记录+出院信息) |
| 36 | JZ_ZY_QuXiaoCY |
取消出院 | cancelOutHospInfo |
是(回退在院状态并清任务) |
| 37 | JZ_ZY_YuChuYuan |
患者预出院 | addPreOutHospInfo |
是(住院记录预出院状态) |
| 38 | JZ_ZY_LiQiang |
患者离抢 | editRescueFinishedOutHospInfo |
是(回填出院时间/死亡处理) |
| 39 | JG_ZZ_BingQu |
病区 | addWardAreaInfo |
是(sys_dept,deptType=2) |
| 40 | JG_ZZ_YiLiaoZYS |
医疗组医生 | addMedicalTeam |
否(当前为空实现) |
| 41 | JZ_ZY_RuKe |
入科 | addInDeptInfo |
是(档案+住院记录) |
未在
switch中匹配到的XiaoXiLX会走默认分支,直接返回成功(Code=0),不产生任何数据变更。请调用方确保类型拼写完全一致。
BingRenXX 患者基本信息对应 ExternalInHospPatientInfo。住院、接诊、检查、手术类消息均使用该对象。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZuZhiJGID | String | 是 | 组织机构 ID(写入 orgid);JZ_MZ_WanChengJZ 会改用消息头 FaSongJGID |
| ZuZhiJGMC | String | 否 | 组织机构名称 |
| MPI | String | 否 | 居民主索引 |
| BingRenID | String | 是 | 病人 ID,写入 patid_his/patno,是患者匹配依据之一 |
| XingMing | String | 是 | 患者姓名 |
| XingMingQP | String | 否 | 姓名全拼 |
| JiuZhenYWLX | String | 否 | 就诊业务类型 |
| JiuZhenYWID | String | 是 | 就诊业务 ID,与 BingAnHao 共同定位住院/门诊记录 |
| JiuZhenKH | String | 否 | 就诊卡号;证件号码为空时作为患者档案唯一标识 |
| ZhuYuanHao | String | 否 | 住院号 |
| BingAnHao | String | 是 | 病案号(代码注释明确使用病案号,不使用住院号) |
| ZhengJianLXDM | String | 否 | 证件类型代码 |
| ZhengJianLXMC | String | 否 | 证件类型名称,写入档案 idcardtype |
| ZhengJianHM | String | 是(建议) | 证件号码,患者档案唯一标识;为空时使用 JiuZhenKH |
| XingBieDM | String | 否 | 性别代码;**必须为数字字符串**(如 1/2),代码执行 Long.valueOf |
| XingBieMC | String | 否 | 性别名称 |
| ChuShengRQ | String | 是(建议) | 出生日期,格式 yyyy-MM-dd hh:mm:ss(代码实际解析格式,建议一并传时间) |
| NianLing | String | 否 | 年龄,代码不使用,年龄由出生日期计算 |
| NianLingDW | String | 否 | 年龄单位,代码不使用 |
| DangQianKSID | String | 是 | 当前科室 ID,写入住院/出院科室 |
| DangQianKSMC | String | 是 | 当前科室名称 |
| DangQianBQID | String | 是 | 当前病区 ID,写入住院病区 |
| DangQianBQMC | String | 是 | 当前病区名称 |
| DangQianCWID | String | 否 | 当前床位 ID |
| DangQianCWMC | String | 否 | 当前床位名称,写入住院 bedNo |
| ZhuYuanCS | Long | 否 | 住院次数 |
| RuYuanSJ | Date | 是(入院/入科) | 入院时间,写入住院 starttime;格式 yyyy-MM-dd HH:mm:ss |
| FeiYongLBID | String | 否 | 费用类别 ID |
| FeiYongLBMC | String | 否 | 费用类别名称 |
| FeiYongXZID | String | 否 | 费用性质 ID |
| FeiYongXZMC | String | 否 | 费用性质名称 |
| LianXiDH | String | 是(建议) | 联系电话,写入患者档案手机号 |
| LianXiRDH | String | 否 | 联系人电话;LianXiDH 为空时作为患者手机号 |
| DanWeiDH | String | 否 | 单位电话 |
| DanWeiMC | String | 否 | 单位名称 |
| HunYinDM | String | 否 | 婚姻代码 |
| HunYinMC | String | 否 | 婚姻名称 |
| ZhiYeDM | String | 否 | 职业代码 |
| ZhiYeMC | String | 否 | 职业名称 |
| GuoJiDM | String | 否 | 国籍代码 |
| GuoJiMC | String | 否 | 国籍名称,写入档案 nativePlace |
| MinZuDM | String | 否 | 民族代码 |
| MinZuMC | String | 否 | 民族名称,写入档案 nation |
| CaoZuoRID | String | 否 | 操作人 ID(入院登记 operatorId) |
| CaoZuoRXM | String | 否 | 操作人姓名(入院登记 operator) |
| YingErBZ | String | 否 | 婴儿标志 |
| MuQinZYJZID | String | 否 | 母亲就诊 ID |
| ChanFuBZ | String | 否 | 产妇标志 |
| XianZhuZXX | String | 否 | 现住址;**优先于 DiZhiXXList** 写入档案现住址 |
| ZeRenHSID | String | 否 | 责任护士 ID |
| ZeRenHSXM | String | 否 | 责任护士姓名 |
| ZhuZhiYSID | String | 否 | 主治医生 ID |
| ZhuZhiYSXM | String | 否 | 主治医生姓名 |
| JingGuanYSID | String | 否 | 经管医生 ID |
| JingGuanYSXM | String | 否 | 经管医生姓名 |
| DuanHaoXX | String | 否 | 短号信息;出院时可由 BingRenKZXXList 覆盖 |
| BingRenLXDM | String | 否 | 病人类型代码,手术记录写入 inhospstate |
| BingRenLXMC | String | 否 | 病人类型名称 |
externalInHospPatientLiaisonInfos字段不会从报文读取,联系人请使用YeWuXX.LianXiRList。
DiZhiXXList 患者地址信息对应 ExternalInHospPatientAddrInfo,取第一条作为患者现住址(XianZhuZXX 为空时)。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| DiZhiLX | String | 否 | 地址类型 |
| DiZhiXX | String | 否 | 地址信息;有值时直接作为现住址,否则由省/市/区/乡镇/村/其他拼接 |
| ShengFenDM | String | 否 | 省份代码 |
| ShengFenMC | String | 否 | 省份名称 |
| ShiDiQDM | String | 否 | 市地区代码 |
| ShiDiQMC | String | 否 | 市地区名称 |
| XianQuDM | String | 否 | 县区代码 |
| XianQuMC | String | 否 | 县区名称 |
| XiangZhenDM | String | 否 | 乡镇代码 |
| XiangZhenMC | String | 否 | 乡镇名称 |
| CunJiDM | String | 否 | 村级代码 |
| CunJiMC | String | 否 | 村级名称 |
| QiTaXX | String | 否 | 其他信息 |
| YouBian | String | 否 | 邮编 |
LianXiRList 患者联系人信息对应 ExternalInHospPatientLiaisonInfo,写入 pat_archivecontact。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| LianXiRXM | String | 否 | 联系人姓名 |
| LianXiRDH | String | 否 | 联系人电话 |
| GuanXiDM | String | 否 | 关系代码 |
| GuanXiMC | String | 否 | 关系名称,写入联系人 relation |
ZhenDuanList 诊断信息不同消息类型字段不同,按下表传递。
(1)住院类(入院登记、出院、出院记录、预出院)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZhenDuanID | String | 否 | 诊断 ID |
| ZhenDuanMC | String | 是 | 诊断名称 |
| Icd10 | String | 是(建议) | ICD10 编码;出院时写入 leaveicd10code |
(2)门急诊完成接诊(JZ_MZ_WanChengJZ)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZhenDuanYSID | String | 否 | 诊断医生 ID |
| ZhenDuanYSXM | String | 否 | 诊断医生姓名 |
| ZhenDuanID | String | 否 | 诊断 ID |
| ZhenDuanMC | String | 是 | 诊断名称 |
| ZhenDuanLBDM | String | 否 | 诊断类别代码 |
| ZhenDuanLBMC | String | 是 | 诊断类别名称;等于 主诊断 时写入门诊主诊断、医生、ICD10 |
| Icd10 | String | 是(建议) | ICD10 编码 |
(3)检查/检验申请(JianChaSQ.ZhenDuanList)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZhenDuanID | String | 否 | 诊断 ID |
| ZhenDuanMC | String | 否 | 诊断名称 |
JiuZhenXX 就诊/住院过程信息不同消息类型按需取字段,未被使用的字段可忽略。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| JiuZhenKSID | String | 接诊必填 | 就诊科室 ID |
| JiuZhenKSMC | String | 接诊必填 | 就诊科室名称 |
| JiuZhenYSID | String | 否 | 就诊医生 ID(当前代码未落库) |
| JiuZhenYSMC | String | 否 | 就诊医生名称(当前代码未落库) |
| JiuZhenRQ | Date | 接诊必填 | 就诊日期,写入门诊 admitdate,格式 yyyy-MM-dd HH:mm:ss |
| sfrq | Date | 否 | 随访日期,写入门诊 fudate(代码备注字段待 HIS 确认) |
| HuanZheQXDM | String | 否 | 患者去向代码 |
| HuanZheQXMC | String | 否 | 患者去向名称 |
| ChuYuanSJ | String | 出院必填 | 出院时间,格式 yyyy-MM-dd HH:mm:ss |
| YuChuYSJ | String | 预出院必填 | 预出院时间,格式 yyyy-MM-dd HH:mm:ss |
| LiQiangSJ | String | 离抢建议必填 | 离抢时间,格式 yyyy-MM-dd HH:mm:ss;缺失时只做死亡标记处理 |
| LiYuanQXDM | String | 预出院必填 | 离院方式代码;5 表示死亡,触发死亡患者处理 |
| CaoZuoRID | String | 否 | 操作人 ID |
| CaoZuoRXM | String | 否 | 操作人姓名 |
| ZhuZhiYSID | String | 否 | 主治医生 ID(写入 drcode) |
| ZhuZhiYSXM | String | 否 | 主治医生姓名(写入 drname) |
| ZeRenHSID | String | 否 | 责任护士 ID |
| ZeRenHSXM | String | 否 | 责任护士姓名 |
| DangQianCWMC | String | 否 | 床位名称(写入 bedNo) |
| JingGuanYSID | String | 否 | 经管医生 ID |
| JingGuanYSXM | String | 否 | 经管医生姓名 |
离院方式代码说明:
1医嘱离院、2医嘱转院、3医嘱转社区卫生服务机构/乡镇卫生院、4非医嘱离院、5死亡、9其他、10介入室、20手术室。
RuKeXX 入科信息仅 JZ_ZY_RuKe 使用,对应 ExternalInDeptPatientInfo。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| CaoZuoRID | String | 否 | 操作人 ID |
| CaoZuoRXM | String | 否 | 操作人姓名 |
| RuKeSJ | String | 否 | 入科时间 |
| RuYuanSJ | Date | 否 | 入院时间,覆盖 BingRenXX.RuYuanSJ |
| YiLiaoZID | String | 否 | 医疗组 ID |
| YiLiaoZMC | String | 否 | 医疗组名称 |
| ZhuZhiYSID | String | 否 | 主治医生 ID |
| ZhuZhiYSXM | String | 否 | 主治医生姓名 |
| ZeRenHSID | String | 否 | 责任护士 ID |
| ZeRenHSXM | String | 否 | 责任护士姓名 |
| HuShiZID | String | 否 | 护士主 ID |
| HuShiZXM | String | 否 | 护士主姓名 |
| JingGuanYSID | String | 否 | 经管医生 ID |
| JingGuanYSXM | String | 否 | 经管医生姓名 |
ChuYuanJL.SuiFangJH 随访计划出院、出院记录、预出院消息使用,用于生成/更新随访计划。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| SuiFangBS | String | 否 | 随访标识,0 不需要随访、1 需要;默认 1 |
| SuiFangRQ | String | 否 | 随访日期,格式 yyyy-MM-dd HH:mm:ss |
| SuiFangZQJY | String | 否 | 随访周期建议 |
| SuiFangFSDM | String | 否 | 随访方式代码 |
| SuiFangFSMC | String | 否 | 随访方式名称 |
| FuZhenZD | String | 否 | 复诊指导 |
| QiTaZKJBSF | String | 否 | 其他专科禁补随访说明 |
BingRenKZXXList 患者扩展信息出院(JZ_ZY_ChuYuan)使用,用于提取短号。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiangMuDM | String | 是(若传) | 项目代码;等于 DuanHaoXX 时取 XiangMuZMC 作为短号 |
| XiangMuZMC | String | 是(若传) | 项目值 |
示例:
"BingRenKZXXList": [
{ "XiangMuDM": "DuanHaoXX", "XiangMuZMC": "669999" }
]
WenZhenList 问诊信息仅 JZ_MZ_WanChengJZ 使用。代码按 WenZhenLXMC 匹配以下四类:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| WenZhenLXMC | String | 是(若传) | 问诊类型名称:现病史、主诉、随访天数、随访天数单位 |
| NeiRong | String | 是(若传) | 问诊内容;随访天数 必须为整数,随访天数单位 支持 天/周/月/年 |
其他字段(
WenZhenLXDM、WenZhenSJ、WenZhenYSID、WenZhenYSXM、WenZhenKSID、WenZhenKSMC)当前不参与业务处理。
以下仅列出
YeWuXX中该消息类型实际使用的键;未列出的键会被忽略。
JG_ZZ_JiGou 组织机构YeWuXX 结构:{ "XiaoXiID": "...", "ZuZhiJGXX": { ... } }
ZuZhiJGXX 字段:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZuZhiJGID | String | 是 | 机构 ID,同时写入 orgid |
| ZuZhiJGMC | String | 是 | 机构名称 |
| ShiJianDM | String | 是 | 事件代码:1 新增,其他值更新(3 作废当前也走更新) |
| ShiJianMC | String | 否 | 事件名称 |
| ShuRuMa1 | String | 否 | 输入码 1 |
| ShuRuMa2 | String | 否 | 输入码 2 |
| ShuRuMa3 | String | 否 | 输入码 3 |
| createBy | String | 否 | 创建人(来自 BaseEntity,实际生效) |
| createTime | Date | 否 | 创建时间,yyyy-MM-dd HH:mm:ss |
| updateBy | String | 否 | 修改人(实际生效) |
| updateTime | Date | 否 | 修改时间,yyyy-MM-dd HH:mm:ss |
JG_ZZ_KeShi 科室YeWuXX.KeShiXX:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZuZhiJGID | String | 是 | 机构 ID |
| KeShiID | String | 是 | 科室 ID,写入 his_dept_id / dept_code |
| KeShiMC | String | 是 | 科室名称 |
| FuKeSID | String | 否 | 父科室 ID,用于查找并填充 parentId |
| KeShiLBDM | String | 否 | 科室类别代码,写入 type |
| ShiJianDM | String | 是 | 1 新增;3 作废(status=1);其他值修改 |
| ShiJianMC | String | 否 | 事件名称 |
| KeShiLBMC | String | 否 | 科室类别名称 |
| FuKeSMC | String | 否 | 父科室名称 |
| MoJiBZ | Integer | 否 | 末级标志 |
| ShuRuMa1/2/3 | String | 否 | 输入码 |
| createBy | String | 否 | 创建人(实际生效) |
| createTime | Date | 否 | 创建时间(实际生效) |
| updateBy | String | 否 | 修改人(实际生效) |
| updateTime | Date | 否 | 修改时间(实际生效) |
JG_YH_JiBenXX 用户基本信息YeWuXX.YongHuXX:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZuZhiJGID | String | 是 | 机构 ID;为空时直接返回失败 |
| YongHuDLM | String | 是 | 用户登录名;为空时直接返回失败 |
| YongHuID | String | 是(建议) | HIS 用户 ID,写入 his_user_id,后续科室用户关系按此匹配 |
| YongHuXM | String | 是(建议) | 用户姓名,写入 nick_name |
| LianXiDH | String | 否 | 联系电话 |
| GongZuoDH | String | 否 | 工作电话 |
| XingBieDM | String | 否 | 性别代码,写入 sex |
| ChuShengRQ | Date | 否 | 出生日期,yyyy-MM-dd HH:mm:ss |
| ShiJianDM | String | 是 | 3 作废(status=1);其他值按用户名+机构判断新增或更新 |
| ShiJianMC | String | 否 | 事件名称 |
| ShenFenZH | String | 否 | 身份证号(当前未落库) |
| ChuangJianRXM | String | 否 | 创建人姓名 |
| ChuangJianSJ | Date | 否 | 创建时间 |
| XiuGaiRXM | String | 否 | 修改人姓名 |
| XiuGaiSJ | Date | 否 | 修改时间 |
新增用户时密码使用系统默认密码
defaultPwd加密后写入。
JG_YH_KeShiYH 科室用户关系YeWuXX.KeShiYH:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZuZhiJGID | String | 是 | 机构 ID |
| YongHuID | String | 是 | 用户 ID,用于查找 sys_user |
| KeShiID | String | 是 | 科室 ID,用于查找 sys_dept |
| ShiJianDM | String | 是 | 3 作废(del_flag=1);其他值新增或更新关系 |
| ShiJianMC | String | 否 | 事件名称 |
| KeShiYHDZID | String | 否 | 科室用户地址 ID(未落库) |
| YongHuXM | String | 否 | 用户姓名(未落库) |
| KeShiMC | String | 否 | 科室名称(未落库) |
| ZhiGongID | String | 否 | 职工 ID(未落库) |
| YongHuDLM | String | 否 | 用户登录名(仅日志) |
| ChuangJianRXM | String | 否 | 创建人姓名 |
| ChuangJianSJ | Date | 否 | 创建时间 |
| XiuGaiRXM | String | 否 | 修改人姓名 |
| XiuGaiSJ | Date | 否 | 修改时间 |
用户或科室找不到时返回
Code=500(false)。
JG_ZZ_BingQu 病区YeWuXX.BingQuXX:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZuZhiJGID | String | 是 | 机构 ID |
| BingQuID | String | 是 | 病区 ID,写入 his_dept_id / dept_code |
| BingQuMC | String | 是 | 病区名称 |
| BingQuLXDM | String | 否 | 病区类型代码,写入 type |
| ShiJianDM | String | 是 | 1 新增;3 作废(status=1);其他值修改 |
| ShiJianMC | String | 否 | 事件名称 |
| BingQuLXMC | String | 否 | 病区类型名称(未落库) |
| ShuRuMa1/2/3 | String | 否 | 输入码 |
| ChuangJianRXM | String | 否 | 创建人姓名(实际生效) |
| createTime | Date | 否 | 创建时间,yyyy-MM-dd HH:mm:ss(实际生效) |
| updateBy | String | 否 | 修改人(实际生效) |
| updateTime | Date | 否 | 修改时间(实际生效) |
病区记录
deptType=2,与科室(deptType=1)区分。
GY_ZD_JiBingML 疾病目录YeWuXX.JiBingMLXX:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZuZhiJGID | String | 是 | 机构 ID |
| JiBingID | String | 是 | 疾病 ID,写入 his_icdid |
| JiBingMC | String | 是 | 疾病名称,写入 icdname |
| IcD10 | String | 是 | ICD10 编码,作为新增/更新匹配条件 |
| MOJIBZ | String | 否 | 末级标志,写入 lastflag |
| ZhongYiZDBZ | Long | 否 | 中医诊断标志,写入 chimedflag |
| ShiJianDM | String | 否 | 事件代码(当前未参与判断,存在即更新、不存在即新增) |
| 其他字段 | - | 否 | 当前未使用 |
编码不区分新增/修改:按
IcD10 + 机构查询,存在则更新,不存在则新增。
JZ_ZY_RuYuanDJ 入院登记YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息,见 4.1 |
| DiZhiXXList | array | 是 | 地址列表,**代码未做空判断,不能为空** |
| LianXiRList | array | 是 | 联系人列表,**不能为空** |
| ZhenDuanList | array | 是 | 诊断列表,**不能为空**,取第一条写入入院诊断 |
处理结果:
pat_archive;BingAnHao + JiuZhenYWID 新增/更新住院记录 pat_med_inhosp;inhospstate=0(在院)。请求示例:
{
"XiaoXiTou": {
"FaSongJGID": "47255004333112711A1001",
"FaSongJGMC": "丽水市中医院",
"FaSongSJ": "2026-10-20 10:00:00",
"XiaoXiLX": "JZ_ZY_RuYuanDJ",
"XiaoXiID": "MSG-20261020-0001"
},
"YeWuXX": {
"XiaoXiID": "MSG-20261020-0001",
"BingRenXX": {
"ZuZhiJGID": "47255004333112711A1001",
"ZuZhiJGMC": "丽水市中医院",
"BingRenID": "BR0001",
"XingMing": "张三",
"JiuZhenYWID": "JZ20261020001",
"JiuZhenKH": "MZ0001",
"BingAnHao": "BA20261020001",
"ZhengJianLXMC": "居民身份证",
"ZhengJianHM": "330102199001011234",
"XingBieDM": "1",
"XingBieMC": "男",
"ChuShengRQ": "1990-01-01 08:00:00",
"DangQianKSID": "D001",
"DangQianKSMC": "心血管内科",
"DangQianBQID": "B001",
"DangQianBQMC": "心内科病区",
"DangQianCWMC": "12床",
"RuYuanSJ": "2026-10-20 09:30:00",
"LianXiDH": "13800000000",
"CaoZuoRID": "U001",
"CaoZuoRXM": "李医生",
"ZhuZhiYSID": "D1001",
"ZhuZhiYSXM": "王医生"
},
"DiZhiXXList": [
{
"DiZhiLX": "1",
"DiZhiXX": "浙江省丽水市莲都区XX路1号",
"ShengFenMC": "浙江省",
"ShiDiQMC": "丽水市",
"XianQuMC": "莲都区"
}
],
"LianXiRList": [
{
"LianXiRXM": "李四",
"LianXiRDH": "13900000000",
"GuanXiMC": "配偶"
}
],
"ZhenDuanList": [
{
"ZhenDuanID": "I10",
"ZhenDuanMC": "原发性高血压",
"Icd10": "I10"
}
]
}
}
JZ_ZY_RuKe 入科YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息;其中 DiZhiXXList 不能为空 |
| RuKeXX | object | 是 | 入科信息,见 4.6 |
| JiuZhenXX | object | 否 | 代码读取但未使用,可忽略 |
处理结果:用 RuKeXX 中的主治医生、责任护士、入院时间覆盖患者信息,然后新增/更新档案与住院记录。
JZ_ZY_QuXiaoRY 取消入院登记YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 至少包含 BingAnHao、JiuZhenYWID |
| JiuZhenXX | object | 否 | 取 CaoZuoRID、CaoZuoRXM 记录操作人 |
处理结果:按 BingAnHao + JiuZhenYWID 找到住院记录,置 schemestatus=3、del_flag=1。
JZ_ZY_ChuYuan 患者出院YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息,见 4.1 |
| JiuZhenXX | object | 是 | 必须包含 ChuYuanSJ(出院时间);另取操作人、主治医生、责任护士、床位、经管医生、LiYuanQXDM |
| DiZhiXXList | array | 否 | 地址列表,为空不报错 |
| LianXiRList | array | 否 | 联系人列表,为空不报错 |
| ChuYuanJL | object | 否 | 出院记录,取 SuiFangJH 随访计划 |
| BingRenKZXXList | array | 否 | 患者扩展信息,XiangMuDM=DuanHaoXX 时覆盖短号 |
| ZhenDuanList | array | 否 | 诊断列表,取第一条写入出院诊断、ICD10 |
处理结果:
BingAnHao + JiuZhenYWID 查找住院记录,存在则更新,不存在则新增;schemestatus=2、inhospstate=1(出院);LiYuanQXDM=5(死亡)时:fuflag=0,患者档案标记 notrequiredFlag=1、原因“患者已离世”,并终止已生成的随访任务(sendstate=4);noLongTask 配置中时,fuflag=0(不做长期随访)。BL_JL_ChuYuanJL 患者出院记录YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息,见 4.1 |
| ChuYuanJL | object | 是(建议) | 取 SuiFangJH 随访计划 |
| DiZhiXXList | array | 否 | 地址列表 |
| LianXiRList | array | 否 | 联系人列表 |
| ZhenDuanList | array | 否 | 诊断列表,取第一条写入出院诊断、ICD10 |
处理结果与 JZ_ZY_ChuYuan 类似,但**不读取 JiuZhenXX**、不修改在院状态、也不做死亡标记处理;仅更新住院记录的出院信息(schemestatus=2)与随访计划。
JZ_ZY_YuChuYuan 患者预出院YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息,见 4.1 |
| JiuZhenXX | object | 是 | 必须包含 YuChuYSJ、LiYuanQXDM(代码未做空判断) |
| ChuYuanJL | object | 否 | 取 SuiFangJH 随访计划 |
| DiZhiXXList | array | 否 | 地址列表 |
| LianXiRList | array | 否 | 联系人列表 |
| ZhenDuanList | array | 否 | 诊断列表 |
处理结果:schemestatus=2、inhospstate=3(预出院),写入预出院时间、诊断、随访计划;LiYuanQXDM=5 时执行死亡患者处理。
JZ_ZY_QuXiaoCY 取消出院YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 至少包含 BingAnHao、JiuZhenYWID |
| JiuZhenXX | object | 否 | 取 CaoZuoRID、CaoZuoRXM |
处理结果:
schemestatus=4、inhospstate=0(恢复在院);sendstate=1/2 的随访子任务,并清理 Redis 缓存中的任务 ID。JZ_ZY_LiQiang 患者离抢YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 至少包含 BingAnHao、JiuZhenYWID |
| JiuZhenXX | object | 是 | 取 LiQiangSJ(离抢时间)、LiYuanQXDM |
处理结果:把 LiQiangSJ 回填到住院记录出院时间,inhospstate=1;LiYuanQXDM=5 时执行死亡患者处理。找不到住院记录时返回失败。
JZ_MZ_WanChengJZ 门急诊完成接诊YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息;ZuZhiJGID 可省略,代码使用消息头 FaSongJGID |
| JiuZhenXX | object | 是 | 至少包含 JiuZhenKSID、JiuZhenKSMC、JiuZhenRQ |
| ZhenDuanList | array | 是 | 不能为空;ZhenDuanLBMC=主诊断 的记录用于主诊断 |
| WenZhenList | array | 是 | 不能为空;用于现病史、主诉、随访天数、随访天数单位 |
处理结果:
BingAnHao + JiuZhenYWID 新增/更新门诊就诊记录 pat_med_outhosp,admitdate 取 JiuZhenRQ;diagname、drcode、drname、icd10code,并置 fuflag=1;WenZhenList 中 现病史→hpi、主诉→mainsuit;随访天数(且单位为天/周/月/年)并且 fuflag=1,自动生成/处理随访任务;orgid = 47226079133110211G1001)完成接诊后,按 pat_specific_archive_generate_config 配置生成妇科/儿科专科档案;其他机构不生成。详见 doc/api/妇幼专科档案生成接口文档_20261104.md。请求示例:
{
"XiaoXiTou": {
"FaSongJGID": "47255004333112711A1001",
"FaSongJGMC": "丽水市中医院",
"FaSongSJ": "2026-10-20 11:00:00",
"XiaoXiLX": "JZ_MZ_WanChengJZ",
"XiaoXiID": "MSG-20261020-0002"
},
"YeWuXX": {
"XiaoXiID": "MSG-20261020-0002",
"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天……" },
{ "WenZhenLXMC": "随访天数", "NeiRong": "30" },
{ "WenZhenLXMC": "随访天数单位", "NeiRong": "天" }
]
}
}
适用类型:JC_SQ_ShenQing、JC_SQ_XiuGai、JY_SQ_ShenQing、JY_SQ_XiuGai。
YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息;ZuZhiJGID 会被消息头 FaSongJGID 覆盖 |
| JianChaSQ | object | 是 | 检查/检验申请信息,见下表 |
| JianChaBG | object | 否 | 报告信息,此处仅使用 ShenQingDID 回填申请单号 |
JianChaSQ 字段:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| YiZhuID | String | 是 | 医嘱 ID,代码执行 Long.valueOf,必须为数字 |
| ShenQingDID | String | 是 | 申请单 ID,作为检查记录匹配键 |
| YouXianJi | String | 否 | 优先级 |
| KaiDanRID | String | 否 | 开单人 ID |
| KaiDanRXM | String | 否 | 开单人姓名 |
| KaiDanKSID | String | 否 | 开单科室 ID |
| KaiDanKSMC | String | 否 | 开单科室名称 |
| KaiDanSJ | String | 否 | 开单时间,yyyy-MM-dd HH:mm:ss |
| ShenHeRID | String | 否 | 审核人 ID |
| ShenHeRXM | String | 否 | 审核人姓名 |
| ShenHeSJ | String | 否 | 审核时间,yyyy-MM-dd HH:mm:ss |
| ZhiXingSJ | String | 否 | 执行时间,yyyy-MM-dd HH:mm:ss |
| JianChaLXID | String | 否 | 检查类型 ID |
| JianChaLXMC | String | 否 | 检查类型名称 |
| JinE | String | 是 | 金额,代码执行 Float.valueOf,必须为数字 |
| JiaoPianFBZ | String | 是 | 交片费标志,0/1,代码执行 Integer.valueOf |
| ChuangBianBZ | String | 是 | 床边标志,0/1 |
| TuiChuangBZ | String | 是 | 推床标志,0/1 |
| JiaJiBZ | String | 是 | 加急标志,0/1 |
| WeiShouXZXBZ | String | 是 | 未收先执行标志,0/1 |
| JianChaBWList | array | 否 | 检查部位列表;为空则不写项目/部位 |
| ZhenDuanList | array | 否 | 诊断列表,取第一条写入诊断 ID/名称 |
JianChaBWList 元素:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| JianChaXMID | String | 否 | 检查项目 ID |
| JianChaXMMC | String | 否 | 检查项目名称 |
| JianChaBWID | String | 否 | 检查部位 ID |
| JianChaBWMC | String | 否 | 检查部位名称 |
ZhenDuanList 元素:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ZhenDuanID | String | 否 | 诊断 ID |
| ZhenDuanMC | String | 否 | 诊断名称 |
处理结果:
ShenQingDID(appliyid)查询检查记录,存在则更新,不存在则新增;JianChaBWList 第一条;JY_SQ_* 与 JC_SQ_* 共用同一张表,仅类型不同。请求示例:
{
"XiaoXiTou": {
"FaSongJGID": "47255004333112711A1001",
"FaSongJGMC": "丽水市中医院",
"FaSongSJ": "2026-10-20 12:00:00",
"XiaoXiLX": "JC_SQ_ShenQing",
"XiaoXiID": "MSG-20261020-0003"
},
"YeWuXX": {
"XiaoXiID": "MSG-20261020-0003",
"BingRenXX": {
"ZuZhiJGID": "47255004333112711A1001",
"BingRenID": "BR0001",
"XingMing": "张三",
"JiuZhenYWID": "JZ20261020001",
"BingAnHao": "BA20261020001",
"ZhengJianHM": "330102199001011234",
"LianXiDH": "13800000000"
},
"JianChaSQ": {
"YiZhuID": "100001",
"ShenQingDID": "SQ20261020001",
"YouXianJi": "1",
"KaiDanRID": "D1001",
"KaiDanRXM": "王医生",
"KaiDanKSID": "D001",
"KaiDanKSMC": "心血管内科",
"KaiDanSJ": "2026-10-20 11:30:00",
"ShenHeRID": "D1002",
"ShenHeRXM": "赵医生",
"ShenHeSJ": "2026-10-20 11:40:00",
"ZhiXingSJ": "2026-10-20 13:00:00",
"JianChaLXID": "CT",
"JianChaLXMC": "CT检查",
"JinE": "280.00",
"JiaoPianFBZ": "0",
"ChuangBianBZ": "0",
"TuiChuangBZ": "0",
"JiaJiBZ": "0",
"WeiShouXZXBZ": "0",
"JianChaBWList": [
{
"JianChaXMID": "CT001",
"JianChaXMMC": "胸部CT",
"JianChaBWID": "BW001",
"JianChaBWMC": "胸部"
}
],
"ZhenDuanList": [
{ "ZhenDuanID": "I10", "ZhenDuanMC": "原发性高血压" }
]
}
}
}
JC_BG_BaoGao 检查报告YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 至少包含 ZuZhiJGID、BingAnHao、BingRenID、XingMing |
| JianChaBG | object | 是 | 检查报告信息,见下表 |
JianChaBG 字段:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ShenQingDID | String | 是 | 申请单 ID,用于查找检查记录;找不到时会先调用申请逻辑补建 |
| JianChaHao | String | 是 | 检查号,写入 inspection_name |
| DangQianZTDM | String | 是 | 当前状态代码 |
| DangQianZTMC | String | 是 | 当前状态名称 |
| BaoGaoRID | String | 是 | 报告人 ID;注意代码最终把它写入 reportid |
| BaoGaoRXM | String | 是 | 报告人姓名 |
| BaoGaoSJ | String | 否 | 报告时间,yyyy-MM-dd HH:mm:ss |
| ZhenDuanYX | String | 是 | 诊断印象 |
| ZhenDuanSJ | String | 是 | 诊断所见 |
| ZhenDuanJY | String | 是 | 诊断建议 |
| BaoGaoYXDZ | String | 是 | 报告影像地址 |
| WeiJiZBZ | String | 是 | 危急值标志,必须为数字 |
| WeiJiZNR | String | 是 | 危急值内容 |
| BaoGaoKSID | String | 是 | 报告科室 ID |
| BaoGaoKSMC | String | 是 | 报告科室名称 |
| JianChaJGDM | String | 是 | 检查结果代码 |
| JianChaJGMC | String | 是 | 检查结果名称 |
代码对上述字符串字段大量直接调用
.toString(),缺失会抛空指针导致返回失败,请务必传齐。
处理结果:按 ShenQingDID 找到检查主记录,新增或更新 pat_med_inspection_item 报告明细。
SM_SQ_ShenQing 手术申请YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 患者信息,见 4.1 |
| ShouShuSQ | object | 是 | 手术申请信息,见下表 |
ShouShuSQ 字段:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ShenQingDID | String | 是 | 申请单 ID,写入 opreqcode,作为手术记录匹配键 |
| ShouShuLBDM | String | 否 | 手术类别代码,写入 optypecode |
| ShouShuLBMC | String | 否 | 手术类别名称,写入 optypename |
| YaoQiuSJ | Date | 否 | 要求时间,写入 operatortime |
| ShenQingSJ | Date | 否 | 申请时间,写入 opreqtime |
| ShenQingYSID | String | 否 | 申请医生 ID |
| ShenQingYSXM | String | 否 | 申请医生姓名 |
| ShenQingKSID | String | 否 | 申请科室 ID |
| ShenQingKSMC | String | 否 | 申请科室名称 |
| ShouShuKSID | String | 否 | 手术科室 ID |
| ShouShuKSMC | String | 否 | 手术科室名称 |
| ZhuDaoYSID | String | 否 | 主刀医生 ID |
| ZhuDaoYSXM | String | 否 | 主刀医生姓名 |
| YiZhuID | String | 否 | 医嘱 ID(代码映射到 firasscode) |
| YiZhuMC | String | 否 | 医嘱名称(代码映射到 firassname) |
| ErZhuYSID | String | 否 | 二助医生 ID |
| ErZhuYSXM | String | 否 | 二助医生姓名 |
| SanZhuYSID | String | 否 | 三助医生 ID |
| SanZhuYSXM | String | 否 | 三助医生姓名 |
| ShouShuMXList | array | 是 | 手术明细,**代码未做空判断**,见下表 |
ShouShuMXList 元素:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ShouShuMCID | String | 否 | 手术名称 ID |
| ShouShuMC | String | 否 | 手术名称 |
| ZhuShouSBZ | String | 是 | 主手术标志,1 表示主手术;代码直接调用 .equals,**不能为空** |
| QieKouLBDM | String | 否 | 切口类别代码 |
| QieKouLBMC | String | 否 | 切口类别名称 |
| ShouShuJBDM | String | 否 | 手术级别代码 |
| ShouShuJBMC | String | 否 | 手术级别名称 |
| ShouShuBW | String | 否 | 手术部位 |
| BiaoZhunBM | String | 否 | 标准编码 |
| ShouShuMCQZ | String | 否 | 手术名称前缀 |
| ShouShuMCHZ | String | 否 | 手术名称后缀 |
处理结果:
patid + ShenQingDID 查询手术记录,存在则更新,不存在则新增;ZhuShouSBZ=1)信息回写手术主表,其余写入 pat_med_operation_item;请求示例:
{
"XiaoXiTou": {
"FaSongJGID": "47255004333112711A1001",
"FaSongJGMC": "丽水市中医院",
"FaSongSJ": "2026-10-20 14:00:00",
"XiaoXiLX": "SM_SQ_ShenQing",
"XiaoXiID": "MSG-20261020-0004"
},
"YeWuXX": {
"XiaoXiID": "MSG-20261020-0004",
"BingRenXX": {
"ZuZhiJGID": "47255004333112711A1001",
"BingRenID": "BR0001",
"XingMing": "张三",
"JiuZhenYWID": "JZ20261020001",
"BingAnHao": "BA20261020001",
"DangQianKSID": "D001",
"DangQianKSMC": "心血管内科",
"DangQianBQID": "B001",
"DangQianBQMC": "心内科病区"
},
"ShouShuSQ": {
"ShenQingDID": "SS20261020001",
"ShouShuLBDM": "1",
"ShouShuLBMC": "择期手术",
"YaoQiuSJ": "2026-10-21 09:00:00",
"ShenQingSJ": "2026-10-20 13:30:00",
"ShenQingYSID": "D1001",
"ShenQingYSXM": "王医生",
"ShenQingKSID": "D001",
"ShenQingKSMC": "心血管内科",
"ShouShuKSID": "D003",
"ShouShuKSMC": "手术室",
"ZhuDaoYSID": "D1001",
"ZhuDaoYSXM": "王医生",
"ShouShuMXList": [
{
"ShouShuMCID": "OP001",
"ShouShuMC": "冠状动脉造影术",
"ZhuShouSBZ": "1",
"QieKouLBDM": "1",
"QieKouLBMC": "Ⅰ类切口",
"ShouShuJBDM": "3",
"ShouShuJBMC": "三级手术",
"ShouShuBW": "心脏"
}
]
}
}
}
SM_SQ_CheXiao 手术撤销YeWuXX 结构:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| XiaoXiID | String | 是(建议) | 响应回显 |
| BingRenXX | object | 是 | 至少包含 BingAnHao、JiuZhenYWID |
| ShouShuCX | object | 是 | 撤销信息,**至少包含 ShenQingDID**,其余字段当前未使用 |
处理结果:
patid + ShenQingDID 找到手术记录,置 checkFlag=1、delFlag=1;sendstate=4,备注“手术撤销”)并清理 Redis 缓存。
ShouShuGX(手术更新)虽在addOperationInfo中预留,但当前没有XiaoXiLX路由到该分支,实际不会生效。
{
"Code": "0",
"Message": "success",
"Data": {
"XiaoXiID": "MSG-20261020-0001",
"ChuangJianSJ": 1760928000000
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
| Code | String | "0" 成功,"500" 失败 |
| Message | String | success / error |
| Data.XiaoXiID | String | 原样返回请求 YeWuXX.XiaoXiID |
| Data.ChuangJianSJ | long | 服务器当前时间(JSON 序列化为毫秒时间戳) |
{
"Code": "500",
"Message": "error",
"Data": {
"XiaoXiID": "MSG-20261020-0001",
"ChuangJianSJ": 1760928000000
}
}
false(如找不到对应住院记录、用户/科室不存在、数据库操作影响行数不为 1)→ Code="500";Code="500";XiaoXiTou 缺失、XiaoXiLX 为空、YeWuXX 缺失等报文级错误,可能在响应组装阶段直接抛异常,返回 HTTP 500。建议调用方严格按本文档组装报文。BingRenXX、JiuZhenYWID,不能写成下划线或全小写。BingAnHao + JiuZhenYWID 定位住院记录;BingAnHao + JiuZhenYWID 定位门诊记录;ZhengJianHM(为空时用 JiuZhenKH)+ 机构定位;ShenQingDID;ShenQingDID;JZ_ZY_RuYuanDJ:DiZhiXXList、LianXiRList、ZhenDuanList;JZ_ZY_RuKe:BingRenXX.DiZhiXXList;JZ_MZ_WanChengJZ:ZhenDuanList、WenZhenList;SM_SQ_ShenQing:ShouShuSQ.ShouShuMXList,且每条明细 ZhuShouSBZ 不能为空。yyyy-MM-dd HH:mm:ss;BingRenXX.ChuShengRQ 代码内部使用 yyyy-MM-dd hh:mm:ss 解析,建议同样传完整时间,且尽量使用 08:00:00 这类 12 小时制可解析的时间。BingRenXX.XingBieDM、JianChaSQ.YiZhuID、JinE、各类 *BZ 标志、JC_BG_BaoGao.WeiJiZBZ 等会被直接转换为 Long/Float/Integer,必须传数字字符串。FaSongJGID 是机构过滤与落库 orgid 的主要来源;"1"(丽水无院区概念);JZ_MZ_WanChengJZ 使用 FaSongJGID 覆盖患者信息中的机构 ID。LiYuanQXDM=5 时,系统会取消患者后续随访(fuflag=0)、标记档案无需随访、终止已生成任务;请确保离院方式代码准确。noLongTask 中的机构,出院/接诊时 fuflag 会被置为 0。XiaoXiLX 会直接返回成功但不做任何处理,联调时请先核对类型拼写。| 现象 | 可能原因 |
|---|---|
返回 Code=500 且日志提示空指针 |
缺少 XiaoXiTou、XiaoXiLX、BingRenXX、JiuZhenXX 或必传列表 |
返回 Code=500 且日志提示 NumberFormatException |
XingBieDM、YiZhuID、JinE、*BZ 等字段传了非数字 |
返回 Code=500 且日志提示 ParseException |
日期不是 yyyy-MM-dd HH:mm:ss |
| 返回成功但数据未更新 | XiaoXiLX 拼写错误,走了默认分支;或业务键(病案号/就诊业务 ID/申请单 ID)不匹配 |
| 患者档案重复 | ZhengJianHM、JiuZhenKH 为空,或不同机构下重复建档 |
| 住院记录重复 | BingAnHao 或 JiuZhenYWID 发生变化 |
| 出院后仍在院 | 未传 JiuZhenXX.ChuYuanSJ,或 LiYuanQXDM 非法 |
| 随访任务未生成 | SuiFangJH.SuiFangBS=0、机构在 noLongTask 中、fuflag=0,或 JZ_MZ_WanChengJZ 未传随访天数 |