搜索热词:

返回订单API

dangdang.order.goods.package.pickgoods

拣货接口

接口概述
版本变更记录
提交参数
返回参数
入参格式示例
返回出参格式示例

接口概述
[隐藏]

功能描述：商家可以将“等待配货”或者“可配货”的订单修改为“等待发货”，商家可以批量处理多张拣货订单。本接口支持自发订单（包括COD和非COD订单），暂时不支持当当代发订单（包括COD和非COD订单）。支持拣货拆分包裹，用于多次不同包裹发货使用。

a)如果订单当前状态是“等待配货”或者“可配货”，则配货商品数量，以商家在本接口录入的商品数量为准，少填或者不填则按照报缺处理。

b) 网络订单、货到付款订单，海外购订单、换货新单等均不支持拣货拆分包裹

c)此接口只能调用一次（对于一个订单而言）

支持最大订单量：50

支持的数据格式：json

HTTP请求方式：POST

版本:1.0
版本变更记录
[隐藏]

接口调用时传递的v为大版本号，如对于1.1，调用时为v=1.0

时间：2019-10-14

版本：v1.0

提交参数

变量名称	变量命名	变量类型	是否必填	示例	说明
拣货json文件	pickGoodParamDTO	file	是		拣货json字符串，具体内容请参考以下表格

变量名称	变量命名	变量类型	是否必填	示例	说明
订单批量拣货请求列表	markPickGoodsInfoList	List	是		订单列表信息含多张订单信息
订单编号	orderId	Long	是	123456789
包件信息列表	orderPackageDTOList	List	是		该订单对应拣货拆分的包件信息，包含：某包件下对应的商品信息列表
商品信息列表	itemInfoDTOS	List	是		同一个包件下的商品信息放在一个商品信息中，只修改商品编号，如： X包件中需要拣货a商品两件 …… "orderPackageDTOList":[ { "itemInfoDTOS":[ { "itemId":a, "productNum":2, "snNumber":"string" } ] } ] …… 错误示范： …… "orderPackageDTOList":[ { "itemInfoDTOS":[ { "itemId":a, "productNum":1, "snNumber":"string" }， { "itemId":a, "productNum":1, "snNumber":"string" } ] } ] ……
品id	itemId	Long	是		dangdang.order.details.package.get接口中的ItemId字段,格式为订单号+00x,如：订单号+001
商品数量	productNum	Int	是		特别注意此字段，表示要拣货的商品数量，如果某订单中所有包件中某个品的拣货数量小于下单数据，则报缺没有拣货的品数量
商品sn编码	snNumber	String	否

返回参数

[隐藏]

变量名称	变量命名	变量类型	说明
接口操作码	code	Int	0表示接口调用成功，其他表示失败
接口操作码解析	message	string	对于接口操作码的中文或英文解释
操作数据	data
订单拣货操作结果列表	ordersList	List	订单号对应订单拣货操作码对应订单拣货操作码解析
订单号	orderID	Long
订单拣货操作码	orderOperCode	Int	对应订单拣货操作码
订单拣货操作码解析	orderOperation	string	对于订单操作码的中文或英文解释

入参格式示例
[隐藏]

{
    "markPickGoodsInfoList":[
        {
            "orderId":0,
            "orderPackageDTOList":[
                {
                    "itemInfoDTOS":[
                        {
                            "itemId":0,
                            "productNum":0,
                            "snNumber":"string"
                        }
                    ]
                }
            ]
        }
    ]
  }
返回出参格式示例
[隐藏]

{
    "code":0,
    "message":"success",
    "data":{
        "ordersList":[
            {
                "orderID":123456789,
                "orderOperCode":0,
                "orderOperation":"操作成功"
            }
        ]
    }
}

当当网开放平台系统

返回订单API

dangdang.order.goods.package.pickgoods

拣货接口

接口概述

版本变更记录

提交参数

dangdang.order.details.package.get接口中的ItemId字段,格式为订单号+00x,如：订单号+001

返回参数

入参格式示例

返回出参格式示例