# 微信长辈就医开发文档

## 一、功能介绍

微信长辈就医是微信官方提供的医疗行业适老化版本建设方案，医院公众号或小程序均可接入以实现适老化版开发，为老年患者提供友好的线上诊疗服务。

微信长辈就医主要包括三个功能：

1. 页面适老化改造标准方案，提供两种方式，接入微信长辈就医 SDK 或按微信长辈就医设计规范设计全流程；
2. 快捷建档接口，医院调用后可获得老年患者实名信息（姓名、身份证、手机号），免去建档填写的繁琐流程；
3. 门诊主流程消息推送接口，底层对接就医助手消息方案，为医院提供一整套消息能力，可按需调用生成可视化门诊就诊流程。

微信长辈就医体验路径：扫描下方二维码，按公众号引导开通后，点击「我的医院」菜单，查找含关怀版标志的医院进行挂号体验即可。

图1 微信长辈就医体验路径示意图

![](https://res8.wxqcloud.qq.com.cn/wxdoc/b4d19921-2754-4cb7-8893-6778ddd1f75f.png)

## 二、产品开发

### 2.1 调用方式

文档所有接口请求方式均为 HTTPS-POST 请求，UTF-8 编码，请求和相应参数仅支持 JSON 数据格式，所有接口的调用均需要获取[access_token](/miniprogram/dev/server/API/mp-access-token/api_getaccesstoken.md)授权。

服务商获取 access_token，走[微信开放平台-第三方平台](/doc/oplatform/Third-party_Platforms/2.0/product/Third_party_platform_appid.md)的模式，由医院为第三方服务商授权[134 微信长辈就医权限集](/doc/oplatform/Third-party_Platforms/2.0/product/offical_account_authority.md)，授权流程操作指引点击[这里](/doc/oplatform/Third-party_Platforms/2.0/operation/authorization/authorization_management.md)查看。

### 2.2 开发前的准备

开发准备清单如下，收集完备后提供给我们工作人员协助配置测试环境：

- 开发测试的公众号 AppID；
- 开发人员微信账号；
- 用来测试获取 wxmed_authcode 的测试路径，H5 链接或者小程序路径均可；
- 医院信息，字段如下：

| 字段                                            | 示例                                                         |
| :--------------------------------------------------- | ------------------------------------------------------------ |
| 医院名称                                             | 广东省第二人民医院                                           |
| 公众号昵称                                           | 广东省第二人民医院                                           |
| 公众号 AppID                                         | 公众号 AppID 信息                                             |
| 医院地址
提供省市区+详细地址+坐标，多院区分别提供 | 广东省广州市海珠区新港中路466号(23.094539;113.333887)
广东省广州市白云区机场路290号（23.179604;113.260129） |
| 医院等级                                             | 三级甲等                                                     |
| 是否公立                                             | 是                                                           |
| 医院属性                                             | 综合医院                                                     |

### 2.3 页面适老化改造标准方案

医院适老化建设中，微信长辈就医提供两种页面适老化改造标准方案，分别为**微信长辈就医 SDK**或按**微信长辈就医设计规范**设计全流程，下面会详细介绍两种方案，医院可按需选择。

#### 2.3.1 微信长辈就医 SDK

##### 1. SDK 文档

参见[微信长辈就医 SDK 方案](elderMedical-sdk)

##### 2. 方案介绍

本方案由微信提供一套包含门诊挂号、缴费、查询、个人中心（挂号、缴费记录）功能的标准化前端 SDK，医院只需要类似于接入 VUE 一样提供一个 div 的选择器进行初始化后，在不同的页面步骤中传入对应的协议字段， SDK 就会在对应 div 中渲染出对应状态的适老化后的页面，轻松实现线上字体放大、按钮放大、对比度加深、页面交互简化，便捷老年患者操作。

页面样式以及交互全部由 SDK 进行处理，接入方只需要处理页面的逻辑部分（数据接口拉取、事件钩子回调逻辑等）。

> 图2-1 微信长辈就医 SDK 挂号流程

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t4fhppaMWo8TYq7lTaChaEOtZQg2727gxqKq8FxUBKT0EDn-mRdLHqVod7gBcmXyBg)

> 图2-2 微信长辈就医 SDK 挂号流程

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t5xuuEqHugVeiBdnLF4A52TucH1GEdAzOy_pZdCVQ7i61umIuLi8WxLTnJaZBGAYGw)

> 图3 微信长辈就医 SDK 缴费流程

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t1QEtH6Sz8zEsYDC_9loiavPiond139QgTZWOZB3kaAIStUNPiyfGh0sVUuiat4cVg)

