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

JZ_MZ_WanChengJZ 门急诊完成接诊 接口文档

接口:POST /smartor/serviceExternal/generalInterface
消息类型:JZ_MZ_WanChengJZ
文档生成日期:2026-10-20
说明:字段名区分大小写,请严格按文档中的拼音字段名传参。


一、接口说明

项目 内容
接口地址 /smartor/serviceExternal/generalInterface
请求方式 POST
Content-Type application/json;charset=UTF-8
认证方式 无需登录(/smartor/serviceExternal/** 已配置 permitAll)
消息类型 JZ_MZ_WanChengJZ
业务含义 门急诊完成接诊
处理入口 addFinshJZInfo
是否落库 是(实际落库)
业务说明 接收门急诊完成接诊信息,写入门诊就诊记录,并按随访天数生成随访任务。

二、请求报文

2.1 报文结构

字段 类型 必填 说明
XiaoXiTou object 是 消息头
YeWuXX object 是 业务信息,必须包含 XiaoXiID

2.2 消息头 XiaoXiTou

字段 类型 必填 说明
FaSongFCSJC String 否 发送方程序简称,默认 ZJHES
FaSongJGID String 是 发送机构 ID,对应系统 orgid;部分消息类型用它覆盖业务中的机构 ID
FaSongJGMC String 否 发送机构名称
FaSongSJ String 否 发送时间,建议 yyyy-MM-dd HH:mm:ss
FaSongXTJC String 否 发送系统简称,默认 SUIFANGXT
FaSongXTMC String 否 发送系统名称,默认 随访系统
XiaoXiID String 否 消息 ID;本接口响应回显取的是 YeWuXX.XiaoXiID
XiaoXiLX String 是 消息类型,决定业务分支,缺失或为空时接口报错
XiaoXiMC String 否 消息名称
ZuHuID String 否 医院 ID
ZuHuMC String 否 医院名称

2.3 业务信息 YeWuXX

字段 类型 必填 说明
XiaoXiID String 是(建议) 消息 ID,原样放入响应 Data.XiaoXiID;缺失时返回 null
BingRenXX object 是 患者信息;ZuZhiJGID 可省略,代码使用消息头 FaSongJGID
JiuZhenXX object 是 就诊信息,至少包含科室、就诊日期
ZhenDuanList array 是 诊断列表,不能为空
WenZhenList array 是 问诊列表,不能为空

2.4 请求示例

{
  "XiaoXiTou": {
    "FaSongJGID": "47255004333112711A1001",
    "FaSongJGMC": "丽水市中医院",
    "FaSongSJ": "2026-10-20 10:00:00",
    "XiaoXiLX": "JZ_MZ_WanChengJZ",
    "XiaoXiID": "MSG-20261020-0001"
  },
  "YeWuXX": {
    "XiaoXiID": "MSG-20261020-0001",
    "BingRenXX": {
      "BingRenID": "BR0002",
      "XingMing": "李四",
      "JiuZhenYWID": "MZ20261020002",
      "JiuZhenKH": "MZ0002",
      "BingAnHao": "BA20261020002",
      "ZhengJianHM": "330102198505051234",
      "XingBieDM": "2",
      "ChuShengRQ": "1985-05-05 10:00:00",
      "LianXiDH": "13700000000"
    },
    "JiuZhenXX": {
      "JiuZhenKSID": "D002",
      "JiuZhenKSMC": "妇科",
      "JiuZhenRQ": "2026-10-20 10:30:00",
      "sfrq": "2026-11-20 00:00:00"
    },
    "ZhenDuanList": [
      {
        "ZhenDuanYSID": "D1002",
        "ZhenDuanYSXM": "赵医生",
        "ZhenDuanID": "O20.0",
        "ZhenDuanMC": "先兆流产",
        "ZhenDuanLBDM": "1",
        "ZhenDuanLBMC": "主诊断",
        "Icd10": "O20.0"
      }
    ],
    "WenZhenList": [
      {
        "WenZhenLXMC": "主诉",
        "NeiRong": "停经50天,阴道流血1天"
      },
      {
        "WenZhenLXMC": "现病史",
        "NeiRong": "患者停经50天,1天前出现阴道流血……"
      },
      {
        "WenZhenLXMC": "随访天数",
        "NeiRong": "30"
      },
      {
        "WenZhenLXMC": "随访天数单位",
        "NeiRong": "天"
      }
    ]
  }
}

三、业务字段说明

3.1 BingRenXX 患者基本信息

机构 ID 会被消息头 FaSongJGID 覆盖。

字段 类型 必填 说明
ZuZhiJGID String 是 组织机构 ID(写入 orgid)
ZuZhiJGMC String 否 组织机构名称
BingRenID String 是 病人 ID,写入 patid_his/patno
XingMing String 是 患者姓名
JiuZhenYWID String 是 就诊业务 ID,与 BingAnHao 共同定位住院/门诊记录
JiuZhenKH String 否 就诊卡号;证件号码为空时作为患者档案唯一标识
BingAnHao String 是 病案号(代码按病案号匹配,不使用住院号)
ZhengJianLXMC String 否 证件类型名称,写入档案 idcardtype
ZhengJianHM String 是(建议) 证件号码,患者档案唯一标识;为空时使用 JiuZhenKH
XingBieDM String 否 性别代码,必须为数字字符串(如 1/2),代码执行 Long.valueOf
ChuShengRQ String 是(建议) 出生日期,代码按 yyyy-MM-dd hh:mm:ss 解析,建议传完整时间
DangQianKSID String 是 当前科室 ID,写入住院/出院科室
DangQianKSMC String 是 当前科室名称
DangQianBQID String 是 当前病区 ID
DangQianBQMC String 是 当前病区名称
DangQianCWMC String 否 床位名称,写入住院 bedNo
RuYuanSJ Date 是(入院/入科) 入院时间,格式 yyyy-MM-dd HH:mm:ss
LianXiDH String 是(建议) 联系电话,写入患者档案手机号
LianXiRDH String 否 联系人电话;LianXiDH 为空时作为患者手机号
GuoJiMC String 否 国籍名称,写入档案 nativePlace
MinZuMC String 否 民族名称,写入档案 nation
XianZhuZXX String 否 现住址;优先于 DiZhiXXList 写入档案
CaoZuoRID String 否 操作人 ID
CaoZuoRXM String 否 操作人姓名
ZeRenHSID String 否 责任护士 ID
ZeRenHSXM String 否 责任护士姓名
ZhuZhiYSID String 否 主治医生 ID
ZhuZhiYSXM String 否 主治医生姓名
JingGuanYSID String 否 经管医生 ID
JingGuanYSXM String 否 经管医生姓名
DuanHaoXX String 否 短号信息
BingRenLXDM String 否 病人类型代码,手术记录写入 inhospstate

3.2 JiuZhenXX 就诊信息

字段 类型 必填 说明
JiuZhenKSID String 是 就诊科室 ID
JiuZhenKSMC String 是 就诊科室名称
JiuZhenRQ Date 是 就诊日期,yyyy-MM-dd HH:mm:ss,写入门诊 admitdate
sfrq Date 否 随访日期,写入门诊 fudate
CaoZuoRID String 否 操作人 ID
CaoZuoRXM String 否 操作人姓名

3.3 ZhenDuanList 诊断列表

ZhenDuanLBMC=主诊断 的记录用于门诊主诊断。

字段 类型 必填 说明
ZhenDuanYSID String 否 诊断医生 ID
ZhenDuanYSXM String 否 诊断医生姓名
ZhenDuanID String 否 诊断 ID
ZhenDuanMC String 是 诊断名称
ZhenDuanLBDM String 否 诊断类别代码
ZhenDuanLBMC String 是 诊断类别名称;等于 主诊断 时写入门诊主诊断
Icd10 String 是(建议) ICD10 编码

3.4 WenZhenList 问诊列表

用于现病史、主诉、随访天数及单位。

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

四、处理逻辑

  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。

五、响应说明

成功响应:

{
  "Code": "0",
  "Message": "success",
  "Data": {
    "XiaoXiID": "MSG-20261020-0001",
    "ChuangJianSJ": 1760928000000
  }
}

失败响应(业务返回 false 或处理异常):

{
  "Code": "500",
  "Message": "error",
  "Data": {
    "XiaoXiID": "MSG-20261020-0001",
    "ChuangJianSJ": 1760928000000
  }
}
字段 类型 说明
Code String "0" 成功,"500" 失败
Message String success / error
Data.XiaoXiID String 原样返回请求 YeWuXX.XiaoXiID
Data.ChuangJianSJ long 服务器当前时间(毫秒时间戳)

六、注意事项

  • ZhenDuanList、WenZhenList 代码未做空判断,缺失会报错。
  • 随访天数 必须是整数,随访天数单位 支持 天、周、月、年。
  • 门诊记录匹配键为 BingAnHao + JiuZhenYWID。
  • 报文缺少 XiaoXiTou、XiaoXiLX、YeWuXX 时可能在响应组装阶段直接抛异常,返回 HTTP 500。
  • 日期时间除特别说明外统一使用 yyyy-MM-dd HH:mm:ss。

本文档根据当前代码生成;若后端逻辑调整,请同步更新文档。