商品增量编辑

商品编辑增量更新

商品编辑增量更新;
该接口编辑sku，只能更新价格、库存等信息，不能新增sku;
新增sku用全量接口alibaba.item.edit.submit，先设置销售属性;

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/alibaba/item/edit/fast/update

比如，只更新商品标题：

<itemSchema>
    <field id="title" type="input">
        <value>测试宝贝连衣裙 2021</value>
    </field>
</itemSchema>

比如，更新宝贝详情页，如果是html形式的话，要对html内容进行转义

 <itemSchema> 
     <field id="desc" name="PC端详情描述" type="input">
        <rules>
            <rule name="requiredRule" value="true"></rule>
            <rule name="valueTypeRule" value="html"></rule>
        </rules>
        <value> 
             &lt;p&gt;   &lt;h2&gt;这是一个大美女&lt;/h2&gt; 
           &lt;img src=&quot;https://gd3.alicdn.com/imgextra/i3/661153176/O1CN012Kn0i51ZKecCBEqmY_!!661153176.jpg_400x400.jpg&quot; &gt;&lt;/img&gt;
            &lt;/p&gt;
        </value>
    </field> 
</itemSchema>

说明：

A）目前淘宝支持的增量更新字段有：catId,bizIdentity,id,price,quantity,title,wirelessDesc,desc,barcode,outerId,video,images,recommendReason,imageVideo,sellPromise

B）天猫市场支持增量更新的字段如下：

title（标 题）

subtitle（子标题，即卖点）

show_title (展示标题)

short_title（无线短标题）

desc（pc描述）

wap_desc（无线描述）

wireless_desc (新版无线描述字段)

vertical_image（竖图）

white_bg_image (白底图)

large_screen_image (电子大屏图)

shop_category (店铺类目)

item_image(主图)

item_wireless_images(无线主图)

postage_id_increment（运费模板id）

image_video_type (主图视频比例类型)

main_video (主图视频)

three_to_four_images (3:4商品图片)

2. 请求示例代码(Java)

  @Test
    public void AlibabaItemEditFastUpdate () throws Exception {
        String tb_seller_nick = Config.TBSellerNick;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("item_id", "657645255129");
        String schema = "<itemSchema>\n" +
                "    <field id=\"title\" type=\"input\">\n" +
                "        <value>测试宝贝连衣裙 2021</value>\n" +
                "    </field>\n" +
                "</itemSchema>";
        data.put("schema", schema);
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.AlibabaItemEditFastUpdateUrl, data);

    } 

3. 返回结果如下

{
    "code": 0,
    "message": "ok",
    "data": {
        "item_id": 657645255129, // 商品Id
        "market": "taobao",
        "request_id": "6fomqdrr5vmg",
        "update_time": "2021-10-08 12:07:15"
    },
    "trace_id": ""
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

4. 常见问题

1. 商品上传发布后，如果马上调用本接口进行更新，可能会提示

   {“code”:202,”message”:”images:电脑端宝贝图片为必填项，不能为空”,”trace_id”:””}

建议商品发布后，10秒后再更新。