> 图4 微信长辈就医 SDK 报告查询流程

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9twc3w1boSc9PoxsVe1Rsh-QbaabvXdcdR93n0qZVa9-LcKuembgLAHKPgD5xxdINsA)

##### 3. 方案说明

本 SDK 方案目前支持 H5 形式，若医院计划使用 H5 提供适老化服务，可直接参照[微信长辈就医 SDK 方案](elderMedical-sdk)文档开发。

若医院计划采用小程序形式开发，也可接入本方案，通过小程序内嵌 webview 实现。因小程序内嵌 webview 不支持拉起支付，故此处支付流程需切换为小程序支付实现。

##### 4. 就医公告接口（选用）

部分医院挂号过程中，可能需要向患者展示来院就诊前的注意事项，我们把这类信息称为就医公告，如下图。

> 图5 医院就医须知 demo

![descript](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t-Qjfc_ZZdiqJ6GZwkv8A6MclraqiJJpxUIovSVNx4JpNcBgp23w8sFDBeF1H0fZLg)

SDK 支持医院按既定样式展示就医公告，可通过本接口进行内容设置。设置步骤为：`添加草稿->编辑人员线上预览草稿->确认发布`，医院也可以直接跳过预览步骤，将公告直接发布。

**步骤一：[添加公告草稿](/miniprogram/dev/server/API/cityservice/elderMedical/api_sethopsnotice.md)**

  > 图6 医院就医公告富文本 demo
  >
  > ![descript](https://res.wx.qq.com/op_res/uuuyIn2NDBPzbSu0VnQ13p3rhzd1Ia1pLHw2asLrkBCb3LPMByLPpF3AcsomS2ZyvHuKaw1AmJv8yeD1X2xRQQ)

**步骤二：[公告草稿预览设置](/miniprogram/dev/server/API/cityservice/elderMedical/api_previewhopsnotice.md)**

**步骤三：[正式发布公告](/miniprogram/dev/server/API/cityservice/elderMedical/api_intp_eldermed_publichopsnotice.md)**

**步骤四：[查询所有公告](/miniprogram/dev/server/API/cityservice/elderMedical/api_intp_eldermed_gethospnoticelist.md)**

#### 2.3.2 微信长辈就医设计规范

##### 1. 规范文档

参见[微信长辈就医开发文档](elderMedical-api)

##### 2. 规范介绍

微信长辈就医设计规范由微信提供一套页面适老化设计规范，医院可参考规范，遵循可感知性、可操作性、理解性、兼容性和安全性设计老年用户访问的界面功能，功能开发完毕后经微信团队验收通过即可发布上线。本方案设计、前后端均由医院实现。

##### 3. 开通组件

医院可在适老化入口调用本组件，调用后用户进入微信长辈就医标准化开通流程，开通后医院可调用本节「4. 实名组件」，获取用户实名信息。

> 图7 微信长辈就医开通组件

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t-U-sHnrU06hg6doXkVnEMhgTcVlM3kwShbRbQ4uwKQMdd9hPuNuu0yUtr1CoWGdTA)

**H5开通组件**

H5 的跳转链接为：

``` bash
https://mp.weixin.qq.com/insurance/template/eldermedical/open.html?appid={appid}#wechat_redirect
```
> 链接上的 {appid} 需要替换成公众号的 AppID。

**小程序开通组件**

``` javascript
wx.navigateToMiniProgram({
    appId: 'wx308bd2aeb83d3345',
    path: '/subPages/medical-mvp/auth/main?from=hospital&appid={appid}',
    complete: (res) => {
      console.log('onTapToEldmOpen res', res)
    }
});
```

##### 4. 实名组件

医院可在挂号时按需调用实名组件，调用后将唤起微信实名授权弹窗，经用户同意，微信将生成长辈就医信息授权码 wxmed_authcode 并传递给医院页面，医院可调用**3.4.1 查询用户实名 API** 进行解密并帮助老年患者完成后台建档，免去填写个人信息的繁琐工作。

> 图8 微信长辈就医实名组件

