🏥 东方医院 · 接口工作台

78+

接口总数

服务器节点

院区数量

业务流程

快速入口

👉 查看业务流程 — 预约/挂号/缴费完整调用链路

👉 查看内部接口 — 公众号内部接口速查

👉 查看平台接口 — 平台→HIS接口速查

🔄 业务流程

👆

请选择上方业务流程

点击一个流程按钮查看详细接口调用链和真实数据

📋 预约挂号 · 自费流程

不涉及医保分解，用户直接通过延华SOAP预约。先拉取科室→医生→排班→号源，确认档案后提交预约

涉及: 公众号内部 5个 · 延华SOAP 5个 · HIHIS平台 1个 · 公众号代理(聚合) 1个 · 接口总数 12个

⚠️ 每个科室单独一次getAllDeptMsg请求(24次)，延华SOAP两个端点混用(yhzn获取数据+linkonworks提交预约)。新患者需先建档。测试环境使用hihispre预发布服务器。

getFullUser

获取用户信息+就诊人列表

⏱ ~600ms 📋 点击查看详情

公众号内部

返回userId、patientList（姓名/身份证/绑定的卡列表）。该用户有2张卡：医保卡6022199030(cardType=0)+自费卡DZ1000000011947(cardType=2)

📥 入参 (1个)

参数名	类型	必填	说明	来源/去向
(无)	—	可选	基于Token自动识别	← 微信登录态

📤 出参 (3个)

参数名	类型	必填	说明	来源/去向
userId	String	可选	用户ID
└ cardNo	String	可选	就诊卡号	→ 选择自费卡
⭐ └ cardType	String	可选	0=医保,1=社保,2=自费

📋 真实调用示例

📥 请求 (Request)

{}  // 基于微信登录态自动识别用户

📤 响应 (Response)

{
  "code": 0,
  "data": {
    "userId": "8F587CA43D7546838A7C346E1685DA11",
    "patientList": [{
      "cardType": "1",
      "cardNo": "350128199209203275",
      "name": "李华",
      "sex": "1",
      "mobile": "18559938150",
      "isDefault": "1",
      "medicalcardList": [
        { "medicalCard": "DZ1000000011947", "medicalCardType": "2", "isDefault": "1", "hisPid": "1202477048" },
        { "medicalCard": "6022199030", "medicalCardType": "0", "isDefault": "0", "hisPid": "1202492618" },
        { "medicalCard": "350128199209203275", "medicalCardType": "1", "isDefault": "0" }
      ]
    }]
  },
  "msg": "请求成功"
}

getToken

获取JWT凭证

⏱ ~500ms 📋 点击查看详情

公众号内部

JWT含CustomerId=91, AppId=gh_19aaa7139bb2, ExpireTime

📋 真实调用示例

📥 请求 (Request)

{}  // 无业务参数

📤 响应 (Response)

{
  "code": 0,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIs...",
    "version": "1.0"
  },
  "msg": "请求成功"
}
// JWT Payload 解码后:
// { "CusId": "91", "UIServiceId": "gh_19aaa7139bb2", "QIMAIUserId": "8F587CA...", "exp": 1781539199 }

getFull

获取用户简要信息

⏱ ~200ms 📋 点击查看详情

公众号内部

多次调用，用于刷新用户状态。与getFullUser的区别：返回medicalCardType字段(0=医保/1=身份证/2=自费)

📋 真实调用示例

📥 请求 (Request)

{}  // 无业务参数

📤 响应 (Response)

{
  "code": 0,
  "data": {
    "patientList": [{
      "name": "李华",
      "medicalcardList": [
        { "medicalCard": "DZ1000000011947", "medicalCardType": "2", "hisPid": "1202477048", "insure": "0" },
        { "medicalCard": "6022199030", "medicalCardType": "0", "hisPid": "1202492618", "insure": "0" }
      ]
    }]
  }
}
// ⚠️ 注意: getFull返回medicalCardType，getFullUser不返回此字段

Entity.GetNodeList (延华SOAP)

延华SOAP获取科室列表

⏱ ~24×100ms=2.4s 📋 点击查看详情

延华SOAP

⚠️ 每个科室单独一次SOAP请求！日志中调用24次
端点: http://service.yhzn.com (新端点)
出参: oneDeptCode/oneDeptName/outpOrInpName/sortId
📌 实际已迁移到REST接口 queryOpeningDepartment，一次返回全部科室（约50个）

📥 入参 (2个)

参数名	类型	必填	说明	来源/去向
deptType	String	可选	科室类型	← 固定:all
deptCode	String	可选	科室代码	← 固定:all

📤 出参 (4个)

参数名	类型	必填	说明	来源/去向
oneDeptCode	String	可选	一级科室代码	→ getDeptDoctor
⭐ oneDeptName	String	可选	科室名称
outpOrInpName	String	可选	科室分类(内科/外科/儿科等)
sortId	String	可选	排序ID

📋 真实调用示例

📥 请求 (Request)

// 新版REST接口 (实际使用)
POST /platform/common/commonQuery
{"method":"queryOpeningDepartment","cardNo":"","branchId":"42501633102"}

📤 响应 (Response)

{
  "code": 200,
  "data": [
    { "ksmc": "呼吸内科", "mzksNa": "呼吸内科", "ksfl": "内科", "sortId": "10", "depttype": "普通" },
    { "ksmc": "心血管内科", "mzksNa": "心血管内科", "ksfl": "内科", "sortId": "10" },
    { "ksmc": "消化内科", "mzksNa": "消化内科", "ksfl": "内科", "sortId": "10" },
    { "ksmc": "脊柱外科", "mzksNa": "脊柱外科", "ksfl": "外科", "sortId": "20" },
    { "ksmc": "泌尿外科", "mzksNa": "泌尿外科", "ksfl": "外科", "sortId": "20" },
    { "ksmc": "妇科", "mzksNa": "妇科", "ksfl": "妇产科", "sortId": "30" },
    ... // 共约50个科室
  ]
}

💡 ⚠️ 严重性能问题：24次串行SOAP调用！建议改为一次批量获取

Entity.GetEntityMap (延华SOAP)

延华SOAP获取科室医生

⏱ ~200ms 📋 点击查看详情

延华SOAP

延华SOAP接口: Entity.GetEntityMap
端点: http://service.yhzn.com
根据科室代码获取该科室下的医生列表

📥 入参 (2个)

参数名	类型	必填	说明	来源/去向
oneDeptCode	String	可选	科室代码	← getAllDeptMsg选择
hospitalNo	String	可选	院区(2=南院)

📤 出参 (2个)

参数名	类型	必填	说明	来源/去向
doctorId	String	可选	医生ID	→ getDoctorWork
doctorName	String	可选	医生姓名

Booking.GetClass (延华SOAP)

延华SOAP获取排班日期

⏱ ~200ms 📋 点击查看详情

延华SOAP

延华SOAP接口: Booking.GetClass
获取某医生可预约的日期列表

📥 入参 (2个)

参数名	类型	必填	说明	来源/去向
doctorId	String	可选	医生ID	← 上一步
hospitalNo	String	可选	院区

📤 出参 (1个)

参数名	类型	必填	说明	来源/去向
workDate	String	可选	可预约日期	→ getDoctorSource

Booking.GetPeriod (延华SOAP)

延华SOAP获取号源时段

⏱ ~200ms 📋 点击查看详情

延华SOAP

延华SOAP接口: Booking.GetPeriod
获取某医生某日期的时段号源（上午/下午，每时段剩余号数）

📥 入参 (2个)

参数名	类型	必填	说明	来源/去向
doctorId	String	可选	医生ID
workDate	String	可选	日期	← 上一步

📤 出参 (3个)

参数名	类型	必填	说明	来源/去向
period	String	可选	时段(上午/下午)
⭐ remainNum	String	可选	剩余号数
⭐ templateld	String	可选	号源模板ID	→ getScheClinicorder

HIHIS queryBrda (x3并发)

HIHIS查患者档案(三台HIS并发)

⏱ ~100ms 📋 点击查看详情

HIHIS平台

HIHIS接口: /hcenter/queryBrda
172.31.10.34(南院) + 192.168.3.136(本院) + hihispre(预发布)
自费卡 cardType=2 DZ1000000011947
⚠️ 三台返回不同的associtePatNo(HIS实例独立患者ID)

📤 出参 (3个)

参数名	类型	必填	说明
⭐ cardNo	String	可选	就诊卡号
⭐ cardType	Int	可选	2=统一自费就诊卡
⭐ associtePatNo	String	可选	患者ID(三台不同!)

📋 真实调用示例

📥 请求 (Request)

// 并发请求3台服务器
// 服务器1 — 南院 (172.31.10.34:19077)
{"branchId":"42501633102","platformType":"2","channelCode":"1","patName":"李华","idcardNo":"350128199209203275"}

// 服务器2 — 本院 (192.168.3.136:18077)
{"branchId":"42501633100","platformType":"2","channelCode":"1","patName":"李华","idcardNo":"350128199209203275"}

// 服务器3 — 预发布 (hihispre.easthospital.cn)
{"branchId":"42501633102","platformType":"2","channelCode":"1","patName":"李华","idcardNo":"350128199209203275"}

📤 响应 (Response)

// 服务器1 (南院)
{"code":0,"data":[{"cardNo":"6022199030","cardType":0,"associtePatNo":1202492618},{"cardNo":"DZ1000000011947","cardType":2,"associtePatNo":1202477048}]}

// 服务器2 (本院)
{"code":0,"data":[{"cardNo":"DZ1000000011947","cardType":2,"associtePatNo":1202477049},{"cardNo":"6022199030","cardType":0,"associtePatNo":1202492619}]}

// 服务器3 (预发布 hihispre)
{"code":0,"data":[{"cardNo":"DZ1000000017010","cardType":2,"associtePatNo":805971612515176448},{"cardNo":"DZ1000000011947","cardType":2},{"cardNo":"6022199030","cardType":0}]}

// ⚠️ 关键差异: 同一患者在三台HIS中associtePatNo完全不同!

bs_userassociatecard

数据库查询用户绑卡

⏱ ~5ms

公众号内部

SQL: SELECT * FROM bs_userassociatecard WHERE userid='...' AND customerid='91' AND status='1'

CardInterceptRule

卡拦截规则校验(日志发现)

⏱ ~6ms 📋 点击查看详情

公众号代理(聚合)

127.0.0.1:9099
CardCategory=SelfPayCard(自费卡)
校验卡是否符合该科室挂号规则

📥 入参 (5个)

参数名	类型	必填	说明
BranchCode	String	可选	2=南院
SceneCode	String	可选	AppointmentConfirm
OneDeptCode	String	可选	1003010000020000
SecondDeptCode	String	可选	1003010000020000=呼吸内科正
CardCategory	String	可选	SelfPayCard

📤 出参 (1个)

参数名	类型	必填	说明	来源/去向
⭐ IsPassCheck	Bool	可选	是否通过

📋 真实调用示例

📥 请求 (Request)

POST /api/CardInterceptRule/checkRule
{
  "BranchCode": "2",
  "BranchName": "东方医院南院",
  "SceneCode": "AppointmentConfirm",
  "RuleSceneCode": "AppointmentRelated",
  "OneDeptCode": "1003010000020000",
  "OneDeptName": "呼吸内科",
  "SecondDeptCode": "1003010000020000",
  "SecondDeptName": "呼吸内科正",
  "ClinicTypeCode": "2",
  "CardCategory": "SelfPayCard",
  "ChannelCode": "WeiXin"
}

📤 响应 (Response)

{
  "code": 0,
  "data": {
    "IsPassCheck": true,
    "NeedPrompt": false,
    "NeedSelectCard": false,
    "FailReasonCode": "",
    "PromptMessage": ""
  },
  "msg": "请求成功"
}

Booking.ConfirmBooking → HIHIS getScheClinicorder

延华SOAP→HIHIS提交预约

⏱ ~300ms 📋 点击查看详情

延华SOAP

延华SOAP Booking.ConfirmBooking → 东方医院通过HIHIS /appoint/getScheClinicorder (SOAP)处理
端点: service.busi.df.linkonworks.com
medicineCardNo传自费卡号DZ1000000011947

📥 入参 (6个)

参数名	类型	必填	说明	来源/去向
⭐ templateld	String	可选	号源模板	← getDoctorSource组合
name	String	可选	患者姓名	← 李华
medicineCardNo	String	可选	自费卡号DZ1000000011947
idendityCardNo	String	可选	身份证号
idendityCardType	String	可选	11=身份证
cellphone	String	可选	手机号

📤 出参 (3个)

参数名	类型	必填	说明
⭐ ReservationId	String	可选	预约成功ID=828844103279575040
⭐ State	String	可选	1=成功
Message	String	可选	预约成功

📋 真实调用示例

📥 请求 (Request)

// SOAP XML 请求
POST http://service.busi.df.linkonworks.com/
<Envelope xmlns:soapenv='...' xmlns:ser='http://service.busi.df.linkonworks.com/'>
  <Header><MyHeader>
    <factoryno>QMGS</factoryno>
    <factoryname>齐脉公司</factoryname>
    <versionno>V1.0</versionno>
    <hospitalno>2</hospitalno>
  </MyHeader></Header>
  <Body><getScheClinicorder>
    <templateld>1003010302021000@GZL0194@20260617...</templateld>
    <name>李华</name>
    <medicineCardNo>DZ1000000011947</medicineCardNo>
    <idendityCardNo>350128199209203275</idendityCardNo>
    <idendityCardType>11</idendityCardType>
    <cellphone>18559938150</cellphone>
  </getScheClinicorder></Body>
</Envelope>

📤 响应 (Response)

// SOAP XML 响应
<?xml version="1.0" encoding="UTF-8"?>
<Rows>
  <Row>
    <Message>预约成功</Message>
    <ReservationId>828844103279575040</ReservationId>
    <State>1</State>
  </Row>
