权益服务(绿通)
#
一、 核销扣减: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 |