應用場景：普通使用者線上向快遞公司線上下單，快遞公司收到申請快遞員上門取件

獲取快遞公司列表

介面地址：http://v.juhe.cn/expressonline/test/getCarriers.php

支援格式：json/xml

請求方式：http get/post

請求示例：http://v.juhe.cn/expressonline/test/getCarriers.php?key=APPKEY

介面備註：獲取支援的快遞公司列表

請求引數說明：

返回引數說明：

JSON返回示例：

{
    "reason": "查詢成功",
    "result": [
        {
            "carrier_code": "ems",/*快遞公司程式碼*/
            "carrier_phone": "11183",/*快遞公司電話*/
            "carrier_name": "EMS"/*快遞公司名稱*/
        },
        {
            "carrier_code": "zhongtong",
            "carrier_phone": "021-39777777",
            "carrier_name": "中通快遞"
        },
        {
            "carrier_code": "yuantong",
            "carrier_phone": "021-69777888",
            "carrier_name": "圓通速遞"
        },
        {
            "carrier_code": "zjs",
            "carrier_phone": "400-6789-000",
            "carrier_name": "宅急送"
        },
        {
            "carrier_code": "debang",
            "carrier_phone": "400-830-5555",
            "carrier_name": "德邦物流"
        },
        {
            "carrier_code": "huitong",
            "carrier_phone": "021-62963636",
            "carrier_name": "百世匯通"
        },
        {
            "carrier_code": "shunfeng",/*快遞公司編碼*/
            "carrier_phone": "400-811-1111",/*快遞公司電話*/
            "carrier_name": "順豐速運"/*快遞公司名稱*/
        },....
    ],
    "error_code": 0
}
 

XML返回示例：

<?xml version="1.0" encoding="utf-8"?>
<root>
    <reason>查詢成功</reason>
    <result>
        <item>
            <carrier_code>ems</carrier_code>
            <carrier_phone>11183</carrier_phone>
            <carrier_name>EMS</carrier_name>
        </item>
        <item>
            <carrier_code>zhongtong</carrier_code>
            <carrier_phone>021-39777777</carrier_phone>
            <carrier_name>中通快遞</carrier_name>
        </item>
        <item>
            <carrier_code>yousu</carrier_code>
            <carrier_phone>400-1111-119</carrier_phone>
            <carrier_name>優速快遞</carrier_name>
        </item>
        <item>
            <carrier_code>quanfeng</carrier_code>
            <carrier_phone>400-100-0001</carrier_phone>
            <carrier_name>全峰快遞</carrier_name>
        </item>
        <item>
            <carrier_code>yuantong</carrier_code>
            <carrier_phone>021-69777888</carrier_phone>
            <carrier_name>圓通速遞</carrier_name>
        </item>
        <item>
            <carrier_code>zjs</carrier_code>
            <carrier_phone>400-6789-000</carrier_phone>
            <carrier_name>宅急送</carrier_name>
        </item>
        <item>
            <carrier_code>debang</carrier_code>
            <carrier_phone>400-830-5555</carrier_phone>
            <carrier_name>德邦物流</carrier_name>
        </item>
        <item>
            <carrier_code>huitong</carrier_code>
            <carrier_phone>021-62963636</carrier_phone>
            <carrier_name>百世匯通</carrier_name>
        </item>
        <item>
            <carrier_code>shunfeng</carrier_code>
            <carrier_phone>400-811-1111</carrier_phone>
            <carrier_name>順豐速運</carrier_name>
        </item>
    </result>
    <error_code>0</error_code>
</root>
 

線上下單發快遞

介面地址：http://v.juhe.cn/expressonline/test/expressSend.php

支援格式：json/xml

請求方式：http post

請求示例：http://v.juhe.cn/expressonline/test/expressSend.php?key=APPKEY&send_method=addOrderInfoMes&order_no=......所有引數(請轉換成post形式提交)

介面備註：提供兩種模式,(1)普通發快遞:線上向快遞公司線上下單;(2)非同步發快遞: 使用者將訂單資訊提交到平臺

請求引數說明：

返回引數說明：

JSON返回示例：

{
    "reason": "下單成功",
    "result": {
         "order_no":"20160129121200956523",/*訂單編號*/
         "carrier_code":"zjs"/*快遞公司編號*/
    },
    "error_code": 0
}

撤銷訂單

介面地址：http://v.juhe.cn/expressonline/test/cancleSend.php

支援格式：json/xml

請求方式：http post

請求示例：http://v.juhe.cn/expressonline/test/cancleSend.php?key=APPKEY&

介面備註：使用者下單後，不想發快遞了，可以及時取消;由於快遞公司IT系統原因，暫支援 宅急送、優速、百世匯通、圓通、中通、德邦快遞公司撤銷發件

請求引數說明：

返回引數說明：

JSON返回示例：

{
    "reason": "取消成功",
    "result": {
        "order_no": "20160129121200956523",/*訂單號*/
        "carrier_code": "zjs"/*快遞公司編碼 (宅急送)*/
    },
    "error_code": 0
}

推送介面設定

介面地址：http://v.juhe.cn/expressonline/test/setPush.php

支援格式：json/xml

請求方式：http post

請求示例：http://v.juhe.cn/expressonline/test/setPush.php?key=APPKEY&

介面備註：使用者設定訂單狀態更新資訊推送介面

請求引數說明：

返回引數說明：

JSON返回示例：

{
    "reason": "成功的返回",
    "result": {
        "name": "",/*公司名稱或其他說明文字*/
        "state_method": "您接收訂單狀態更新資訊推送的介面(例:http://test.com/test.php)",/*訂單狀態更新推送地址*/
        "content_method": "您接收訂物流資訊更新推送的介面(例:http://test.com/test.php)",/*物流資訊更新推送地址*/
        "key": APPKEY
    },
    "error_code": 0
}


/*訂單狀態推送,資料格式以及引數說明.(注:操作完成後輸出:success字串)*/
{
"orders": [
		{
		"order_no": "20160201090120458263",/*訂單號*/
		"carrier_code": "zjs",/*快遞公司編碼*/
		"status": "4",/*訂單狀態:0:下單成功,1:下單失敗,2:撤單成功,3:撤單失敗,4:接單成功,5:接單失敗,
6:攬收成功,7:攬收失敗,8:在途,9:派件掃描,10:簽收成功,11:簽收失敗*/
		"time": "2015-01-15 09:33:32",/*操作時間*/
		"content": "工業園區網點接單，電話1234568"/*內容*/
		}
	]
}


/*物流資訊推送,資料格式以及引數說明.(注:操作完成後輸出:success字串)*/
{
"orders": [
		{
			"order": {
				"bill_code": "350301727598", /*快遞公司運單號*/
				"order_no": "20160201090120458263", /*訂單號*/
				"carrier_code": "zjs", /*快遞公司編碼*/
				"status": "4"
			},
			"data": [/*物流資訊list*/
				{
					"time": "2014-11-14 15:51:59",/*操作時間*/
					"content": "到太原市【太原分撥中心】"/*操作內容*/
				},
				{
					"time": "2014-11-14 01:57:02",
					"content": "北京市【北京分撥中心】，正發往【太原分撥中心】"
				},
				{
					"time": "2014-11-14 01:55:27",
					"content": "到北京市【北京分撥中心】"
				}
			]
		}
	]
}