</Rows>

💡 ⚠️ 自费卡确认：cardType=2(统一自费就诊卡)，CardCategory=SelfPayCard，全程无医保接口调用

getBookingList

获取预约列表确认结果

⏱ ~200ms 📋 点击查看详情

公众号内部

预约完成后调3次，确认预约记录已生成

📋 真实调用示例

📥 请求 (Request)

POST /api/Booking/getBookingList
{
  "medicalCard": "DZ1000000011947",
  "startTime": "2026-06-15 00:00:00",
  "endTime": "2026-09-13 00:00:00",
  "branchCode": ""
}

📤 响应 (Response)

{
  "code": 0,
  "data": {
    "bookingList": [{
      "bookingId": "828844103279575040",
      "branchName": "东方医院南院",
      "nodeName": "呼吸内科正",
      "name": "李华",
      "doctorName": "郭忠良",
      "classDate": "2026-06-17",
      "period": "15:30-16:00",
      "price": 50.0,
      "bookingTime": "2026-06-15 18:05:38",
      "status": 0,
      "reservationSource": "上海市东方医院公众号"
    }, ...]
  }
}
// status: 0=已预约, 2=已就诊, 3=已过期

📋 预约挂号 · 医保流程

与自费流程基本一致，差异在于卡类型为医保卡(cardType=0/1)，需先通过电子医保凭证获取医保卡信息

涉及: 公众号内部 2个 · 延华SOAP 5个 · HIHIS平台 2个 · 公众号代理(聚合) 1个 · 接口总数 10个

⚠️ 医保患者 cardType=0(医保卡)或1(社保卡)。多一步getMedicalInsuranceCard获取医保卡号。其余延华SOAP调用与自费完全相同。

getFullUser

获取用户信息+就诊人列表

⏱ ~600ms 📋 点击查看详情

公众号内部

医保患者确认就诊人绑定了医保卡(cardType=0或1)

📋 真实调用示例

📥 请求 (Request)

{}  // 基于微信登录态

📤 响应 (Response)

// 医保卡 cardType=0(医保卡) 示例
{
  "code": 0,
  "data": {
    "patientList": [{
      "cardType": "1",
      "cardNo": "350128199209203275",
      "name": "李华",
      "medicalcardList": [
        { "medicalCard": "6022199030", "medicalCardType": "0", "hisPid": "1202492618" }
      ]
    }]
  }
}

getToken

获取JWT凭证

⏱ ~500ms 📋 点击查看详情

公众号内部

📋 真实调用示例

📥 请求 (Request)

{}

📤 响应 (Response)

{"code":0,"data":{"access_token":"eyJ...","version":"1.0"},"msg":"请求成功"}

getAllDeptMsg

延华SOAP获取全部科室

⏱ ~2.4s

延华SOAP

同自费流程

getDeptDoctor

获取科室医生

⏱ ~200ms

延华SOAP

同自费流程

getDoctorWork

获取排班日期

⏱ ~200ms

延华SOAP

同自费流程

getDoctorSource

获取号源时段

⏱ ~200ms

延华SOAP

同自费流程

queryBrda (x3)

查患者档案

⏱ ~100ms 📋 点击查看详情

HIHIS平台

医保患者cardType=0

📋 真实调用示例

📥 请求 (Request)

// 并发3台HIS服务器（同自费流程）
// 南院 172.31.10.34 + 本院 192.168.3.136 + 预发布 hihispre

📤 响应 (Response)

// 南院返回: cardType=0, associtePatNo=1202492618
// 本院返回: cardType=0, associtePatNo=1202492619
// 预发布: cardType=0, associtePatNo=805971612515176448

getMedicalInsuranceCard

电子医保码获取医保卡

⏱ ~1s 📋 点击查看详情

HIHIS平台

刷医保电子凭证二维码→换取医保卡号

📥 入参 (3个)

参数名	类型	必填	说明	来源/去向
⭐ ecQrCode	String	可选	医保电子凭证码	← 用户刷码
ecQrChannel	String	可选	2=微信
businessType	String	可选	01101=挂号

📤 出参 (3个)

参数名	类型	必填	说明
⭐ cardNo	String	可选	医保就诊卡号
cardType	String	可选	0=医保卡
insuOrg	String	可选	参保地

CardInterceptRule

卡拦截规则校验

⏱ ~6ms 📋 点击查看详情

公众号代理(聚合)

CardCategory=MedicalInsuranceCard

📋 真实调用示例

📥 请求 (Request)

// 与自费流程差异: CardCategory=MedicalInsuranceCard
{"BranchCode":"2","SceneCode":"AppointmentConfirm","OneDeptCode":"1003010000020000","CardCategory":"MedicalInsuranceCard"}

📤 响应 (Response)

{"code":0,"data":{"IsPassCheck":true},"msg":"请求成功"}

getScheClinicorder

延华SOAP提交预约

⏱ ~300ms

延华SOAP

medicineCardNo传医保卡号

📋 当日挂号 · 自费流程

全自费支付挂号费，无医保分解环节

涉及: 公众号内部 2个 · HIHIS平台 3个 · 接口总数 5个

⚠️ 挂号费=挂号费(ghf)+诊疗费(zlf)，不同科室/医生级别费用不同

getFullUser

获取用户+就诊人信息

⏱ ~600ms

公众号内部

确认默认就诊人和默认卡

RegRecordQuery

查询当日挂号数据

⏱ ~200ms 📋 点击查看详情

HIHIS平台

根据卡号查询HIS中当日的挂号记录

📥 入参 (2个)

参数名	类型	必填	说明	来源/去向
cardNo	String	可选	就诊卡号或身份证号	← 步骤①
deptCode	String	可选	科室代码(可选)

📤 出参 (3个)

参数名	类型	必填	说明	来源/去向
⭐ hisRegNo	String	可选	HIS就诊流水号	→ 步骤③⑤
deptName	String	可选	科室名称
ghsj	String	可选	挂号时间(yyyy-MM-dd)

PreChRegInfo

自费挂号预结算

⏱ ~500ms 📋 点击查看详情

HIHIS平台

计算挂号费用，返回待支付金额

📥 入参 (6个)

参数名	类型	必填	说明	来源/去向
orderId	String	可选	平台交易流水号	← 系统生成
└ associtePatNo	String	可选	患者ID	← 步骤①
└ cardNo	String	可选	就诊卡号	← 步骤①
└ hisRegNo	String	可选	HIS就诊号	← 步骤②
└ deptCode	String	可选	科室代码
└ totalMoney	Decimal	可选	挂号总金额

📤 出参 (3个)

参数名	类型	必填	说明	来源/去向
⭐ totalAmount	Decimal	可选	总金额
⭐ selfPay	Decimal	可选	自费金额	→ 步骤④支付金额
hisRegNo	String	可选	HIS挂号ID	→ 步骤⑤

微信JSAPI支付

公众号调起微信支付

⏱ ~2s 📋 点击查看详情

公众号内部

用户输入支付密码，支付全额挂号费。支付成功后获得 tradeNo(微信支付流水号)

📥 入参 (3个)

参数名	类型	必填	说明	来源/去向
amount	Decimal	可选	支付金额	← 步骤③ selfPay
orderId	String	可选	商户订单号
channel	String	可选	支付渠道(wechat)

📤 出参 (2个)

参数名	类型	必填	说明	来源/去向
⭐ tradeNo	String	可选	微信支付流水号	→ 步骤⑤ payInfo.tradeNo
orderNo	String	可选	第三方支付订单号

ChRegInfo

自费挂号结算确认

⏱ ~300ms 📋 点击查看详情

HIHIS平台

将支付凭证传给HIS完成挂号结算

📥 入参 (6个)

参数名	类型	必填	说明	来源/去向
orderId	String	可选	平台交易流水号
patInfo	Object	可选	患者信息(同预结算)
regInfo	Object	可选	就诊信息(同预结算)
└ orderNo	String	可选	支付订单号	← 步骤④
⭐ └ tradeNo	String	可选	微信支付流水号	← 步骤④
└ channel	String	可选	支付渠道(wechat)

📤 出参 (3个)

参数名	类型	必填	说明
⭐ hisRegNo	String	可选	HIS挂号ID
jzpdh	String	可选	就诊排队号
⭐ hisghfp	String	可选	HIS挂号发票号

📋 当日挂号 · 医保流程

医保先分解费用(统筹+个账+自费)，用户仅支付自费部分，结算后需状态查询兜底确认

涉及: 公众号内部 2个 · HIHIS平台 4个 · 接口总数 6个

⚠️ 医保接口耗时较长(预结算~3s)，需加超时重试。ecQrChannel=3(随申办)时不返回payOrdId/payToken。

getFullUser

获取用户+就诊人信息

⏱ ~600ms

公众号内部

确认就诊人绑定了医保卡

RegRecordQuery

查询当日挂号数据

⏱ ~200ms

HIHIS平台

同自费流程

PreRegSettlement

医保挂号预结算

⏱ ~3s 📋 点击查看详情

HIHIS平台

调用医保接口分解费用：统筹支付+个人账户支付+自费现金。返回支付令牌供后续使用

📥 入参 (11个)

参数名	类型	必填	说明	来源/去向
orderId	String	可选	平台交易流水号	← 系统生成
⭐ ecQrCode	String	可选	医保电子凭证二维码	← 用户刷码
ecQrChannel	String	可选	渠道(2=微信,3=随申办)	← 配置
payAuthNo	String	可选	支付授权码
acctUsedFlag	String	可选	个人账户标志(1=使用)	← 默认1
└ cardNo	String	可选	就诊卡号	← 步骤①
└ cardType	String	可选	卡类型(1=社保卡)
└ associtePatNo	String	可选	患者ID	← 步骤①
└ deptCode	String	可选	科室代码
└ deptClassify	String	可选	科室类型(100=普通门诊)
⭐ └ totalMoney	Decimal	可选	挂号总金额

6/11

📤 出参 (7个)

参数名	类型	必填	说明	来源/去向
⭐ totalAmount	Decimal	可选	总金额
⭐ insurancePay	Decimal	可选	医保统筹支付
psnAcctPay	Decimal	可选	个人账户支付
fundPay	Decimal	可选	基金支付
⭐ selfPay	Decimal	可选	自费金额→下一步支付	→ 步骤④支付金额
payOrdId	String	可选	支付订单号	→ 步骤⑤
payToken	String	可选	支付令牌	→ 步骤⑤

6/7

💡 ⚠️ ecQrChannel=3(随申办)时不返回payOrdId/payToken，需走不同支付流程

微信JSAPI支付

微信支付(仅自费部分)

⏱ ~2s

公众号内部

用户仅支付 selfPay 金额(如6元)。医保统筹+个账部分由系统自动扣减，用户无需操作

💡 ⚠️ 支付金额 ≠ 总金额(totalAmount)，仅支付 selfPay 部分

RegSettlement

医保挂号结算确认

⏱ ~300ms 📋 点击查看详情

HIHIS平台

将预结算返回的 payOrdId/payToken 传给HIS完成医保结算

📥 入参 (5个)

参数名	类型	必填	说明	来源/去向
orderId	String	可选	平台交易流水号
patInfo(同预结算)	Object	可选	患者信息
regInfo(同预结算)	Object	可选	就诊信息(hisRegNo需用预结算返回的值)
payOrdId	String	可选	支付订单号	← 步骤③
payToken	String	可选	支付令牌	← 步骤③

📤 出参 (4个)

参数名	类型	必填	说明	来源/去向
hisRegNo	String	可选	HIS挂号ID
⭐ idMedstoe	String	可选	结算记录ID	→ 步骤⑥
orderNo	String	可选	为空=无需额外支付
sqzzbz	String	可选	社区转诊标志(0=非转诊)

ChStateQuery

医保状态查询(兜底确认)

⏱ ~900ms 📋 点击查看详情

HIHIS平台

医保结算可能超时或前端未收到确认，调用此接口查询最终状态获取排队号和发票号

📥 入参 (4个)

参数名	类型	必填	说明	来源/去向
orderId	String	可选	订单号
idMedstoe	String	可选	结算记录ID	← 步骤⑤
payOrdId	String	可选	支付订单号	← 步骤⑤
payToken	String	可选	支付令牌	← 步骤⑤

📤 出参 (3个)

参数名	类型	必填	说明
hisId	String	可选	HIS流水号
⭐ jzpdh	String	可选	就诊排队号
⭐ hisghfp	String	可选	HIS挂号发票号

📋 门诊缴费 · 自费流程

全额自费支付处方费用，无医保分解

涉及: HIHIS平台 4个 · 公众号内部 1个 · 接口总数 5个

⚠️ 需双院区分别查询待缴费列表。处方明细中字段名有尾部空格bug('patAge '→需trim)

GetOutpPresc

获取待缴费订单列表(双院区)

⏱ ~200ms 📋 点击查看详情

HIHIS平台

需分别查询42501633102(南院)和42501633100(总院)，合并结果

📥 入参 (5个)

参数名	类型	必填	说明	来源/去向
cardType	String	可选	卡类型	← 2=统一自费就诊卡
cardNum	String	可选	卡号或身份证号
idcardNo	String	可选	身份证号
startTime	String	可选	开始日期(yyyy-MM-dd)
endTime	String	可选	结束日期

📤 出参 (4个)

参数名	类型	必填	说明	来源/去向
└ hisRegNo	String	可选	HIS挂号流水号	→ 步骤②
└ deptName	String	可选	科室名称
└ presCount	Int	可选	处方数量
⭐ └ orderTotal	Decimal	可选	订单总额

GetOutpPrescDetails

获取处方明细

⏱ ~150ms 📋 点击查看详情

HIHIS平台

根据挂号流水号获取费用明细，⚠️返回字段名有尾部空格bug

📥 入参 (3个)

参数名	类型	必填	说明	来源/去向
hisRegNo	String	可选	HIS就诊号	← 步骤①
cardNum	String	可选	就诊卡号
patId	String	可选	患者ID

