编辑 | blame | 历史 | 原始文档

/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

1.1 接口定位

该接口是 HIS/第三方系统向随访系统推送数据的**统一入口**,通过 XiaoXiTou.XiaoXiLX 区分 41 种业务消息,分别处理:

  • 机构、科室、用户、科室用户、病区(JG_*)
  • 患者档案、住院登记、入科、出院、出院记录、预出院、取消入院/出院、离抢(BR_DA_*、JZ_ZY_*、BL_JL_*)
  • 门急诊完成接诊(JZ_MZ_WanChengJZ)
  • 检查/检验申请、修改、报告(JC_*、JY_*)
  • 手术申请、撤销(SM_*)
  • 疾病目录(GY_ZD_JiBingML)
  • 随访任务(fu_task)

其中 22 种消息会实际落库,另外 19 种消息当前不落库(多数仅记录日志后直接返回成功,见第三章)。


二、请求报文结构

2.1 顶层结构

字段 类型 必填 说明
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"
  }
}

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 视消息类型 患者基本信息,见 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),不产生任何数据变更。请调用方确保类型拼写完全一致。


四、公共业务对象

4.1 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。

4.2 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 否 邮编

4.3 LianXiRList 患者联系人信息

对应 ExternalInHospPatientLiaisonInfo,写入 pat_archivecontact。

字段 类型 必填 说明
LianXiRXM String 否 联系人姓名
LianXiRDH String 否 联系人电话
GuanXiDM String 否 关系代码
GuanXiMC String 否 关系名称,写入联系人 relation

4.4 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 否 诊断名称

4.5 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 手术室。

4.6 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 否 经管医生姓名

4.7 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 否 其他专科禁补随访说明

4.8 BingRenKZXXList 患者扩展信息

出院(JZ_ZY_ChuYuan)使用,用于提取短号。

字段 类型 必填 说明
XiangMuDM String 是(若传) 项目代码;等于 DuanHaoXX 时取 XiangMuZMC 作为短号
XiangMuZMC String 是(若传) 项目值

示例:

"BingRenKZXXList": [
  { "XiangMuDM": "DuanHaoXX", "XiangMuZMC": "669999" }
]

4.9 WenZhenList 问诊信息

仅 JZ_MZ_WanChengJZ 使用。代码按 WenZhenLXMC 匹配以下四类:

字段 类型 必填 说明
WenZhenLXMC String 是(若传) 问诊类型名称:现病史、主诉、随访天数、随访天数单位
NeiRong String 是(若传) 问诊内容;随访天数 必须为整数,随访天数单位 支持 天/周/月/年

其他字段(WenZhenLXDM、WenZhenSJ、WenZhenYSID、WenZhenYSXM、WenZhenKSID、WenZhenKSMC)当前不参与业务处理。


五、各消息类型的业务报文

以下仅列出 YeWuXX 中该消息类型实际使用的键;未列出的键会被忽略。

5.1 机构、科室、用户、病区

5.1.1 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

5.1.2 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 否 修改时间(实际生效)

5.1.3 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 加密后写入。

5.1.4 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)。

5.1.5 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)区分。

5.2 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 + 机构 查询,存在则更新,不存在则新增。

5.3 入院、入科、取消入院

5.3.1 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"
      }
    ]
  }
}

5.3.2 JZ_ZY_RuKe 入科

YeWuXX 结构:

字段 类型 必填 说明
XiaoXiID String 是(建议) 响应回显
BingRenXX object 是 患者信息;其中 DiZhiXXList 不能为空
RuKeXX object 是 入科信息,见 4.6
JiuZhenXX object 否 代码读取但未使用,可忽略

处理结果:用 RuKeXX 中的主治医生、责任护士、入院时间覆盖患者信息,然后新增/更新档案与住院记录。

5.3.3 JZ_ZY_QuXiaoRY 取消入院登记

YeWuXX 结构:

字段 类型 必填 说明
XiaoXiID String 是(建议) 响应回显
BingRenXX object 是 至少包含 BingAnHao、JiuZhenYWID
JiuZhenXX object 否 取 CaoZuoRID、CaoZuoRXM 记录操作人

处理结果:按 BingAnHao + JiuZhenYWID 找到住院记录,置 schemestatus=3、del_flag=1。

5.4 出院、出院记录、预出院、取消出院、离抢

5.4.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(不做长期随访)。

5.4.2 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)与随访计划。

5.4.3 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 时执行死亡患者处理。

5.4.4 JZ_ZY_QuXiaoCY 取消出院

YeWuXX 结构:

字段 类型 必填 说明
XiaoXiID String 是(建议) 响应回显
BingRenXX object 是 至少包含 BingAnHao、JiuZhenYWID
JiuZhenXX object 否 取 CaoZuoRID、CaoZuoRXM

