文档中心 > API类目 > 五道口API

qimen.alibaba.wdk.fulfill.ebeecake.dms.work.order.dispatch (北京小蜜蜂配送作业单下发接口)

下发作业单给对应的配送作业系统

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
workOrder	WorkOrder	必须			作业单
└ workOrderId String 必须 34354354353 作业单号 └ workOrderName String 可选 171215-中一区B-08:00-08:30 作业单名称 └ merchantCode String 必须 CSDARUNFA 商户编码 └ nodeCode String 必须 1234 节点编码 └ earliestArriveTime String 必须 2017-04-26 19:17:55 作业单最早送达时间，格式： yyyy-MM-dd HH:mm:ss └ latestArriveTime String 必须 2017-04-26 19:17:55 作业单最晚送达时间，格式： yyyy-MM-dd HH:mm:ss └ warehouseCode String 可选 8043 仓code └ isTest Boolean 必须 true 是否测试单 workOrderUnits WorkOrderUnit [] 必须作业单元 └ workOrderUnitId String 必须 4564536545 作业单元单号 └ sourceFrom String 必须 TC 订单来源: TC("自营")-淘鲜达, MEITUAN("美团"), ELEME("饿了么"), TDD("淘点点"), SANJIANG("三江"), BAIDU("百度"), WEIXIN("微信"), FEINIU ("大润发优鲜") └ earliestArriveTime String 必须 2017-04-26 19:45:00 最早开始时间 └ latestArriveTime String 必须 2017-04-26 20:15:00 最晚送达时间 └ orderTime String 必须 2017-04-26 10:15:00 下单时间 receiver Receiver 必须收货人对象 └ receiverName String 必须张三收货人姓名 └ receiverPhone String 必须 1341432334 收货人电话 └ receiverAddress String 必须上海市长宁区新兴路1号收货人地址 └ lnglat String 可选 106.917295,27.666815 收货地址经纬度，格式：经度,纬度 └ poi String 可选如xxx大厦、xxx科技园等收货地址POI名称 └ routeArea String 必须 343 区块编码 workOrderUnitContents WorkOrderUnitContent [] 必须作业内容 └ workUnitContentId String 必须 645234534 作业内容单号 └ subSourceOrderId String 必须 7685678 外部子单号 └ skuCode String 必须 465465 盒马标准商品编码 └ skuName String 必须可口可乐商品名称 └ saleUnit String 必须瓶销售单位 └ stockUnit String 必须箱库存单位 └ expectSaleQuantity String 必须 1 销售单位购买数量 └ expectStockQuantity String 必须 1 库存单位购买库数量 └ actualSaleQuantity String 可选 1 销售单位出库数量 └ actualStockQuantity String 可选 1 库存单位出库数量 └ isGift Boolean 必须 true 是否赠品 └ status String 可选 CANCELED 状态： CANCELED("取消")，，为空该商品可以正常捡货 └ sourceOrderIds String [] 必须 45364565 外部订单号 containers Container [] 可选容器列表 └ containerCode String 可选 001 容器编码 └ containerType String 可选 NORMAL_BOX 容器类型： NORMAL_BOX（周转箱），INSULATION_BOX（保温箱），SKU_PACK（异形件sku捆绑，不能装入箱子，需要另外打包），UNKNOWN（未取到）

响应参数

名称	类型	示例值	描述
success	Boolean	ture	是否成功
respCode	String	SUCCESS	响应code
respMessage	String	下发成功	响应提示信息

请求示例

{"workOrder":{"workOrderUnits":[{"workOrderUnitId":"4564536545","workOrderUnitContents":[{"skuName":"可口可乐","expectStockQuantity":"1","actualSaleQuantity":"1","workUnitContentId":"645234534","expectSaleQuantity":"1","isGift":true,"subSourceOrderId":"7685678","actualStockQuantity":"1","saleUnit":"瓶","skuCode":"465465","stockUnit":"箱","status":"CANCELED"}],"orderTime":"2017-04-26 10:15:00","routeArea":"343","receiver":{"receiverAddress":"上海市长宁区新兴路1号","receiverPhone":"1341432334","lnglat":"106.917295,27.666815","receiverName":"张三","poi":"如xxx大厦、xxx科技园等"},"earliestArriveTime":"2017-04-26 19:45:00","latestArriveTime":"2017-04-26 20:15:00","sourceOrderIds":["45364565"],"sourceFrom":"TC"}],"merchantCode":"CSDARUNFA","isTest":true,"nodeCode":"1234","workOrderName":"171215-中一区B-08:00-08:30","earliestArriveTime":"2017-04-26 19:17:55","latestArriveTime":"2017-04-26 19:17:55","containers":[{"containerType":"NORMAL_BOX","containerCode":"001"}],"workOrderId":"34354354353","warehouseCode":"8043"}}

响应示例

{
    "success":ture,
    "respCode":"SUCCESS",
    "respMessage":"下发成功"
}

验签示例

{"respMessage":"Illegal request","success":"false","respCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

五道口API

qimen.alibaba.wdk.fulfill.ebeecake.dms.work.order.dispatch (北京小蜜蜂配送作业单下发接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