文档中心 > API类目 > 闲鱼

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
orderId	String	必须	123		闲鱼物流id
goodsInfo	IdleGoodsInfo	可选			物品信息
└ name String 可选手机名称 └ weight String 可选 1 重量（单位g）
senderAddress	IdleAddressSimpleInfo	必须			寄件地址
└ name String 必须测试名称名称 └ mobile String 必须 15600172826 手机 └ province String 必须浙江省省 └ city String 必须杭州市 └ area String 必须余杭区 └ town String 可选黄湖镇县 └ addressDetail String 必须阿里巴巴西溪A区2号楼详细地址
receiverAddress	IdleAddressSimpleInfo	必须			收件地址
└ name String 必须测试名称名称 └ mobile String 必须 15600172826 手机 └ province String 必须浙江省省 └ city String 必须杭州市 └ area String 必须余杭区 └ town String 可选黄湖镇县 └ addressDetail String 必须阿里巴巴西溪A区2号楼详细地址
expectedGotStartTime	String	必须	2022-10-10 10:10:00		预约上门开始时间
expectedGotEndTime	String	必须	2022-10-12 10:10:00		预约上门结束时间
incrementServices	IdleIncrementService []	可选		最大列表长度：20	增值服务信息
└ value1 String 可选 100 增值服务扩展属性1 └ value2 String 可选 500 增值服务扩展属性2 └ value3 String 可选 600 增值服务扩展属性3 └ value4 String 可选 700 增值服务扩展属性4 └ name String 可选 INSURE 增值服务名称 └ value String 可选 1000 增值服务扩展属性
productCode	String	可选	YT		产品code
cpCode	String	必须	YT		合作伙伴的code
monthlyCard	String	可选	7551234567		月结卡号
payType	String	可选	3		支付方式（全国无固定第三方支付月结值为3）

响应参数

名称	类型	示例值	描述
result	Result		结果
data IdleData 业务数据 └ waybillNo String 1289381093 闲鱼物流单号 └ orderId String 23891283092 运单号 └ errorMsg String 系统错误错误信息 └ errorCode String SYS_ERR 错误码 └ success Boolean true 是否成功 └ isRetry Boolean true 是否可以重试

请求示例

{"receiverAddress":{"area":"余杭","addressDetail":"阿里巴巴西溪A区2号楼","province":"浙江省","town":"黄湖镇","city":"杭州","name":"测试名称","mobile":"15600172826"},"cpCode":"YT","senderAddress":{"area":"余杭","addressDetail":"阿里巴巴西溪A区2号楼","province":"浙江省","town":"黄湖镇","city":"杭州","name":"测试名称","mobile":"15600172826"},"productCode":"YT","payType":"3","orderId":"123","monthlyCard":"7551234567","incrementServices":[{"value2":"500","value1":"100","value4":"700","value3":"600","name":"INSURE","value":"1000"}],"expectedGotStartTime":"2022-10-10 10:10:00","expectedGotEndTime":"2022-10-12 10:10:00","goodsInfo":{"name":"手机","weight":"1"}}

响应示例

{
    "result":{
        "data":{
            "waybillNo":"1289381093",
            "orderId":"23891283092"
        },
        "errorMsg":"系统错误",
        "errorCode":"SYS_ERR",
        "success":true,
        "isRetry":true
    }
}

验签示例

{"result":"false","success":{"errorCode":"sign-check-failure","errorMsg":"Illegal request"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部