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

qimen.alibaba.wdk.fulfill.warehouse.order.dispatch (同城外部商家ERP仓作业单下发接口)

同城外部商家ERP仓作业单下发接口

公共参数

请求地址：

环境	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 └ planEndTime String 可选 "2023-03-13 10:30:52" 最晚出库时间 └ isTest Boolean 必须 true 是否测试单 workOrderUnits WorkOrderUnit [] 必须作业单元 └ workOrderUnitId String 必须 4564536545 作业单元单号 └ sourceFrom String 必须 TC 订单来源:MEITUAN("美团"),ELEME("饿了么"),TDD("淘点点"),BAIDU("百度"),WEIXIN("微信"),TC("自营"),DAILY_FRESH("每日优鲜") └ 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号收货人地址 workOrderUnitContents WorkOrderUnitContent [] 必须作业内容 └ workUnitContentId String 必须 645234534 作业内容单号 └ subSourceOrderId String 必须 7685678 外部子单号 └ 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("取消")，，为空该商品可以正常捡货 operationalRequirement OperationalRequirement 可选作业要求 └ processService String 可选宰杀加工服务 └ thermosphere String 可选常温温层要求 └ attribute String 可选 {"key":"value"} 扩展字段 └ subBizOrderId String 可选 500123456 渠道交易子单号 └ shopCode String 必须 1234 门店编码 └ sourceOrderIds String [] 必须 45364565 外部订单号集合,可能1对多 └ attribute String 可选 {"pickupCode":"123","containerCodes":["123","456"],"businessSourceFrom":"MAOCHOA_SELLER","batchStrategy":"O2O"} 扩展字段Map。取件码key是pickupCode；业务来源key是businessSourceFrom，value取值MAOCHOA_SELLER代表猫超共享库存，value取值TAOBAO_SELLER代表淘鲜达；batchStrategy是作业策略,O2O代表小时达,O2O_SELF_TAKE_AT_SHOP代表自提；merchantBrand品牌；brandCode 品牌编码 └ userMemo String 可选备注备注 └ bizOrderId String 可选 5001234 渠道交易单号 └ channelSeq String 可选 12 渠道顺序号,小号 └ attribute String 可选 {"key":"value"} 扩展字段

响应参数

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

请求示例

{"workOrder":{"workOrderUnits":[{"shopCode":"1234","workOrderUnitContents":[{"isStandardSku":true,"workUnitContentId":"645234534","subSourceOrderId":"7685678","saleUnit":"瓶","stockUnit":"箱","skuName":"可口可乐","expectStockQuantity":"1","subBizOrderId":"500123456","expectSaleQuantity":"1","isGift":true,"attribute":"{\"key\":\"value\"}","operationalRequirement":{"processService":"宰杀","thermosphere":"常温"},"skuCode":"465465","status":"CANCELED"}],"receiver":{"receiverAddress":"上海市长宁区新兴路1号","receiverPhone":"1341432334","receiverName":"张三"},"sourceOrderIds":"45364565","workOrderUnitId":"4564536545","orderTime":"2017-04-26 10:15:00","bizOrderId":"5001234","channelSeq":"12","earliestArriveTime":"2017-04-26 19:45:00","latestArriveTime":"2017-04-26 20:15:00","attribute":"{\"pickupCode\":\"123\",\"containerCodes\":[\"123\",\"456\"],\"businessSourceFrom\":\"MAOCHOA_SELLER\",\"batchStrategy\":\"O2O\"}","sourceFrom":"TC","userMemo":"备注"}],"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","planEndTime":"\"2023-03-13 10:30:52\"","workOrderId":"34354354353","attribute":"{\"key\":\"value\"}"}}

响应示例

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

验签示例

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

错误码解释

错误码	错误描述	解决方案
isp.http-read-timeout
isp.http-connection-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

五道口API

qimen.alibaba.wdk.fulfill.warehouse.order.dispatch (同城外部商家ERP仓作业单下发接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

用户导航

用户反馈

用户反馈

用户反馈