![](https://res.wx.qq.com/op_res/uuuyIn2NDBPzbSu0VnQ13n2yDfOly6BYxN-yoz7jhRqPoG0lRUNJd6wJgsKWfvvrp-AraHOF-WFWkKpT9P-wUg)

**H5实名组件**

H5 的跳转链接为：

``` bash
https://mp.weixin.qq.com/insurance/template/eldermedical/auth-realname.html?appid={appid}&returnUrl={returnUrl}#wechat_redirect
```
> 说明：链接上的参数 `{returnUrl}` -> 授权后会返回此 `{returnUrl}`，注意链接必须经过 `encodeURIComponent`，授权获得的 `wxamedAuthcode` 会携带在此参数上返回。
参数 `{appid}` 需要替换成公众号的 `appid`。

**小程序实名组件**

``` javascript
wx.openBusinessView({
    businessType: 'eldermedicalAuthRealname',
    queryString: 'appid={appid}',
    complete: (res) => {
      console.log('onTapToEldmAuth res code', res.extraData.wxamedAuthcode)
    }
});
```

### 2.4 API 接口列表

#### 2.4.1 查询用户实名 API

##### 1. 接口说明

为降低老年患者建档门槛，微信向公立医院免费提供本接口。老年患者挂号时，医院可通过本接口查询用户实名信息（姓名、身份证、手机号），并获取上述信息在后台为用户创建诊疗卡，后续老年患者挂号时无需再次建档，可直接挂号。

上述流程示例：

用户访问医院适老版主页时，实名开通微信长辈就医服务。使用医院关怀版服务时，院方可请求查询用户实名 API 获取实名信息，完成后台建档**（说明：下图全部流程由微信提供，医院无需开发前端界面）。**

> 图9 微信长辈就医获取用户实名授权流程（若用户已在别处开通长辈就医，则点击图一服务直接拉起第五张图的实名弹窗）

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t4F-F7PfqlAFV9VPf3eUgiB5F6ByVERlOpbpzgf1IDwxwMHTVsKLrPWxY6ZAhyB0tw)

**用户点击医院服务后，医院获取实名的时序图如下：**

> 图10 微信长辈就医获取用户实名时序图
> 
![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t1_dQ2xvMV4j43t30xGjznpQs6L4G9yPol5l5y0PBclogsQt7O__ggIpvJFdKSkULA)

时序图说明： 

1. 用户进入医院适老版主页，点击医院挂号服务;
2. 用户同意授权将实名信息传递给医院；
3. 微信生成长辈就医信息授权码 wxmed_authcode；
4. 跳转医院的挂号页面，wxmed_authcode 通过 url query 传递给医院，示例如下：

   ```bash
    小程序path: /pages/registerpage?wxmed_authcode=xxx
    h5链接：https://registerpage.hospital.com?wxmed_authcode=xxx
    ```
5. 进入医院的建档流程；
6. 医院后台通过[查询用户实名 API](/miniprogram/dev/server/API/cityservice/elderMedical/api_cityservice_getmedrealname.md)和 wxmed_authcode，查询用户的身份信息和手机号；
7. 微信返回加密后的用户身份信息和手机号；
8. 微信给每家医院分配了各自的实名信息解密 KEY，解密后可获得用户实名信息；开发者提供本文档 2.2 要求的信息后由微信工作人员提供解密密钥；
9. 医院完成后续的建档和挂号流程。

##### 2. 接口详情

请查看 [查询用户实名 API](/miniprogram/dev/server/API/cityservice/elderMedical/api_cityservice_getmedrealname.md) 文档

#### 2.4.2 门诊主流程消息推送

##### 1. 接口说明

医院调用本接口推送 4 条门诊主流程消息（挂号成功通知、待缴费订单通知、检验检查报告、取药提醒）给用户，用户点击可访问医院相关服务的适老化页面。

此外，为了便利患者，我们也建议医院通过长辈就医下发停诊通知、排队候诊提醒、检验检查排队提醒、取消预约挂号通知和缴费成功通知。

> 注意事项：
>
> 1. 接口中 status 值 1501001、1501018、1501030、1501031、1501034 分别对应预约挂号成功通知、门诊待缴费提醒、检查结果通知、检验结果通知、取药提醒这 5 条消息，是门诊就医主流程消息，必须下发；
>
> 2. status 值 1501010、1501014、1501026、1501027、1501004、1501019 分别对应停诊通知、排队候诊提醒、检查排号提醒、检验排号提醒、取消预约挂号通知、门诊缴费成功通知，是门诊就医体验优化类消息，建议下发；
>
> 3. 为给医院提供丰富的模板消息，同时减少医院对接的工作，本接口和就医助手共用同一套消息接口和模板库。曾经对接过就医助手的医院只需在原就医助手的基础上，提供适老化的网页链接或小程序页面路径，即可完成改造。

Demo 示例：

医院调用本接口后，老年患者**可在【微信长辈就医】公众号中收到院方下发的就医主流程消息，消息跳转到院方服务。**

> 图11 微信长辈就医消息下发流程

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t6sWOkEEFbiODjWiiwM48gcEelnBtu2uZpldaWJqZ1uupc7N0CJ9KiWBRHQ9Kz8CGQ)

