首页>常规接口> 新版新增商品信息接口【pms/addSku】

到家侧接口开发规范

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 数据格式

API测试工具