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

qimen.alibaba.wdk.fulfill.sf.btoc.fms.wms.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	SfB2CFmsWorkOrder	必须			作业单
└ workOrderId String 必须 34354354353 作业单号 └ workOrderName String 必须 171215-中一区B-08:00-08:30 作业单名称 └ merchantCode String 必须 CSDARUNFA 商户编码 └ nodeCode String 必须 1234 节点编码 └ workOrderKind String 必须 AO 作业单类型（PO:销售订单 RO:返厂订单 EO:换货订单 AO:调拨订单 SP:促销订单 Mp:预约订单） └ isTest Boolean 必须 true 是否测试单 workOrderUnits SfB2CFmsWorkOrderUnit [] 必须作业单元 └ 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号收货人地址 └ province String 必须上海市省、自治区、直辖市、特别行政区名称 └ city String 可选上海市地级市、地区、盟、自治州名称 └ district String 可选黄浦区县、区、自治县、旗名称 └ town String 必须人民广场街道乡、镇、街道行政区划级别名称 workOrderUnitContents SfB2CFmsWorkOrderUnitContent [] 必须作业内容 └ 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 ContentOperationalRequirement 可选作业要求 └ processService String 可选宰杀加工服务 └ thermosphere String 可选常温温层要求 └ sourceOrderIds String [] 必须 45364565 外部订单号集合,可能1对多

响应参数

名称	类型	示例值	描述
success	Boolean	ture	是否成功
respCode	String	SUCCESS	响应code(SUCCESS:作业批次接收成功； SYSTEM_ERROR :系统异常； PARAM_ERROR :参数错误； BUSINESS_ERROR:业务异常；)
respMessage	String	作业批次接收成功	响应提示信息

请求示例

{"workOrder":{"workOrderUnits":[{"workOrderUnitId":"4564536545","workOrderUnitContents":[{"skuName":"可口可乐","expectStockQuantity":"1","isStandardSku":true,"workUnitContentId":"645234534","expectSaleQuantity":"1","isGift":true,"subSourceOrderId":"7685678","operationalRequirement":{"processService":"宰杀","thermosphere":"常温"},"saleUnit":"瓶","skuCode":"465465","stockUnit":"箱","status":"CANCELED"}],"orderTime":"2017-04-26 10:15:00","receiver":{"receiverAddress":"上海市长宁区新兴路1号","receiverPhone":"1341432334","province":"上海市","town":"人民广场街道","city":"上海市","receiverName":"张三","district":"黄浦区"},"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","workOrderId":"34354354353","workOrderKind":"AO"}}

响应示例

{
    "success":ture,
    "respCode":"SUCCESS",
    "respMessage":"作业批次接收成功"
}

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

五道口API

qimen.alibaba.wdk.fulfill.sf.btoc.fms.wms.work.order.dispatch (顺丰仓作业单下发接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