Skip to main content

权益服务(绿通)

一、 核销扣减:#

1.权益核销扣减#

二、 信息同步:#

注意:

1、同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。

2、后台通知交互时,如果京东收到商户的应答不符合规范或超时,会判定本次通知失败,重新发送通知,直到成功为止,但不保证通知最终一定能成功。

3、合作方在进行核销扣减操作时,需根据有效时间,等待期,状态进行判断,未在有效时间或状态无效会导致权益核销扣减失败。

4、用户权益项业务上可能会发生加次加项。 加项:新的用户权益项履约消息,正常处理即可。 加次:若供应商侧已有用户权益项ID,发生加次时,JD侧发送相同用户权益项ID的履约消息,并且次数为加次后总次数,合作方侧更新总次数 建议合作方侧根据用户权益项ID和总次数做幂等:

  • 若接收到的用户权益项ID和总次数域合作方已有数据相同,则丢弃消息不处理

  • 若接收到的用户权益项ID与合作方已有数据相同,但总次数不同,则合作方侧按照总次数最大的用户权益项更新数据

  • 若接收到的用户权益项ID不同,直接落库

特别提醒:

1、商户系统对于通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成业务的异常。

2、当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。

3、验签和公共参数部分的说明请查看接收调用章节

1. 预约记录同步#

业务参数说明:

参数名类型描述
appointmentRecordIdLong预约服务单号
beneficialIdLong权益ID
businessTypeInteger权益场景(枚举值见下文)
providerCodeInteger供应商CODE
servicePackageConfigIdLong服务包ID
servicePackageRecordIdLong用户服务包ID
patientNameString患者姓名
patientPhoneString患者手机号
patientPhoneExtendString分机号
visitTimeString就诊时间
visitDepartmentString就诊科室
visitHospitalString就诊医院
remarksString备注

业务处理完成,统一返回结果格式如下:

参数名下级参数类型描述
reponse
codeString响应码,0000成功
dataBoolean返回数据true/false
uuidString日志ID
errMsgString错误描述

正确结果示例:

{"reponse":{"code":"0000","data":true,"uuid":"f602e02e-a8c6-4fed-94f5-d7052d16b033"}}

错误结果示例:

{"reponse":{"code":"错误码","errMsg":"错误描述","uuid":"1ded1b62-c60f-4e4f-9620-a78a16b8f284"}}
2. 履约记录同步#

业务参数说明:

参数名类型描述
beneficialIdLong权益ID
businessTypeInteger权益场景(枚举值见下文)
providerCodeInteger供应商CODE
totalCountInteger权益细项享有总次数
residueCountInteger权益细项剩余总次数
servicePackageConfigIdLong服务包ID
servicePackageRecordIdLong用户服务包ID
servicePackageTypeInteger服务分类
servicePackageSecondTypeLong服务二级分类
waitingPeriodInteger等待期
validityStartTimeString有效期-开始时间
validityEndTimeString有效期-结束时间
orderIdLong订单ID
orderTimeString订单创建时间
finishTimeString订单完成时间
cancelTimeString订单取消时间
statusInteger状态(1有效 2无效)

业务处理完成,统一返回结果格式如下:

参数名下级参数类型描述
reponse
codeString响应码,0000成功
dataBoolean返回数据true/false
uuidString日志ID
errMsgString错误描述

正确结果示例:

{"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