淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
stationId	String	可选	Station001	服务商配送站编码门店发单该值必填
deliveryType	Number	必须	1	配送类型（0 门店发单，1 点对点发单）
deliveryOrderType	Number	必须	0	运单类型（0 正向单，1 逆向单）
expectTimeMode	Number	必须	0	送达时效类型 (0 即时单 1预约单)
serialNo	String	必须	6	订单小号
expectFetchTime	Number	可选	1728379194000	期望取货时间，毫秒级时间戳
expectReceiveTime	Number	可选	1728379194000	期望送达时间，毫秒级时间戳正向单该值必填
remark	String	可选	放在门口	订单备注
sender	DeliveryOrderSender	可选		发货人信息点对点发单该值必填
└ senderName String 可选李四发货人名称 └ senderPhone String 可选 13789560890,0778 发货人电话（示例 13789560890,0778） └ senderAddress String 可选 xx省xx市xx区xx街道xx单元发货人地址 └ senderLat String 可选 120.13 发货人纬度（高德坐标数据），格式如120.13 └ senderLng String 可选 120.13 发货人经度（高德坐标数据），格式如120.13
receiver	DeliveryOrderReceiver	必须		收货人信息
└ receiverName String 必须张三收货人姓名 └ receiverPhone String 必须 13789560890,0778 收货人电话（示例：13789560890,0778） └ receiverAddress String 必须 xx区xx街道xx单元收货人地址 └ receiverLat String 必须 120.13 收货人纬度（高德坐标数据） └ receiverLng String 必须 120.13 收货人经度（高德坐标数据）
goodsTotalAmount	Number	必须	14500	订单原金额，单位：分
goodsActualAmount	Number	必须	12500	订单用户实付金额，单位：分
goodsTotalWeight	Number	必须	5000	商品总重量，单位：g
categoryId	String	必须	3001	订单类目ID
isInsure	Boolean	必须	false	是否保价单

名称	类型	示例值	描述
success	Boolean	true	预下单调用是否成功
code	String	SUCCESS	错误码，成功时非必填
message	String	调用成功	错误说明，成功时非必填
data	DeliveryOrderCreateResp		返回对象
└ deliveryOriginalFee Number 500 配送原始运费，单位：分 └ deliveryDiscountFee Number 400 优惠后运费，单位：分 └ basicFee Number 300 基础运费，单位：分 └ distanceFee Number 100 距离加价，单位：分 └ overweightFee Number 0 重量加价，单位：分 └ timeFee Number 0 时段加价，单位：分 └ typeFee Number 0 品类加价，单位：分 └ deliveryDistance Number 3000 配送距离，单位：米 └ estimateFinishTime Number 1728379194000 预计送达时间，毫秒时间戳 └ preCreatedId String order0000001 预询后下单标识，正式下单通过该id校验价格是否一致

{"deliveryOrderType":0,"expectReceiveTime":0,"goodsTotalWeight":5000,"receiver":{"receiverAddress":"xx区xx街道xx单元","receiverPhone":"13789560890,0778","receiverName":"张三","receiverLng":"120.13","receiverLat":"120.13"},"expectTimeMode":0,"deliveryType":1,"remark":"放在门口","serialNo":"6","sender":{"senderPhone":"13789560890,0778","senderLat":"120.13","senderName":"李四","senderAddress":"xx省xx市xx区xx街道xx单元","senderLng":"120.13"},"goodsTotalAmount":14500,"expectFetchTime":0,"goodsActualAmount":12500,"isInsure":false,"categoryId":"3001","stationId":"Station001"}

{
    "success":true,
    "code":"SUCCESS",
    "message":"调用成功",
    "data":{
        "deliveryOriginalFee":500,
        "deliveryDiscountFee":400,
        "basicFee":300,
        "distanceFee":100,
        "overweightFee":0,
        "timeFee":0,
        "typeFee":0,
        "deliveryDistance":3000,
        "estimateFinishTime":1728379194000,
        "preCreatedId":"order0000001"
    }
}

{"code":"sign-check-failure","success":"false","message":"Illegal request"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

淘宝小时达履约

qimen.alibaba.xsd.logistics.order.precreate (配送预下单)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