📤 出参 (4个)

参数名	类型	必填	说明
└ itemName	String	可选	药品/项目名称
└ num	Float	可选	数量
└ retaPrice	Float	可选	零售单价
└ prescDoctName	String	可选	开方医生

💡 ⚠️ 'patAge '、'patType '、'patGender ' 字段名末尾有空格，解析需trim！

PreChPresInfo

自费收费预结算

⏱ ~500ms 📋 点击查看详情

HIHIS平台

计算处方总费用

📥 入参 (4个)

参数名	类型	必填	说明
orderId	String	可选	平台交易流水号
patInfo	Object	可选	患者信息
regInfo	Object	可选	就诊信息
presInfo[]	Array	可选	处方明细列表(presSn/groupNo/itemCode/itemName/num/retaPrice)

📤 出参 (2个)

参数名	类型	必填	说明	来源/去向
⭐ totalAmount	Decimal	可选	总金额
⭐ selfPay	Decimal	可选	自费金额	→ 步骤④

微信JSAPI支付

微信支付全额

⏱ ~2s

公众号内部

支付全额处方费用

ChPresInfo

自费收费结算确认

⏱ ~300ms 📋 点击查看详情

HIHIS平台

传入支付凭证完成结算

📥 入参 (2个)

参数名	类型	必填	说明	来源/去向
orderId/payInfo	Object	可选	含tradeNo/amount/channel
patInfo/regInfo/presInfo	Object	可选	同预结算

📤 出参 (2个)

参数名	类型	必填	说明	来源/去向
chargeId	String	可选	收费ID
idMedstoe	String	可选	结算记录ID

参数名	类型	必填	说明	来源/去向
totalAmount	Decimal	可选	总金额
insurancePay	Decimal	可选	医保统筹支付
fundPay	Decimal	可选	基金支付
psnAcctPay	Decimal	可选	个人账户支付
⭐ selfPay	Decimal	可选	自费金额→支付	→ 步骤④
payOrdId/payToken	String	可选	支付令牌	→ 步骤⑤

🛏️

住院业务

该模块业务待补充，后续可在此添加住院相关流程（入院登记、住院缴费、出院结算、住院报告等）

👆

请选择上方业务流程

点击一个流程按钮查看详细接口调用链和真实数据

📋 我的预约 · 自费流程

基于默认自费卡查询预约列表，包含南院+北院双院区的所有预约记录

涉及: 公众号内部 2个 · 公众号代理(聚合) 1个 · 接口总数 3个

getFullUser

获取用户+就诊人信息

⏱ ~600ms

公众号内部

获取userId和默认就诊人，确认当前使用的就诊卡(自费卡DZ1000000011947)

getFull

获取用户简要信息

⏱ ~200ms

公众号内部

多次调用刷新用户状态，含medicalCardType字段

getBookingList → 延华 Service.BookingList

公众号代理 → 延华SOAP查询预约

⏱ ~600ms 📋 点击查看详情

公众号代理(聚合)

BusCenter /api/Booking/getBookingList 底层调用延华SOAP Service.BookingList。延华返回Xml格式预约数据，BusCenter转换为JSON。支持双院区、多时间范围。同一张卡在不同HIS有不同记录。

📥 入参 (5个)

参数名	类型	必填	说明	来源/去向
medicalCard	String	可选	就诊卡号	← 默认卡DZ1000000011947
medicalCardType	String	可选	2=自费卡
startTime	String	可选	开始日期(默认+3个月)
endTime	String	可选	结束日期
branchCode	String	可选	空=全部院区

📤 出参 (9个)

参数名	类型	必填	说明
└ bookingId	String	可选	预约ID(平台8288...或北院1033...)
└ branchName	String	可选	院区名称
⭐ └ nodeName	String	可选	科室名称
└ doctorName	String	可选	医生姓名
⭐ └ classDate	String	可选	就诊日期
└ period	String	可选	就诊时段
⭐ └ price	Decimal	可选	费用
└ status	Int	可选	0=已预约/2=已就诊/3=已过期/8=已取消
└ reservationSource	String	可选	预约渠道(官微/公众号/系统渠道)

6/9

📋 真实调用示例

📥 请求 (Request)

// 第一次查询：默认3个月范围
POST /api/Booking/getBookingList
{
  "medicalCard": "DZ1000000011947",
  "startTime": "2026-06-16",
  "endTime": "2026-09-14",
  "branchCode": ""
}

// 第二次查询：近1个月范围
{
  "medicalCard": "DZ1000000011947",
  "startTime": "2026-06-01",
  "endTime": "2026-06-30",
  "branchCode": ""
}

📤 响应 (Response)

// 第1次查询返回8条，第2次返回24条
{
  "code": 0,
  "data": {
    "bookingList": [{
      "bookingId": "828844103279575040",
      "branchName": "东方医院南院",
      "nodeName": "呼吸内科正",
      "name": "李华",
      "doctorName": "郭忠良",
      "classDate": "2026-06-17",
      "period": "15:30-16:00",
      "price": 50.0,
      "status": 2,
      "reservationSource": "上海市东方医院公众号"
    }, {
      "bookingId": "829083377933484032",
      "branchName": "东方医院南院",
      "nodeName": "心血管内科特需3",
      "doctorName": "李昕",
      "classDate": "2026-06-16",
      "period": "15:00-15:30",
      "price": 300.0,
      "status": 2,
      "reservationSource": "上海市东方医院公众号"
    }, ...]
  }
}
// status: 0=已预约(可取消), 2=已就诊, 3=已过期, 8=已取消
// 南院bookingId格式: 8开头的18位数字
// 北院bookingId格式: 103开头的短数字

📋 我的挂号 · 自费流程

从公众号BusCenter和HIS两路查询挂号记录并合并展示

涉及: 公众号内部 1个 · 公众号代理(聚合) 1个 · HIHIS平台 2个 · 接口总数 4个

⚠️ 挂号查询需同时查3台HIS(南院+本院+预发布)，每个院区又有多个MZID(同一患者在不同HIS实例有不同门诊ID)，最终结果需去重合并。

getFullUser

获取用户+就诊人信息

⏱ ~600ms

公众号内部

确认当前默认就诊人和默认卡

getRegList → 延华+HIHIS聚合

公众号聚合延华+HIS挂号数据

⏱ ~600ms 📋 点击查看详情

公众号代理(聚合)

BusCenter /api/Registration/getRegList 聚合了延华SOAP(Extra.VisitInfo)和HIHIS(RegRecordQuery)两路数据。先查当天(无结果)→再查整月。返回合并去重后的挂号记录。

📥 入参 (5个)

参数名	类型	必填	说明	来源/去向
medicalCard	String	可选	就诊卡号	← DZ1000000011947
medicalCardType	String	可选	2=自费卡
startTime	String	可选	开始日期
endTime	String	可选	结束日期
branchCode	String	可选	空=全部

📤 出参 (7个)

参数名	类型	必填	说明
└ regId	String	可选	挂号ID
⭐ └ nodeName	String	可选	科室名称
└ doctorName	String	可选	医生姓名
└ classDate	String	可选	就诊日期
⭐ └ serviceType	String	可选	号别(普通/专家/特需/专科)
⭐ └ totalAmt	Decimal	可选	总金额
└ branchAddress	String	可选	院区地址

6/7

📋 真实调用示例

📥 请求 (Request)

// 先查今天(无结果)
POST /api/Registration/getRegList
{
  "medicalCard": "DZ1000000011947",
  "startTime": "2026-06-16",
  "endTime": "2026-06-16",
  "branchCode": ""
}
// ⬆ 返回: {"code":0,"data":{"regList":[]}}

// 再查整月
{
  "medicalCard": "DZ1000000011947",
  "startTime": "2026-06-01",
  "endTime": "2026-06-30",
  "branchCode": ""
}

📤 响应 (Response)

{
  "code": 0,
  "data": {
    "regList": [{
      "regId": "123652858",
      "branchAddress": "北院(即墨路150号)",
      "nodeName": "神经内科副",
      "doctorName": "肖亚平",
      "classDate": "2026-06-04",
      "serviceType": "专家门诊",
      "totalAmt": "40.00"
    }, {
      "regId": "825086371061829632",
      "branchAddress": "南院(云台路1800号)",
      "nodeName": "肿瘤科特需3*",
      "doctorName": "李群",
      "classDate": "2026-06-05",
      "serviceType": "特需",
      "totalAmt": "300.00"
    }, ...]
  }
}
// 北院regId: 短数字; 南院regId: 8开头长数字
// 返回14条记录，涵盖普通(¥25)、专家(¥40-50)、特需(¥200-300)

getBrdaMz → HIHIS commonQuery

HIHIS通用查询→HIS查门诊档案

⏱ ~30ms 📋 点击查看详情

HIHIS平台

通过HIHIS通用查询接口 /common/commonQuery(method=getBrdaMz) 直连HIS。三台HIS分别查询：172.31.10.34(南院) + 192.168.3.136(本院) + hihispre(预发布)。每台返回该院区的MZID。

📥 入参 (4个)

参数名	类型	必填	说明
SFZH	String	可选	身份证号
MZHM	String	可选	就诊卡号
branchId	String	可选	院区代码(42501633102/42501633100)
method	String	可选	固定:getBrdaMz

📤 出参 (3个)

参数名	类型	必填	说明
⭐ └ MZID	String	可选	门诊患者ID(HIS内部)
└ BRXM	String	可选	患者姓名
└ XZMC	String	可选	费用性质(自费/新医保)

📋 真实调用示例

📥 请求 (Request)

// 南院
{"SFZH":"350128199209203275","MZHM":"DZ1000000011947","branchId":"42501633102","method":"getBrdaMz"}
// 本院
{"SFZH":"350128199209203275","MZHM":"DZ1000000011947","branchId":"42501633100","method":"getBrdaMz"}
// 预发布
{"SFZH":"350128199209203275","MZHM":"DZ1000000011947","branchId":"42501633102","method":"getBrdaMz"}

📤 响应 (Response)

// 南院: {"code":"0","data":[{"MZID":"1202477048","BRXM":"李华","XZMC":"自费"}]}
// 本院: {"code":"0","data":[{"MZID":"1202477049","BRXM":"李华","XZMC":"自费"}]}
// 预发布: {"code":"200","data":[{"MZID":"805971612515176448","BRXM":"李华"},{"MZID":"803795254691233792","BRXM":"李华"}]}
// ⚠️ 预发布环境同一患者可能有多个MZID!

getGhjlMz → HIHIS commonQuery

HIHIS通用查询→HIS查挂号记录

⏱ ~500ms 📋 点击查看详情

HIHIS平台

通过HIHIS通用查询接口 /common/commonQuery(method=getGhjlMz) 直连HIS数据库。每个MZID查一次→返回该院区该患者的所有挂号记录。字段名因HIS版本不同有差异(南院用GHSJ/本院用时间戳等)。

📥 入参 (4个)

参数名	类型	必填	说明	来源/去向
MZID	String	可选	门诊患者ID	← getBrdaMz
branchId	String	可选	院区代码
clinicDateStart/End	String	可选	日期范围
method	String	可选	固定:getGhjlMz

📤 出参 (8个)

参数名	类型	必填	说明
⭐ └ GHSJ	String	可选	挂号时间戳
⭐ └ GHKSMC	String	可选	挂号科室名称
└ YSXM	String	可选	医生姓名
⭐ └ ZJE	Decimal	可选	总金额
⭐ └ GHLBMC	String	可选	号别(普通/专家/特需/专科)
⭐ └ hisRegNo	String	可选	HIS挂号流水号
└ THBZ	String	可选	退号标志(1=正常)
└ CardNo	String	可选	实际使用的就诊卡号

6/8

📋 真实调用示例

📥 请求 (Request)

// 南院MZID=1202477048 查6月
{"MZID":"1202477048","clinicDateStart":"2026/06/01","clinicDateEnd":"2026/06/30","method":"getGhjlMz","branchId":"42501633102"}

📤 响应 (Response)

// 南院返回9条:
[{"GHSJ":"2026-06-05","ZJE":"300.00","GHKSMC":"肿瘤科特需3*","GHLBMC":"特需","hisRegNo":"825086371061829632","YSXM":"李群","THBZ":"1","CardNo":"DZ1000000011947","ChargeId":"825086434464501760"},
 {"GHSJ":"2026-06-05","ZJE":"25.00","GHKSMC":"甲亢甲减","GHLBMC":"专科","hisRegNo":"825086721521090560","THBZ":"1","CardNo":"DZ1000000011947"},
 {"GHSJ":"2026-06-04","ZJE":"40.00","GHKSMC":"呼吸内科副","GHLBMC":"专家","hisRegNo":"824753707490476032","YSXM":"刘美璇","CardNo":"6022199030"}]
// ⚠️ 同一次会话可能使用不同卡(自费卡DZ1000... vs 医保卡6022...)

📋 我的缴费 · 自费流程

自费患者查待缴费处方记录

涉及: 公众号内部 2个 · 公众号代理(聚合) 1个 · HIHIS平台 2个 · 接口总数 5个

⚠️ 缴费查询分两路：公众号BusCenter (Recipe/toPayList + Recipe/getPayList) 和 HIS直连 (GetOutpPresc × 双院区 × 多MZID)。当前测试环境无待缴费数据。

getFullUser

获取用户+就诊人信息

⏱ ~600ms

公众号内部

确认默认就诊卡

Recipe/toPayList → 聚合HIS数据

公众号聚合查待缴费

⏱ ~300ms 📋 点击查看详情

公众号代理(聚合)

BusCenter /api/Recipe/toPayList 聚合HIS待缴费数据。底层可能调用HIHIS GetOutpPresc或延华接口获取待缴费列表。

📥 入参 (3个)

参数名	类型	必填	说明	来源/去向
medicalCard	String	可选	就诊卡号	← DZ1000000011947
startTime	String	可选	开始日期
endTime	String	可选	结束日期

