淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
biz_code	String	可选	234234234234		单号标识
delivery_code	String	必须	TTWL001		配资源编码
supplier_id	String	必须	12341567891022		服务商id
pick_start_time	String	必须	2023-02-20 08:00:00		取件开始时间
pick_end_time	String	必须	2023-02-20 09:00:00		取件结束时间
total_price	String	可选	199		总金额，单位为分，小数点后三位数
total_weight	String	可选	13.040		总重量，单位g，小数点保留三位数
item_list	ItemsDO []	必须		最大列表长度：50	商品列表
ItemsDO ItemInfoDO 必须商品 └ extend_fields String 可选 1 扩展属性 └ check_items Boolean 可选 false 是否需要核验，核验商品品类、颜色、数量、外观 └ leaf_category_name String 必须小毛衣叶子类目信息描述 └ item_num String 必须 1 商品数量 └ sku_name String 可选毛衣商品sku信息 └ item_name String 必须毛衣商品名称
sender	SenderDO	必须			发件人信息
└ latitude String 可选 123.000000 纬度 └ longitude String 可选 123.000000 经度 └ address String 必须浙江省杭州市余杭区文一西路823号发件人详细地址 └ area_id String 必须 67991 地址id └ street String 可选街道发件人街道 └ district String 可选余杭发件人区 └ city String 可选杭州发件人市 └ province String 必须浙江发件人省 └ mobile String 可选 13989203824 发件人电话号码 └ phone String 可选 0571-84292224 发件人座机号 └ name String 必须刘某发件人姓名
receiver	ReceiverDO	必须			收件人信息
└ latitude String 可选 123.000000 纬度 └ longitude String 可选 123.000000 经度 └ address String 必须四川省成都市高新区新航路283号收件人详细地址 └ area_id String 必须 67991 地址ID └ street String 可选文一路收件人街道 └ district String 可选高新收件人区 └ city String 可选成都收件人市 └ province String 必须四川收件人省 └ mobile String 可选 15956874256 收件人电话号码 └ phone String 可选 024-84332654 收件人座机号 └ name String 必须李某收件人姓名
platform_requirement	String	可选	UnpaidAssignment		平台服务要求（枚举），以英文逗号隔开 UnpaidNoAssignment-未支付不支持走件 UnpaidAssignment-未支付支持走件

名称	类型	示例值	描述
success	Boolean	true	系统成功失败 true\|false
is_retry	Boolean	true	是否可重试
data	DataDO		服务商返回数据
periods PeriodDO 可取件的时间片列表 └ pick_end_time String 2023-02-20 08:00:00 取件结束时间 └ pick_start_time String 2023-02-20 08:00:00 取件开始时间
biz_error_code	String	100001	错误码
biz_error_msg	String	系统错误	错误信息

{"biz_code":"234234234234","delivery_code":"TTWL001","pick_start_time":"2023-02-20 08:00:00","total_price":"199","receiver":{"address":"四川省成都市高新区新航路283号","province":"四川","city":"成都","phone":"024-84332654","street":"文一路","latitude":"123.000000","district":"高新","mobile":"15956874256","name":"李某","area_id":"67991","longitude":"123.000000"},"sender":{"address":"浙江省杭州市余杭区文一西路823号","province":"浙江","city":"杭州","phone":"0571-84292224","street":"街道","latitude":"123.000000","district":"余杭","mobile":"13989203824","name":"刘某","area_id":"67991","longitude":"123.000000"},"platform_requirement":"UnpaidAssignment","item_list":[{"ItemsDO":{"leaf_category_name":"小毛衣","check_items":false,"extend_fields":"1","sku_name":"毛衣","item_name":"毛衣","item_num":"1"}}],"supplier_id":"12341567891022","pick_end_time":"2023-02-20 09:00:00","total_weight":"13.040"}

{
    "success":true,
    "is_retry":true,
    "data":{
        "periods":{
            "pick_end_time":"2023-02-20 08:00:00",
            "pick_start_time":"2023-02-20 08:00:00"
        }
    },
    "biz_error_code":"100001",
    "biz_error_msg":"系统错误"
}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

淘天物流API

qimen.taobao.logistics.express.order.precreate (下单前校验接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