蔔數開(kāi)放(fàng)平台API

API
下(xià)單
查單
取消訂單
回單回傳
Java調用

API

下(xià)單

接口地(dì)址：http://e8dev.boudata.com/tss/tms/api/order/create

請求參數:

名稱	說(shuō)明(míng)	備注
params	Json字符串	Json字符串，具體(tǐ)見下(xià)面params參數說(shuō)明(míng)
uName	對(duì)接賬号
uSign	簽名	MD5(uToken + timestamp)
timestamp	時(shí)間(jiān)戳	格式：2018-12-12 12:12:12

params參數:

名稱	編碼	類型	必填	示例
客戶單号	ccode	String		Erp0000001
寄件(jiàn)人(rén)	send_man	String	TRUE	張三
寄件(jiàn)人(rén)電(diàn)話(huà)	send_phone	String	TRUE	18767166222
寄件(jiàn)省份	send_province	String	TRUE	浙江省
寄件(jiàn)市(shì)	send_city	String	TRUE	杭州市(shì)
寄件(jiàn)區(qū)縣	send_district	String		江幹區(qū)
寄件(jiàn)鄉(xiāng)鎮	send_town	String
寄件(jiàn)具體(tǐ)地(dì)址	send_street_no	String	TRUE
收件(jiàn)人(rén)	receive_man	String	TRUE	李四
收件(jiàn)人(rén)電(diàn)話(huà)	receive_phone	String	TRUE	18767166333
收件(jiàn)人(rén)公司	receive_company	String
收件(jiàn)省份	receive_province	String	TRUE	江蘇省
收件(jiàn)市(shì)	receive_city	String	TRUE	揚州市(shì)
收件(jiàn)區(qū)縣	receive_district	String		高(gāo)郵市(shì)
收件(jiàn)鄉(xiāng)鎮	receive_town	String
收件(jiàn)具體(tǐ)地(dì)址	receive_street_no	String	TRUE	xx小(xiǎo)區(qū)x幢
服務方式	service_mode	String		派送, 站點自(zì)提, 中心自(zì)提, 自(zì)提
保價額	insurance_limit	Double
支付方式	settle_type	String	TRUE	寄付, 到付, 月(yuè)結
代收貨款金(jīn)額	cod	Double
需要網點上(shàng)門提貨	if_visit	Boolean	TRUE
快件(jiàn)	if_fast	Boolean		Default=false
備注	remark	String
子(zǐ)單集合	subOrders	Object
———件(jiàn)數	amount	Integer
———重量	weight	Double
———體(tǐ)積	volume	Double
———貨物(wù)	cargo	String
———包裝	pack	String

響應參數：

名稱	編碼	類型	示例
結果	result	Boolean
錯(cuò)誤信息	errorMsg	String	result=false時(shí)會有(yǒu)該屬性
訂單	data	String	E8單号

查軌迹

接口地(dì)址：http://e8dev.boudata.com/tss/tms/api/order/trace

請求參數:

名稱	說(shuō)明(míng)	備注
params	Json字符串	Json字符串，具體(tǐ)見下(xià)面params參數說(shuō)明(míng)
uName	對(duì)接賬号
uSign	簽名	MD5(uToken + timestamp)
timestamp	時(shí)間(jiān)戳	格式：2018-12-12 12:12:12

params參數:

名稱	編碼	類型	必填	示例
E8單号	code	String	TRUE	兩者必填一個(gè)
客戶單号	ccode	String	TRUE	兩者必填一個(gè)

響應參數：

名稱	編碼	類型	示例
軌迹	data	List	[{"scan_date": "2019-12-06 15:43:38","description": "新訂單","create_time": "2019-12-06 15:43:39"}]
結果	result	Boolean
錯(cuò)誤信息	errorMsg	String	Result=false時(shí)會有(yǒu)該屬性

取消訂單(暫無)

接口地(dì)址：http://e8dev.boudata.com/tss/tms/api/order/cancel

請求參數:

