# 查询面单详情

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:ewaybill_getorder

可通过该接口查询电子面单详情。

相关事件通知:物流轨迹推送通知

相关文档: 微信小店「电子面单操作」使用指南

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/order/get?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用。

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用)

# 请求体 Request Payload

参数名类型必填示例说明
ewaybill_order_idstring11111电子面单订单id,全局唯一id

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
order_infoobject电子面单列表

# Res.order_info Object Payload

电子面单列表

参数名类型说明枚举
ewaybill_order_idstring电子面单订单id,全局唯一id-
delivery_idstring快递公司id-
site_codestring网点编码-
ewaybill_acct_idstring物流账号编码:每绑定一个物流商网点/月结账号分配一个acct_id -
senderobject寄件人-
receiverobject收件人-
ec_order_listobjarray订单信息-
remarkstring备注-
shop_idstring面单主体ID:每个商家分配的唯一shop_id-
waybill_idstring快递单号-
statusnumber状态,电子面单状态枚举值
path_infoobjarray轨迹信息-
order_typenumber订单类型枚举值
monthly_cardstring月结账号-
order_vas_listobjarray保价等增值服务-
ext_infoobject温层等补充字段-

# Res.order_info.sender Object Payload

寄件人

参数名类型说明
namestring人名
mobilestring联系电话
provincestring
citystring
countystring
streetstring街道
addressstring详细地址

# Res.order_info.receiver Object Payload

收件人

参数名类型说明
namestring人名
mobilestring联系电话
provincestring
citystring
countystring
streetstring街道
addressstring详细地址

# Res.order_info.ec_order_list(Array) Object Payload

订单信息

参数名类型说明
ec_order_idnumber订单id
goods_listobjarray订单商品信息

# Res.order_info.ec_order_list(Array).goods_listObject Payload

订单商品信息

参数名类型说明
good_namestring商品名
good_countnumber商品个数
product_idnumber商品product_id
sku_idnumber商品sku_id

# Res.order_info.path_info(Array) Object Payload

轨迹信息

参数名类型说明枚举
statusnumber轨迹状态枚举值
descstring轨迹描述-
update_timenumber更新时间-

# Res.order_info.order_vas_list(Array) Object Payload

保价等增值服务

参数名类型说明枚举
vas_typestring增值服务类型,目前支持的增值服务枚举值
vas_valuestring增值服务描述-
vas_detailstring增值服务值, 涉及金额单位一律为分-

# Res.order_info.ext_info Object Payload

温层等补充字段

参数名类型说明
temperature_rangenumber温层信息,京东专用 0或不传则为月结账号的默认温层信息 1:普通/常温 5:鲜活 6:控温 7:冷藏 8:冷冻 9:深冷

# 4. 枚举信息

# Res.order_info.status Enum

状态,电子面单状态

枚举值描述
1下单成功
2取消
3已打单
4已发货

# Res.order_info.order_type Enum

订单类型

快递公司枚举值枚举解释
JD--
JD1京东标快
JD2京东快送
JD3生鲜标快
JD4生鲜特快
JD5电商特惠
JD6特惠包裹
JD7特惠小件
JD8函速达
JD11特快零担
JD12特快重货
SF-顺丰产品详情
SF1顺丰特快
SF2顺丰标快
SF6顺丰即日
SF10国际小包
SF23顺丰国际特惠(文件)
SF24顺丰国际特惠(包裹)
SF60顺丰特快(文件)
SF144当日配-门(80CM/1KG以内)
SF199特快包裹
SF201冷运标快
SF231陆运包裹
SF242丰网速运
SF247电商标快
SF249丰礼遇
SF255顺丰卡航
SF263同城半日达
SF266顺丰空配(新)
SF283填仓标快
SF285填舱电标
SF303专享急件
SF304特早达
SF323电商微小件
SF325温控包裹
EMS--
EMS1特快专递(EMS)
EMS2快递包裹(youzhengguonei)
EMS3邮政电商标快(yzdsbk)
DBKD--
DBKD1大件快递3.60
DBKD2标准快递
DBKD3特快专递
DBKD4航空大件隔日达
DBKD5特快次日
DBKD6重包入户
DBKD7精准卡航(新)
DBKD8精准重货(新)
DBKD9精准汽运(新)
KYSY--
KYSY1当天达
KYSY2次日达
KYSY3隔日件
KYSY4陆运件
KYSY5空运
KYSY6专运
KYSY7省内次日
KYSY8省内即日
KYSY9同城次日
KYSY10同城即日

# Res.order_info.path_info(Array).status Enum

轨迹状态

枚举值描述
0待揽件
1揽收
2运输中
3派件
4入柜
5签收
6退回
7转寄
8异常
9出柜
99其他未知

# Res.order_info.order_vas_list(Array).vas_type Enum

增值服务类型,目前支持的增值服务

快递公司vas_typevas_detailvas_value
SFINSURE基础保{"value":"500"}
SFIN160定额保{"value":"500"}
SFIN159足额保{"value":"500"}
SFIN67纸箱-
CNSDVA002标准保价保价金额,单位:分
DBKDinsuranceValue保价保价金额,单位:分
STOINSURE_SERVICE保价业务保价金额,单位:分
JD1普通保价-快递保价金额,单位:分
JD2包装-
EMSinsuranceFlag保价保价金额,单位:分
ZTOSVC-INSURE保价保价金额,单位:分

# 5. 注意事项

# 6. 代码示例

请求示例

{
   "ewaybill_order_id":"11111"
}

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"order_info": {
		"ewaybill_order_id": "1111",
		"delivery_id": "xxxx",
		"site_code": "1111",
		"ewaybill_acct_id": "1111",
		"sender": {
			"name": "test",
			"mobile": "1111",
			"province": "静安区",
			"city": "上海市",
			"county": "静安区",
			"street": "xxxxx",
			"address": "xxxxxx"
		},
		"receiver": {
			"name": "test",
			"mobile": "11111",
			"province": "上海市",
			"city": "上海市",
			"county": "青浦区",
			"street": "xxxx",
			"address": "xxxxxxx"
		},
		"ec_order_list": [{
			"ec_order_id": 1111, #供货商代发单为ds_order_id
			"goods_list": [{
				"good_name": "电子资料书,",
				"good_count": 1,
				"product_id": 111,
				"sku_id": 11
			}]
		}],
		"remark": "test",
		"shop_id": "xxxx",
		"waybill_id": "xxxx",
		"status": 2,
		"path_info": [{
			"update_time": 11,
			"status": 1,
			"desc": "xxxx"
		}]
	}
}

# 7. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述
10025010面单不存在

# 8. 适用范围

本接口在不同账号类型下的可调用情况:
微信小店小店供货商
  • ✔:该账号可调用此接口。
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口。