# 电子面单子件追加

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

接口英文名：ewaybill_addsuborder

通过该接口可以对已经取号的电子面单追加子件，目前支持子母单的快递公司有：顺丰速运(SF)、德邦快递(DBKD)、京东快递(JD)、顺心捷达(SXJD)、韵达快运（YDKY）、安能物流(ANEKY)

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/order/addsuborder?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`

参数名	类型	必填	说明
ewaybill_order_id	number	是	电子面单订单号
waybill_id	string	是	运单号
delivery_id	string	是	快递公司id
add_package_quantity	number	是	追加面单数量 1<=add_package_quantity <= 300
template_id	string	否	面单模板id
shop_id	string	是	店铺id（从查询开通账号信息接口获取）
ewaybill_acct_id	string	是	电子面单账号id（从查询开通账号信息接口获取）
subpackage_list	objarray	否	包裹的体积和重量信息，顺丰支持该字段
sub_order_ext_info	string	否	子单额外信息，如用于填写商家与快递定义的交易分单类型等

# Body.subpackage_list(Array) `Object Payload`

包裹的体积和重量信息，顺丰支持该字段

参数名	类型	必填	说明
weight_g	number	否	商品重量，单位克
space_x	number	否	商品长度，单位厘米
space_y	number	否	商品宽度，单位厘米
space_z	number	否	商品高度，单位厘米
package_no	string	否	包裹编号

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
delivery_error_msg	string	快递公司错误码
waybill_id	string	快递单号
waybill_id_list	objarray	子母单号列表
print_info	string	如果请求参数填了template_id，则返回打印报文信息，可以传给打印组件打印面单。
ewaybill_order_id	string	电子面单订单id

# Res.waybill_id_list(Array) `Object Payload`

子母单号列表

参数名	类型	说明
waybill_id	string	快递单号
waybill_type	number	快递单号类型，1：母单号，2：子单号
create_time	number	单号创建时间，秒级时间戳

# 4. 注意事项

京东的子母单的单号规则是：运单号-序号-总件数，由于每次追加都会引起总件数的变化，所以会导致全部的运单号都会发生变化，例如JDAWX021335191911-1-2追加子单之后序号1包裹的单号变成JDAWX021335191911-1-3；所以调用追加接口之后，京东需要将所有的子母面单重新打印。
仅支持运单整票取消，不支持单独取消某一个子单；如果需要取消子母单，请调用运单取消接口整票取消。

# 5. 代码示例

请求示例

{
    "ewaybill_order_id": xxxxxxx,
    "delivery_id": "JD",
    "waybill_id":"xxxxxxx",
    "add_package_quantity":1,
    "shop_id": "xxxxxx",
    "ewaybill_acct_id": "xxxxx"
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "delivery_error_msg":"调用成功",
    "waybill_id": "JDAWX0161464774",
    "waybill_id_list": [
    {
      "create_time": 1734508828,
      "waybill_id": "JDAWX0161464774-1-3-",
      "waybill_type": 2
    },
    {
      "create_time": 1734508828,
      "waybill_id": "JDAWX0161464774-2-3-",
      "waybill_type": 2
    },
    {
      "create_time": 1734508828,
      "waybill_id": "JDAWX0161464774-3-3-",
      "waybill_type": 2
    }
  ],
  "print_info":"xxxxxxx"
}

# 6. 错误码

此接口没有特殊错误码，可参考通用错误码

# 7. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。