到家侧接口开发规范
API功能描述
新版新增商品信息接口
接口地址:https://openapi.jddj.com/djapi/pms/addSku
授权类型
是
应用场景
到家的商品信息为商家维度,利用该接口创建的即为商家维度的商品,该商家下所有门店共用一套商品信息。 商品信息分为标准商品和非标准商品,标准商品意味着带有upc码,商品的分类与upc码有一定关系 1、有些分类下是不要求填写upc码的,水果/蔬菜,水产,肉品几个大类的不校验upc必填,还有散装的一些类别也不校验,这相关类目商品可以不填upc,如果填就一定要符合校验 2、当入参UPC码是到家标库商品UPC码时,到家系统会自动匹配商品品牌类目信息(返回结果:code:0,msg:品牌或分类同步失败,到家已经设置为标库对应的品牌分类),但是图片信息会按照商家实际传的图片保存(中文字符需要改成中文全角,URL特殊字符需encode转义) 3、处方药商品不能通过此接口增加,否则会返回错误码1001096,提示处方药商品请根据商品UPC码批量新增商品接口创建。 4、商品创建是异步的,接口返回结果状态码(resultCode)为1009000(这种一般就是成功),需要调用接口查询新建结果:新版查询商品创建状态接口
系统级别输入参数
字段 | 类型 | 是否必须 | 描述 |
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 |
应用级别输入参数
字段 | 类型 | 是否必须 | 示例值 | 描述 |
返回结果
字段 | 类型 | 示例值 | 描述 |
code | String | 0 | 0表示成功,其他均为失败。 详见:到家平台状态码说明 |
msg | String | 操作成功 | 结果描述 |
+data | String | ,该属性值为字符串型JSON数据,请先按照字符串取值,再解析转换成JSON对象。 |
返回示例值
JSON 数据格式