dangdang.items.spec.update

批量更新商品规格参数

  • 功能描述:批量更新商品规格参数。请首先使用“查询当当标准规格参数”接口,查看商品所属分类是否支持设置规格参数,然后再使用本接口。

    支持的数据格式:XML

    HTTP请求方式:POST

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:

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

    多个商品的规格参数的XML文件

    updateMultiItemsExtendedAttributes

    file

    <input type=file..

    多个商品的规格参数的XML文件,具体内容请参考“多个商品的规格参数的XML文件格式说明”

    商品状态XML文件格式说明:

    变量名称 变量命名 变量类型 说明

    商品列表信息

    ProductInfoList

    -

    商品列表信息含多个商品信息(ProductInfo)

    商品信息

    ProductInfo

    -

    每个商品信息含:

    商品标志符

    规格参数组列表

    1.1商品标识符

    itemID

    int

    商品标识符

    1.2规格参数组列表

    extendedAttributeGroupList

    -

    规格参数组列表,含若干规格参数组

    extendedAttributeGroup

    1.2.1规格参数组

    extendedAttributeGroup

    -

    规格参数组含:

    组名

    规格参数名称-值列表

    1.2.1.1组名

    extendedAttributeGroupName

    string

    例子:娱乐功能

    1.2.1.2规格参数名称-值列表

    extendedAttributeList

    -

    含若干规格参数名称-值
    extendedAttributeValue
    格式为:规格参数名称>>规格参数值

    例子如下:
    <extendedAttributeList>
    <extendedAttributeValue>
    视频格式>>wma
    </extendedAttributeValue>
    <extendedAttributeValue>
    音乐格式>>mp3
    </extendedAttributeValue>
    <extendedAttributeValue>
    重力感应>>支持
    </extendedAttributeValue>
    ......
    </extendedAttributeList>

     

  • 商品状态XML文件示例:

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

    <request>

    <ProductInfoList>

    <ProductInfo>

    <itemID>40056780123</itemID>

    <extendedAttributeGroupList>

    <extendedAttributeGroup>

    <extendedAttributeGroupName>

    娱乐功能

    </extendedAttributeGroupName>

    <extendedAttributeList>

    <extendedAttributeValue>

    视频格式>>wma

    </extendedAttributeValue>

    <extendedAttributeValue>

    音乐格式>>mp3

    </extendedAttributeValue>

    <extendedAttributeValue>

    重力感应>>支持

    </extendedAttributeValue>

    ......

    </extendedAttributeList>

    </extendedAttributeGroup>

    <extendedAttributeGroup>

    <extendedAttributeGroupName>

    存储

    </extendedAttributeGroupName>

    <extendedAttributeList>

    <extendedAttributeValue>

    视频格式>>wma

    </extendedAttributeValue>

    <extendedAttributeValue>

    音乐格式>>mp3

    </extendedAttributeValue>

    <extendedAttributeValue>

    重力感应>>支持

    </extendedAttributeValue>

    ......

    </extendedAttributeList>

    </extendedAttributeGroup>

    </extendedAttributeGroupList>

    </ProductInfo>

    </ProductInfoList>

    </request>

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

    变量名称 变量命名 变量类型 说明

    处理结果

    Error

    -

    处理结果含:(1操作码和2操作结果信息)或者(3商品标识符列表)
    操作码(operCode)与操作结果信息(operation)必须同时返回;
    如果返回操作码(operCode)和操作结果信息(operation),那么不返回商品标识符列表;
    如果返回商品标识符列表,那么不返回操作码(operation)和操作结果信息(operation)。
    处理结果含:
    操作码
    操作结果信息
    例子:
    <Error>
    <operCode>450</operCode>
    <operation>没有上传xml文件</operation>
    </Error>

    3商品标识符列表

    ItemsIDList

    -

    商品标识符列表含若干商品标识符信息(ItemIDInfo):商家修改多少个商品,

    就返回多少个商品标识符信息(ItemIDInfo)

    产品标识符信息

    ItemIDInfo

    -

    如果xml文件中返回了3商品标识符列表(ItemsIDList),那么此项必返回;


    每个商品标识符信息含以下:

    商品标识符

    操作码

    操作结果信息

    商品标识符

    itemID

    int

    商品标志符

    操作码

    operCode

    int

    103 上传文件错误

    100 没有上传xml文件

    101 上传文件过大

    401 更新商品失败

    123 商品id不存在

    102 上传文件不是xml格式

    614 该产品所属分类不包含规格参数

    628 上传文件中规格参数组名为空

    615 上传文件中规格参数组名不存在

    627 上传文件中规格参数名为空

    629 上传文件中规格参数属性为空

    626 上传文件中规格参数名不存在

    操作结果信息

    operation

    string

    103 上传文件错误
    100 没有上传xml文件
    101 上传文件过大
    401 更新商品失败
    123 商品id不存在
    102 上传文件不是xml格式
    614 该产品所属分类不包含规格参数
    628 上传文件中规格参数组名为空
    615 上传文件中规格参数组名不存在
    627 上传文件中规格参数名为空
    629 上传文件中规格参数属性为空
    626 上传文件中规格参数名不存在



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

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

    <response>

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

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

     <ItemsIDList>

      <ItemIDInfo>

       <itemID>10001</itemID>

       <operCode>0</operCode>

       <operation>操作成功</operation>

      </ItemIDInfo>

      <ItemIDInfo>

       <itemID>10000</itemID>

       <operCode>4</operCode>

       <operation>商品描述过大</operation>

      </ItemIDInfo>

     </ItemsIDList>

    </response>