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

qimen.alibaba.wdk.fulfill.warehouse.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 作业单名称 └ parentWorkOrderId String 可选 7657476 父作业单号 └ merchantCode String 必须 CSDARUNFA 商户编码 └ workOrderType String 必须 BATCH 作业类型：批次，单子 └ brotherlyWorkOrderCount Number 必须 2 兄弟作业单数量 └ nodeCode String 必须 1234 节点编码 └ earliestArriveTime String 必须 2017-04-26 19:17:55 作业单最早送达时间，格式： yyyy-MM-dd HH:mm:ss └ attribute String 可选 {"pickupCode":"123","containerCodes":["123","456"]} 扩展属性 └ latestArriveTime String 必须 2017-04-26 19:17:55 作业单最晚送达时间，格式： yyyy-MM-dd HH:mm:ss └ nextNodeCode String 可选 UD8043 下一个作业节点编码 └ nextNodeName String 可选上海B2C长泰配送站下一个作业节点名称 └ planStartTime String 可选 2017-04-26 19:17:55 作业预计开始时间 └ planEndTime String 可选 2017-04-26 19:27:55 作业预计结束时间 └ isTest Boolean 可选 true 是否测试单 operationalRequirement OperationalRequirement 必须作业要求 └ thermosphere String 必须 FREEZING 温层要求：ORDINARY_TEMPERATURE("常温"), REFRIGERATION("冷藏"), FREEZING("冷冻") └ predictContainerQuantity Number 可选 2 预测容器数量 workOrderUnits WorkOrderUnit [] 必须作业单元 └ workOrderUnitId String 必须 123434 作业单元单号 └ bizOrderId String 可选 4532345 盒马订单号 └ earliestArriveTime String 必须 2017-04-26 19:45:00 最早开始时间 └ sourceOrderId String 可选 345345 外部订单号 └ sourceFrom String 必须 TC 订单来源: TC("自营")-淘鲜达, MEITUAN("美团"), ELEME("饿了么"), TDD("淘点点"), SANJIANG("三江"), BAIDU("百度"), WEIXIN("微信"), FEINIU ("大润发优鲜") └ latestArriveTime String 必须 2017-04-26 20:15:00 最晚送达时间 └ orderTime String 必须 2017-04-26 10:15:00 下单时间 └ userMemo String 可选多加香菜用户备注 └ attribute String 可选 {"pickupCode":"123","containerCodes":["123","456"],"merchantBrand":"全能超市","brandCode":"QNCS"} pickupCode是CFC取货码，存在时需要打印到小票上 TMCS(天猫超市) GXLS(天猫超市) QNCS(全能超市) SDY(啥都有) JSH(集食号) receiver Receiver 必须收货人对象 └ receiverName String 必须张三收货人姓名 └ receiverPhone String 必须 1341432334 收货人电话 └ receiverAddress String 必须上海市长宁区新兴路1号收货人地址 workOrderUnitContents WorkOrderUnitContent [] 必须作业内容 └ workUnitContentId String 必须 34546546 作业内容单号 └ skuCode String 必须 465465 盒马标准商品编码 └ skuName String 必须可口可乐商品名称 └ saleUnit String 必须瓶销售单位 └ stockUnit String 必须箱库存单位 └ expectSaleQuantity String 必须 1 销售单位购买数量 └ expectStockQuantity String 必须 1 库存单位购买库数量 └ isStandardSku Boolean 必须 true 是否是标品 └ isGift Boolean 必须 true 是否赠品 └ status String 可选 CANCELED 状态： CANCELED("取消")，，为空该商品可以正常捡货 └ attribute String 可选 { "pickupCode": "123", "containerCodes": ["123", "456"], "logisticsLinesId": "test" } 扩展属性 operationalRequirement OperationalRequirement 可选作业要求 └ processService String 可选宰杀加工服务 └ subSourceOrderId String 必须 4536456 外部子单号 └ subBizOrderId String 必须 34525432 交易子单号

响应参数

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

请求示例

{"workOrder":{"nextNodeCode":"UD8043","workOrderUnits":[{"workOrderUnitId":"123434","sourceOrderId":"345345","workOrderUnitContents":[{"isStandardSku":true,"workUnitContentId":"34546546","subSourceOrderId":"4536456","saleUnit":"瓶","stockUnit":"箱","skuName":"可口可乐","expectStockQuantity":"1","subBizOrderId":"34525432","expectSaleQuantity":"1","isGift":true,"attribute":"{ \t\"pickupCode\": \"123\", \t\"containerCodes\": [\"123\", \"456\"], \t\"logisticsLinesId\": \"test\" }","operationalRequirement":{"processService":"宰杀"},"skuCode":"465465","status":"CANCELED"}],"orderTime":"2017-04-26 10:15:00","receiver":{"receiverAddress":"上海市长宁区新兴路1号","receiverPhone":"1341432334","receiverName":"张三"},"bizOrderId":"4532345","earliestArriveTime":"2017-04-26 19:45:00","latestArriveTime":"2017-04-26 20:15:00","attribute":"{\"pickupCode\":\"123\",\"containerCodes\":[\"123\",\"456\"],\"merchantBrand\":\"全能超市\",\"brandCode\":\"QNCS\"}","sourceFrom":"TC","userMemo":"多加香菜"}],"merchantCode":"CSDARUNFA","workOrderType":"BATCH","planStartTime":"2017-04-26 19:17:55","nodeCode":"1234","nextNodeName":"上海B2C长泰配送站","brotherlyWorkOrderCount":2,"parentWorkOrderId":"7657476","predictContainerQuantity":2,"isTest":true,"workOrderName":"171215-中一区B-08:00-08:30","earliestArriveTime":"2017-04-26 19:17:55","latestArriveTime":"2017-04-26 19:17:55","planEndTime":"2017-04-26 19:27:55","workOrderId":"34354354353","attribute":"{\"pickupCode\":\"123\",\"containerCodes\":[\"123\",\"456\"]}","operationalRequirement":{"thermosphere":"FREEZING"}}}

响应示例

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

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

五道口API

qimen.alibaba.wdk.fulfill.warehouse.work.order.dispatch (仓作业单下发接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