追加子单 | 微信开放文档

# 追加子单

# 接口说明

通过该接口可以对已经取号的电子面单追加子件，目前支持子母单的快递公司有：顺丰速运、德邦快递、京东快递

# 注意事项

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

# 接口请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
ewaybill_order_id	uint64	是	电子面单订单号
waybill_id	string	是	运单号
delivery_id	string	是	快递公司id
add_package_quantity	uint32	是	追加面单数量 1<=add_package_quantity <= 300
template_id	string	否	面单模板id
shop_id	string	是	店铺id（从查询开通账号信息接口获取）
ewaybill_acct_id	string	是	电子面单账号id（从查询开通账号信息接口获取）
subpackage_list	EWaybillSubPackage	否	包裹的体积和重量信息，顺丰支持该字段，结构体详情参考EWaybillSubPackage

# EWaybillSubPackage

包裹信息

参数	类型	是否必填	描述
weight_g	uint64	否	商品重量，单位克
space_x	uint64	否	商品长度，单位厘米
space_y	uint64	否	商品宽度，单位厘米
space_z	uint64	否	商品高度，单位厘米
package_no	string	否	包裹编号

# 请求参数示例

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

# 返回参数说明

参数	类型	是否必填	描述
errcode	number	是	错误码
errmsg	string	是	错误信息
ewaybill_order_id	String	是	电子面单订单id
waybill_id	String	是	快递单号
delivery_error_msg	String	是	快递公司错误码
print_info	String	否	如果请求参数填了template_id，则返回打印报文信息，可以传给打印组件打印面单。
waybill_id_list	SubWaybillIdInfo	否	子母单号列表，定义详见SubWaybillIdInfo

# SubWaybillIdInfo

参数	类型	描述
waybill_id	String	快递单号
waybill_type	uint32	快递单号类型，1：母单号，2：子单号
create_time	uint32	单号创建时间，秒级时间戳

# 返回参数参数示例

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