文档中心 > API类目 > 菜鸟末端商业

qimen.cainiao.cntec.recycle.express.delivery.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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
order_id	String	必须	F00000xqqq	菜鸟履约单号
biz_type	String	必须	CLOTHES	业务类型，用于区分回收品类
biz_mode	String	必须	EXPRESS_DELIVERY	业务模式，用于区分快递上门模式、到站模式
predict_weight	String	必须	5	预估重量，单位：克
sending_info	SendingInfoDTO	必须		寄件地址信息
└ contact_name String 必须王大山联系人姓名 └ contact_phone String 必须 130xxxxxxxx 联系人手机 └ appoint_start_time String 必须 2024-04-23 11:23:30 预约起始时间 └ appoint_end_time String 必须 2024-04-23 11:23:30 预约结束时间 └ appoint_province String 必须浙江省省 └ appoint_city String 必须杭州市市 └ appoint_district String 可选西湖区区 └ detail_address String 必须文一西路中节能西溪首座详细地址
feature	String	可选	{"xxx":"yyy"}	预留扩展信息

响应参数

名称	类型	示例值	描述
err_message	String	参数非法	错误描述，success为false时有值
success	Boolean	true	true表示成功，false表示失败
err_code	String	ERROR_PARAM	错误码，success为false时有值

请求示例

{"biz_mode":"EXPRESS_DELIVERY","predict_weight":"5","feature":"{\"xxx\":\"yyy\"}","biz_type":"CLOTHES","sending_info":{"appoint_start_time":"2024-04-23 11:23:30","contact_name":"王大山","appoint_province":"浙江省","contact_phone":"130xxxxxxxx","appoint_city":"杭州市","detail_address":"文一西路中节能西溪首座","appoint_end_time":"2024-04-23 11:23:30","appoint_district":"西湖区"},"order_id":"F00000xqqq"}

响应示例

{
    "err_message":"参数非法",
    "success":true,
    "err_code":"ERROR_PARAM"
}

验签示例

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

菜鸟末端商业

qimen.cainiao.cntec.recycle.express.delivery.order.create (调用回收商创建快递上门订单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