处理结果:

  • 住院记录 schemestatus=4、inhospstate=0(恢复在院);
  • 删除该患者 sendstate=1/2 的随访子任务,并清理 Redis 缓存中的任务 ID。

5.4.5 JZ_ZY_LiQiang 患者离抢

YeWuXX 结构:

字段 类型 必填 说明
XiaoXiID String 是(建议) 响应回显
BingRenXX object 是 至少包含 BingAnHao、JiuZhenYWID
JiuZhenXX object 是 取 LiQiangSJ(离抢时间)、LiYuanQXDM

处理结果:把 LiQiangSJ 回填到住院记录出院时间,inhospstate=1;LiYuanQXDM=5 时执行死亡患者处理。找不到住院记录时返回失败。

5.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": "天" }
    ]
  }
}

5.6 检查/检验申请与修改

适用类型: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": "原发性高血压" }
      ]
    }
  }
}

5.7 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 报告明细。

5.8 手术申请、撤销

5.8.1 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": "心脏"
        }
      ]
    }
  }
}

5.8.2 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 路由到该分支,实际不会生效。


六、响应说明

6.1 成功响应

{
  "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 序列化为毫秒时间戳)

6.2 失败响应

{
  "Code": "500",
  "Message": "error",
  "Data": {
    "XiaoXiID": "MSG-20261020-0001",
    "ChuangJianSJ": 1760928000000
  }
}

6.3 失败判定规则

  • 业务方法返回 false(如找不到对应住院记录、用户/科室不存在、数据库操作影响行数不为 1)→ Code="500";
  • 业务方法抛出异常(字段缺失、类型转换失败、空指针等)→ 控制器捕获并记录日志,返回 Code="500";
  • XiaoXiTou 缺失、XiaoXiLX 为空、YeWuXX 缺失等报文级错误,可能在响应组装阶段直接抛异常,返回 HTTP 500。建议调用方严格按本文档组装报文。

七、调用注意事项

  1. 字段名大小写敏感:所有字段均为拼音首字母大写格式,如 BingRenXX、JiuZhenYWID,不能写成下划线或全小写。
  2. 唯一业务键:
  • 住院类消息使用 BingAnHao + JiuZhenYWID 定位住院记录;
  • 门诊接诊使用 BingAnHao + JiuZhenYWID 定位门诊记录;
  • 患者档案使用 ZhengJianHM(为空时用 JiuZhenKH)+ 机构定位;
  • 检查使用 ShenQingDID;
  • 手术使用 ShenQingDID;
  • 机构/科室/用户/病区使用各自 ID + 机构。
  1. 重复推送:代码按上述业务键查询后执行“存在则更新、不存在则新增”,重复推送一般不会重复插入;但若业务键变化,会产生新记录。
  2. 必传列表:以下消息对列表字段没有空判断,缺失会直接报错:
  • JZ_ZY_RuYuanDJ:DiZhiXXList、LianXiRList、ZhenDuanList;
  • JZ_ZY_RuKe:BingRenXX.DiZhiXXList;
  • JZ_MZ_WanChengJZ:ZhenDuanList、WenZhenList;
  • SM_SQ_ShenQing:ShouShuSQ.ShouShuMXList,且每条明细 ZhuShouSBZ 不能为空。
  1. 日期格式:除特别说明外,日期时间统一使用 yyyy-MM-dd HH:mm:ss;BingRenXX.ChuShengRQ 代码内部使用 yyyy-MM-dd hh:mm:ss 解析,建议同样传完整时间,且尽量使用 08:00:00 这类 12 小时制可解析的时间。
  2. 数字字段:BingRenXX.XingBieDM、JianChaSQ.YiZhuID、JinE、各类 *BZ 标志、JC_BG_BaoGao.WeiJiZBZ 等会被直接转换为 Long/Float/Integer,必须传数字字符串。
  3. 机构与院区:
  • FaSongJGID 是机构过滤与落库 orgid 的主要来源;
  • 院区字段当前统一写死为 "1"(丽水无院区概念);
  • JZ_MZ_WanChengJZ 使用 FaSongJGID 覆盖患者信息中的机构 ID。
  1. 死亡患者处理:LiYuanQXDM=5 时,系统会取消患者后续随访(fuflag=0)、标记档案无需随访、终止已生成任务;请确保离院方式代码准确。
  2. 不随访机构:配置项 noLongTask 中的机构,出院/接诊时 fuflag 会被置为 0。
  3. 消息类型白名单:未在第三章列出的 XiaoXiLX 会直接返回成功但不做任何处理,联调时请先核对类型拼写。
  4. 接口无鉴权:该地址对外网开放时存在数据写入风险,建议通过网关/防火墙限制来源 IP,或在网关层增加签名校验。

八、快速排查

现象 可能原因
返回 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 未传随访天数