API功能描述
门店商品库存上下架状态消息
接口地址: http://xxx.xxx.xxx/xxx/djsw/stockIsHave,其中红色部分自定义。
授权类型
需要
应用场景
商家操作门店商品库存可售状态,推送门店商品库存可售状态消息。(发送报文时URL encode(utf-8)编码,接收报文时URL decode(utf-8)解码)
系统级别输入参数
字段 | 类型 | 是否必须 | 描述 |
token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。 |
format | String | 是 | 暂时只支持json |
v | String | 是 | API协议版本,可选值:1.0 |
应用级别输入参数
字段 | 类型 | 是否必须 | 示例值 | 描述 |
stationNo | String | 是 | 10006602 | 到家门店编号 |
skuId | String | 是 | 2006492299 | 到家商品编号 |
have | String | 是 | true | 是否有货(可用库存是否大于0):true 有货,false无货 |
vendibility | String | 是 | 0 | 门店商品上下架等同于是否可售(0:上架即可售 1:下架即不可售) |
operPin | String | 是 | test | 操作人 |
operTime | String | 是 | 1491378912188 | 操作时间,商家需要保存操作时间,当接收到相同的门店商品消息记录时,需按照操作时间先后顺序进行状态更新,也即当收到消息的操作时间小于当前记录的操作时间,不需要做状态更新。 |
operSource | String | 是 | 10 | 操作来源,1:京东LSP, 2:京东医药城, 3:京东厂商直送, 4:京东One, 5:库存中心, 6:订单中心, 7:商品系统, 8:前置仓, 9:门店系统, 10:商家中心, 11:开放平台, 13:捡货系统, 14:批量上下架任务 |
stockout | String | 是 | 0 | 是否缺货(0 不缺货,1 缺货) |
返回结果
字段 | 类型 | 示例值 | 描述 |
code | String | 0 ,-1 | 结果值 错误码定义规则请见:消息类接口开发规范 |
msg | String | 结果描述 | |
data | String | 结果详细信息 |
返回示例值
JSON 数据格式