名稱	說(shuō)明(míng)	備注
params	Json字符串	Json字符串，具體(tǐ)見下(xià)面params參數說(shuō)明(míng)
uName	對(duì)接賬号
uSign	簽名	MD5(uToken + timestamp)
timestamp	時(shí)間(jiān)戳	格式：2018-12-12 12:12:12

params參數:

名稱	編碼	類型	必填	示例
E8單号	code	String		E8單号和(hé)客戶單号必傳一個(gè)
客戶單号	ccode	String

響應參數：

名稱	編碼	類型	示例
結果	result	Boolean
錯(cuò)誤信息	errorMsg	String	Result=false時(shí)會有(yǒu)該屬性

回單回傳

接口地(dì)址：對(duì)方提供

請求參數:

名稱	說(shuō)明(míng)	備注
code	E8單号
ccode	客戶單号	可能為(wèi)空
uName	對(duì)接賬号	對(duì)方提供, 下(xià)文(wén)uToken也是，對(duì)接方不校(xiào)驗也可不提供
uSign	簽名	MD5(uToken + timestamp)
timestamp	時(shí)間(jiān)戳	格式：2018-12-12 12:12:12
file	文(wén)件(jiàn)	格式為(wèi)Base64

響應參數要求：

名稱	編碼	類型	示例
結果	result	Boolean
錯(cuò)誤信息	errorMsg	String	Result=false時(shí)會有(yǒu)該屬性

Java調用

  public void xiadan() {
    String myCode = "ERP000004";
    JSONObject ov = new JSONObject();
    ov.put("ccode", myCode);
    ov.put("send_man", "張三");
    ov.put("send_phone", "18767166222");
    ov.put("send_province", "浙江省");
    ov.put("send_city", "杭州市(shì)");
    ov.put("send_district", "江幹區(qū)");
    ov.put("send_street_no", "一号大街(jiē)華媒科(kē)創園");
    ov.put("receive_man", "李四");
    ov.put("receive_phone", "18767166333");
    ov.put("receive_province", "北京市(shì)");
    ov.put("receive_city", "北京市(shì)");
    ov.put("receive_district", "東城(chéng)區(qū)");
    ov.put("receive_street_no", "中關村(cūn)");
    ov.put("amount", 3);
    ov.put("volume", 1.11);
    ov.put("weight", 100.5);
    ov.put("service_mode", "派送");
    ov.put("insurance_limit", 3000D);
    ov.put("pay_type", "寄付");
    ov.put("cod", 8999D);
    ov.put("if_visit", true);
    ov.put("remark", "請盡快上(shàng)門取貨");

    List<>> subOrders = new ArrayList<>();
    Map subOrder = new HashMap<>();
    subOrder.put("amount", "3");
    subOrder.put("weight", "2.11");
    subOrder.put("volume", "2.11");
    subOrder.put("cargo", "電(diàn)腦");
    subOrders.add(subOrder);

    subOrder = new HashMap<>();
    subOrder.put("amount", "1");
    subOrder.put("weight", "2.22");
    subOrder.put("volume", "2.22");
    subOrder.put("cargo", "音(yīn)響");
    subOrders.add(subOrder);
    ov.put("subOrders", subOrders);

    executePost(origin + "/tss/tms/api/order/create", ov);
  }

  private void executePost(String url, JSONObject ov) {
    PostMethod postMethod = new PostMethod(url);
    postMethod.setRequestHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");

    postMethod.setParameter("params", ov.toString());
    postMethod.setParameter("uName", uName);
    String time = DateUtil.formatCare2Second(new Date());
    postMethod.setParameter("timestamp", time);
    postMethod.setParameter("uSign", InfoEncoder.string2MD5(uToken + time));

    HttpClient httpClient = new HttpClient();
    try {
      httpClient.executeMethod(postMethod);
      String responseBody = postMethod.getResponseBodyAsString();
      System.out.println(responseBody);
    } catch (Exception e) {
      e.printStackTrace();
    }
  }