# 电子面单预取号
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:ewaybill_precreateorder
可通过该接口校验电子面单取号接口的参数,并获取全局唯一的ewaybill_order_id用于真正取号的接口
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/order/precreate?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:130、159
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
delivery_id | string | 是 | 快递公司id |
site_code | string | 否 | 网点编码 |
ewaybill_acct_id | string | 是 | 电子面单账号id |
sender | object | 是 | 寄件人,传明文 |
receiver | object | 是 | 收件人,传小店订单内获取到的用户信息即可 |
ec_order_list | objarray | 是 | 订单信息 |
remark | string | 否 | 备注 |
shop_id | string | 是 | 店铺id(从查询开通账号信息接口获取) |
# Body.sender Object Payload
寄件人,传明文
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
name | string | 是 | 人名 |
mobile | string | 是 | 联系电话 |
province | string | 是 | 省 |
city | string | 是 | 市 |
county | string | 是 | 区 |
street | string | 是 | 街道 |
address | string | 是 | 详细地址 |
# Body.receiver Object Payload
收件人,传小店订单内获取到的用户信息即可
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
name | string | 是 | 人名 |
mobile | string | 是 | 联系电话 |
province | string | 是 | 省 |
city | string | 是 | 市 |
county | string | 是 | 区 |
street | string | 是 | 街道 |
address | string | 是 | 详细地址 |
# Body.ec_order_list(Array) Object Payload
订单信息
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
ec_order_id | number | 是 | 订单id |
goods_list | objarray | 是 | 订单商品信息 |
ewaybill_order_code | string | 否 | 代发的订单密文 |
ewaybill_order_appid | string | 否 | 代发的订单所属店铺appid |
# Body.ec_order_list(Array).goods_listObject Payload
Object Payload
订单商品信息
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
good_name | string | 是 | 商品名 |
good_count | number | 是 | 商品个数 |
product_id | number | 是 | 商品product_id |
sku_id | number | 是 | 商品sku_id |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
ewaybill_order_id | string | 电子面单订单id,可用于取号接口请求参数 |
# 4. 注意事项
- 如果使用代发模式,填ewaybill_order_code和ewaybill_order_appid即可,不能填ec_order_id字段。
- ewaybill_order_code可从小店订单详情接口获取。
# 5. 代码示例
请求示例
{
"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,
"goods_list": [{
"good_name": "电子资料书,",
"good_count": 1,
"product_id": 111,
"sku_id": 11
}]
}],
"remark": "test",
"shop_id": "xxxx"
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"ewaybill_order_id":"111"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
10025012 | delivery_id错误 | |
10025013 | 网点信息错误 | |
10025014 | 网点账号编码错误 | |
10025015 | 寄件人信息错误 | |
10025016 | 收件人信息错误 | |
10025017 | 小店订单信息错误 | |
10025018 | 店铺id信息错误 |
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。