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

qimen.wdk.mall.booktrade.logistics.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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
data	Data	必须			输入参数
└ orderCode String 可选 900271 物流订单号 └ payMethod String 可选 JFYJ 支付方式 └ custId String 可选 80001137 客户ID └ sendStartTime String 可选 2020-02-14 08:00:00 要求上门取件时间 └ bizType String 可选 1 业务类型 1-取件下单 2-回程送件 └ isDoCall String 可选 1 1-上门取件，其他不上门取件 └ preOrderCode String 可选 900270 取件下单单号，bizType=2有值 └ remark String 可选请准时取件备注 senderInfo SenderInfo 可选送件人信息 └ name String 可选李先生寄件人姓名 └ tel String 可选 18874201688 寄件人电话 └ province String 可选广东省寄件人省份 └ city String 可选深圳市寄件人城市 └ district String 可选宝安区寄件人区域 └ town String 可选新安街道寄件人街道 └ detail String 可选汇聚·宝安湾智创园 D栋224房寄件人详细地址 └ company String 可选汇聚·宝安湾智创园 D栋224房寄件人公司地址 receiveInfo ReceiveInfo 可选收件人信息 └ name String 可选张三收件人姓名 └ tel String 可选 15974261100 收件人电话 └ province String 可选广东省收件人省份 └ city String 可选深圳市收件人城市 └ district String 可选宝安区收件人区域 └ town String 可选新安街道收件人街道 └ detail String 可选匠心洗护中心收件人详细地址 └ company String 可选匠心洗护中心收件人公司地址

响应参数

名称	类型	示例值	描述
success	Boolean	true	true-创建成功 false-创建失败
resultCode	String	0	0-创建成功其他-创建失败
resultInfo	String	下单成功	报错原因，succes == false，则一定存在
orderCode	String	990001	物流订单号
waybillNos	String	SF-0001	运单号，如果 success==true，则一定存在

请求示例

{"data":{"bizType":"1","senderInfo":{"province":"广东省","town":"新安街道","city":"深圳市","district":"宝安区","name":"李先生","tel":"18874201688","company":"汇聚·宝安湾智创园 D栋224房","detail":"汇聚·宝安湾智创园 D栋224房"},"preOrderCode":"900270","payMethod":"JFYJ","custId":"80001137","sendStartTime":"2020-02-14 08:00:00","orderCode":"900271","remark":"请准时取件","receiveInfo":{"province":"广东省","town":"新安街道","city":"深圳市","district":"宝安区","name":"张三","tel":"15974261100","company":"匠心洗护中心","detail":"匠心洗护中心"},"isDoCall":"1"}}

响应示例

{
    "success":true,
    "resultCode":"0",
    "resultInfo":"下单成功",
    "orderCode":"990001",
    "waybillNos":"SF-0001"
}

验签示例

{"success":"不等于true","resultCode":"sign-check-failure","resultInfo":"Illegal request"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

五道口API

qimen.wdk.mall.booktrade.logistics.create (创建物流作业单)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

用户导航

用户反馈

用户反馈

用户反馈