更新产品
支持平台： 淘宝
更新产品
支持平台： 淘宝
需授权
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| method | String | 是 | API接口名称 |
| certi_id | Number | 否 | 分配给应用的证书ID |
| from_node_id | String | 是 | API调用的来源节点ID,对于第三方开发者来说，此id即为申请应用颁发的APP KEY |
| from_api_v | String | 否 | 请求方版本号 |
| to_node_id | String | 否 | API调用的目的节点ID(除了基础服务类api，其他接口必传此参数) |
| to_api_v | String | 否 | 接收方版本号 |
| callback_url | String | 否 | 响应回调地址，带http路径的标准URL。（调用异步接口此参数必填） |
| v | String | 是 | 矩阵API协议版本，可选值:1.0 |
| timestamp | String | 是 | 时间戳，格式为yyyy-MM-dd hh:mm:ss，例如：2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟 |
| format | String | 是 | 可选，指定响应格式。默认JSON ,目前支持格式为JSON |
| sign | String | 是 | 对调用API时所有输入参数（包括应用级参数）进行签名结果 |
| 名称 | 类型 |
|
示例值 | 默认值 | 描述 |
|---|---|---|---|---|---|
| sku_standard_prices | String |
淘宝(必填) |
10.50,11.00,20.50 |
sku采购基准价，单位元，例："10.50,11.00,20.50"，字段必须和上面的sku_ids或sku_properties保持一致 |
|
| sku_properties | String |
淘宝(必填) |
ku属性。格式:pid:vid;pid:vid,表示一组属性如:1627207:3232483;1630696:3284570,表示一组:机身颜色:军绿色;手机套餐:一电一充。多组之间用逗号“,”区分。(属性的pid调用taobao.itemprops.get取得，属性值的vid用taobao.itempropvalues.get取得vid) 通过此字段可新增和更新sku。若传入此值将忽略sku_ids字段。sku其他字段与此值保持一致。 |
||
| sku_properties_del | String |
淘宝(必填) |
根据sku属性删除sku信息。需要按组删除属性 |
||
| is_authz | String |
淘宝(必填) |
产品是否需要授权isAuthz:yes|no yes:需要授权 no:不需要授权 |
||
| pic_path | String |
淘宝(必填) |
产品主图图片空间相对路径或绝对路径 |
||
| image | String |
淘宝(必填) |
主图图片，如果pic_path参数不空，则优先使用pic_path，忽略该参数 支持的文件类型：gif,jpg,jpeg,png,bmp |
||
| properties | String |
淘宝(必填) |
产品属性 |
||
| property_alias | String |
淘宝(必填) |
属性别名 |
||
| input_properties | String |
淘宝(必填) |
自定义属性。格式为pid:value;pid:value |
||
| dealer_cost_price | String |
淘宝(必填) |
经销采购价，单位：元。例：“10.56”。必须在0.01元到10000000元之间。 |
||
| sku_dealer_cost_prices | String |
淘宝(必填) |
sku的经销采购价。如果多个，用逗号分隔，并与其他sku信息保持相同顺序。其中每个值的单位：元。例：“10.56,12.3”。必须在0.01元到10000000元之间。 |
||
| category_id | Number |
淘宝(必填) |
所属类目id，参考Taobao.itemcats.get，不支持成人等类目，输入成人类目id保存提示类目属性错误。 |
||
| standard_retail_price | String |
淘宝(必填) |
零售基准价，单位：元。例：“10.56”。必须在0.01元到10000000元之间。 |
||
| pid | Number |
淘宝(必填) |
产品ID |
||
| name | String |
淘宝(可选) |
产品名称 |
||
| standard_price | String |
淘宝(可选) |
标准价格，单位：元。例：“10.56”。 |
||
| cost_price | String |
淘宝(可选) |
采购价格，单位：元。例：“10.56”。 |
||
| retail_price_low | String |
淘宝(可选) |
最低零售价，单位：元。例：“10.56”。 |
||
| retail_price_high | String |
淘宝(可选) |
最高零售价，单位：元。例：“10.56”。 |
||
| outer_id | String |
淘宝(可选) |
商家编码 |
||
| quantity | Number |
淘宝(可选) |
产品库存 |
||
| alarm_String | Number |
淘宝(可选) |
警戒库存 |
||
| desc | String |
淘宝(可选) |
产品描述，长度为5到25000字符。 |
||
| province | String |
淘宝(可选) |
所在地：省，例：“浙江” |
||
| city | String |
淘宝(可选) |
所在地：市，例：“杭州” |
||
| postage_type | String |
淘宝(可选) |
运费类型，可选值：seller（供应商承担运费）、buyer（分销商承担运费），默认seller。 |
||
| postage_id | String |
淘宝(可选) |
运费模板ID(淘宝的运费模版ID) |
||
| postage_ordinary | String |
淘宝(可选) |
平邮费用，单位：元。例：“10.56”。 |
||
| postage_fast | String |
淘宝(可选) |
快递费用，单位：元。例：“10.56”。 |
||
| postage_ems | String |
淘宝(可选) |
ems费用，单位：元。例：“10.56”。 |
||
| status | String |
淘宝(可选) |
发布状态，可选值：up（上架）、down（下架）、delete（删除） |
||
| sku_ids | String |
淘宝(可选) |
sku id列表，例：1001,1002,1003 |
||
| sku_cost_prices | String |
淘宝(可选) |
sku采购价格，单位元，例："10.50,11.00,20.50"，字段必须和上面的sku_ids保持一致。 |
||
| sku_quantitys | String |
淘宝(可选) |
sku库存，例："10,20,30"。 |
||
| sku_outer_ids | String |
淘宝(可选) |
sku商家编码，例："S1000,S1002,S1003"。 |
||
| have_invoice | String |
淘宝(可选) |
是否有发票，可选值：false（否）、true（是），默认false |
||
| have_guarantee | String |
淘宝(可选) |
是否有保修，可选值：false（否）、true（是），默认false |
||
| discount_id | Number |
淘宝(可选) |
折扣ID |
| 名称 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| fenxiao_product | Fenxiao_Product | 是 | 返回 pid,modified |
{
"rsp":"fail",
"msg_id":"3463421b2581604c74dcb9b74ffab2e4"
"data":{
"fenxiao_product":{
"pid": "52",
"modified": 2000-01-01 00:00:00
}
}
}
| 错误码 | 错误描述 | 解决方案 |
|---|
