🏥 新华崇明 · 接口工作台
4+
接口总数
1
服务器节点
1
院区数量
3
业务流程
🔄 业务流程
🏥
门诊业务
该模块业务待补充,后续可在此添加住院相关流程(入院登记、住院缴费、出院结算、住院报告等)
🎨 颜色图例 — 对应接口文档
公众号内部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)
📱 公众号内部接口速查
其他
| 接口 | 功能说明 | 频率 | 关联流程 | |
|---|---|---|---|---|
| **开发/运维/测试人员 | - | 展开 | ||
| ⚠️ 阅读前必读 — 文档 vs 实际 | ---:|------| | - | 展开 | |
| 目录 | 1. [系统架构全景图](#1-系统架构全景图) 2. [对接方与环境](#2-对接方与环境) 3. [号源池系统详解](#3-号源池系统详解) 4. [核心业 | - | 展开 |
1.1 物理架构
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
1.2 与东方医院的核心差异
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
2.1 客户标识
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
3.1 号源池微服务
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
3.2 号源池内部通信协议
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
3.3 号源相关的万达集成接口
| 接口 | 功能说明 | 频率 | 关联流程 | |
|---|---|---|---|---|
| 第1步:获取Token | 21-00:30:13 | - | 展开 | |
| 第2步:获取用户卡片列表 | 21-00:35:34 | - | 展开 | |
| 第3步:获取患者信息 | 21-00:06:02 | - | 展开 | |
| 第4步:提交预约 (DoBespeak) | 21-00:06:59 | - | 展开 | |
| 第5步:号源同步到HIS | PM0031 (门诊就诊信息同步) | - | 展开 |
4.2 支付流程(当面付 FacePay)
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
4.3 账单上传流程 (PayByOthers)
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
5.1 接口调用统计
| 接口 | 功能说明 | 频率 | 关联流程 | |
|---|---|---|---|---|
| `/api/User/getFull` — 获取用户完整信息 | { | - | 展开 | |
| JWT Token 结构 | 1, | - | 展开 |
5.3 前台XML接口(QM.CSFP框架)
| 接口 | 功能说明 | 频率 | 关联流程 | |
|---|---|---|---|---|
| DoBespeak 参数详解 | QM.CSFP.208.DIS.BespeakLayout-DoBespeak$Key1:Value1|Key2:Value2|... | - | 展开 |
6.1 基本信息
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
6.2 通用请求格式
| 接口 | 功能说明 | 频率 | 关联流程 | |
|---|---|---|---|---|
| 获取患者信息 (FugaoGetPatientInfo) | 根据身份证号查询患者档案 | - | 展开 | |
| 预约后当日可挂号查询 (FGJKyyztqr) | 需增加出参 | - | 展开 |
8.2 订单号格式
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
8.3 SecretKey
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
9.2 发送短信
| 接口 | 功能说明 | 频率 | 关联流程 | |
|---|---|---|---|---|
| 前台日志 | 06:53 8497:<Xml><Head>...</Head><Request>...</Request></Xml> | - | 展开 | |
| 接口交付日志 | 2026-06-14 00:04:07,894 | - | 展开 | |
| 支付日志 | 21-HH:MM:SS MSSS:操作描述:XML/数据 | - | 展开 | |
| 号源池 Controller 日志 | 00:01 045973 0.1.1 Trace GetClass请求参数:{JSON万达入参} | - | 展开 |
标识对照
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
号源池核心服务
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
关键日志位置
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
🔗 平台交接接口速查
4.1 预约挂号流程(完整链路,实时日志)
| 接口 | 功能说明 | 频率 | 关联流程 | |
|---|---|---|---|---|
| 门诊待缴费订单查询 (YJSGetOutpPresc) | 需增加出参 OperatorCode(操作工号), OperatorName(操作姓名) | - | 展开 |
🏥 HIS对接接口速查
2.2 万达信息集成平台
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
6.3 微信服务接口(万达→HIS)
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
6.4 预约服务接口(万达→号源池)
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
7.1 复高HIS接口
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
7.2 HIS医保线上支付
| 接口 | 功能说明 | 频率 | 关联流程 |
|---|
Server: . (本地)
Database: qmwx
User ID: wx
Password: weixin@112
Max Pool Size: 512
关键表:
bs_pay — 支付记录
UserSMS — 短信验证码
从INSERT SQL提取的真实字段:
| 字段 | 说明 | 示例值 |
|---|---|---|
| payid | 支付ID | 8382200 |
| userid | 用户标识 | FacePay (当面付) |
| customerid | 客户编号 | 208 |
| medicalcard | 就诊卡号 | -1 (当面付不传卡号) |
| paysite | 支付地点 | 0 |
| paytype | 支付类型 | 1 |
| pttype | 患者类型 | '' |
| branchid | 院区ID | -1 |
| deptid | 科室ID | -1 |
| deptname | 科室名称 | -1 |
| doctorid | 医生ID | -1 |
| doctorname | 医生名称 | -1 |
| feetype | 费用类型 | 4 (当面付订单) |
| feetypedescribe | 费用类型描述 | 当面付订单 |
| feeidhis | HIS费用ID | MZ4622399774048455944 |
| payaccount | 支付账户 | FacePay |
| paybillno | 支付流水号 | 4200003116202606122696082801 |
| feedate | 费用日期 | |
| paydate | 支付日期 | |
| originalmoney | 原始金额 | 5.85 |
| paymoney | 实付金额 | 5.85 |
| relationid | 关联ID | -1 |
| orderstatus | 订单状态 | 0=未付, 1=已付 |
| refundablemoney | 可退金额 | 5.85 |
| uitype | 界面类型 | wx |
| uiserviceId | 公众号ID | gh_050d71726e6f |
-- 验证码表
CREATE TABLE UserSMS (
UserId VARCHAR(50),
OpenId VARCHAR(50),
SMSCode VARCHAR(10),
ExpireTime DATETIME,
CreateTime DATETIME
)
-- 查询当天已发送次数
SELECT COUNT(1) FROM UserSMS
WHERE UserId='3D70FD46A4FE4F6E90E519CFE92303D9'
AND CONVERT(varchar(2), CreateTime, 108)='01' -- 当前小时
-- 验证码校验
SELECT ExpireTime FROM UserSMS
WHERE UserId='3D70FD46A4FE4F6E90E519CFE92303D9'
AND SMSCode='839610'
齐脉公众号业务使用 SQL Server 数据库:
Server: . (本地)
Database: qmwx
User ID: wx
Password: weixin@112
Trusted_Connection: False
Max Pool Size: 512
⚠️ 复高 HIS 端数据库齐脉无直接访问权限,所有 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('3D70FD46...', 'omWLGs2v...', '839610', '2026-06-15 01:42:33', '2026-06-15 01:37:33')
校验验证码:
SELECT ExpireTime FROM UserSMS
WHERE UserId='3D70FD46...' AND SMSCode='839610'
频次控制(每小时限制):
SELECT COUNT(1) FROM UserSMS
WHERE UserId='3D70FD46...' AND CONVERT(varchar(2), CreateTime, 108)='01'
关联模块: SMSService.SendContent
| 字段 | 类型 | 说明 | 示例值 |
|---|---|---|---|
| payid | VARCHAR | 支付ID(自增) | 8382200 |
| userid | VARCHAR | 用户标识 | FacePay(当面付) |
| customerid | VARCHAR | 客户编号 | 208 |
| medicalcard | VARCHAR | 就诊卡号 | -1(当面付不传) |
| paysite | VARCHAR | 支付地点 | 0 |
| paytype | VARCHAR | 支付类型 | 1 |
| feeidhis | VARCHAR | HIS费用ID | MZ4622399774048455944 |
| paybillno | VARCHAR | 微信支付流水号 | 4200003116202606122696082801 |
| paymoney | DECIMAL | 实付金额 | 5.85 |
| originalmoney | DECIMAL | 原始金额 | 5.85 |
| orderstatus | VARCHAR | 订单状态 | 0=未付, 1=已付 |
| refundablemoney | DECIMAL | 可退金额 | 5.85 |
| uitype | VARCHAR | 界面类型 | wx |
| uiserviceId | VARCHAR | 公众号AppId | gh_050d71726e6f |
| feetypedescribe | VARCHAR | 费用类型描述 | 当面付订单 |
| paydate | DATETIME | 支付完成时间 | |
| feedate | DATETIME | 费用产生时间 |
业务场景:
创建支付单:
INSERT INTO bs_pay(payid, userid, customerid, feeidhis, payaccount,
originalmoney, paymoney, orderstatus, uitype, uiserviceId, ...)
VALUES('8382200', 'FacePay', '208', 'MZ4622399774048455944',
'FacePay', '5.85', '5.85', '0', 'wx', 'gh_050d71726e6f', ...)
支付成功回写:
UPDATE bs_pay SET orderstatus='1',
paybillno='4200003116202606122696082801',
paydate='2026-06-12 12:15:40',
paymoney='5.85'
WHERE feeidhis='MZ4622399774048455944'
账单上传(分页查询未上传订单):
SELECT * FROM bs_pay WHERE orderstatus=0
ORDER BY payid OFFSET 0 ROWS FETCH NEXT 500 ROWS ONLY
关联模块: GeneFacePay、RequstFacePay、PayByOthers、GetBillList
| 数据库 | 用途 |
|---|---|
| qmwx | 主业务库(用户/预约/支付) |
新华崇明/
├── 公众号/
│ ├── 前台日志/ ← 公众号前端XML请求日志
│ │ ├── 20260615.txt ← 最新日志(5240行)
│ │ ├── 20251231.txt ← 历史日志
│ │ └── 20251231/ ← 按时间段拆分的前台日志
│ │ └── 21-HHMMSS-MMMM.txt ← 格式: 小时-分钟秒-毫秒
│ │
│ ├── 接口交付日志/ ← 内部API调用日志
│ │ ├── 2026.06.14.txt ← 50万+行(编码: GBK)
│ │ └── 2025.12.31-*.txt ← 历史日志
│ │
│ └── 支付日志/ ← 支付相关日志
│ ├── 20260612.txt ← 11万行
│ └── 20251231.txt ← 历史日志
│
├── 号源池/ ← 齐脉号源池系统日志
│ ├── Controller/20260614A/ ← 预约API日志
│ │ └── -BookApi{N}-.txt ← 按序号分割的BookApi日志
│ ├── QM.Server.Booking.Interface.10/20260614A/
│ │ └── Booking.CancelBooking-{GUID}-.txt ← 取消预约日志
│ ├── QM.Server.BPServer/ ← 号源核心日志
│ │ ├── date/ db/ error/ trace/
│ │ ...
│
└── 接口文档/ ← 对接文档
├── 万达信息-集成平台统一服务-接口文档-微信服务-V1.1.2.docx
├── 万达信息-集成平台统一服务-接口文档-预约服务-V1.1.2.docx
├── 复高通用服务接口规范new.docx
├── His医保线上支付对接HIS接口规范*.docx
├── 互联互通调整说明.txt ← 关键: 接口变更记录
├── 新华崇明互联互通接口文档/
├── 短信接口/
└── 诊间客户端2.0调用文档-v1.0.1.docx
| 错误现象 | 日志特征 | 可能原因 | 排查方式 |
|---|---|---|---|
| 号源查不到 | 没找到需要的数据 |
MapId对应科室无排班 | 检查MapId是否正确 |
| 预约重复提交 | SchedulingID相同 | 用户短时间内重复点击 | 前端防重复或后端校验 |
| 支付失败 | orderstatus=0 且 paybillno为空 |
微信支付超时/余额不足 | 查看 RequstFacePay-End 中的 ErrorMsg |
| Token过期 | encryKey无效 |
需重新获取Token | Token有效期约30分钟 |
| 患者查不到 | 返回空data | HIS中无该患者档案 | 引导线下建档 |