• 功能描述:商家一次可以同时上传多个商品。包含有特殊字符和HTML标签的节点值请采用CDATA写法。

    支持的数据格式:XML

    HTTP请求方式:POST

    版本:2.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:

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

    发布新商品XML文件

    addItems

    file

    input type=file..

    新商品的XML文件,具体内容请参考

    “新商品XML文件格式说明”


    新商品XML文件格式说明:

    说明:

    1、分色分码商品使用<SpecilaItemInfo>组合:

    1.1<specialAttributeClass><specialAttribute><specialAttributeSeq><unitPrice><stockCount><outerItemID>。

    1.2、<specialAttributeClass>允许为空;<specialAttributeSeq>非数字、为空或者大于9999时,对应属性值显示顺序自动设置为0。

    1.3、<specialAttribute>的自定义属性名称:不允许超过20个字符(10个汉字)。

    1.4、销售属性是选填的,比如商品所属分类的销售属性是“颜色+尺码”,填写方式有3种:1)可以不填,2)可以只填写“颜色”或者“尺码”,3)可以填写“颜色+尺码”,对于同一个商品,只能选择一种填写方式,填写格式如上所述。

    2、使用<ItemsList>组合多个<ItemAddInfo>

    3、bestPartnerList字段只对普通商品有效,内容必须符合格式要求;“拍档商品的商品ID”对应的商品必须是商家店内商品、不能是分色分码商品、不能重复;依照设置时的商品顺序,在单品页中从左到右展示;拍档数量不能多于3个

    4、[限]节能补贴政策和节能补贴金额目前仅适用于特定商家,暂时不对其他商家开放使用。

     

  • 发布新商品XML文件示例1

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

    <request> 
      <functionID>dangdang.item.add</functionID>  
      <time>2009-03-20 15:10:50</time>  
      <ItemsList> 
        <ItemAddInfo> 
          <itemBarcode>123456789</itemBarcode>  
          <itemName>瑜珈/图文鞋</itemName>  
          <itemSubhead>漂亮又便宜</itemSubhead>  
          <classificationCode1>4001832</classificationCode1>  
          <classificationCode2>4001832</classificationCode2>  
          <brand>皮尔瑜伽</brand>  
          <model>瑜珈/图文鞋</model>  
          <attribute>性别&gt;&gt;女性;质地&gt;&gt;牛皮</attribute>  
          <itemDetail>规格:15*69cm材质:牛皮</itemDetail>  
          <stockPrice>28</stockPrice>  
          <marketPrice>88</marketPrice>  
          <vipPriceType>是</vipPriceType>  
          <shopCategoryID1>10000</shopCategoryID1>  
          <shopCategoryID2>10000</shopCategoryID2>  
          <shopCategoryID3>10000</shopCategoryID3>  
          <shopCategoryID4>10000</shopCategoryID4>  
          <shopCategoryID5>10000</shopCategoryID5>  
          <itemState>上架</itemState> 
          <is_cod>是</is_cod>  
          <SpecilaItemInfo> 
            <specialAttributeClass>颜色&gt;&gt;军绿;鞋码&gt;&gt;38</specialAttributeClass>  
            <specialAttribute>颜色&gt;&gt;军绿色;鞋码&gt;&gt;38</specialAttribute>  
            <specialAttributeSeq>0;10</specialAttributeSeq>  
            <stockCount>199</stockCount>  
            <unitPrice>28</unitPrice>  
            <outerItemID>sku001</outerItemID> 
          </SpecilaItemInfo>  
          <SpecilaItemInfo>……</SpecilaItemInfo>  
          <isSubsidy>是</isSubsidy>  
          <subsidyAmount>180.00</subsidyAmount>  
          <volume>180.00</volume>  
          <weight>180.00</weight>  
          <templateName>店铺运费</templateName> 
        </ItemAddInfo>  
        <ItemAddInfo>......</ItemAddInfo> 
      </ItemsList> 
    </request>

    发布新商品XML文件示例2:

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

    <request> 
      <functionID>dangdang.item.add</functionID>  
      <time>2009-03-20 15:10:50</time>  
      <ItemsList> 
        <ItemAddInfo> 
          <itemBarcode>123456789</itemBarcode>  
          <itemName>瑜珈/图文鞋</itemName>  
          <itemSubhead>漂亮又便宜</itemSubhead>  
          <classificationCode1>4001832</classificationCode1>  
          <classificationCode2>4001832</classificationCode2>  
          <brand>皮尔瑜伽</brand>  
          <model>瑜珈/图文鞋</model>  
          <attribute>性别&gt;&gt;女性;质地&gt;&gt;牛皮</attribute>  
          <itemDetail>规格:15*69cm材质:牛皮</itemDetail>  
          <stockPrice>28</stockPrice>  
          <marketPrice>88</marketPrice>  
          <vipPriceType>是</vipPriceType>  
          <shopCategoryID1>10000</shopCategoryID1>  
          <shopCategoryID2>10000</shopCategoryID2>  
          <shopCategoryID3>10000</shopCategoryID3>  
          <shopCategoryID4>10000</shopCategoryID4>  
          <shopCategoryID5>10000</shopCategoryID5>  
          <itemState>上架</itemState>  
          <is_cod>是</is_cod>  
          <stockCount>199</stockCount>  
          <unitPrice>28</unitPrice>  
          <outerItemID>sku001</outerItemID>  
          <bestPartnerList>79847693;79847655;79847676</bestPartnerList>  
          <isSubsidy>是</isSubsidy>  
          <subsidyAmount>180.00</subsidyAmount>  
          <volume>180.00</volume>  
          <weight>180.00</weight>  
          <templateName>店铺运费</templateName> 
        </ItemAddInfo>  
        <ItemAddInfo>......</ItemAddInfo> 
      </ItemsList> 
    </request>

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

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

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

    <response> 
      <functionID>dangdang.item.add</functionID>  
      <time>2009-04-20 15:33:29</time>  
      <ItemsIDList> 
        <ItemIDInfo> 
          <outerItemID>![CDATA[00001]]</outerItemID>  
          <itemID>![CDATA[10001]]</itemID>  
          <itemName>![CDATA[10000]]</itemName> 
        </ItemIDInfo>  
        <ItemIDInfo> 
          <itemID>![CDATA[10000]]</itemID>  
          <itemName>![CDATA[10000]]</itemName>  
          <SpecialItemInfo> 
            <outerItemID>![CDATA[00002]]</outerItemID>  
            <subItemID>![CDATA[2132]]</subItemID>  
            <operCode>![CDATA[0]]</operCode>  
            <operation>![CDATA[发布商品成功]]</operation> 
          </SpecialItemInfo>  
          <SpecialItemInfo> 
            <outerItemID>![CDATA[00003]]</outerItemID>  
            <subItemID>![CDATA[2132]]</subItemID>  
            <operCode>![CDATA[11]]</operCode>  
            <operation>![CDATA[单价错误]]</operation> 
          </SpecialItemInfo> 
        </ItemIDInfo>  
        <ItemIDInfo> 
          <itemName> <![CDATA[测试用新商品1357888022327]]> </itemName>  
          <operCode> <![CDATA[0]]> </operCode>  
          <operation> <![CDATA[发布商品成功]]> </operation>  
          <noticeMessage> <![CDATA[]]> </noticeMessage>  
          <outerItemID>![CDATA[00001]]</outerItemID> 
        </ItemIDInfo>  
        <ItemIDInfo> 
          <outerItemID>![CDATA[00001]]</outerItemID>  
          <itemName>![CDATA[2000]]</itemName>  
          <operCode>![CDATA[10]]</operCode>  
          <operation>![CDATA[进货价:必填]]</operation> 
        </ItemIDInfo> 
      </ItemsIDList> 
    </response>




  • java版

    SdkClient sdk= new SdkClient(appKey, appSecret, session, version) ;
    ItemAddRequest request=new ItemAddRequest();
    request.setAddItemsFile(new FileItem(new File(path)));
    ItemAddResponse response=sdk.excute(request);
    System.out.println( response.toString());


    php版
    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $itemAddRequest = new ItemAddRequest();
    $itemAddRequest->setAddItems($xmlFile);
    $sdkResponse = $sdkClient->execute($itemAddRequest);