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

qimen.alibaba.tc.order.pickup.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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
pickupOrderGroupDTO	PickupOrderGroupDTO	必须			取货任务组
└ taskGroupCode String 必须 10026345 任务组code └ supplierCode String 必须 CSDN 配送商code └ deliveryDockCode String 必须 112233 配送站编码 taskList PickupOrderDTO [] 必须任务列表 └ supplierCode String 可选 PSSCODE 配送商Code └ takeTaskCode String 可选 PT13623424 取货任务单号 └ pickupFulfillOrderId String 可选 157493625717853837 取货履约单号 └ fulfillOrderId String 可选 127212340520031302 正向履约单号 └ pickupContactName String 可选孙大圣取货联系人 └ pickupContactPhone String 可选 13245678910 取货联系人电话(隐私处理) └ pickupAddrPoiName String 可选西溪园区取货位置名称 └ pickupAddrDetail String 可选 1号楼小邮局取货详细地址 └ pickupAddrLonLat String 可选 121.241234,31.345234 取货地址位置坐标 └ pickupAreaName String 可选中二区取货区块名称 └ pickupMemo String 可选门口有狗取货备注 └ expEarliestPickupTime String 可选 2010-10-29 00:00:00 期望最早取货时间 └ expLatestPickupTime String 可选 2010-10-29 00:00:00 期望最晚取货时间 └ rcvDeliveryDockCode String 可选 UD007 配送站Code └ rcvAddrPoiName String 可选上海滩配送站配送站位置名称 └ rcvAddrDetail String 可选黄浦江3号龙门镖局配送站详细地址 └ rcvLonLat String 可选 120.234,32.1234 配送站位置坐标 └ rcvContactName String 可选孙行者配送站联系人名称 └ rcvContactPhone String 可选 12345678910 配送站联系电话 └ warehouseCode String 可选 WCODE8765 仓Code └ warehouseName String 可选咱家大仓仓名称 └ outTradeOrderId String 可选 1231231231 淘宝交易单号 └ saleBizMode Number 可选 1 单据销售模式 1. 完美履约,2 共享库存， null 表示无 pickupOrderSpecDTO PickupOrderSpecDTO 可选作业规范 └ deliveryWorkMode Number 可选 1 配送作业模式 0 或空表示sku 作业，1 包裹作业 pickUpItems PickupOrderSkuDTO [] 可选取货子单列表 └ taskContentCode String 可选 1231312 取货子单Code └ itemDeliveryQty String 可选 1 应取数量 └ itemSalesUnit String 可选盒销售单位 └ itemCode String 可选 111222 商品Code └ itemBarCode String 可选 11122201 商品BarCode └ itemFullName String 可选五常大米商品名称 └ itemShortName String 可选大米商品简称 └ itemDesc String 可选好吃商品描述 └ itemSpec String 可选 5KG/袋商品规格 └ temperatureRequirement Number 可选 1 温度要求：1-常温；2-冷藏；3-冷冻；4-热链；5-鲜活 └ itemWeight String 可选 5 商品单品重量，单位：kg └ reverseRouteName String 可选测试逆向线路Name └ reverseRouteCode String 可选 123123 逆向线路ID └ workUnitContentCode String 可选 2312 作业单元内容code └ workTaskCode String 可选 12312 关联正向作业单元单号 └ outDeliveryDockCode String 可选 32131 对应外部配送商code orderAddressDTO OrderAddressDTO 可选单据地址 └ town String 可选五常街道四级地址街道 └ district String 可选余杭区四级地址区 └ province String 可选浙江省四级地址省 └ city String 可选浙江市四级地址市

响应参数

名称	类型	示例值	描述
outerResult	OuterResult	OuterResult	返回结果
└ errorMsg String 系统错误错误信息 └ errorCode String SYSTEM-ERROR 错误编码 └ success String false 业务返回成功失败

请求示例

{"pickupOrderGroupDTO":{"taskGroupCode":"10026345","taskList":[{"takeTaskCode":"PT13623424","expEarliestPickupTime":"2010-10-29 00:00:00","rcvAddrPoiName":"上海滩配送站","expLatestPickupTime":"2010-10-29 00:00:00","rcvAddrDetail":"黄浦江3号龙门镖局","pickUpItems":[{"taskContentCode":"1231312","itemSpec":"5KG/袋","reverseRouteName":"测试","itemFullName":"五常大米","itemCode":"111222","itemSalesUnit":"盒","temperatureRequirement":1,"itemDesc":"好吃","itemBarCode":"11122201","itemDeliveryQty":"1","workUnitContentCode":"2312","reverseRouteCode":"123123","itemShortName":"大米","itemWeight":"5"}],"supplierCode":"PSSCODE","pickupContactName":"孙大圣","pickupAreaName":"中二区","warehouseName":"咱家大仓","rcvContactName":"孙行者","rcvContactPhone":"12345678910","warehouseCode":"WCODE8765","pickupFulfillOrderId":"157493625717853837","outTradeOrderId":"1231231231","pickupContactPhone":"13245678910","pickupMemo":"门口有狗","saleBizMode":1,"outDeliveryDockCode":"32131","rcvDeliveryDockCode":"UD007","workTaskCode":"12312","pickupAddrPoiName":"西溪园区","pickupAddrLonLat":"121.241234,31.345234","rcvLonLat":"120.234,32.1234","orderAddressDTO":{"town":"五常街道","province":"浙江省","city":"浙江市","district":"余杭区"},"pickupOrderSpecDTO":{"deliveryWorkMode":1},"fulfillOrderId":"127212340520031302","pickupAddrDetail":"1号楼小邮局"}],"supplierCode":"CSDN","deliveryDockCode":"112233"}}

响应示例

{
    "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.pickup.assign.supplier.notfiy (取货甩单通知)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