注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 电子面单答疑知识库

批量取号和子母单的区别

更新时间:2025/05/12 访问次数:881

首先需要明确批量取号和子母单是完全不同的两个概念,不要混淆;

批量取号:一种取号方式,能够一次获取多个单号;批量取号可以用来取普通的单号也可以用来取子母单;取出几个单号取决于一次取号的时候传入了多少组TradeOrderInfoDto;

子母单:一种运单类型,指有关联关系的一组运单号;能够获取多少个单号要看total_packages_count参数,但是需要注意的是total_packages_count只是规定了该订单号能够获取多少个运单号,并不是指total_packages_count传了几就可以返回几个单号;

批量取号的方式:

电子面单支持批量取号,一次最多10个,必须是相同的发货地址和cp_code,配上多个并列的TradeOrderInfoDto。

电子面单不保证出参顺序与入参顺序保持一致:需要通过objectId进行识别。
在入参和出参中都有objectId字段,此字段与业务无关,在批量调用时,需要保证每个对象的objectid不同,在获取到返回值后,可以通过比对出参中的objectId,可以得到与入参的对应关系。
只需要在一次请求中保证不同即可。可以用索引下标代替。

批量取号,一个报错,其他的也不会取号成功。

子母单取号方式:

获取子母单的方式是将订单号传入trade_order_list中,不传tid,同时传入相同的总包裹数total_packages_count和不同的包裹编号package_info.id,就会取出多个面单号,但是这些包裹必须同一个寄件地址和收货地址,必须同时发出,一旦母单生成物流,就不允许再取子单号了,相当于一个快递,特别的是除了顺丰快递、跨越速运可以追加子母单以外,其他的快递是不可以追加子母单的,第一次传入total_packages_count为几,就只能取几个包裹,且顺丰、跨越速运追加子母单的前提是第一个取号的单号传入了总包裹数total_packages_count>=1,否则也是不可以追加的;

例如,此时我们要取三个子母单:

第一次取号传入:trade_order_list:订单号(例如333),total_packages_count:3,package_info.id:1;

第二次取号传入:trade_order_list:订单号(和第一次相同例如333),total_packages_count:3,package_info.id:2;

第三次取号传入:trade_order_list:订单号(和第一次相同例如333),total_packages_count:3,package_info.id:3;

要注意的是快递走子母单,取号参数multi_packages_shipment传true,其他同快运子母单逻辑,总包裹数必传,同样的订单号,不同包裹号,具体可参考快运白皮书 https://support-cnkuaidi.taobao.com/doc.htm#?docId=108902&docType=1

快递支持子母单的有:顺丰速递,德邦快递,平安达腾飞,跨越速运,京广速递,优速达,信丰物流、京东快递。

京东快递取子母单不需要multi_packages_shipment传true,只要传入总包裹数total_packages_count即为子母单;

如何用批量取号的方式获取子母单运单号:

需要清楚子母单取号规则,即取号传入的订单号相同,包裹id不同,总包裹数必传(总包裹数的传参关系该订单号能够取几个运单号);

接下来以批量取号获取30个子母单举例:

注意一次批量取号trade_order_info_dtos最多只能传入10组,即获取10个运单号,要获取30个运单号需要批量取号3次;

第一次取号传入:

trade_order_info_dtos:

[

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:1},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:2},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:3},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:4},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:5},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:6},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:7},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:8},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:9},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:10}

]

返回10个子母单运单号;

第二次取号传入:

trade_order_info_dtos:

[

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:11},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:12},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:13},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:14},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:15},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:16},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:17},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:18},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:19},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:20}

]

返回10个子母单运单号;

第三次取号传入:

trade_order_info_dtos:

[

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:21},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:22},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:23},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:24},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:25},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:26},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:27},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:28},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:29},

{trade_order_list:订单号(例如333),total_packages_count:30,package_info.id:30}

]

返回10个子母单运单号;

至此获取到30个子母单运单号;

实际取号参数举例:

{
    "param_waybill_cloud_print_apply_new_request": [
        {
            "trade_order_info_dtos": [
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 1,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 2,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 3,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 4,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 5,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 6,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 7,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 8,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 9,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                },
                {
                    "logistics_services": {},
                    "template_url": "https://cloudprint.cainiao.com/template/standard/304351/18",
                    "user_id": "179917267",
                    "recipient": {
                        "address": {
                            "province": "省",
                            "town": "街道",
                            "city": "市",
                            "district": "区",
                            "detail": "小区***"
                        },
                        "phone": "",
                        "mobile": "***********",
                        "name": "**",
                        "oaid": "UFcjmikynbLBw8ibhSL25",
                        "tid": "28887"
                    },
                    "object_id": "58",
                    "package_info": {
                        "total_packages_count":30,  
                        "volume": 548,
                        "weight": 52,
                        "id": 10,
                        "items": [
                            {
                                "count": 1,
                                "name": "07"
                            }
                        ]
                    },
                    "order_info": {
                        "order_channels_type": "TB",
                        "trade_order_list": [
                            "订单号"
                        ]
                    }
                }
            ],
            "cp_code": "POSTB",
            "three_pl_timing": "false",
            "multi_packages_shipment": "false",
            "dms_sorting": "false",
            "sender": {
                "address": {
                    "province": "省",
                    "city": "市",
                    "district": "区",
                    "detail": "(淘)"
                },
                "phone": "138",
                "mobile": "188",
                "name": "高洋"
            },
            "need_encrypt": "true"
        }
    ]
}

FAQ

关于此文档暂时还没有FAQ
返回
顶部