更新分销平台产品数据,不传更新数据返回失败
1. 对sku进行增、删操作时,原有的sku_ids字段会被忽略,请使用sku_properties和sku_properties_del。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
pid | Number | 必须 | 444 | 产品ID | |
name | String | 可选 | 袜子 | 产品名称,长度不超过60个字节。 | |
standard_price | String | 可选 | 10.56 | 采购基准价,单位:元。例:“10.56”。必须在0.01元到10000000元之间。 | |
standard_retail_price | String | 可选 | 10.56 | 零售基准价,单位:元。例:“10.56”。必须在0.01元到10000000元之间。 | |
retail_price_low | String | 可选 | 10.56 | 最低零售价,单位:元。例:“10.56”。必须在0.01元到10000000元之间。 | |
retail_price_high | String | 可选 | 10.56 | 最高零售价,单位:元。例:“10.56”。必须在0.01元到10000000元之间,最高零售价必须大于最低零售价。 | |
cost_price | String | 可选 | 10.56 | 代销采购价格,单位:元。例:“10.56”。必须在0.01元到10000000元之间。 | |
dealer_cost_price | String | 可选 | 12.5 | 经销采购价,单位:元。例:“10.56”。必须在0.01元到10000000元之间。 | |
outer_id | String | 可选 | hz00141 | 商家编码,长度不能超过60个字节。 | |
quantity | Number | 可选 | 10 | 产品库存必须是1到999999。 | |
desc | String | 可选 | 红色 | 产品描述,长度为5到25000字符。 | |
category_id | Number | 可选 | 234545 | 所属类目id,参考Taobao.itemcats.get,不支持成人等类目,输入成人类目id保存提示类目属性错误。 | |
properties | String | 可选 | 10000:10000 | 产品属性 | |
property_alias | String | 可选 | 1627207:28335:绿荫色 | 属性别名 | |
input_properties | String | 可选 | 20000:品牌名 | 自定义属性。格式为pid:value;pid:value | |
pic_path | String | 可选 | i5/T1rnNbXjOdutLe6Rra_091834.jpg | 产品主图图片空间相对路径或绝对路径 | |
image | byte[] | 可选 | 主图图片 |
|
主图图片,如果pic_path参数不空,则优先使用pic_path,忽略该参数 |
prov | String | 可选 | 浙江 | 所在地:省,例:“浙江” | |
city | String | 可选 | 杭州 | 所在地:市,例:“杭州” | |
postage_type | String | 可选 | seller | 运费类型,可选值:seller(供应商承担运费)、buyer(分销商承担运费)。 | |
postage_id | Number | 可选 | 434343 | 运费模板ID,参考taobao.postages.get。更新时必须指定运费类型为 buyer,否则不更新。 | |
postage_ordinary | String | 可选 | 10.56 | 平邮费用,单位:元。例:“10.56”。大小为0.01元到999999元之间。更新时必须指定运费类型为buyer,否则不更新。 | |
postage_fast | String | 可选 | 10.56 | 快递费用,单位:元。例:“10.56”。大小为0.01元到999999元之间。更新时必须指定运费类型为buyer,否则不更新。 | |
postage_ems | String | 可选 | 10.56 | ems费用,单位:元。例:“10.56”。大小为0.01元到999999元之间。更新时必须指定运费类型为buyer,否则不更新。 | |
have_invoice | String | 可选 | true | 是否有发票,可选值:false(否)、true(是),默认false。 | |
have_quarantee | String | 可选 | true | 是否有保修,可选值:false(否)、true(是),默认false。 | |
status | String | 可选 | delete | 发布状态,可选值:up(上架)、down(下架)、delete(删除),输入非法字符则忽略。 | |
sku_ids | String | 可选 | 1001,1002,1003 | sku id列表,例:1001,1002,1003。如果传入sku_properties将忽略此参数。 | |
sku_standard_prices | String | 可选 | 10.50,11.00,20.50 | sku采购基准价,单位元,例:"10.50,11.00,20.50",字段必须和上面的sku_ids或sku_properties保持一致。 | |
sku_cost_prices | String | 可选 | 10.50,11.00,20.50 | sku采购价格,单位元,例:"10.50,11.00,20.50",字段必须和上面的sku_ids或sku_properties保持一致。 | |
sku_dealer_cost_prices | String | 可选 | 12.3,12.5 | sku的经销采购价。如果多个,用逗号分隔,并与其他sku信息保持相同顺序。其中每个值的单位:元。例:“10.56,12.3”。必须在0.01元到10000000元之间。 | |
sku_quantitys | String | 可选 | 10,20,30 | sku库存,单位元,例:"10,20,30",字段必须和sku_ids或sku_properties保持一致。 | |
sku_outer_ids | String | 可选 | S1000,S1002,S1003 | sku商家编码 ,单位元,例:"S1000,S1002,S1003",字段必须和上面的id或sku_properties保持一致,如果没有可以写成",," | |
sku_properties | String | 可选 | 1627207:80882;125465:123456,1627207:80882;1630696:3284570 | sku属性。格式: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 | 可选 | 1627207:80882;125465:123456,1627207:80882;1630696:3284570 | 根据sku属性删除sku信息。需要按组删除属性。 | |
discount_id | Number | 可选 | 10001 | 折扣ID | |
is_authz | String | 可选 | yes | 产品是否需要授权isAuthz:yes|no yes:需要授权 no:不需要授权 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
pid | Number | 12313454121 | 产品ID |
modified | Date | 2000-01-01 00:00:00 | 更新时间,时间格式:yyyy-MM-dd HH:mm:ss |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); FenxiaoProductUpdateRequest req = new FenxiaoProductUpdateRequest(); req.setPid(444L); req.setName( "袜子" ); req.setStandardPrice( "10.56" ); req.setStandardRetailPrice( "10.56" ); req.setRetailPriceLow( "10.56" ); req.setRetailPriceHigh( "10.56" ); req.setCostPrice( "10.56" ); req.setDealerCostPrice( "12.5" ); req.setOuterId( "hz00141" ); req.setQuantity(10L); req.setDesc( "红色" ); req.setCategoryId(234545L); req.setProperties( "10000:10000" ); req.setPropertyAlias( "1627207:28335:绿荫色" ); req.setInputProperties( "20000:品牌名" ); req.setPicPath( "i5/T1rnNbXjOdutLe6Rra_091834.jpg" ); req.setImage( new FileItem( "/tmp/file.txt" )); req.setProv( "浙江" ); req.setCity( "杭州" ); req.setPostageType( "seller" ); req.setPostageId(434343L); req.setPostageOrdinary( "10.56" ); req.setPostageFast( "10.56" ); req.setPostageEms( "10.56" ); req.setHaveInvoice( "true" ); req.setHaveQuarantee( "true" ); req.setStatus( "delete" ); req.setSkuIds( "1001,1002,1003" ); req.setSkuStandardPrices( "10.50,11.00,20.50" ); req.setSkuCostPrices( "10.50,11.00,20.50" ); req.setSkuDealerCostPrices( "12.3,12.5" ); req.setSkuQuantitys( "10,20,30" ); req.setSkuOuterIds( "S1000,S1002,S1003" ); req.setSkuProperties( "1627207:80882;125465:123456,1627207:80882;1630696:3284570" ); req.setSkuPropertiesDel( "1627207:80882;125465:123456,1627207:80882;1630696:3284570" ); req.setDiscountId(10001L); req.setIsAuthz( "yes" ); FenxiaoProductUpdateResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 | < fenxiao_product_update_response > < pid >12313454121</ pid > < modified >2000-01-01 00:00:00</ modified > </ fenxiao_product_update_response > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|---|---|
isv.invalid-parameter:authz | 代销产品必须授权 | 不更新产品,返回错误 |