文档中心 > API类目 > 分销

分销

taobao.fenxiao.product.update (更新产品)

更新分销平台产品数据，不传更新数据返回失败
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[] 可选 主图图片
  • 最大长度：512000
    		•  主图图片，如果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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    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());

    响应示例

    • XML示例
    • JSON示例
    <fenxiao_product_update_response>
    <pid>12313454121</pid>
    <modified>2000-01-01 00:00:00</modified>
</fenxiao_product_update_response>

    异常示例

    • XML示例
    • JSON示例
    <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 代销产品必须授权 不更新产品，返回错误

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部
    阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
    关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
    网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号