~~~[api]
post:/api/goods/batchUp
*string:key#系统颁发的appkey,系统级参数
*string:timestamp#当前时间戳,系统级参数
*string:sign#签名,系统级参数
*json_array:goods_list#商品数组,例如[{},{},{},{}],每次批量操作的最大长度为100,100之后的不予处理
<<<
success
{"code":"0","msg":"操作成功","data":"","errors":[123456,1234567,12345678]}
code:错误码,0成功,其他失败
msg:错误消息
data:返回空字符串
errors:因为goods_list中加*的字段出错而被跳过的miscode数组
<<<
error
{"code":"1000","msg":"缺少XXXX参数","data":""}
~~~
goods_list对象属性如下:
*string:caption#商品名称,最长50个汉字
*string:miscode#商品在MIS系统中的店内码
*json_array:barcode_list#商品条码,例如[1234567,1234567,1234567,.......]
*float:price#商品售价,大于或者等于0
string:spec#商品规格
string:unit#商品单位
string:status#商品状态,0-上架,1-下架
string:photo#商品图片,只能传url地址,例如http://www.baidu.com
json_array:price_list#价格方案
价格方案中对象属性如下:
*string:begin#开始时间,yyyy-MM-dd hh:mm:ss格式例如2017- 10-10 01:01:01
*string:end#结束时间,yyyy-MM-dd hh:mm:ss格式例如2017- 10-10 01:01:01
*float:price#零售价
int:priority#优先级,数字越大优先级越高
价格方案的价格获取规则:
1、开始时间 < 当前时间 <= 结束时间
2、优先级最大
备注:平台会依据miscode进行重复检查,若miscode已存在则执行更新,否则新增;该接口不会返回失败,但是有错误数据时会将miscode放入errors数组返回;>
**要求所有参数进行url编码(仅限提交到平台接口时编码,签名时参数无需编码)**