#
一、 药品信息查询:应用场景 京东提供了多场景和多维度来满足商户药品信息的查询,商户可根据实际业务需求申请调用。
1.根据药品属性查询药品信息列表#
2.根据药品skuId批量查询药品sku库存#
3.根据药品skuId查询详细信息#
4.分页获取药品skuId列表#
#
二、 药品信息变更:应用场景 药品基础信息,价格,库存变更时,京东会把相关药品变更信息通过数据流的形式发送给商户,商户需要接收处理,并按文档规范返回应答。
注意: 1、同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 2、后台通知交互时,如果京东收到商户的应答不符合规范或超时,会判定本次通知失败,重新发送通知,直到成功为止,但不保证通知最终一定能成功。
特别提醒: 1、商户系统对于通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成业务的异常。 2、当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。 3、验签和公共参数部分的说明请查看接收调用章节。
#
1. 药品基础信息变更业务参数说明:
参数名 | 类型 | 描述 |
---|---|---|
partnerSource | String | 药品对接渠道类型 |
skuId | String | 药品 Id |
op | Integer | 操作类型,为枚举值:1-增加信息、2-修改信息、 3-删除信息/下架、4-上架 |
sourceTimestamp | Long | 源头消息处理时间戳 |
业务处理完成,统一返回结果格式如下:
参数名 | 下级参数 | 类型 | 描述 |
---|---|---|---|
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. 药品价格变更业务参数说明:
参数名 | 类型 | 业务描述 |
---|---|---|
partnerSource | String | 药品对接渠道类型 |
skuId | String | 药品 Id |
price | Integer | 药品价格,分为单位,1000代表10元 |
sourceTimestamp | Long | 源头消息处理时间戳 |
业务处理完成,统一返回结果格式如下:
参数名 | 下级参数 | 类型 | 描述 |
---|---|---|---|
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"}}
#
3. 药品库存变更业务参数说明:
参数名 | 类型 | 业务描述 |
---|---|---|
partnerSource | String | 药品对接渠道类型 |
skuId | String | 药品 Id |
status | Integer | 状态值 1 有货、2 无货 |
stockSize | Integer | 药品库存(1-5真实数量,大于5为1000,无库存为0) |
sourceTimestamp | Long | 源头消息处理时间戳 |
业务处理完成,统一返回结果格式如下:
参数名 | 下级参数 | 类型 | 描述 |
---|---|---|---|
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"}}