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

qimen.alibaba.tc.order.delivery.assign.supplier.notfiy (送货单任务通知)

水站接口：送货单任务通知

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
deliveryTaskGroupDTO	DeliveryTaskGroupDTO	可选			配送任务
└ supplierCode String 必须 CSDN 配送商Code └ taskGroupCode String 必须 1231221 任务组code taskList DeliveryTaskDTO [] 必须入参 └ workOrderCode String 可选 2132131 配送作业单号原批次,淘鲜达场景下使用 workOrderCode 扫码揽收 └ deliveryDockCode String 可选 CSDN02 配送站code └ receiverName String 可选张三收货人名称 └ receiverPhone String 可选 110 收货人电话 └ receiverAddress String 可选阿里巴巴西溪园区收货人地址 └ receiverPoiLngLat String 可选 121.507261,31.233882 收货人坐标 └ pickupAddrType Number 可选 1 1 配送站，2仓。快递等场景可为空 └ pickupAddrCode String 可选 SH01 取货点code 1 配送站Code，2仓。 code └ pickupAddrName String 可选上海配送站取货地点名称 xxx 配送站，xxx 仓 └ pickupAddrDetail String 可选外滩取货地址明细 └ pickupAddrLonLat String 可选 121.507261,31.233882 取货地址坐标 └ pickupContactPhone String 可选 110 取货联系人电话 └ pickupContactName String 可选张三取货联系人 └ earliestArriveTime String 可选 2020-10-29 00:00:00 时间片-最早送达时间 └ latestArriveTime String 可选 2020-10-29 00:00:00 时间片-最早送达时间 └ orderRemark String 可选快订单备注 deliveryOrderSpec DeliveryOrderSpecDTO 可选订单作业规范 └ fullOrderRefuse Boolean 可选 false 是否需要整单拒收 └ deliveryWorkMode Number 可选 0 配送作业模式 0 或空表示sku 作业 └ tradeOrderNo String 可选 1312312 校验单号 packageList DeliveryTaskPackageDTO [] 可选包裹列表 └ packageCode String 可选 2131231 包裹号 └ packageMode Number 可选 3 包裹打包类型：3-箱外件；4-订单包裹 └ containerCode String 可选 111 周转箱号（订单包裹所处的周转箱号） └ warehouseCode String 可选 cs001 仓Code packageContentList DeliveryTaskPackageContentDTO [] 可选包裹明细 └ skuFullName String 可选测试商品名称 └ actualSaleQuantity String 可选 1 实际销售数量 └ tcTokenCode String 可选 12321 同城令牌号 └ deliveryOrderContentCode String 可选 12312 运单内容ID └ tcTokenCode String 可选 12321 同城令牌号 └ pickupCode String 可选 12321312 包裹取货号 └ estPackagedTime String 可选 2020-10-29 00:00:00 预估打包完成时间 deliveryOrderAttr DeliveryOrderAttr 可选单据属性 └ alscNrTying Boolean 可选 false 是否为搭售单 └ taskStatus Number 可选 1 任务状态 taskContentList DeliveryTaskContentDTO [] 可选明细 └ skuCode String 可选 12321 货物编码 └ skuBarcode String 可选 12321 货物条码 └ skuName String 可选大米货物名称 └ orderQuantity String 可选 99999 购买销售数量 └ sellUnit String 可选 kg 销售单位 └ deliveryOrderQuantity String 可选 2 配送销售量 └ weight String 可选 2 货物总量 └ volume String 可选 10 货物总体积 └ temperatureRequirement Number 可选 1 温度要求 └ isStockOut Number 可选 1 是否缺货 └ skuFullName String 可选东北大米商品全称 └ itemDesc String 可选好丑商品描述 └ itemSpec String 可选 1kg 商品规格 └ subTradeOrderNo String 可选 12321312 子交易单号 └ taskContentStatus Number 可选 1 任务内容状态 └ taskContentCode String 可选 12321 任务明细code deliveryTaskContentAttr DeliveryTaskContentAttr 可选任务内容扩展属性 └ reverseRouteCode String 可选 12312 线路code └ reverseRouteName String 可选测试线路名称 └ workUnitContentCode String 可选 123213 作业单元内容code └ saleBizMode Number 可选 1 单据销售模式：1. 完美履约,2 共享库存 └ taskCode String 可选 12321 作业任务单号 └ outTradeOrderNo String 可选 12431231 外部交易单号 └ outDeliveryDockCode String 可选 12311 对应的外部配送站code orderAddressDTO OrderAddressDTO 可选单据地址 └ province String 可选浙江省四级地址省 └ city String 可选杭州市四级地址市 └ district String 可选余杭区四级地址区 └ town String 可选五常街道四级地址街道

响应参数

名称	类型	示例值	描述
outerResult	OuterResult		响应出参
└ errorMsg String 系统错误错误说明 └ errorCode String SYSTEM-ERROR 错误编码 └ success Boolean false 是否成功

请求示例

{"deliveryTaskGroupDTO":{"taskGroupCode":"1231221","taskList":[{"deliveryOrderAttr":{"alscNrTying":false},"pickupAddrName":"上海配送站","estPackagedTime":"2020-10-29 00:00:00","workOrderCode":"2132131","deliveryOrderSpec":{"deliveryWorkMode":0,"fullOrderRefuse":false},"orderRemark":"快","receiverPoiLngLat":"121.507261,31.233882","pickupContactName":"张三","deliveryDockCode":"CSDN02","receiverPhone":"110","taskCode":"12321","pickupAddrType":1,"earliestArriveTime":"2020-10-29 00:00:00","latestArriveTime":"2020-10-29 00:00:00","taskStatus":1,"pickupContactPhone":"110","receiverName":"张三","saleBizMode":1,"outDeliveryDockCode":"12311","tradeOrderNo":"1312312","pickupAddrCode":"SH01","packageList":[{"packageMode":3,"packageCode":"2131231","tcTokenCode":"12321","packageContentList":[{"deliveryOrderContentCode":"12312","skuFullName":"测试","actualSaleQuantity":"1","tcTokenCode":"12321"}],"pickupCode":"12321312","containerCode":"111","warehouseCode":"cs001"}],"receiverAddress":"阿里巴巴西溪园区","pickupAddrLonLat":"121.507261,31.233882","outTradeOrderNo":"12431231","taskContentList":[{"taskContentCode":"12321","itemSpec":"1kg","isStockOut":1,"taskContentStatus":1,"temperatureRequirement":1,"subTradeOrderNo":"12321312","weight":"2","deliveryOrderQuantity":"2","itemDesc":"好丑","orderQuantity":"99999","skuName":"大米","volume":"10","sellUnit":"kg","skuFullName":"东北大米","workUnitContentCode":"123213","skuBarcode":"12321","deliveryTaskContentAttr":{"reverseRouteName":"测试","reverseRouteCode":"12312"},"skuCode":"12321"}],"orderAddressDTO":{"province":"浙江省","town":"五常街道","city":"杭州市","district":"余杭区"},"pickupAddrDetail":"外滩"}],"supplierCode":"CSDN"}}

响应示例

{
    "outerResult":{
        "errorMsg":"系统错误",
        "errorCode":"SYSTEM-ERROR",
        "success":false
    }
}

验签示例

{"outerResult":{"success":"false","errorCode":"sign-check-failure","errorMsg":"Illegal request"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

五道口API

qimen.alibaba.tc.order.delivery.assign.supplier.notfiy (送货单任务通知)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