Skip to main content

一、 药品信息查询:#

应用场景 京东提供了多场景和多维度来满足商户药品信息的查询,商户可根据实际业务需求申请调用。

1.根据药品属性查询药品信息列表#
2.根据药品skuId批量查询药品sku库存#
3.根据药品skuId查询详细信息#
4.分页获取药品skuId列表#

二、 药品信息变更:#

应用场景 药品基础信息,价格,库存变更时,京东会把相关药品变更信息通过数据流的形式发送给商户,商户需要接收处理,并按文档规范返回应答。

注意: 1、同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 2、后台通知交互时,如果京东收到商户的应答不符合规范或超时,会判定本次通知失败,重新发送通知,直到成功为止,但不保证通知最终一定能成功。

特别提醒: 1、商户系统对于通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成业务的异常。 2、当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。 3、验签和公共参数部分的说明请查看接收调用章节

1. 药品基础信息变更#

业务参数说明:

参数名类型描述
partnerSourceString药品对接渠道类型
skuIdString药品 Id
opInteger操作类型,为枚举值:1-增加信息、2-修改信息、 3-删除信息/下架、4-上架
sourceTimestampLong源头消息处理时间戳

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

参数名下级参数类型描述
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. 药品价格变更#

业务参数说明:

参数名类型业务描述
partnerSourceString药品对接渠道类型
skuIdString药品 Id
priceInteger药品价格,分为单位,1000代表10元
sourceTimestampLong源头消息处理时间戳

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

参数名下级参数类型描述
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"}}
3. 药品库存变更#

业务参数说明:

参数名类型业务描述
partnerSourceString药品对接渠道类型
skuIdString药品 Id
statusInteger状态值 1 有货、2 无货
stockSizeInteger药品库存(1-5真实数量,大于5为1000,无库存为0)
sourceTimestampLong源头消息处理时间戳

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

参数名下级参数类型描述
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"}}