📤 出参 (1个)

参数名	类型	必填	说明	来源/去向
RecipeList	Array	可选	待缴费处方列表

📋 真实调用示例

📥 请求 (Request)

POST /api/Recipe/toPayList
{"medicalCard":"DZ1000000011947","startTime":"2026-06-15","endTime":"2026-06-16"}

📤 响应 (Response)

{"code":0,"data":{"RecipeList":[]},"msg":"请求成功"}
// 当前测试环境无待缴费数据

Recipe/getPayList

公众号查已缴费记录

⏱ ~300ms 📋 点击查看详情

公众号内部

查近1月(6月)→近5月(5月)的已缴费记录

📥 入参 (3个)

参数名	类型	必填	说明
medicalCard	String	可选	就诊卡号
category	String	可选	Recipe=处方缴费
startTime/endTime	String	可选	日期范围

📋 真实调用示例

📥 请求 (Request)

// 查6月
{"medicalCard":"DZ1000000011947","startTime":"2026-06-01","endTime":"2026-06-30","branchCode":""}
// 查5月
{"medicalCard":"DZ1000000011947","startTime":"2026-05-01","endTime":"2026-05-31","branchCode":""}

📤 响应 (Response)

{"code":0,"data":{"recipeList":[]},"msg":"请求成功"}

getBrdaMz

HIS查门诊患者档案

⏱ ~30ms x 3台

HIHIS平台

同挂号流程，三台HIS并发查

GetOutpPresc → HIHIS /hcenter/GetOutpPresc

HIHIS查待缴费处方(双院区)

⏱ ~50ms x 2院区 📋 点击查看详情

HIHIS平台

通过HIHIS接口 /hcenter/GetOutpPresc 分别查南院(42501633102)和本院(42501633100)。HIHIS直连HIS获取门诊待缴费处方列表。预发布环境额外再查一次(不同MZID需分次查询)。

📥 入参 (5个)

参数名	类型	必填	说明
branchId	String	可选	院区代码
cardType	String	可选	2=自费卡
cardNum	String	可选	就诊卡号
idcardNo	String	可选	身份证号
startTime/endTime	String	可选	日期范围(yyyy-MM-dd)

📤 出参 (2个)

参数名	类型	必填	说明	来源/去向
regInfo	Array	可选	待缴费挂号记录
feeInfo	Array	可选	费用明细

📋 真实调用示例

📥 请求 (Request)

// 南院
{"branchId":"42501633102","cardType":"2","cardNum":"DZ1000000011947","idcardNo":"350128199209203275","startTime":"2026-06-15","endTime":"2026-06-16"}

📤 响应 (Response)

// 南院响应: {"code":"0","msg":"未查到数据"}
// 本院响应: {"code":"0","msg":"未查到数据"}
// 预发布: {"code":"-1","msg":"卡号:DZ1000000011947未查到就诊信息"}
// 当前测试账号无待缴费处方

📋 检查报告 · 检查流程

邢秋丽检查报告：妇科超声、胎儿筛查、心电图、MRI等共27条

涉及: 公众号内部 1个 · 延华SOAP 2个 · 接口总数 3个

⚠️ idKeyGuid含"EMPTY"的是占位记录，正式版不含EMPTY。同一reportId可能有EMPTY版和正式版两个idKeyGuid。

getReportType

获取报告类型(纯内部)

⏱ ~20ms 📋 点击查看详情

公众号内部

返回报告大类: 01=检查报告(延华PACS), 02=检验报告(延华LIS)。前端据此展示Tab。无后端调用，纯配置返回。

📥 入参 (1个)

参数名	类型	必填	说明	来源/去向
branchCode	String	可选	院区(空=全部)

📤 出参 (2个)

参数名	类型	必填	说明	来源/去向
⭐ └ reportTypeCode	String	可选	01=检查/02=检验
└ reportTypeName	String	可选	中文名

📋 真实调用示例

📥 请求 (Request)

POST /api/Report/getReportType
{"branchCode":""}

📤 响应 (Response)

{"code":0,"data":{"reportTypeList":[{"reportTypeCode":"01","reportTypeName":"检查报告"},{"reportTypeCode":"02","reportTypeName":"检验报告"}]}}

getReportList(01) → 延华 GetLisReport/PacsReport

公众号代理 → 延华查检查报告

⏱ ~1.5s 📋 点击查看详情

延华SOAP

BusCenter /api/Report/getReportList(reportTypeCode=01) 底层调用延华SOAP获取检查报告(超声/心电图/MRI等)。延华再从PACS/HIS系统提取数据。先查近1月(无结果)→再查近1年(27条)。

📥 入参 (6个)

参数名	类型	必填	说明	来源/去向
reportTypeCode	String	可选	01=检查报告
medicalCard	String	可选	就诊卡号	← 143606074607811
cardNo	String	可选	身份证号	← 411527199202135049
ptName	String	可选	患者姓名	← 邢秋丽
startTime	String	可选	开始日期
endTime	String	可选	结束日期

📤 出参 (4个)

参数名	类型	必填	说明	来源/去向
⭐ └ reportName	String	可选	报告名称
⭐ └ reportId	String	可选	报告ID(NYJC开头=南院检查)
└ reportTime	String	可选	报告日期
⭐ └ idKeyGuid	String	可选	报告唯一键(查详情用)	→ getReportInfo

📋 真实调用示例

📥 请求 (Request)

// 第1次：查1个月范围(无结果)
{"reportTypeCode":"01","medicalCard":"143606074607811","ptName":"邢秋丽","cardNo":"411527199202135049","startTime":"2026-06-01","endTime":"2026-06-30"}

// 第2次：扩大到1年(有数据)
{"reportTypeCode":"01","medicalCard":"143606074607811","ptName":"邢秋丽","cardNo":"411527199202135049","startTime":"2025-06-16","endTime":"2026-06-16"}

📤 响应 (Response)

// 返回27条检查报告:
[{"reportName":"妇科彩色超声常规（经阴道）","reportId":"NYJC260603302222","reportTime":"2026-06-10","idKeyGuid":"NYJC260603302222_NYJC260603302222_e72e..."},
 {"reportName":"常规心电图检查(心电图室检查)","reportId":"NYJC260413003841","reportTime":"2026-04-13"},
 {"reportName":"头颅+脑弥散功能成像(DWI)(MRI平扫)","reportId":"NYJC260407003274","reportTime":"2026-04-08"},
 {"reportName":"胎儿畸形筛查-单胎（3楼特需超声）","reportId":"NYJC260603300554","reportTime":"2026-06-03"},
 {"reportName":"脱落细胞【妇科】","reportId":"NYBLSQ2026030400035","reportTime":"2026-03-05"}]
// NYJC=南院检查, NYBLSQ=南院病理申请

getReportInfo(01) → 延华 GetReportDetail

公众号代理 → 延华查报告详情

⏱ ~30ms 📋 点击查看详情

延华SOAP

BusCenter /api/Report/getReportInfo(reportTypeCode=01) 底层调用延华SOAP获取报告详情。返回checkDetail(检查所见+诊断结果)。数据最终来源：PACS/超声/内镜等检查系统。

📥 入参 (4个)

参数名	类型	必填	说明	来源/去向
reportId	String	可选	报告ID	← 列表选中
idKeyGuid	String	可选	唯一键	← 列表选中
reportTypeCode	String	可选	01=检查
branchCode	String	可选	院区(空)

📤 出参 (4个)

参数名	类型	必填	说明
⭐ └ result	String	可选	检查所见
⭐ └ resultDesc	String	可选	诊断结果
└ checkNodeName	String	可选	检查科室
germDetail	Object	可选	null=检查报告无微生物数据

📋 真实调用示例

📥 请求 (Request)

POST /api/Report/getReportInfo
{"reportId":"NYJC260603302222","idKeyGuid":"NYJC260603302222_NYJC260603302222_e72e0e68d6834463b37aa6963c4e4c99","reportTypeCode":"01","branchCode":""}

📤 响应 (Response)

{"code":0,"data":{"checkDetail":{"result":"宫颈呈"T"型，内口无分离","checkNodeName":"妇产超声科","resultDesc":"孕妇宫颈长41.1mm，颈管呈"T"型，内口无分离。CDFI：未见明显异常血流信号。"},"resultList":[],"germDetail":null}}

📋 检验报告 · 检验流程

邢秋丽检验报告：血细胞分析、尿液分析、PCT、D-Dimer等共18条

涉及: 公众号内部 1个 · 延华SOAP 2个 · 接口总数 3个

⚠️ getReportList(02)返回的列表中inspectTypeCode="1"为常规检验，"2"为微生物检验。查检验详情时需传inspectTypeCode。检验结果在resultList中，checkDetail为null。

getReportType

获取报告类型

⏱ ~20ms

公众号内部

返回01=检查, 02=检验

getReportList(02) → 延华 GetLisReport

公众号代理 → 延华查检验报告

⏱ ~1.5s 📋 点击查看详情

延华SOAP

BusCenter /api/Report/getReportList(reportTypeCode=02) 底层调用延华SOAP获取检验报告(血常规/尿常规/生化等)。延华从LIS系统提取。返回18条，inspectTypeCode: 1=常规检验, 2=微生物。按reportTime倒序。

📥 入参 (4个)

参数名	类型	必填	说明
reportTypeCode	String	可选	02=检验报告
inspectTypeCode	String	可选	null=全部(含常规+微生物)
medicalCard	String	可选	143606074607811
ptName	String	可选	邢秋丽

📤 出参 (4个)

参数名	类型	必填	说明
⭐ └ reportName	String	可选	检验项目名称
⭐ └ reportId	String	可选	报告ID(纯数字)
⭐ └ inspectTypeCode	String	可选	1=常规检验/2=微生物
└ branchId	String	可选	2=南院(微生物专属)

📋 真实调用示例

📥 请求 (Request)

POST /api/Report/getReportList
{"reportTypeCode":"02","medicalCard":"143606074607811","ptName":"邢秋丽","cardNo":"411527199202135049","startTime":"2026-06-01","endTime":"2026-06-30"}

📤 响应 (Response)

// 返回18条检验报告:
[{"reportName":"一般细菌培养及鉴定(中段尿)","reportId":"27259245","inspectTypeCode":"2","branchId":"2"},
 {"reportName":"艰难梭菌核酸（DNA）检测","reportId":"27259217","inspectTypeCode":"1"},
 {"reportName":"血细胞分析,CRP","reportId":"27259114","inspectTypeCode":"1"},
 {"reportName":"PCT","reportId":"27259155","inspectTypeCode":"1"},
 {"reportName":"急诊尿液分析(尿9联及以上)","reportId":"27259201","inspectTypeCode":"1"},
 {"reportName":"急诊D-Dimer","reportId":"27259163","inspectTypeCode":"1"},
 {"reportName":"SAA,血细胞分析,CRP","reportId":"27237043","inspectTypeCode":"1"}]
// inspectTypeCode="1"→点进去看检验指标
// inspectTypeCode="2"→点进去看微生物药敏

getReportInfo(02) → 延华 GetReportDetail

公众号代理 → 延华查检验详情

⏱ ~70ms 📋 点击查看详情

延华SOAP

BusCenter /api/Report/getReportInfo(reportTypeCode=02, inspectTypeCode=1) 底层调用延华SOAP获取检验详情。返回resultList数组(24项指标)，每项含指标名、参考范围、实测值、异常标记(↑↓)、单位。数据源：LIS系统。

📥 入参 (4个)

参数名	类型	必填	说明	来源/去向
reportId	String	可选	报告ID	← 列表选中如27259114
idKeyGuid	String	可选	=reportId(检验报告无组合键)
reportTypeCode	String	可选	02=检验
⭐ inspectTypeCode	String	可选	1=常规检验

📤 出参 (5个)

参数名	类型	必填	说明
⭐ └ index	String	可选	检验指标名称
⭐ └ standard	String	可选	参考范围
⭐ └ result	String	可选	实测结果值
⭐ └ abnormal	String	可选	↑=偏高/↓=偏低/正常
└ resultUnit	String	可选	单位

📋 真实调用示例

📥 请求 (Request)

POST /api/Report/getReportInfo
{"reportId":"27259114","idKeyGuid":"27259114","reportTypeCode":"02","inspectTypeCode":"1"}

📤 响应 (Response)

{"code":0,"data":{"resultList":[
  {"index":"白细胞计数","standard":"3.5--9.5","result":"9.69","abnormal":"↑","resultUnit":"10^9/L"},
  {"index":"中性粒细胞百分比","standard":"40--75","result":"74.8","abnormal":"正常","resultUnit":"%"},
  {"index":"淋巴细胞百分比","standard":"20--50","result":"17.4","abnormal":"↓","resultUnit":"%"},
  {"index":"红细胞计数","standard":"3.8--5.1","result":"3.78","abnormal":"↓","resultUnit":"10^12/L"},
  {"index":"血红蛋白","standard":"115--150","result":"121","abnormal":"正常","resultUnit":"g/L"},
  {"index":"血小板计数","standard":"125--350","result":"220","abnormal":"正常","resultUnit":"10^9/L"},
  {"index":"快速C反应蛋白","standard":"0--6","result":"3.06","abnormal":"正常","resultUnit":"mg/L"}
  // ...共24项指标
],"checkDetail":null,"germDetail":null}}

📋 微生物报告 · 微生物流程

邢秋丽微生物报告：一般细菌培养及鉴定(中段尿)→粪肠球菌+10种抗生素药敏

涉及: 公众号内部 1个 · 延华SOAP 3个 · 接口总数 4个

⚠️ 微生物报告三个接口全部走延华SOAP。①列表：BusCenter代理→延华GetLisReport过滤inspectTypeCode=2 ②详情/药敏：BusCenter代理→延华GetMicrobeDetail ③补充鉴定：公众号直连延华SOAP getMicrobeReport。当前测试环境getMicrobeReport返回空。

