商品增量编辑

商品编辑增量更新

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

一、请求参数

请求URL:

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

参数名	类型	必须	示例值	说明
appid	String	是	uwkahf@jfs92	合作伙伴AppId
timestamp	String	是	1633618722	当前时间戳
tb_seller_nick	String	是	kingdo	淘宝卖家店铺登录账号，非店铺名称
sign	String	是	999de41d862efaa6f1084ead3b3ba480	如何计算生成见示例代码
item_id	Number	true	610191026823	商品ID
cat_id	Number	false	50021288	商品类目ID。若不需要修改商品类目，则不用填写
spu_id	Number	false	32323	产品ID，若不需要修改关联的产品信息，则不需要填写
schema	Number	true	见下面示例	编辑后的schema信息(增量更新，只填写需要更新的字段)

比如，只更新商品标题：

<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商品图片)

二、请求示例代码

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);

    }

三、返回结果

{
    "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会包含失败原因。

四、常见问题

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

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

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