文档中心 > API类目 > 淘宝物流API

qimen.taobao.logistics.tms.mainline.transportorder.create (干线运输单创建)

淘天下发干线运输作业单给服务商,干线运输作业单用于仓间调拨。

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
request	Request	可选			请求
└ ownerCode String 必须 AX766232 货主编码 └ orderCode String 必须 YS8877623 干线运输作业单号 └ orderType String 必须 TOB_TRANSPORT 作业单类型标识 └ resourceCode String 必须 STA 干线运输资源编码 relatedOrders RelatedOrder [] 可选关联单据信息（本项目在此处带关联的调拨出库单号、或者调拨入库单号） └ orderCode String 可选 LBX777212 关联的单据编号 └ orderType String 可选 DBCK 关联的单据类型(DBCK=调拨出库、DBRK=调拨入库) └ extendProps Map 可选扩展属性 senderInfo SenderInfo 可选发货人 └ name String 可选张三姓名 └ phone String 可选 58867727 电话 └ email String 可选 a@demo.com 邮箱 └ country String 可选中国国家（使用中文文描） └ province String 可选浙江省省（使用中文文描） └ city String 可选杭州市市（使用中文文描） └ area String 可选余杭区区（使用中文文描） └ address String 可选永寿街9号详细地址（使用中文文描） └ zipCode String 可选 100086 邮编 └ extendProps Map 可选扩展属性 receiverInfo ReceiverInfo 可选收货人 └ name String 可选李四姓名 └ phone String 可选 58867727 电话 └ email String 可选 a@demo.com 邮编 └ country String 可选中国国家（使用中文文描） └ province String 可选浙江省省（使用中文文描） └ city String 可选杭州市市（使用中文文描） └ area String 可选余杭区区（使用中文文描） └ address String 可选永寿街9号详细地址（使用中文文描） └ zipCode String 可选 100086 邮编 └ extendProps Map 可选扩展属性 orderLines OrderLine [] 必须明细行信息 └ orderLineNo String 必须 01 明细行号 └ itemCode String 必须 758772 商品编码 └ itemName String 必须淘公仔商品名称 └ planQty String 必须 100 应运输商品数量 └ extendProps Map 可选扩展属性 fromLocation FromLocation 可选起始地址 └ warehouseCode String 可选仓A 起始仓 └ province String 可选上海市起始地址省（使用中文文描） └ city String 可选上海市起始地址市（使用中文文描） └ area String 可选宝山区起始地址区（使用中文文描） └ address String 可选宝山街9号起始地址详细地址 └ extendProps Map 可选扩展属性 toLocation ToLocation 可选目的地址 └ warehouseCode String 可选仓B 目的仓 └ province String 可选浙江省目的地址省（使用中文文描） └ city String 可选杭州市目的地址市（使用中文文描） └ area String 可选余杭区目的地址区（使用中文文描） └ address String 可选永寿街9号目的地址详细地址 └ extendProps Map 可选扩展属性 └ extendProps Map 可选扩展属性

响应参数

名称	类型	示例值	描述
response	Response		返回
└ success Boolean true 是否成功，true-成功; false-失败 └ biz_error_code String E0001 错误编码 └ biz_error_msg String invalid app key 错误描述 └ retry Boolean false 是否可重试 true-可重试 └ outerOrderCode String EXT11234 服务商系统的干线运输作业单号

请求示例

{"request":{"orderType":"TOB_TRANSPORT","senderInfo":{"area":"余杭区","country":"中国","zipCode":"100086","address":"永寿街9号","province":"浙江省","phone":"58867727","city":"杭州市","name":"张三","extendProps":"","email":"a@demo.com"},"resourceCode":"STA","orderLines":[{"orderLineNo":"01","itemName":"淘公仔","planQty":"100","itemCode":"758772","extendProps":""}],"ownerCode":"AX766232","receiverInfo":{"area":"余杭区","country":"中国","zipCode":"100086","address":"永寿街9号","province":"浙江省","phone":"58867727","city":"杭州市","name":"李四","extendProps":"","email":"a@demo.com"},"extendProps":"","orderCode":"YS8877623","relatedOrders":[{"orderType":"DBCK","extendProps":"","orderCode":"LBX777212"}],"fromLocation":{"area":"宝山区","address":"宝山街9号","province":"上海市","city":"上海市","extendProps":"","warehouseCode":"仓A"},"toLocation":{"area":"余杭区","address":"永寿街9号","province":"浙江省","city":"杭州市","extendProps":"","warehouseCode":"仓B"}}}

响应示例

{
    "response":{
        "success":true,
        "biz_error_code":"E0001",
        "biz_error_msg":"invalid app key",
        "retry":false,
        "outerOrderCode":"EXT11234"
    }
}

验签示例

{"response":{"biz_error_msg":"Illegal request","success":"不等于true","biz_error_code":"sign-check-failure"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

淘宝物流API

qimen.taobao.logistics.tms.mainline.transportorder.create (干线运输单创建)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