getReportType

获取报告类型(纯内部)

⏱ ~20ms

公众号内部

纯内部配置返回01=检查, 02=检验。无后端调用。

getReportList(02) → 延华 GetLisReport

公众号代理 → 延华查检验列表(含微生物)

⏱ ~1.5s 📋 点击查看详情

延华SOAP

BusCenter /api/Report/getReportList(reportTypeCode=02) 底层调用延华SOAP GetLisReport获取检验报告列表。延华从LIS系统拉取数据，返回中包含inspectTypeCode="2"的微生物报告。如「一般细菌培养及鉴定(中段尿)」reportId=27259245, branchId=2(南院)。

📋 真实调用示例

📥 请求 (Request)

// 同检验报告列表
POST /api/Report/getReportList
{"reportTypeCode":"02","medicalCard":"143606074607811","ptName":"邢秋丽","startTime":"2026-06-01","endTime":"2026-06-30"}

📤 响应 (Response)

// inspectTypeCode="2" 的记录:
{"reportName":"一般细菌培养及鉴定(中段尿)","reportId":"27259245","inspectTypeCode":"2","branchId":"2"}
{"reportName":"一般细菌培养及鉴定(中段尿)","reportId":"27237099","inspectTypeCode":"2","branchId":"2"}
{"reportName":"一般细菌培养及鉴定","reportId":"27241505","inspectTypeCode":"2","branchId":"2"}

getReportInfo(02,inspType=2) → 延华 GetMicrobeDetail

公众号代理 → 延华查微生物药敏

⏱ ~260ms 📋 点击查看详情

延华SOAP

BusCenter /api/Report/getReportInfo(reportTypeCode=02, inspectTypeCode=2) 底层调用延华SOAP获取微生物培养+药敏结果。返回germDetail含菌种鉴定+抗生素药敏列表(MIC值/抑菌圈/敏感度)。数据源：LIS微生物模块。

📥 入参 (3个)

参数名	类型	必填	说明
reportId	String	可选	27259245
reportTypeCode	String	可选	02=检验
⭐ inspectTypeCode	String	可选	2=微生物

📤 出参 (5个)

参数名	类型	必填	说明
⭐ └ germCheckResult	String	可选	菌种鉴定结果
⭐ └ antibiotics	String	可选	抗生素名称
⭐ └ sensitivity	String	可选	敏感/中介/耐药
└ mic	String	可选	MIC值(最低抑菌浓度)
└ rad	String	可选	抑菌圈直径(mm)

📋 真实调用示例

📥 请求 (Request)

POST /api/Report/getReportInfo
{"reportId":"27259245","idKeyGuid":"27259245","reportTypeCode":"02","inspectTypeCode":"2"}

📤 响应 (Response)

{"code":0,"data":{"germDetail":{
  "germCheckResult":"粪肠球菌(D群)[strfae]",
  "germMicrobeItemDetail":[
    {"antibiotics":"氨苄西林","sensitivity":"敏感","mic":"<=2","rad":""},
    {"antibiotics":"苄青霉素","sensitivity":"敏感","mic":"2","rad":""},
    {"antibiotics":"万古霉素","sensitivity":"敏感","mic":"<=0.5","rad":""},
    {"antibiotics":"利奈唑胺","sensitivity":"敏感","mic":"2","rad":""},
    {"antibiotics":"替考拉宁","sensitivity":"敏感","mic":"<=0.5","rad":""},
    {"antibiotics":"达托霉素","sensitivity":"中介","mic":"4","rad":""},
    {"antibiotics":"呋喃妥因","sensitivity":"敏感","mic":"","rad":"25"},
    {"antibiotics":"左氧氟沙星","sensitivity":"耐药","mic":">=8","rad":""},
    {"antibiotics":"高浓度庆大霉素","sensitivity":"耐药","mic":"SYN-R","rad":""},
    {"antibiotics":"磷霉素","sensitivity":"敏感","mic":"","rad":"20"}
  ]
}}}

getMicrobeReport → 延华SOAP直连

公众号直连延华SOAP查微生物鉴定

⏱ ~200ms 📋 点击查看详情

延华SOAP

公众号不经过BusCenter代理，直连延华SOAP端点 http://service.yhzn.com。按就诊卡号查询微生物鉴定原始结果(菌种名称、标本类型等)。返回JSON包裹在SOAP Envelope中。与getReportInfo互补：getMicrobeReport返回菌种鉴定原始数据，getReportInfo(inspType=2)返回药敏结果。

📥 入参 (1个)

参数名	类型	必填	说明	来源/去向
cardNo	String	可选	就诊卡号	← 143606074607811

📤 出参 (2个)

参数名	类型	必填	说明	来源/去向
result	Array	可选	微生物报告列表
resultCode	String	可选	T/F

📋 真实调用示例

📥 请求 (Request)

// SOAP XML 请求
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ser:getMicrobeReport xmlns:ser="http://service.yhzn.com">
      <cardNo>143606074607811</cardNo>
    </ser:getMicrobeReport>
  </soap:Body>
</soap:Envelope>

📤 响应 (Response)

// SOAP XML 响应
<soap:Envelope>
  <soap:Body>
    <ns2:getMicrobeReportResponse>
      <return>{"result":[],"resultCode":"T"}</return>
    </ns2:getMicrobeReportResponse>
  </soap:Body>
</soap:Envelope>
// resultCode="T"=调用成功但无数据(该患者当前无未收录的微生物报告)

🎨 颜色图例 — 对应接口文档

