# `/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`** | ```json { "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 | 是(若传) | 项目值 | 示例: ```json "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`(在院)。 请求示例: ```json { "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`。 请求示例: ```json { "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_*` 共用同一张表,仅类型不同。 请求示例: ```json { "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`; - 已存在的手术会先物理删除旧明细再重建。 请求示例: ```json { "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 成功响应 ```json { "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 失败响应 ```json { "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 + 机构。 3. **重复推送**:代码按上述业务键查询后执行“存在则更新、不存在则新增”,重复推送一般不会重复插入;但若业务键变化,会产生新记录。 4. **必传列表**:以下消息对列表字段没有空判断,缺失会直接报错: - `JZ_ZY_RuYuanDJ`:`DiZhiXXList`、`LianXiRList`、`ZhenDuanList`; - `JZ_ZY_RuKe`:`BingRenXX.DiZhiXXList`; - `JZ_MZ_WanChengJZ`:`ZhenDuanList`、`WenZhenList`; - `SM_SQ_ShenQing`:`ShouShuSQ.ShouShuMXList`,且每条明细 `ZhuShouSBZ` 不能为空。 5. **日期格式**:除特别说明外,日期时间统一使用 `yyyy-MM-dd HH:mm:ss`;`BingRenXX.ChuShengRQ` 代码内部使用 `yyyy-MM-dd hh:mm:ss` 解析,建议同样传完整时间,且尽量使用 `08:00:00` 这类 12 小时制可解析的时间。 6. **数字字段**:`BingRenXX.XingBieDM`、`JianChaSQ.YiZhuID`、`JinE`、各类 `*BZ` 标志、`JC_BG_BaoGao.WeiJiZBZ` 等会被直接转换为 Long/Float/Integer,必须传数字字符串。 7. **机构与院区**: - `FaSongJGID` 是机构过滤与落库 `orgid` 的主要来源; - 院区字段当前统一写死为 `"1"`(丽水无院区概念); - `JZ_MZ_WanChengJZ` 使用 `FaSongJGID` 覆盖患者信息中的机构 ID。 8. **死亡患者处理**:`LiYuanQXDM=5` 时,系统会取消患者后续随访(`fuflag=0`)、标记档案无需随访、终止已生成任务;请确保离院方式代码准确。 9. **不随访机构**:配置项 `noLongTask` 中的机构,出院/接诊时 `fuflag` 会被置为 `0`。 10. **消息类型白名单**:未在第三章列出的 `XiaoXiLX` 会直接返回成功但不做任何处理,联调时请先核对类型拼写。 11. **接口无鉴权**:该地址对外网开放时存在数据写入风险,建议通过网关/防火墙限制来源 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` 未传随访天数 |