获取快递公司列表
获取快递公司代码
发货接口需要传入快递公司的代码，市面上很多家快递公司，此接口可以获取主流快递公司的代码以及快递单号的检验规则。 此接口一般不需要每次都调用，您获取最新数据后，可以作为基础数据存到自己的系统中。
一、请求参数
请求URL:
POST https://kf.fw199.com/gateway/taobao/logistices/getcompany
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号，非店铺名称. 如果不传入将用代理店铺。建议自行传入。 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| order_mode | string | 推荐物流公司的下单方式.可选值:offline(电话联系/自己联系),online(在线下单),all(即电话联系又在线下单). | |
| is_recommended | bool | 是否查询推荐物流公司.可选值:true,false.如果不提供此参数,将会返回所有支持电话联系的物流公司. |
二、请求示例代码
Java
@Test public void getLogisticesCompany() throws Exception {
String result =""; String tb_seller_nick = Config.TBSellerNick ; //要查询支付宝的淘宝商家 CloseableHttpClient httpclient = HttpClients.createDefault(); HttpPost httpPost = new HttpPost( Config.LogisticesCompanyUrl );
//业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); data.put("tb_seller_nick", tb_seller_nick); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString());
// 推荐物流公司的下单方式.可选值:offline(电话联系/自己联系),online(在线下单),all(即电话联系又在线下单). // 此参数仅仅用于is_recommended 为ture时。就是说对于推荐物流公司才可用.如果不选择此参数将会返回推荐物流中支持电话联系的物流公司. // 是否查询推荐物流公司.可选值:true,false.如果不提供此参数,将会返回所有支持电话联系的物流公司. data.put("is_recommended", "true"); data.put("order_mode","offline"); // 参数签名 data.put("sign", Utils.Sign(data,Config.AppSecret)); List<BasicNameValuePair> params = new ArrayList<BasicNameValuePair>(); for (Map.Entry<String, String> entry : data.entrySet()) { params.add(new BasicNameValuePair(entry.getKey(), entry.getValue())); } //发起POST请求 try { httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8")); HttpResponse httpResponse = httpclient.execute(httpPost); if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) { result = EntityUtils.toString(httpResponse.getEntity()); } else { result = ("doPost Error Response: " + httpResponse.getStatusLine().toString()); } } catch (Exception e) { e.printStackTrace();
}
System.out.println(result);
}
}三、返回结果
{ "code": 0, "message": "ok", "data": [{ "code": "ZJS", // 资源编码（发货使用） "id": 103, "name": "宅急送", "reg_mail_no": "^[a-zA-Z0-9]{10}$|^(42|16)[0-9]{8}$|^A[0-9]{12}" }, { "code": "SF", // 资源编码（发货使用） "id": 505, "name": "顺丰速运", "reg_mail_no": "^[A-Za-z0-9-]{4,35}$" } ] }说明： code为0表示成功，非0为失败，message会包含失败原因。失败时一定要注意，可能商户授权过期，或是参数有误。 data为快递公司的集合，由于篇幅有限，省略部分数据。data集合中的对象关系如下： code: 资源编码（发货使用），name: 快递公司名称，reg_mail_no： 快递单号的规则。
注意：此接口返回的code用于对应快递发货时使用，电子面单取号时快递公司的代码用”获取菜鸟标准电子面单模板“中的cp_code。两者代码不要搞混，具体的区分见 https://open.taobao.com/doc.htm?docId=105085&docType=1
四、常用快递公司名称及发货代码
菜鸟中的快递公司会有变化，请通过接口获取最新的快递公司信息。
{ "code": 0, "message": "ok", "data": [ { "code": "POST", "id": 1, "name": "中国邮政", "reg_mail_no": "" }, { "code": "OTHER", "id": -1, "name": "其他", "reg_mail_no": "^[A-Za-z0-9-]{4,35}$" }, { "code": "CYEXP", "id": 511, "name": "长宇", "reg_mail_no": "" }, { "code": "DTW", "id": 512, "name": "大田", "reg_mail_no": "" }, { "code": "YUD", "id": 513, "name": "长发", "reg_mail_no": "" }, { "code": "DISTRIBUTOR_13211725", "id": 1216000000124268, "name": "跨越速运", "reg_mail_no": "" }, { "code": "DISTRIBUTOR_30493846", "id": 1216000000361492, "name": "平安达腾飞快递", "reg_mail_no": "10位纯数字单如：1661783770" }, { "code": "DISTRIBUTOR_13222803", "id": 1216000000125358, "name": "中通快运", "reg_mail_no": "" }, { "code": "PKGJWL", "id": 21000038002, "name": "派易国际物流77", "reg_mail_no": "" }, { "code": "DISTRIBUTOR_13148625", "id": 6000100034229, "name": "菜鸟大件-中铁配", "reg_mail_no": "^\\d{15,}[-\\d]+$|^[0-9]{10}|[0-9]{12}$" }, { "code": "DISTRIBUTOR_13159132", "id": 6000100034186, "name": "菜鸟大件-日日顺配", "reg_mail_no": "" }, { "code": "DISTRIBUTOR_30464910", "id": 1216000000349602, "name": "丰网速运", "reg_mail_no": "" }, { "code": "DISTRIBUTOR_30292473", "id": 1216000000280959, "name": "大食品商家自配", "reg_mail_no": "^[A-Za-z0-9-]{4,35}$" }, { "code": "WND", "id": 21000127009, "name": "WnDirect", "reg_mail_no": "" }, { "code": "GZLT", "id": 200427, "name": "飞远配送 ", "reg_mail_no": "" }, { "code": "DISTRIBUTOR_1710055", "id": 5000000178661, "name": "邮政标准快递", "reg_mail_no": "^(10)[0-9]{11}$|^(11)[0-9]{11}$" }, { "code": "DISTRIBUTOR_13484485", "id": 1216000000158681, "name": "顺心捷达", "reg_mail_no": "^[0-9]{8}$;^[0-9]{10}$" }, { "code": "YC", "id": 1139, "name": "远长", "reg_mail_no": "^96[0-9]{12}$" }, { "code": "DFH", "id": 1137, "name": "东方汇", "reg_mail_no": "^[0-9]{10}$|^LBX[0-9]{15}-[2-9AZ]{1}-[1-9A-Z]{1}" }, { "code": "UNIPS", "id": 1237, "name": "发网", "reg_mail_no": "" }, { "code": "MGSD", "id": 21000007003, "name": "美国速递", "reg_mail_no": "" }, { "code": "BHWL", "id": 21000053037, "name": "保宏物流", "reg_mail_no": "" }, { "code": "ZJS", "id": 103, "name": "宅急送", "reg_mail_no": "^[a-zA-Z0-9]{10}$|^(42|16)[0-9]{8}$|^A[0-9]{12}" }, { "code": "SF", "id": 505, "name": "顺丰速运", "reg_mail_no": "^[A-Za-z0-9-]{4,35}$" }, { "code": "STO", "id": 100, "name": "申通快递", "reg_mail_no": "^(268|888|588|688|368|468|568|668|768|868|968)[0-9]{9}$|^(11|22|40|268|888|588|688|368|468|568|668|768|868|968)[0-9]{10}$|^(STO)[0-9]{10}$|^(33)[0-9]{11}$|^(4)[0-9]{12}$|^(55)[0-9]{11}$|^(66)[0-9]{11}$|^(77)[0-9]{11}$|^(88)[0-9]{11}$|^(99)[0-9]{11}$" }, { "code": "EMS", "id": 2, "name": "EMS", "reg_mail_no": "^[A-Z]{2}[0-9]{9}[A-Z]{2}$|^(10|11|12)[0-9]{11}$|^(50|51)[0-9]{11}$|^(95|97)[0-9]{11}$" }, { "code": "YUNDA", "id": 102, "name": "韵达快递", "reg_mail_no": "^(10|11|12|13|14|15|16|17|19|18|50|55|58|80|88|66|31|77|39)[0-9]{11}$|^[0-9]{13}$" }, { "code": "HTKY", "id": 502, "name": "极兔速递", "reg_mail_no": "^((A|B|D|E)[0-9]{12})$|^(BXA[0-9]{10})$|^(K8[0-9]{11})$|^(02[0-9]{11})$|^(000[0-9]{10})$|^(C0000[0-9]{8})$|^((21|22|23|24|25|26|27|28|29|30|31|32|33|34|35|36|37|38|39|61|63)[0-9]{10})$|^((50|51)[0-9]{12})$|^7[0-9]{13}$|^6[0-9]{13}$|^58[0-9]{14}$" }, { "code": "YTO", "id": 101, "name": "圆通速递", "reg_mail_no": "^[A-Za-z0-9]{2}[0-9]{10}$|^[A-Za-z0-9]{2}[0-9]{8}$|^[6-9][0-9]{17}$|^[DD]{2}[8-9][0-9]{15}$|^[Y][0-9]{12}$" }, { "code": "TTKDEX", "id": 504, "name": "天天快递", "reg_mail_no": "(66|77|88|(5(5|6|8)))\\d{10}|(99(5|8))\\d{9}|TT(66|88|99|(5(6|7)))\\d{11}" }, { "code": "QFKD", "id": 1216, "name": "全峰快递", "reg_mail_no": "^[0-6|9][0-9]{11}$|^[7][0-8][0-9]{10}$|^[0-9]{15}$|^[S][0-9]{9,11}(-|)P[0-9]{1,2}$|^[0-9]{13}$|^[8][0,2-9][0,2-9][0-9]{9}$|^[8][1][0,2-9][0-9]{9}$|^[8][0,2-9][0-9]{10}$|^[8][1][1][0][8][9][0-9]{6}$" }, { "code": "EYB", "id": 3, "name": "EMS经济快递", "reg_mail_no": "^[A-Z]{2}[0-9]{9}[A-Z]{2}$|^(10|11)[0-9]{11}$|^(50|51)[0-9]{11}$|^(95|97)[0-9]{11}$" }, { "code": "UC", "id": 1207, "name": "优速快递", "reg_mail_no": "^VIP[0-9]{9}|V[0-9]{11}|[0-9]{12}$|^LBX[0-9]{15}-[2-9AZ]{1}-[1-9A-Z]{1}$|^(9001)[0-9]{8}$" }, { "code": "DBKD", "id": 5000000110730, "name": "德邦快递", "reg_mail_no": "^[0-9]{8,10}$|^\\d{15,}[-\\d]+$" }, { "code": "SURE", "id": 201174, "name": "速尔快运", "reg_mail_no": "^(SUR)[0-9]{12}$|^[0-9]{12}$" }, { "code": "FEDEX", "id": 106, "name": "联邦快递", "reg_mail_no": "^[0-9]{12}$" }, { "code": "SHQ", "id": 108, "name": "华强物流", "reg_mail_no": "^[A-Za-z0-9]*[0|2|4|6|8]$" }, { "code": "UAPEX", "id": 1259, "name": "全一快递", "reg_mail_no": "^\\d{12}|\\d{11}$" }, { "code": "HOAU", "id": 1191, "name": "天地华宇", "reg_mail_no": "^[A-Za-z0-9]{8,9}$" }, { "code": "BEST", "id": 105, "name": "百世物流", "reg_mail_no": "^[0-9]{11,12}$" }, { "code": "LB", "id": 1195, "name": "龙邦速递", "reg_mail_no": "^[0-9]{12}$|^LBX[0-9]{15}-[2-9AZ]{1}-[1-9A-Z]{1}$|^[0-9]{15}$|^[0-9]{15}-[1-9A-Z]{1}-[1-9A-Z]{1}$" }, { "code": "XB", "id": 1186, "name": "新邦物流", "reg_mail_no": "^[0-9]{8}$|^[0-9]{10}$" }, { "code": "ZTO", "id": 500, "name": "中通快递", "reg_mail_no": "^((010|768|765|778|779|719|828|618|680|518|688|880|660|805|988|628|205|717|718|728|738|761|762|763|701|757|751|359|358|100|200|118|128|689|738|528|852)[0-9]{9})$|^((5711|2008|2009|2010|2013)[0-9]{8})$|^((91|92|93|94|95|98|36|68|39|50|53|37)[0-9]{10})$|^(4)[0-9]{11}$|^(90)[0-9]{10}$|^(120)[0-9]{9}$|^(780)[0-9]{9}$|^(881)[0-9]{9}$|^(882|885)[0-9]{9}$|^(54|55|56)[0-9]{10}$|^(960)[0-9]{9}$|^(665|666)[0-9]{9}$|^(63)[0-9]{10}$|^(64)[0-9]{10}$|^(72)[0-9]{10}$|^2[1-9][0-9]{10}$" }, { "code": "GTO", "id": 200143, "name": "国通快递", "reg_mail_no": "^(3(([0-6]|[8-9])\\d{8})|((2|4|5|6)\\d{9})|(7(?![0|1|2|3|4|5|7|8|9])\\d{9})|(8(?![2-9])\\d{9})|(2|4)\\d{11})$" }, { "code": "FAST", "id": 1204, "name": "快捷快递", "reg_mail_no": "^(?!440)(?!510)(?!520)(?!5231)([0-9]{9,13})$|^(P330[0-9]{8})$|^(D[0-9]{11})$|^(319)[0-9]{11}$|^(56)[0-9]{10}$|^(536)[0-9]{9}$" }, { "code": "NEDA", "id": 1192, "name": "能达速递", "reg_mail_no": "^((88|)[0-9]{10})$|^((1|2|3|5|)[0-9]{9})$|^(90000[0-9]{7})$" }, { "code": "BJRFD-001", "id": 100034107, "name": "如风达配送", "reg_mail_no": "^[\\x21-\\x7e]{1,100}$" }, { "code": "XFWL", "id": 202855, "name": "信丰物流", "reg_mail_no": "^130[0-9]{9}|13[7-9]{1}[0-9]{9}|18[8-9]{1}[0-9]{9}$" }, { "code": "GDEMS", "id": 1269, "name": "广东EMS", "reg_mail_no": "^[a-zA-Z]{2}[0-9]{9}[a-zA-Z]{2}$" }, { "code": "POSTB", "id": 200734, "name": "邮政快递包裹", "reg_mail_no": "^([GA]|[KQ]|[PH]){2}[0-9]{9}([2-5][0-9]|[1][1-9]|[6][0-5])$|^[99]{2}[0-9]{11}$|^[96]{2}[0-9]{11}$|^[98]{2}[0-9]{11}$" }, { "code": "DBL", "id": 107, "name": "德邦物流", "reg_mail_no": "^[0-9]{8,10}$|^\\d{15,}[-\\d]+$" }, { "code": "YCT", "id": 1185, "name": "黑猫宅急便", "reg_mail_no": "^[0-9]{12}$" }, { "code": "LTS", "id": 1214, "name": "联昊通", "reg_mail_no": "^[0-9]{9,12}$" }, { "code": "ESB", "id": 200740, "name": "E速宝", "reg_mail_no": "[0-9a-zA-Z-]{5,20}" }, { "code": "BESTQJT", "id": 105031, "name": "百世快运", "reg_mail_no": "" }, { "code": "QRT", "id": 1208, "name": "增益速递", "reg_mail_no": "^[0-9]{12,13}$" }, { "code": "DISTRIBUTOR_13460212", "id": -1, "name": "D速物流", "reg_mail_no": "^[A-Za-z0-9-]{4,35}$" }, { "code": "DISTRIBUTOR_12017865", "id": -1, "name": "安能快运", "reg_mail_no": "^[A-Za-z0-9-]{4,35}$" } ], "trace_id": ""}