##### 2. 接口详情

参见[微信就医助手消息能力](medicalassistant)

#### 2.4.3 查询用户是否开通长辈就医功能

##### 1. 接口说明

微信长辈就医功能需用户简单开通，用户有多种开通方式，包括：

**路径1 访问医院公众号、小程序的适老版主页时开通，适老版主页生成方式参见 2.5；**

> 图12 医院公众号/小程序入口访问长辈就医服务

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t0gG9gSx8bojtQ0ZYsxJ_RkRg5HOtlulbXfvhn-wRjS_NirxrjXq5hiUup3Cd7iHQQ)

**路径2 访问「微信」-「我」-「服务」-「城市服务」-「医疗」-「长辈就医」进行开通；**

> 图13 微信城市服务入口访问长辈就医服务

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t22QCTHSqJr6bFQet7kcYkel8EX18kHpg-YpLCTdYFgNghLyYYg7PoIBfyNYYURChg)

**路径3 关注「微信长辈就医」公众号，按指引开通。**

> 图14 微信长辈就医公众号访问长辈就医服务

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9tySNdWNN91EscD1Olu_-vG8RySNfRnEwc0vI8VUi7gzXqDUDovXkr_PrbOwwjXoaCw)

医院调用本接口可查询用户开通状态。

**请注意：**

1）该开通流程无需医院开发，为微信统一流程；
2）用户开通状态为「已开通」时，才可以获取用户实名信息和推送门诊主流程消息。

##### 2. 接口详情

[查询用户是否开通](/miniprogram/dev/server/API/cityservice/elderMedical/api_cityservice_getmsgrelation.md)

### 2.5 医院适老版主页

医院参照文档完成前述流程开发后，可将适老化版本放在公众号、小程序上供老年用户访问，具体如下：

#### 2.5.1 放置入口

为降低老年患者查找成本，建议将适老版入口放在医院微信公众号菜单或小程序首页。入口文案由医院自定义，可参考名称：长辈模式、长辈服务、关怀版。

> 图15 医院微信公众号/小程序长辈就医入口示例图

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t-XVMLrvU-0ygAjsAfek3OIoD1F1xkLuHFGV0L0kKPf3CBnN9euBlUOrO6l0ddY4YQ)

#### 2.5.2 医院适老版主页生成

微信提供快速生成医院适老版主页的能力，无需额外开发，医院提供已开发好的挂号、缴费、查询报告、个人中心（挂号、缴费记录）功能链接/路径，即可快速生成适老版主页，供用户访问。

适老版主页主色调可自适应医院公众号主色值。

> 图16 医院适老版主页示例图

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t5sRvTAYNMEVbQmyR2lkGzyiYvrGm4h7kQO2klbFuSn1_o5TfYaF0LkiMQqsNsjzXw)

##### 1. 公众号适老版主页生成方式

H5 的跳转链接为：

``` bash
https://mp.weixin.qq.com/insurance/template/eldermedical/hospital-homepage.html?appid={appid}#wechat_redirect
```

链接上的 `{appid}` 需要替换成公众号的 `appid`。

##### 2. 小程序适老版主页生成方式

``` javascript
wx.navigateToMiniProgram({
    appId: 'wx308bd2aeb83d3345',
    path: '/subPages/medical-mvp/hospital-homepage/main?appid={appid}',
    complete: (res) => {
      console.log('onTapToEldmHomePage res', res)
    }
});
```

## 三、验收材料和宣传物料

### 3.1 验收要求

为确保微信老年用户就医体验，微信团队将对本功能进行验收，可通过第四点联系我们获取验收指引。

### 3.2 宣传物料

为便利医院线下推广本功能，我们准备了易拉宝、桌贴、海报的源文件，医院可下载并二次制作，点击查看[微信长辈就医宣传物料](https://drive.weixin.qq.com/s?k=AJEAIQdfAAo6C9ropv#/)。

## 四、联系我们

对上述产品有任何疑问，欢迎联系我们。

![](https://res.wx.qq.com/op_res/65B1rY0g0ylKLDvJStu9t7b8Ybi32-08aC7h9Ub66DLsXGs2x7VUtEZb6OJ4nb3LvFQLwMlySJf8QRrDfe7RCg)

## 五、修订记录

- 2024年03月20日：消息推送接口与就医助手合并，原长辈就医消息接口即将下线；
- 2024年4月23日：新增医院适老版主页调用说明，详见 2.5；新增按视觉规范设计开发方式，详见 2.3.2；