# 电子面单取号
# 接口说明
可通过该接口发起电子面单取号
# 注意事项
- 如果使用代发模式，填ewaybill_order_code和ewaybill_order_appid即可，不能填ec_order_id字段；
- ewaybill_order_code可从小店订单详情接口获取；
- 代发模式下，例如店铺A打印店铺B的订单，只有订单字段ewaybill_order_code和ewaybill_order_appid是店铺B的，其他参数（网点，模版等）均是店铺A的；
- 增值服务在使用之前，请先和快递公司或者网点确认可用。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/order/create?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| ewaybill_order_id | String | 是 | 电子面单订单id，全局唯一id（从预取号接口获取或者自定义）,注意该字段类型用String传递，但是数据内容要求是Uint64 |
| delivery_id | String | 是 | 快递公司id |
| site_code | String | 否 | 网点编码 |
| ewaybill_acct_id | String | 是 | 电子面单账号id |
| sender | Address | 是 | 寄件人，传明文，结构体详情请参考Address |
| receiver | Address | 是 | 收件人,传小店订单内的用户收件人的信息文本即可。注：此字段只做非空参数校验，实际使用的收件人地址是小店订单内的用户地址，若收件人地址有误，可以联系用户修改订单收件地址或者调用修改地址接口，结构体详情请参考Address |
| ec_order_list | array[EcOrderInfo] | 是 | 订单信息，结构体详情请参考EcOrderInfo |
| remark | String | 否 | 备注 |
| shop_id | String | 是 | 店铺id（从查询开通账号信息接口获取） |
| return_address | Address | 否 | 退货地址，结构体详情请参考Address |
| template_id | String | 否 | 如果需要获取打印报文，则填该字段。回包返回print_info。 如无需使用后台模板，可直接传递template_type做为默认模板， 如‘single’ |
| order_type | number | 否 | 支持的类型，陆续更新中，枚举值详情请参考order_type，默认为1，加盟型可以不填 |
| order_vas_list | array[OrderVas] | 否 | 保价等增值服务，结构体详情请参考OrderVas |
| ext_info | EWaybillOrderInfoExt | 否 | 温层等补充字段，枚举值详情请参考EWaybillOrderInfoExt |
# 请求参数示例
{
"ewaybill_order_id": "1111",
"delivery_id": "xxxx",
"site_code": "1111",
"ewaybill_acct_id": "1111",
"template_id": "xxx", // 如果需要获取打印报文，则填该字段。回包会返回 print_info。 如无需使用后台模板，可直接传递 template_type做为默认模板， 如‘single’
"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",
"return_address": {
"name": "test",
"mobile": "13212778355",
"province": "上海市",
"city": "上海市",
"county": "青浦区",
"street": "xxxx",
"address": "xxxxx"
}
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| ewaybill_order_id | String | 电子面单订单id |
| waybill_id | String | 快递单号 |
| delivery_error_msg | String | 快递公司错误码 |
| print_info | String | 如果请求参数填了template_id，则返回打印报文信息，可以传给打印组件打印面单。 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"ewaybill_order_id":"111",
"waybill_id":"1212xzcxz",
"delivery_error_msg":"xxxx"
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 10025005 | 下单失败，具体原因参考delivery_error_msg字段 |
| 10025012 | delivery_id错误 |
| 10025013 | 网点信息错误 |
| 10025014 | 网点账号编码错误 |
| 10025015 | 寄件人信息错误 |
| 10025016 | 收件人信息错误 |
| 10025017 | 小店订单信息错误 |
| 10025018 | 店铺id信息错误 |
| 10025019 | 面单已存在 |
# 结构体
# Address
寄件人，收件人，退货地址
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| name | String | 是 | 人名 |
| mobile | String | 是 | 联系电话 |
| province | String | 是 | 省 |
| city | String | 是 | 市 |
| county | String | 是 | 区 |
| street | String | 是 | 街道(收件人非必填) |
| address | String | 是 | 详细地址 |
# EcOrderInfo
订单信息
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| ec_order_id | Uint64 | 是 | 订单id |
| goods_list | array[GoodsInfo] | 是 | 订单商品信息，结构体详情请参考GoodsInfo |
| ewaybill_order_code | string | 否 | 代发的订单密文 |
| ewaybill_order_appid | string | 否 | 代发的订单所属店铺appid |
# GoodsInfo
订单商品信息
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| good_name | String | 是 | 商品名 |
| good_count | Uint32 | 是 | 商品个数 |
| product_id | Uint64 | 否 | 商品product id |
| sku_id | Uint64 | 否 | 商品sku id |
| out_product_id | String | 否 | 商家自定义spu id |
| out_sku_id | String | 否 | 商家自定义sku id |
| out_goods_info | String | 否 | 商家自定义商品详情（如果不传平台的商品id的话，会展示该字段在面单商品区域） |
# OrderVas
保价等增值服务
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| vas_type | String | 是 | 增值服务类型 |
| vas_detail | String | 否 | 增值服务描述 |
| vas_value | String | 否 | 增值服务值, 涉及金额单位一律为分 |
目前支持的增值服务，OrderVas结构体参数对应填写以下值即可。
| 快递公司 | vas_type | vas_detail | vas_value |
|---|---|---|---|
| SF | INSURE | 基础保 | {"value":"500"} |
| SF | IN160 | 定额保 | {"value":"500"} |
| SF | IN159 | 足额保 | {"value":"500"} |
| SF | IN67 | 纸箱 | - |
| CNSD | VA002 | 标准保价 | 保价金额，单位：分 |
| DBKD | insuranceValue | 保价 | 保价金额，单位：分 |
| STO | INSURE_SERVICE | 保价业务 | 保价金额，单位：分 |
| JD | 1 | 普通保价-快递 | 保价金额，单位：分 |
| JD | 2 | 包装 | - |
# EWaybillOrderInfoExt
温层等补充字段
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| temperature_range | Uint32 | 否 | 温层信息，京东专用； 0或不传则为月结账号的默认温层信息 1:普通/常温 5:鲜活 6:控温 7:冷藏 8:冷冻 9:深冷 |
# 枚举值
# order_type
支持的类型
| 快递公司 | 枚举值 | 描述 |
|---|---|---|
| JD | - | - |
| JD | 1 | 京东标快 |
| JD | 2 | 京东快送 |
| JD | 3 | 生鲜标快 |
| JD | 4 | 生鲜特快 |
| JD | 5 | 电商特惠 |
| JD | 6 | 特惠包裹 |
| JD | 7 | 特惠小件 |
| JD | 8 | 函速达 |
| JD | 11 | 特快零担 |
| JD | 12 | 特快重货 |
| SF | - | 顺丰产品详情 |
| SF | 1 | 顺丰特快 |
| SF | 2 | 顺丰标快 |
| SF | 6 | 顺丰即日 |
| SF | 10 | 国际小包 |
| SF | 23 | 顺丰国际特惠(文件) |
| SF | 24 | 顺丰国际特惠(包裹) |
| SF | 60 | 顺丰特快（文件） |
| SF | 144 | 当日配-门(80CM/1KG以内) |
| SF | 199 | 特快包裹 |
| SF | 201 | 冷运标快 |
| SF | 242 | 丰网速运 |
| SF | 247 | 电商标快 |
| SF | 249 | 丰礼遇 |
| SF | 303 | 专享急件 |
| SF | 304 | 特早达 |
| EMS | - | - |
| EMS | 1 | 特快专递（EMS） |
| EMS | 2 | 快递包裹（youzhengguonei） |
| EMS | 3 | 邮政电商标快（yzdsbk) |
| DBKD | - | - |
| DBKD | 1 | 大件快递3.60 |
| DBKD | 2 | 标准快递 |
| DBKD | 3 | 特快专递 |
| DBKD | 4 | 航空大件隔日达 |
| DBKD | 5 | 航空大件次日达 |
| DBKD | 6 | 重包入户 |
| DBKD | 7 | 精准卡航(新) |
| DBKD | 8 | 精准重货(新) |
| DBKD | 9 | 精准汽运(新) |