权益服务(绿通)
一、 核销扣减:#
1.权益核销扣减#
二、 信息同步:#
注意:
1、同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
2、后台通知交互时,如果京东收到商户的应答不符合规范或超时,会判定本次通知失败,重新发送通知,直到成功为止,但不保证通知最终一定能成功。
3、合作方在进行核销扣减操作时,需根据有效时间,等待期,状态进行判断,未在有效时间或状态无效会导致权益核销扣减失败。
4、用户权益项业务上可能会发生加次加项。 加项:新的用户权益项履约消息,正常处理即可。 加次:若供应商侧已有用户权益项ID,发生加次时,JD侧发送相同用户权益项ID的履约消息,并且次数为加次后总次数,合作方侧更新总次数 建议合作方侧根据用户权益项ID和总次数做幂等:
若接收到的用户权益项ID和总次数域合作方已有数据相同,则丢弃消息不处理
若接收到的用户权益项ID与合作方已有数据相同,但总次数不同,则合作方侧按照总次数最大的用户权益项更新数据
若接收到的用户权益项ID不同,直接落库
特别提醒:
1、商户系统对于通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成业务的异常。
2、当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。
3、验签和公共参数部分的说明请查看接收调用章节。
1. 预约记录同步#
业务参数说明:
| 参数名 | 类型 | 描述 |
|---|---|---|
| appointmentRecordId | Long | 预约服务单号 |
| beneficialId | Long | 权益ID |
| businessType | Integer | 权益场景(枚举值见下文) |
| providerCode | Integer | 供应商CODE |
| servicePackageConfigId | Long | 服务包ID |
| servicePackageRecordId | Long | 用户服务包ID |
| patientName | String | 患者姓名 |
| patientPhone | String | 患者手机号 |
| patientPhoneExtend | String | 分机号 |
| visitTime | String | 就诊时间 |
| visitDepartment | String | 就诊科室 |
| visitHospital | String | 就诊医院 |
| remarks | String | 备注 |
业务处理完成,统一返回结果格式如下:
| 参数名 | 下级参数 | 类型 | 描述 |
|---|---|---|---|
| reponse | |||
| code | String | 响应码,0000成功 | |
| data | Boolean | 返回数据true/false | |
| uuid | String | 日志ID | |
| errMsg | String | 错误描述 |
正确结果示例:
{"reponse":{"code":"0000","data":true,"uuid":"f602e02e-a8c6-4fed-94f5-d7052d16b033"}}错误结果示例:
{"reponse":{"code":"错误码","errMsg":"错误描述","uuid":"1ded1b62-c60f-4e4f-9620-a78a16b8f284"}}2. 履约记录同步#
业务参数说明:
| 参数名 | 类型 | 描述 |
|---|---|---|
| beneficialId | Long | 权益ID |
| businessType | Integer | 权益场景(枚举值见下文) |
| providerCode | Integer | 供应商CODE |
| totalCount | Integer | 权益细项享有总次数 |
| residueCount | Integer | 权益细项剩余总次数 |
| servicePackageConfigId | Long | 服务包ID |
| servicePackageRecordId | Long | 用户服务包ID |
| servicePackageType | Integer | 服务分类 |
| servicePackageSecondType | Long | 服务二级分类 |
| waitingPeriod | Integer | 等待期 |
| validityStartTime | String | 有效期-开始时间 |
| validityEndTime | String | 有效期-结束时间 |
| orderId | Long | 订单ID |
| orderTime | String | 订单创建时间 |
| finishTime | String | 订单完成时间 |
| cancelTime | String | 订单取消时间 |
| status | Integer | 状态(1有效 2无效) |
业务处理完成,统一返回结果格式如下:
| 参数名 | 下级参数 | 类型 | 描述 |
|---|---|---|---|
| reponse | |||
| code | String | 响应码,0000成功 | |
| data | Boolean | 返回数据true/false | |
| uuid | String | 日志ID | |
| errMsg | String | 错误描述 |
正确结果示例:
{"reponse":{"code":"0000","data":true,"uuid":"f602e02e-a8c6-4fed-94f5-d7052d16b033"}}错误结果示例:
{"reponse":{"code":"错误码","errMsg":"错误描述","uuid":"1ded1b62-c60f-4e4f-9620-a78a16b8f284"}}权益场景枚举:
| 类型 | 枚举 |
|---|---|
| 全国就医绿色通道 | 201 |
| 住院加急协调 | 202 |
| 远程名医问诊 | 204 |
| 重疾多学科MDT会诊 | 205 |
| 全程就医陪诊 | 209 |
| 大型检查加速 | 210 |
| 第二诊疗意见咨询 | 216 |
| 医护上门护理 | 217 |
| 手术加急协调 | 218 |
| 重疾绿色通道 | 219 |
| 重疾第二诊疗意见咨询 | 220 |
| 重疾住院手术加急 | 221 |
| 紧急医疗转运服务 | 222 |
| 海外视频二诊 | 223 |
| 海外书面二诊 | 224 |
| 海外转诊协调 | 225 |
| 国际医疗部绿通 | 226 |
| 高端医疗直付 | 227 |
| 住院垫付 | 228 |
| 肿瘤特药 | 229 |