公众号内部BusCenter .NET WebAPI — /api/* — 纯内部逻辑(如getToken/getFullUser)

延华SOAP延华预约/报告系统 — SOAP/XML — Entity/Booking/Service/GetLisReport/PacsReport/MicrobeReport

HIHIS平台医院HIS集成平台 — REST — /hcenter/* /common/* — 患者档案/挂号/收费/病历

公众号代理聚合/转发层 — BusCenter聚合转发到延华或HIHIS(如getBookingList→延华,getRegList→HIS)

📱 公众号内部接口速查

其他

接口功能说明频率关联流程

** 新入职开发/运维/测试人员 - 展开

东方医院公众号业务接口对接文档

适用对象： 新入职开发/运维/测试人员
编写日期： 2026-06-15
数据来源： 2026-06-14 全天生产日志（100万+行）+ HIS接口文档 + 延华预约平台文档
业务背景： 上海市东方医院微信公众号（含总院+南院双院区），为患者提供在线预约挂号、门诊缴费、查报告、住院服务等就医功能

⚠️ 阅读前必读 — 文档 vs 实际 **接口文档仅作参考，实际入出参以接口调用日志为准！** 经对比验证，HIS接口文档与生产日志存在显著差异。典型例子： | 对比维度 | HIS接口文档描述 - 展开

接口文档仅作参考，实际入出参以接口调用日志为准！

经对比验证，HIS接口文档与生产日志存在显著差异。典型例子：

对比维度	HIS接口文档描述	生产日志实际
dept 出参	`idscda, gzrq, doctorCode, doctorName, zblb...`	`deptName, flxh, sortId, mzksNa, ghlb, ksdz, mzks, pydm...`
queryzyjzjl 出参	`bahm, zyh, brxm, zysdm, zzys...` (小写拼音)	`BAHM, ZYID, BRXM, ZRYSDM, ZZYS...` (大写缩写)
状态码	`200`=成功 (UnitedResultDTO)	部分接口返回 `0`=成功, 部分 `"0"`=成功

因此本文档所有字段说明均以日志实际抓取为准，接口文档仅作补充参考。如果你发现本文档与接口文档不一致，以本文档（即日志实际数据）为准。

目录 1. [系统架构全景图](#1-系统架构全景图) 2. [对接方与服务器环境](#2-对接方与服务器环境) 3. [核心业务流程（附真实日志）](#3-核心业务 - 展开

系统架构全景图
对接方与服务器环境
核心业务流程（附真实日志）
公众号内部接口详解（BusCenter）
平台→HIS接口详解
延华预约平台接口详解
双院区查询模式详解
医保业务专项说明
微信模板消息推送
卡拦截规则服务
完整字典表
日志文件结构与排查指南
常见错误速查表
开发调试建议

1.1 物理架构

接口	功能说明	频率	关联流程

1.2 数据流转层次

接口	功能说明	频率	关联流程

3.1 流程一：预约挂号（完整链路）

接口	功能说明	频率	关联流程

4.1 接口调用频次统计

接口功能说明频率关联流程

/api/User/getToken {} (空，基于微信session) - 展开

/api/User/getToken — 获取JWT访问令牌

请求参数: {} (空，基于微信session)
返回: {
  "code": 0,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "version": "1.0"
  }
}

JWT Payload 结构:
{
  "sub": "2",
  "CategoryCode": "wx",              ← 微信渠道
  "CusId": "91",                     ← 客户ID(东方医院)
  "UIServiceId": "gh_19aaa7139bb2",  ← 公众号AppId
  "OpenId": "oTba6uD...",            ← 微信用户OpenId
  "UserId": "oTba6uD...",
  "Version": "1.0",
  "AppCode": "wx0f4b5e2056ee8dba",
  "IsSecret": "1",
  "QIMAIUserId": "04D8CCBD10BF44BC892F0F31690B4B85"
}

/api/User/getFullUser — 获取用户完整信息

请求参数: {} (基于Token识别用户)
返回: {
  "code": 0,
  "data": {
    "userId": "4209765CCD4D48A2A16E56A3D52046D7",
    "patientList": [                    ← 就诊人列表
      {
        "name": "曹阳",
        "sex": "1",
        "mobile": "15026676319",
        "isDefault": "1",              ← 默认就诊人
        "cardType": "1",               ← 身份证
        "cardNo": "511002199608295615",
        "medicalcardList": [           ← 该就诊人绑定的就诊卡
          {
            "medicalCard": "K504A3D97",
            "isDefault": "1",
            "hisPid": "824870514680926208",  ← HIS患者ID
            "createTime": "2026/6/5 12:02:00"
          }
        ]
      }
    ]
  }
}

/api/User/addPatient | 接口 | 方法 | 说明 | |------|------|------| | `/api/User/addPatient` | POST | 添加就诊人（ - 展开

接口	方法	说明
`/api/User/addPatient`	POST	添加就诊人（姓名+身份证+手机号+关系）
`/api/User/updatePatient`	POST	修改就诊人信息
`/api/User/deletePatient`	POST	删除就诊人
`/api/User/bindCard`	POST	为就诊人绑定就诊卡
`/api/User/deleteCard`	POST	解绑就诊卡
`/api/User/setDefaultCard`	POST	设置某张卡为默认
`/api/User/cardInHis`	POST	检查卡号是否在HIS中存在
`/api/User/clickInsCard`	POST	一键绑卡（通过医保电子凭证）
`/api/User/getMiCardNo`	POST	通过医保电子凭证获取医保卡号
`/api/User/getSmSPhone`	POST	获取绑定的手机号
`/api/User/recordMI`	POST	记录医保使用日志
`/api/User/recordSF`	POST	记录随申办使用日志
`/api/User/bindingCancelApply`	POST	申请解绑就诊卡

/api/Booking/getBookingList | 接口 | 说明 | |------|------| | `/api/Booking/getBookingList` | 获取用户的预约记录列表 | | `/ - 展开

接口	说明
`/api/Booking/getBookingList`	获取用户的预约记录列表
`/api/Booking/alternateRegistration`	候补挂号（号源满了时排队候补）
`/api/Booking/getAlternateRecord`	获取候补记录
`/api/Booking/cancelAlternateRecord`	取消候补
`/api/Booking/getCacheParam`	获取预约缓存参数
`/api/Booking/getMedEvaDocotorInfo`	获取医生满意度评价信息

/api/Report/getReportType | 接口 | 日调用量 | 说明 | |------|---------|------| | `/api/Report/getReportType` | 14, - 展开

接口	日调用量	说明
`/api/Report/getReportType`	14,747	获取报告类型（检验/检查/病理等）
`/api/Report/getReportList`	39,220	获取某类型的报告列表
`/api/Report/getReportInfo`	16,523	获取具体报告的详情
`/api/Report/getMedicalReportList`	779	获取电子病历报告列表
`/api/Report/getMedicalReportDetail`	2	获取病历报告详情

/api/MedicalEva/outPatient | 接口 | 说明 | |------|------| | `/api/MedicalEva/outPatient` | 获取门诊评价列表 | | `/api/ - 展开

接口	说明
`/api/MedicalEva/outPatient`	获取门诊评价列表
`/api/MedicalEva/GetOutPatientDetail`	获取门诊评价详情
`/api/MedicalEva/AddOutPatient`	提交门诊评价
`/api/MedicalEva/inHosList`	获取住院评价列表
`/api/MedicalEva/getDetail`	获取评价详情
`/api/MedicalEva/AddInHosPatient`	提交住院评价

/api/System/getBaiduMap | 接口 | 说明 | |------|------| | `/api/System/getBaiduMap` | 获取百度地图导航（到医院路线） | | `/ - 展开

接口	说明
`/api/System/getBaiduMap`	获取百度地图导航（到医院路线）
`/api/System/getQRCode`	生成二维码
`/api/SendMessage/sendVerificationCode`	发送短信验证码
`/api/SendMessage/checkVerificationCode`	校验短信验证码
`/api/Channel/OcrAllInOne`	OCR识别（身份证/医保卡拍照识别）
`/api/AuthorizationRecord/*`	授权记录管理

5.1 接口总览

接口功能说明频率关联流程

门诊相关 method（从日志统计的使用情况） | method | 功能 | 主要入参 | 返回数据 | |--------|------|---------|---------| | `getBrdaMz - 展开

method	功能	主要入参	返回数据
`getBrdaMz`	门诊患者档案查询	SFZH(身份证号), MZHM(卡号)	MZID, BRXM, BRXB, SFZH, XZMC
`getGhjlMz`	挂号记录查询	MZID, clinicDateStart, clinicDateEnd	挂号记录数组(hisRegNo, GHKSMC, YSXM, ZJE, THBZ等)
`getSfjlMz`	收费记录查询	MZID, clinicDateStart, clinicDateEnd	JGID, FPHM, SFRQ, ZFY
`getSfmxMz`	缴费明细查询	FPHM(发票号)	明细数组(XMMC, SL, DJ, DW, KSDM等)
`getMydMz`	预约单查询	jgid, MZID, clinicDateStart, clinicDateEnd	预约记录(ID, BRXM, KSMC, GHSJ等)
`getPayedList`	已缴费列表	userId, cards([{cardNo, cardType}])	goodsDataList
`getHisFyck`	药房发药窗口	fphm(发票号)	发药窗口列表(fyck, cd, desAddrDep)
`queryQueuingList`	排队候诊查询	cardNo, deptCode ⚠️必填	cardNo, name, ddrs(排队号), wjzrs(等候人数)
`queryOpeningDepartment`	开诊科室查询	branchId	当日开诊科室列表
`queryPatientDispensesMedicine`	发药信息查询	cardNo, patName	fyck(发药窗口), qyh(取药号)
`getXXKSYS`	线下科室医生	gzrq_begin, gzrq_end	科室医生排班列表
`getXXHYXX`	线下号源信息	yyrq_begin, yyrq_end, zblb, deptCode	号源详情(含时段、剩余号数)

/hcenter/dept | 接口 | 功能 | 备注 | |------|------|------| | `/hcenter/dept` | 科室字典 | 实际出参见下方「5.4 实 - 展开

接口	功能	备注
`/hcenter/dept`	科室字典	实际出参见下方「5.4 实际字段速查」
`/hcenter/schedule`	当日排班	按科室/医生获取排班信息
`/hcenter/findDiagnosisRecords`	就诊记录查询
`/hcenter/getPersonnelInfo`	人员基本信息(医保1101接口)
`/hcenter/getPrescriptionList`	历史处方(医保5299接口)
`/hcenter/getInvEBillUrl`	电子票据URL	含挂号/收费/退费票据
`/hcenter/getSelfFeeElectronCard`	获取自费电子卡号

dept（科室字典）实际出参 deptName, flxh, sortId, mzksNa, ghlb, code, ksdz, msg, mzks, pydm, zzjxzf, mzlb, - 展开

实际字段: deptName, flxh, sortId, mzksNa, ghlb, code, ksdz, msg, mzks, pydm, zzjxzf, mzlb, deptCode, ksfl

真实示例:
{
  "deptName": "心血管内科",
  "flxh": 1,            ← 分类序号
  "sortId": 10,          ← 排序ID
  "mzksNa": "",          ← 门诊科室名称
  "ghlb": 1,             ← 挂号类别(1=普通)
  "code": "0",
  "ksdz": "挂号后请上二楼中就诊",  ← 科室地址(就诊指引)
  "msg": "成功",
  "mzks": 1,             ← 门诊科室代码
  "pydm": "XXG",         ← 拼音代码
  "zzjxzf": 0,           ← 是否支持诊间结算
  "mzlb": 1,             ← 门诊类别
  "deptCode": "1",       ← 科室代码
  "ksfl": "内科"         ← 科室分类
}

6.1 概述

接口功能说明频率关联流程

6.3.1 预约挂号（两种调用方式）新系统格式（南院）** - 展开

方式一：新系统格式（南院）

SOAP Action: getScheClinicorder / getGeneralScheClinicorder
命名空间:
  xmlns:ser='http://service.busi.df.linkonworks.com/'     ← 老端点
  xmlns:ser='http://service.yhzn.com'                     ← 新端点

templateld 格式: 科室代码@医生代码@排班号源ID
  示例: 1004030402021000@CJF1171@2026061567ebbd0ed5338d000139dd2b
  示例: 1013001312021000@NULL@2026061467ebbd2495f7750001c21a06  (不指定医生)

Header:
  <MyHeader>
    <factoryno>QMGS</factoryno>
    <factoryname>齐脉公司</factoryname>
    <versionno>V1.0</versionno>
    <hospitalno>2</hospitalno>    ← 1=总院, 2=南院
  </MyHeader>

Body参数:
  <templateld>号源模板ID</templateld>
  <name>患者姓名</name>
  <medicineCardNo>医保卡号</medicineCardNo>
  <idendityCardNo>身份证号</idendityCardNo>
  <idendityCardType>11</idendityCardType>    ← 证件类型
  <cellphone>手机号</cellphone>

方式二：老系统格式（总院）

templateld 格式: 日期,院区,科室代码,医生代码,时段,序号
  示例: 20260614,1,10045,NULL,0,05
  示例: 20260615,1,54,5524,0,01

返回格式：

<!-- 成功 -->
<Rows><Row>
  <Message>预约成功</Message>
  <ReservationId>828210346243657728</ReservationId>
  <State>1</State>
</Row></Rows>

<!-- 失败示例1: 号源用完 -->
<Rows><Row>
  <Message>当前院区、时间段、科室、医生号源已用完</Message>
  <State>0</State>
</Row></Rows>

<!-- 失败示例2: 重复预约 -->
{"result":"不要重复预约同一天同一时段同一挂号科室(getGeneralScheClinicorder)",
 "resultCode":"F"}

<!-- 失败示例3: 老系统格式 -->
<Rows><Row>
  <Message>成功</Message>
  <QueueNumber></QueueNumber>
  <ReservationId>103381594</ReservationId>
  <State>1</State>
</Row></Rows>

6.3.2 取消预约 cancelOrder - 展开

SOAP Action: cancelOrder

参数:
  <rervationld>预约ID(ReservationId)</rervationld>

返回:
  <Message>取消成功/取消失败</Message>
  <Result>0=成功, 1=失败</Result>
  <State>0=失败, 1=成功</State>

bs_userassociatecard — 用户关联卡表 ** - 展开

字段	类型	说明
userid	VARCHAR(50)	用户ID
customerid	VARCHAR(50)	客户编号（91=东方医院）
cardNo	VARCHAR(50)	卡号
cardType	VARCHAR(10)	卡类型
status	VARCHAR(10)	状态（1=有效）

业务场景：

查询用户绑定的卡:
  SELECT * FROM bs_userassociatecard
  WHERE userid='8F587CA43D7546838A7C346E1685DA11'
    AND customerid='91'
    AND status='1'

关联模块： 预约挂号（选择就诊卡时读取）、个人中心（展示已绑卡列表）

11.5 电子凭证渠道 (ecQrChannel)

接口	功能说明	频率	关联流程

11.10 用码业务类型 (BusinessTypeEnum)

接口	功能说明	频率	关联流程

11.11 状态码约定汇总

接口	功能说明	关联流程
BusCenter内部接口日志 (bus目录)	00:16.369=>请求接口请求时间：2026-06-14 00:00:16:3677	-	展开
`2026-06-14 00:00:16.369=>请求接口请求时间：2026-06-14 00:00:16:3677 客户端Ip端口：zsyy.easthospital.cn: 请求Id：F8D6D47E6EA0648EA6A74D1B2D4EA6B5...(请求追踪ID) 请求接口名称：FSMicroService.BusCenter.Controllers.UserController.getFullUser 请求接口路径：/api/User/getFullUser 请求接口参数：{}` 返回日志： `请求接口返回参数：2026-06-14 00:00:37:8379{ "code":0, "data":{ "userId":"4209765CCD4D48A2A16E56A3D52046D7", "patientList":[...] }, "msg":"请求成功" }`
错误日志 (error目录)	07:12.569=>系统错误：System.Exception: 院内新系统无档,不支持查询病历报告!	-	展开
2026-06-14 00:07:12.569=>系统错误：System.Exception: 院内新系统无档,不支持查询病历报告! at FSMicroService.Services.ReportService.GetMedicalReportList(...) in D:\QMWork\Code\东方医院-公众号\Api - 副本\FSMicroService.Services\Buiness\ReportService.cs:line 61 at FSMicroService.DoMain.ReportDoMain.GetMedicalReportList(...) in D:\QMWork\Code\东方医院-公众号\Api - 副本\FSMicroService.DoMain\Buiness\ReportDoMain.cs:line 28 at FSMicroService.BusCenter.Controllers.ReportController.getMedicalReportList(...) in ...\Controllers\ReportController.cs:line 93

🔗 平台交接接口速查

2.1 服务器清单

接口	功能说明	频率	关联流程

2.2 院区编码对照

接口	功能说明	频率	关联流程

2.3 平台标识参数

接口	功能说明	频率	关联流程

3.2 流程二：医保当日挂号（完整链路）

接口	功能说明	频率	关联流程

3.3 流程三：退费/退号

接口	功能说明	频率	关联流程

3.4 流程四：个人中心查询（挂号记录）

接口	功能说明	频率	关联流程

3.5 流程五：门诊缴费查询

接口	功能说明	频率	关联流程

5.2 通用查询接口 `/platform/common/commonQuery`

接口功能说明频率关联流程

住院相关 method | method | 功能 | 主要入参 | 返回数据 | |--------|------|---------|---------| | `queryzyjz - 展开

method	功能	主要入参	返回数据
`queryzyjzjl`	住院结算记录	idcardNo, platformType	住院记录列表(BAHM, KSMC, RYRQ, CYRQ等)
`queryjkjl`	缴款记录	ZYID(住院ID)	JKFS(支付方式), JKJE(金额), JKRQ(时间)
`queryzyfyqd`	住院费用清单	ZYID	费用明细(fyrq, sfmc, fysl, fydj, zjje)
`getzyyjkjl`	预交金余额	ZYID	缴款记录(含正负金额)
`queryzycydy`	出院带药	ZYID	CYKS, CYYZ, JL, PC, YF等

/hcenter/createBrda2 "42501633102", - 展开

/hcenter/createBrda2 — 初诊建档

请求:
{
  "branchId": "42501633102",
  "patInfo": {
    "patName": "于昊辰",
    "idcardType": "1",          ← 身份证
    "idcardNo": "220302202003120610",
    "cardNo": "",               ← 新患者无卡号
    "cardType": "2",            ← 统一自费就诊卡
    "csny": "2020-03-12",      ← 出生年月
    "xb": "1",                 ← 男
    "lxdh": "13069289528",     ← 联系电话
    "dzkh": "517045",          ← 自费电子卡
    "sfyb": "0",               ← 自费
    "zhbz": ""
  }
}
返回:
{
  "code": 0,
  "data": {
    "associtePatNo": "...",     ← 建档后返回的患者ID
    "cardNo": "..."             ← 分配的卡号
  }
}

⚠️ 注意: 日志中存在 csny 数据格式错误的情况，如 "1998-98-12"（月份超范围），
        说明前端校验不够严格，后端可能做了容错处理。

/hcenter/queryBrda — 查询档案

请求:
{
  "branchId": "42501633102",
  "patName": "奉光金",
  "idcardNo": "431121199711278738"
}
返回:
{
  "code": 0,
  "msg": "查询档案成功",
  "data": [{
    "cardNo": "5004244980",
    "cardType": 0,              ← 医保卡
    "associtePatNo": "zddr431121199711278738",
    "idcardType": "1",
    "lxdh": "18873957403",
    "jzrq": null                ← 最近就诊日期
  }]
}

/hcenter/CardType — 就诊卡类型判断

请求:
{
  "branchId": "42501633100",
  "patName": "赵臻宏",
  "idcardType": "1",
  "cardNo": "K18723894"
}
返回:
{
  "code": 0,
  "data": [{
    "cardType": "0",            ← 医保卡类型
    "lxdh": "15821415794",
    "sfzh": "310110199605035137"
  }]
}

/hcenter/RegRecordQuery — 当日挂号数据查询

请求:
{
  "branchId": "42501633102",
  "cardNo": "M50A6D890",
  "deptCode": ""                ← 可选，传空查全部
}
返回:
{
  "code": 0,
  "msg": "当日挂号数据获取成功",
  "data": [
    {
      "deptCode": "...",
      "deptName": "...",
      "hisRegNo": "...",
      "ghsj": "2026-06-14 08:30:00",
      "associtePatNo": "..."
    }
  ]
}

/hcenter/PreChRegInfo ** - 展开

步骤	接口	说明
1	`/hcenter/PreChRegInfo`	自费挂号预结算 → 返回费用信息
2	(微信支付)	用户在微信端完成支付
3	`/hcenter/ChRegInfo`	自费挂号结算确认 → 传入支付凭证

PreChRegInfo 请求：

{
  "orderId": "平台流水号",
  "hisOrderType": "1",
  "patInfo": { "patName", "idcardNo", "associtePatNo", "cardNo", "cardType" },
  "regInfo": {
    "hisRegNo": "HIS就诊号",
    "deptCode": "科室代码",
    "regDate": "2026-06-14",
    "deptClassify": "100",
    "totalMoney": 25.0
  }
}

ChRegInfo 请求（比预结算多了 payInfo）：

{
  ...同上...,
  "payInfo": {
    "orderNo": "第三方支付订单号",
    "tradeNo": "第三方支付交易流水号",
    "amount": 25.0,
    "time": "2026-06-14 08:30:00",
    "tradeText": "电子支付交易返回串",
    "channel": "wechat"           ← wechat/alipay/unionpay
  }
}

/hcenter/getMedicalInsuranceCard ** - 展开

步骤	接口	说明
1	`/hcenter/getMedicalInsuranceCard`	通过医保电子凭证二维码获取医保卡信息
2	`/hcenter/PreRegSettlement`	医保挂号预结算 → 返回统筹/个账/自费分解
3	(微信支付自费部分)	仅支付自费金额
4	`/hcenter/RegSettlement`	医保挂号结算确认
5	`/hcenter/ChStateQuery`	状态查询（兜底确认）

关键参数说明： - ecQrCode：医保电子凭证二维码值（刷码获取） - ecToken：医保授权码（预结算返回，结算时传入） - payOrdId / payToken：支付订单号和令牌（预结算返回） - acctUsedFlag：个人账户使用标志（1=使用，0=不使用）

/hcenter/GetOutpPresc | 步骤 | 自费接口 | 医保接口 | 说明 | |------|---------|---------|------| | 列表 | `/hcenter/G - 展开

步骤	自费接口	医保接口	说明
列表	`/hcenter/GetOutpPresc`	同	获取待缴费处方列表
明细	`/hcenter/GetOutpPrescDetails`	同	获取处方明细
预结算	`/hcenter/PreChPresInfo`	`/hcenter/PreSettlement`	计算费用
结算	`/hcenter/ChPresInfo`	`/hcenter/Settlement`	确认支付
退费	`/hcenter/Cancel`	同	统一退费接口

5.4 实际字段速查（来自生产日志验证）

接口	功能说明	关联流程
queryOpeningDepartment（开诊科室）实际出参	ksdm, ksmc, zblb, ghlb, mzks, mzksNa, ksfl, sortId, depttype	-	展开
`实际字段: ksdm, ksmc, zblb, ghlb, mzks, mzksNa, ksfl, sortId, depttype 真实示例: { "ksdm": "1005010514021000", ← 科室代码 "ksmc": "妇科", ← 科室名称 "zblb": "上午", ← 值班类别(上午/下午/全天) "ghlb": "1", ← 挂号类别 "mzks": "1005010000020000", ← 门诊科室 "mzksNa": "妇科", ← 门诊科室名称 "ksfl": "妇产科", ← 科室分类 "sortId": "30", ← 排序ID "depttype": "普通" ← 科室类型(普通/专病/特需) }`
getBrdaMz（门诊患者档案）实际入参/出参	SFZH(身份证号), MZHM(卡号), platformType, channelCode, branchId, method	-	展开
`入参: SFZH(身份证号), MZHM(卡号), platformType, channelCode, branchId, method 出参字段: MZID, MZHM, BRXM, BRXB, SFZH, XZMC 真实示例: 入参 {"SFZH":"622826200111200015","MZHM":"6021891873","platformType":"2","channelCode":"1","branchId":"42501633102","method":"getBrdaMz"} 出参 {"MZID":"1202594844","MZHM":"6021891873","BRXM":"张有为","BRXB":"1","SFZH":"622826200111200015","XZMC":"新医保"}`
getGhjlMz（挂号记录）实际入参/出参	MZID, clinicDateStart, clinicDateEnd, platformType, channelCode, branchId, metho	-	展开
入参: MZID, clinicDateStart, clinicDateEnd, platformType, channelCode, branchId, method 入参日期格式: "yyyy/MM/dd HH:mm:ss" (注意是斜杠不是横杠！) 出参字段(有数据时): hisRegNo, cardNo, GHSJ, GHKSMC, YSXM, ZJE, THBZ, JGID, JZLS, associtePatNo, chargeId, GHKSDM, KSDM, KSMC, GHLBMC, YSDM, LXDH 真实示例(从日志提取的一条有数据记录): { "associtePatNo": "患者ID", "hisRegNo": "HIS挂号流水号", "cardNo": "就诊卡号", "GHSJ": "2026-06-14 08:30:00", ← 挂号时间 "chargeId": "收费结算记录ID", "THBZ": "1", ← 退号标志(1=已退号,0=正常) "JGID": "1", ← 机构ID(1=总院,2=南院) "ZJE": "50.00", ← 总金额 "GHKSDM": "科室代码", "GHKSMC": "科室名称", "KSDM": "科室代码(老系统)", "KSMC": "科室名称", "GHLBMC": "普通/专科/专家/特需", "JZLS": 0, ← 就诊历史(0=初诊,1=复诊) "YSDM": "医生代码(工号)", "LXDH": "医生联系电话", "YSXM": "医生姓名" }
getSfjlMz（收费记录）实际入参/出参	MZID, clinicDateStart, clinicDateEnd, platformType, channelCode, branchId, metho	-	展开
`入参: MZID, clinicDateStart, clinicDateEnd, platformType, channelCode, branchId, method 出参字段: JGID, FPHM, SFRQ, MZID, ZFY 真实示例: { "JGID": "1", ← 机构ID(1=总院,2=南院) "FPHM": "28020811606", ← 发票号码 "SFRQ": "2026-06-14 09:15:00", ← 收费日期 "MZID": "1202594844", ← 门诊ID "ZFY": "415.00" ← 总费用 }`
getSfmxMz（缴费明细）实际入参/出参	FPHM(发票号码), platformType, channelCode, branchId, method	-	展开
`入参: FPHM(发票号码), platformType, channelCode, branchId, method 出参字段: LX, KSDM, KSMC, YSGH, YSXM, XMMC, SL, DJ, DW, CFTS, FPHM 真实示例: { "LX": "处方/非处方", "KSDM": "科室代码", "KSMC": "科室名称", "YSGH": "医生工号", "YSXM": "医生姓名", "XMMC": "医疗服务项目名称", "SL": "数量", "DJ": "单价", "DW": "单位", "CFTS": "1", ← 处方天数 "FPHM": "发票号码" }`
queryzyjzjl（住院记录）实际出参	BAHM, ZYID, BRXM, SFZH, LXDH, RYRQ, CYRQ, CYPB,	-	展开
⚠️ 与HIS文档差异最大！文档用小写拼音(bahm, zyh, brxm)，实际用大写缩写实际字段: BAHM, ZYID, BRXM, SFZH, LXDH, RYRQ, CYRQ, CYPB, BRKS, KSMC, BRBQ, BQMC, ZRYSDM, ZRYS, ZZYSDM, ZZYS, ZYYSDM, ZYYS 真实示例: { "BAHM": "765480", ← 病案号码 "ZYID": 1125314291, ← 住院ID "BRXM": "秦玉洁", ← 病人姓名 "SFZH": "41142520010706872X", "LXDH": "19921316757", "RYRQ": 1761265597760, ← 入院日期(时间戳毫秒!) "CYRQ": 1761344935970, ← 出院日期(时间戳毫秒!) "CYPB": 8, ← 出院判别 "BRKS": 24, ← 病人科室 "KSMC": "耳鼻咽喉科", "BRBQ": 347, ← 病人病区 "BQMC": "十二西", "ZRYSDM": "0166", ← 主任医生编码 "ZRYS": "朱黎伟", ← 主任医生 "ZZYSDM": "3696", ← 主治医生编码 "ZZYS": "姚敏", ← 主治医生 "ZYYSDM": "K227", ← 住院医生编码 "ZYYS": "阮苏雨" ← 住院医生 }
queryjkjl（住院缴款记录）实际出参	JKFS, JKJE, JKRQ, ORDERID, ZYID	-	展开
`实际字段: JKFS, JKJE, JKRQ, ORDERID, ZYID 真实示例: { "JKFS": "支付宝", ← 缴款方式 "JKJE": 2000.00, ← 缴款金额 "JKRQ": 1761264734780, ← 缴款日期(时间戳) "ORDERID": "20251024081221000027325369", ← 平台订单号 "ZYID": 1125314291 }`
getHisFyck（药房发药窗口）实际入参/出参	fphm(发票号), branchId, channelCode, platformType, method	-	展开
`入参: fphm(发票号), branchId, channelCode, platformType, method 出参字段: fyck(发药窗口名称), cd(窗口代码), fphm(发票号), desAddrDep(地址)`
queryQueuingList（排队候诊）实际入参/出参	cardNo(卡号), deptCode(科室代码⚠️必填), branchId	-	展开
`入参: cardNo(卡号), deptCode(科室代码⚠️必填), branchId 出参字段: cardNo, name, deptName, ddrs(当前待诊人数), wjzrs(未就诊人数) ⚠️ deptCode 必填，否则返回 "科室编码不能为空"`
GetOutpPresc（待缴费列表）实际入参/出参	branchId, cardType, cardNum, idcardType, idcardNo, startTime, endTime	-	展开
入参: branchId, cardType, cardNum, idcardType, idcardNo, startTime, endTime 日期格式: "yyyy-MM-dd" 真实入参: { "branchId": "42501633102", "platformType": "2", "channelCode": "1", "cardType": "2", "cardNum": "6021812085", "idcardType": 1, "idcardNo": "420921199707173037", "startTime": "2026-06-13", "endTime": "2026-06-14" } 有数据时的返回结构: { "code": "0", "msg": "成功", "data": { "regInfo": [{ "hisRegNo": "HIS挂号流水号", "hisOrderType": "订单类型", "patId": "患者ID", "cardType": 0, "cardNum": "卡号", "deptCode": "科室代码", "deptName": "科室名称", "doctCode": "医生代码", "doctName": "医生姓名", "deptClassify": "科室类型", "regDate": "就诊日期", "presCount": 3, ← 处方数量 "orderTotal": 415.00 ← 订单总额 }] } }
GetOutpPrescDetails（待缴费明细）实际出参	部分字段名有尾部空格！"patAge ", "patType ", "patGender ", "patTypeName "	-	展开
⚠️ 注意: 部分字段名有尾部空格！"patAge ", "patType ", "patGender ", "patTypeName " 日期格式用点号: "2026.06.14"，不是横杠！实际字段: deptName, medDays, prescDoctName, wayName, prescTime, patAge , patId, useUnit, eachDosage, num, itemCode, patName, patType , regDate, deptClassify, retaPrice, wayId, itemName, payNum, patGender , eachUsage, freqName, hisRegNo, groupNo, itemTypeCode, patTypeName , itemSeq, prescDoctCode, doctAdvice, presUnit, freqId, itemTypeName 真实示例: { "deptName": "儿科", "prescDoctName": "范继桃", "prescTime": "2026.06.14 07:36:00", ← 点号分隔！ "patAge ": 3, ← 注意尾部空格！ "patId": "zddr310114202212260616", "num": 1.0, "itemCode": "828323437255598080", "patName": "苏屹辰", "patType ": "100", ← 注意尾部空格！ "regDate": "2026.06.14 07:34:25", ← 点号分隔！ "deptClassify": "100", "retaPrice": 20, "itemName": "血清淀粉样蛋白测定(SAA)(免疫散射比浊法)", "payNum": 1, "patGender ": "男", ← 注意尾部空格！ "hisRegNo": "828321847570857984", "groupNo": 1, "itemTypeCode": "2200", "patTypeName ": "居民医保", ← 注意尾部空格！ "itemSeq": 1, "prescDoctCode": "FJT5934", "itemTypeName": "检验", ... } ⚠️ 对接时注意对字段名做 trim() 处理！
PreRegSettlement（医保挂号预结算）实际入参/出参（完整版）	"2",	-	展开
入参完整结构: { "platformType": "2", "branchId": "42501633102", "orderId": "NYGHXS061407011566419514", ← 格式: NYGHXS+时间戳 "payNotifyUrl": "http://127.0.0.1:8080/Test.asmx", "ecQrChannel": "2", "hisOrderType": "1", "ecQrCode": "4243988099776262092802310000", "payAuthNo": "AUTH310100202606140701135940799", "acctUsedFlag": "1", "psnSetlway": "01", "channelCode": "1", "ecToken": "4243988099776262092802310000", "patInfo": { "patName": "羿晓杰", "idcardType": "1", "idcardNo": "320483198801052710", "associtePatNo": "782697635080306688", "cardNo": "M51E2F734", "cardType": "1" }, "regInfo": { "hisRegNo": null, ← 预约挂号时为空 "deptCode": "1013001312021000", "deptName": "皮肤科", "deptClassify": "100", "regDate": "2026-06-14", "totalMoney": 25.0 } } 出参完整结构: { "code": 0, "msg": "success", "data": { "cardNo": "M51E2F734", "totalAmount": 25.00, "insurancePay": 19.00, ← 医保统筹+基金 "selfPay": 6.00, ← 自费现金 "hisRegNo": "828314520063053824", "associtePatNo": "782697635080306688", "ecToken": "310000ecr1jfkbupkg0100007f0000687d4e95", "payOrdId": "ORD310100202606140701177272886", "payToken": "TSN310100202606140701177259432", "psnAcctPay": "5.70", ← 个人账户 "fundPay": "13.30", ← 基金支付 "otherPay": "0.00" } }
Cancel（退费退号）实际入参（两种场景）	"372831196109154208",	-	展开
自费退号(简单): { "idcardNo": "372831196109154208", "cardType": "1", "platformType": "2", "channelCode": "1", "hisOrderType": "1", ← 1=退号, 2=退费 "hisRegNo": "123661494", "ecQrChannel": "2", "ecQrCode": "", ← 自费为空 "payOrderId": "", "payOrdId": "", "branchId": "42501633100" } 医保退号(需传支付信息): { "idcardNo": "14042919910409562X", "cardType": "1", "hisOrderType": "1", "hisRegNo": "828335269542371328", "ecQrChannel": "2", "ecQrCode": "4243988108047999667202310000", "payOrderId": "ORD310100202606140823207299443", "payOrdId": "ORD310100202606140823207299443", "branchId": "42501633102", "payAuthNo": "AUTH310100202606140825195979530" } 成功返回: {"msg":"成功","code":0,"data":""}
RegSettlement（医保挂号结算）实际入参/出参	与 PreRegSettlement 基本相同，差异:	-	展开
入参: 与 PreRegSettlement 基本相同，差异: - regInfo.hisRegNo: 从预结算返回的挂号ID（不再是null） - ecToken: null（无需传） - 新增 payOrdId, payToken（从预结算返回）出参: { "code": 0, "msg": "success", "data": { "ecToken": "310000ecr1jfkbupkg0100007f0000687d4e95", "totalAmount": 25, "insurancePay": 19, "selfPay": 6, "hisRegNo": "828314520063053824", "orderNo": "", ← 空=无需额外支付 "sqzzbz": "0", ← 0=非转诊,1=转诊 "idMedstoe": "2065932555332890624" ← 结算记录ID(后续状态查询用) } }

7.1 为什么需要双院区查询

接口	功能说明	频率	关联流程

7.2 典型的三服务器并发查询模式

接口	功能说明	频率	关联流程

7.3 需要双院区查询的接口

接口	功能说明	频率	关联流程

7.4 建档的双院区问题

接口	功能说明	关联流程
支付服务日志 (pay目录)	6021891873	-	展开
`=======查询患者档案信息========= 当前卡号：6021891873 请求APIName：getBrdaMz 开始请求：2026-06-14 00:04:36:5883161 开始参数：{"SFZH":"622826200111200015",...} 开始返回：2026-06-14 00:04:36:6204513 返回参数：{"msg":"门诊病人档案成功","code":"0","data":[...]}`
外部接口调用日志 (其余部分)	`时间戳 Url=接口地址；HttpStrData=请求JSON；result=返回JSON`	-	展开
格式：`时间戳 Url=接口地址；HttpStrData=请求JSON；result=返回JSON` `21-00:07:17 6384：Url=http://172.31.10.34:19077/platform/hcenter/queryBrda； HttpStrData={"branchId":"42501633102","patName":"奉光金","idcardNo":"431121199711278738"} 21-00:07:17 6935：Url=http://172.31.10.34:19077/platform/hcenter/queryBrda； result={"data":[{...}],"code":0,"msg":"查询档案成功"}`

🏥 HIS对接接口速查

其他

接口功能说明频率关联流程

/api/Recipe/toPayList | 接口 | 说明 | |------|------| | `/api/Recipe/toPayList` | 获取待缴费处方列表 | | `/api/Reci - 展开

接口	说明
`/api/Recipe/toPayList`	获取待缴费处方列表
`/api/Recipe/getPayList`	获取已缴费处方列表

ChStateQuery（医保状态查询）实际出参 0, - 展开

出参:
{
  "code": 0,
  "data": {
    "hisId": "828314639006703616",        ← HIS流水号
    "jzpdh": "06001",                      ← 就诊排队号
    "hisghfp": "NYGH2606143000104",       ← HIS挂号发票号
    "sqzzbz": null
  }
}

9. 微信模板消息推送 ** - 展开

从日志中提取的消息推送类型（CommunicationType）：

类型值	含义	推送场景
`RecipeSuccess`	处方缴费成功	用户完成门诊缴费后
`RegistrationSuccess`	挂号成功	当日挂号结算完成
`AppointmentSuccess`	预约成功	预约挂号提交成功
`CancelSuccess`	退费/退号成功	退费申请通过

模板消息数据结构示例（处方缴费成功）：

{
  "PName": "章禹苏",
  "PMedicalCard": "H50DF5464",
  "BranchName": "南院",
  "MedicalAddress": "南院(云台路1800号)",
  "HisPaymentVoucher": "808478610095607808",
  "DispensingWindow": "儿科发药窗口一",
  "NowDateTime": "2026年04月20日 13:20",
  "ItemName": "处方缴费(儿科发药窗口一)",
  "CommunicationType": "RecipeSuccess"
}

微信模板ID： fgvkXfwaVTEJfnms_swM7J29Jx7OHefXG6Zv-AGT6sY

模板字段映射：

thing2   → 患者姓名 (PName)
time6    → 缴费时间 (NowDateTime)
thing7   → 缴费项目 (ItemName)
remark   → 备注
         → 发票号 (HisPaymentVoucher)
         → 就诊院区 (MedicalAddress)
         → 发药窗口 (DispensingWindow)
         → 温馨提示 (Tips)

10. 卡拦截规则服务 ** `http://172.31.12.66:8084/ChildrenHos/api/CardInterceptRule/checkRule` - 展开

服务地址： http://172.31.12.66:8084/ChildrenHos/api/CardInterceptRule/checkRule

在提交预约/挂号前调用，判断是否符合挂号规则。

请求:
{
  "BranchCode": "2",                      ← 1=总院, 2=南院
  "BranchName": "东方医院南院",
  "SceneCode": "AppointmentConfirm",      ← 场景: 预约确认
  "RuleSceneCode": "AppointmentRelated",  ← 规则场景: 预约相关
  "OneDeptCode": "1013000000020000",      ← 一级科室代码
  "OneDeptName": "皮肤科",
  "SecondDeptCode": "1013001312021000",   ← 二级科室代码
  "SecondDeptName": "皮肤科",
  "ClinicTypeCode": "1",                 ← 门诊类型
  "CardCategory": "MedicalInsuranceCard", ← 卡类别
  "ChannelCode": "WeiXin"
}

返回:
{
  "code": 0,
  "data": {
    "IsPassCheck": true,       ← 是否通过
    "NeedPrompt": false,       ← 是否需要弹窗提示
    "NeedSelectCard": false,   ← 是否需要重新选卡
    "FailReasonCode": "",      ← 失败原因码
    "PromptMessage": "",       ← 提示信息
    "MatchedRuleCode": "",     ← 匹配的规则码
    "MatchedRuleName": ""      ← 匹配的规则名
  }
}

6.2 延华接口模块

接口	功能说明	频率	关联流程

6.3 公众号实际使用的延华接口

接口	功能说明	频率	关联流程

8.1 医保 vs 自费流程对比

接口	功能说明	频率	关联流程

8.2 医保关键概念

接口	功能说明	频率	关联流程

8.3 医保状态查询 `ChStateQuery`

接口功能说明频率关联流程

延华预约日志 (其余部分) <Envelope xmlns:soapenv='...'>...</Envelope> - 展开

入参：<Envelope xmlns:soapenv='...'>...</Envelope>
getScheClinicorder 参数：xxx  返回：<?xml ...>...</xml>

或：

2 普通预约登记请求：<soapenv:Envelope ...>...</soapenv:Envelope>
2 普通预约登记返回：<soap:Envelope ...>...</soap:Envelope>

齐脉公众号业务使用 SQL Server 数据库，连接信息：

Server: . (本地)
Database: qmwx
User ID: wx
Password: weixin@112
Trusted_Connection: False
Max Pool Size: 512

⚠️ HIS 端数据库（HIHIS）齐脉无直接访问权限，所有 HIS 数据操作通过平台接口完成。 | 字段 | 类型 | 说明 | |------|------|------| | UserId | VARCHAR(50) | 用户ID | | OpenId | VARCHAR(50) | 微信OpenId | | SMSCode | VARCHAR(10) | 6位验证码 | | ExpireTime | DATETIME | 过期时间（创建时间+5分钟） | | CreateTime | DATETIME | 创建时间 |

业务场景：

发送验证码:
  INSERT INTO UserSMS(UserId, OpenId, SMSCode, ExpireTime, CreateTime)
  VALUES('...', '...', '839610', '2026-06-15 01:42:33', '2026-06-15 01:37:33')

校验验证码:
  SELECT ExpireTime FROM UserSMS
  WHERE UserId='...' AND SMSCode='839610'

频次控制（每小时限制）:
  SELECT COUNT(1) FROM UserSMS
  WHERE UserId='...' AND CONVERT(varchar(2), CreateTime, 108)='01'

关联模块： /api/SendMessage/sendVerificationCode、/api/SendMessage/checkVerificationCode

编码	名称	使用场景
1	线下诊疗挂号	当日挂号
2	线下处方收费	门诊缴费
3	互联网诊疗挂号	互联网医院
4	互联网处方收费	互联网医院
编码	名称	卡号格式特征
------	------	------------
0	医保卡	纯数字 10位左右
1	社保卡	字母+数字
2	统一自费就诊卡	DZ开头或纯数字
编码	名称	说明
------	------	------
100	普通门诊	最常见的类型
101	专科门诊
102	专家门诊
103	特需门诊	费用较高
104	专病门诊
999	其他
HIS接口使用：

编码	名称
1	身份证
2	护照
3	港澳台居住证
4	港澳台通行证

延华接口使用：

编码	名称
1Z / 11	身份证
2	护照
3	港澳台居住证
4	港澳台通行证

⚠️ 注意两套系统的证件类型编码不同！延华接口日志中常见 idendityCardType=11 | 编码 | 名称 | |------|------| | wechat | 微信支付 | | alipay | 支付宝 | | unionpay | 银联 | | 编码 | 名称 | |------|------| | 1 | 西药 | | 2 | 中成药 | | 3 | 草药 | | 编码 | 名称 | |------|------| | 1 | 普通 | | 2 | 专科 | | 3 | 专家 | | 4 | 急诊 | | 编码 | 名称 | |------|------| | 1 | 上午 | | 2 | 下午 |

公众号调用日志/
├── 个人中心/                    ← 个人中心模块 (按功能分类)
│   ├── bus/                    ← 内部接口请求日志
│   │   └── Log_log260614.txt  ← 格式: 请求时间+接口路径+参数+返回值
│   ├── pay/                    ← 支付/查询类接口日志
│   │   └── Log_log260614.txt  ← 格式: API名称+请求参数+返回参数
│   ├── error/                  ← ⚠️ 错误日志 (重点排查目录)
│   │   └── Log_log260614.txt  ← 格式: 异常类型+堆栈跟踪
│   ├── db/                     ← 数据库操作日志
│   ├── debug/                  ← 调试日志
│   └── log/                    ← 通用业务日志
│
└── 其余部分/                    ← 所有外部接口调用 (大文件)
    └── 20260614.txt            ← ~950MB, 100万+行
                                 格式: 时间戳+Url+请求参数+返回结果

确定问题时间点 → 在「其余部分」大文件中搜索时间戳
追踪请求链路 → 用请求参数（身份证号/卡号/订单号）关联上下游日志
定位错误来源 → 看返回的 code/msg，区分是平台报错还是HIS报错
查看堆栈定位代码 → error目录有完整的C#堆栈，可定位到具体文件和行号
核对参数 → 对比请求参数和接口文档，确认参数格式是否正确由于各系统日志分散，建议按以下字段关联： - 患者维度： 身份证号 + 姓名 - 订单维度： orderId (平台流水号) + hisRegNo (HIS流水号) - 时间维度： 精确到毫秒的时间戳（日志中格式为 HH:mm:ss 毫秒）

错误信息	含义	原因	解决方案
`查无此人档案`	HIS中无患者档案	患者首次就诊或未建档	引导患者走初诊建档流程
`院内新系统无档,不支持查询病历报告!`	南院新HIS中无档案	患者只在老系统有档案	需在南院建档后才能查报告
`科室编码不能为空`	queryQueuingList缺少deptCode	前端未传入科室参数	传入当前就诊科室代码
`当日无排班`	schedule接口返回空	当天该科室确实没有排班	正常业务，前端提示用户
`未查询到挂号记录`	该院区无挂号记录	患者当天未挂号或挂的是另一院区	正常业务，展示空列表
`未查到数据`	GetOutpPresc返回空	无待缴费处方	正常业务
`当前院区、时间段、科室、医生号源已用完`	延华返回	号源已满	前端提示用户选其他时段/医生
`不要重复预约同一天同一时段同一挂号科室`	延华返回	重复提交预约	前端防重复或提示用户
`AccessToken错误或已过期`	JWT过期	Token超时	重新调用getToken获取
`code=-1, msg为空`	通用失败	多种可能，需看具体接口	查完整日志定位

[ ] 确认是否需要双院区查询（大多数查询类接口需要）
[ ] 确认 platformType 和 channelCode 参数（公众号场景固定为 "2" 和 "1"）
[ ] 确认 branchId 取值（42501633100=总院, 42501633102=南院）
[ ] 确认是 REST JSON 还是 SOAP XML（延华接口走 SOAP）
[ ] 确认状态码格式（-1 vs "-1"、0 vs "0"、200）
[ ] 医保接口需要 ecQrCode/ecToken，自费接口不需要
[ ] 结算接口需要先调预结算获取 payOrdId/payToken
[ ] 注意卡号格式多样性（纯数字/字母+数字/DZ开头） | 卡号 | 类型 | 说明 | |------|------|------| | 6021891873 | 自费卡 | 有档案的患者 | | M51E2F734 | 社保卡 | 医保患者 | | 5004244980 | 医保卡 | 医保患者 | | DZ0000000488823 | 自费卡 | 自费患者 | | K18723894 | 社保卡 | 有档案的患者 |

# 搜索特定患者的所有接口调用
grep "身份证号" 其余部分/20260614.txt

# 搜索特定接口的调用
grep "PreRegSettlement" 其余部分/20260614.txt

# 搜索错误
grep "code\":-1" 其余部分/20260614.txt

# 搜索延华预约
grep "getScheClinicorder" 其余部分/20260614.txt

# 统计接口调用量
grep -c "queryBrda" 其余部分/20260614.txt

# 搜索特定时间的日志
grep "21-07:01:" 其余部分/20260614.txt

D:\QMWork\Code\东方医院-公众号\Api - 副本\
├── FSMicroService.BusCenter\          ← WebAPI控制器层
│   └── Controllers\
│       ├── UserController.cs
│       ├── ReportController.cs
│       ├── BookingController.cs
│       ├── RegistrationController.cs
│       ├── RecipeController.cs
│       └── SystemController.cs
├── FSMicroService.Services\           ← 业务逻辑层
│   └── Buiness\
│       ├── ReportService.cs
│       └── ...
├── FSMicroService.DoMain\             ← 领域层
│   └── Buiness\
│       ├── ReportDoMain.cs
│       └── ...

文档版本： V2.0
后续更新： 如有接口变更或新功能上线，请更新本文档对应章节
原始文档位置： D:\齐脉\公众号接口文档和日志\接口文档\

参数名	类型	必填	说明	来源/去向
patientName	String	可选	患者姓名	← 邢秋丽
cardNo	String	可选	身份证号	← 411527199202135049
startTime	String	可选	开始日期
endTime	String	可选	结束日期
branchCode	String	可选	院区(空=全部)