返回订单API

dangdang.orders.pickgoods.update(已下线)

配货

  • 功能描述:商家可以将“等待配货”的订单修改为“等待发货”,商家可以批量处理多张配货订单。对于“买A赠多”促销,需要处理主商品和赠品。
        a)如果订单当前状态是“等待配货”,则实际配货商品数量,以商家在本接口录入的商品数量为准
        c)参与了“多买多折”促销的商品,只能全部配货。

    支持的数据格式:XML

    HTTP请求方式:POST

    版本:1.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:


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

    配货XML

    dataXML

    String

    dataXML=……

    配货XML,具体内容请参考“配货XML格式说明”

    dataXML节点说明:

  • 发货XML文件示例:

    <?xml version="1.0" encoding="GBK"?>
    <request> 
      <functionID>pickGoods</functionID>  
      <time>2009-03-20 15:10:50</time>  
      <OrdersList> 
        <OrderInfo> 
          <orderID>1719544796</orderID>  
          <warehouseID>1</warehouseID>  
          <expressID>133508</expressID>  
          <PickGoodsList> 
            <ItemInfo> 
              <pickGoodsCount>1</pickGoodsCount>  
              <productItemId>1321441341342001</productItemId> 
            </ItemInfo>  
            <ItemInfo> 
              <pickGoodsCount>2</pickGoodsCount>  
              <productItemId>1321441341342002</productItemId> 
            </ItemInfo>  
            <ItemInfo> 
              <pickGoodsCount>2</pickGoodsCount>  
              <productItemId>1321441341342003</productItemId> 
            </ItemInfo>  
            <ItemInfo>......</ItemInfo> 
          </PickGoodsList> 
        </OrderInfo>  
        <OrderInfo>......</OrderInfo> ......
      </OrdersList> 
    </request>



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


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

    实例1:

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

    <response> 
      <functionID>pickGoods</functionID>  
      <time>2009-03-21 15:10:50</time>  
      <Result> 
        <operCode>100</operCode>  
        <operation>没有上传xml文件</operation> 
      </Result> 
    </response>

    实例2:

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

    <response> 
      <functionID>pickGoods</functionID>  
      <time>2009-03-21 15:10:50</time>  
      <Result> 
        <OrdersList> 
          <OrderInfo> 
            <orderID>1111</orderID>  
            <orderOperCode>0</orderOperCode>  
            <orderOperation>发货成功</orderOperation> 
          </OrderInfo>  
          <OrderInfo> 
            <orderID>1112</orderID>  
            <orderOperCode>3</orderOperCode>  
            <orderOperation>发货数量全为0</orderOperation> 
          </OrderInfo> 
        </OrdersList> 
      </Result> 
    </response>



  • java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    OrdersPickGoodsUpdateRequest request=new OrdersPickGoodsUpdateRequest();
    PickGoodsUpdate pickGoodsUpdate=new PickGoodsUpdate();
    PickGoodsItemInfo itemInfo=new PickGoodsItemInfo();
    itemInfo.setPickGoodsCount("1");
    List<PickGoodsItemInfo> itemInfoList=new ArrayList<PickGoodsItemInfo>();
    itemInfoList.add(itemInfo);
    PickGoodsOrderInfoDto orderInfoDto=new PickGoodsOrderInfoDto();
    orderInfoDto.setExpressID("31172");
    List<PickGoodsOrderInfoDto> orderInfoDtoList=new ArrayList<PickGoodsOrderInfoDto>();
    orderInfoDtoList.add(orderInfoDto);
    pickGoodsUpdate.setOrderList(orderInfoDtoList);
    request.setPickGoodsUpdate(pickGoodsUpdate);
    OrdersPickGoodsUpdateResponse response=sdkClient.excute(request);
    System.out.println(response.toString());


    php版

    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $ordersPickgoodsUpdateRequest = new OrdersPickgoodsUpdateRequest();
    $ordersList = array();
    for($i=0;$i<2;$i++) {
        $ordersPickgoodsUpdateOrderInfoDto = new OrdersPickgoodsUpdateOrderInfoDto();
        $ordersPickgoodsUpdateOrderInfoDto->orderID = "111";
        $ordersPickgoodsUpdateOrderInfoDto->warehouseID = "2222";
        $ordersPickgoodsUpdateOrderInfoDto->expressID = 11;
        $itemsList = array();
        for ($j = 0; $j < 2; $j++) {
            $ordersPickgoodsUpdateItemInfoDto = new OrdersPickgoodsUpdateItemInfoDto();
            $ordersPickgoodsUpdateItemInfoDto->pickGoodsCount = 11111;
            $ordersPickgoodsUpdateItemInfoDto->productItemId = 1233;
            $itemsList[] = array("ItemInfo"=>$ordersPickgoodsUpdateItemInfoDto);
        }
        $ordersPickgoodsUpdateOrderInfoDto->PickGoodsList = $itemsList;
        $ordersList[] = array("OrderInfo"=>$ordersPickgoodsUpdateOrderInfoDto);
    }
    $ordersPickgoodsUpdateDto = new OrdersPickgoodsUpdateDto;
    $ordersPickgoodsUpdateDto->functionID = $ordersPickgoodsUpdateRequest->getApiMethodName();
    $ordersPickgoodsUpdateDto->time = date("Y-m-d H:i:s");
    $ordersPickgoodsUpdateDto->OrdersList = $ordersList;
    $ordersPickgoodsUpdateRequest->setDataXML(ConvertUtil::arrayToXml($ordersPickgoodsUpdateDto,"request");
    $result = $ddHttpClient->execute($ordersPickgoodsUpdateRequest);