首先需要明确批量取号和子母单是完全不同的两个概念,不要混淆;
批量取号:一种取号方式,能够一次获取多个单号;批量取号可以用来取普通的单号也可以用来取子母单;取出几个单号取决于一次取号的时候传入了多少组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。
快递支持子母单的有:顺丰速递,德邦快递,平安达腾飞,跨越速运,京广速递,优速(UC)。
如何用批量取号的方式获取子母单运单号:
需要清楚子母单取号规则,即取号传入的订单号相同,包裹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"
}
]
}