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