首先需要明确批量取号和子母单是完全不同的两个概念,不要混淆;
批量取号:一种取号方式,能够一次获取多个单号;批量取号可以用来取普通的单号也可以用来取子母单;取出几个单号取决于一次取号的时候传入了多少组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" } ] }