dangdang.items.stock.update

批量更新商品库存

  • 功能描述:更新多个商品的库存,包括促销品。包含有特殊字符和HTML标签的节点值应该采用CDATA写法。

    (请注意:当当内部系统会在商品发货时对现有库存进行扣减,商家对接的系统请不要在发货时对库存进行扣减刷新)


    支持的数据格式:XML

    HTTP请求方式:POST

    版本:2.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


    变量名称 变量命名 变量类型 是否必填 示例 说明

    多个商品的库存XML文件

    multiItemsStock

    file

    <input type=file..

    多个商品的库存的XML文件,具体内容请参考

    “多个商品的库存XML文件格式说明”


     

    多个商品的库存XML文件格式说明:


    变量名称 变量命名 变量类型 是否必填 示例 说明

    企业商品标志符

    outerItemID

    string

    SHOPID_00001

    企业商品标志符

    库存数量

    stockCount

    int

    3

    库存数量,大于0小于1000000的正整数


     

  • 多个商品的库存XML文件示例1:

    <?xml version="1.0" encoding="GBK"?>

    <request>

     <functionID>dangdang.items.stock.update</functionID>

     <time>2009-03-20 15:10:50</time>

     <ItemsList>

      <ItemUpadteInfo>

       <outerItemID>40056780123</outerItemID>

       <stockCount>199</stockCount>

      </ItemUpadteInfo>

      <ItemUpadteInfo>

       ......

      </ItemUpadteInfo>

     </ItemsList>

    </request>

  • 商家接收到的XML文件格式说明:

  • 商家接收到的XML文件实例:

    <?xml version="1.0" encoding="GBK" ?>

    <response>

     <functionID><![CDATA[dangdang.items.stock.update]]></functionID>

     <time>2009-04-20 15:33:29</time>

     <ItemsIDList>

      <ItemIDInfo>

       <itemID>10001</itemID>

       <outerItemID>00007</outerItemID>

       <operCode>0</operCode>

       <operation>操作成功</operation>

      </ItemIDInfo>

      <ItemIDInfo>

       <itemID>10000</itemID>

      <outerItemID>00003</outerItemID>

       <operCode>4</operCode>

       <operation>库存数量错误</operation>

      </ItemIDInfo>

     </ItemsIDList>

    </response>


  • java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    ItemsStockBatchUpdateRequest request=new ItemsStockBatchUpdateRequest();
    request.setMultiItemsStockFile(new FileItem(new File(path)));
    ItemsStockBatchUpdateResponse result=sdkClient.excute(request);
    System.out.println(result.toString());


    php版
    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $itemsStockUpdateRequest = new ItemsStockUpdateRequest();
    $itemsStockUpdateRequest->setMultiItemsStock($xmlFile);
    $sdkResponse = $sdkClient->execute($itemsStockUpdateRequest);