常用快递API及快递在线下单API分享

1.常用快递API

支持顺丰、EMS、申通、圆通、韵达、汇通、中通、天天、德邦、全峰等主流快递公司。

文档地址:https://www.juhe.cn/docs/api/id/43

1.1常用快递查询API

接口地址: http://v.juhe.cn/exp/index
支持格式: json/xml
请求方式: http post/get
请求示例: http://v.juhe.cn/exp/index?key=key&com=sf&no=575677355677
调用样例及调试工具: API测试工具
请求参数说明:
 名称类型必填说明
 comstring需要查询的快递公司编号
 nostring需要查询的订单号
 keystring应用APPKEY(应用详细页查询)
 dtypestring返回数据的格式,xml或json,默认json
返回参数说明:
 名称类型说明
 参考JSON返回示例--
JSON返回示例:
{
"resultcode":"200",/*返回标识码*/
"reason":"查询成功!",
"result":{
	"company":"顺丰",
	"com":"sf",
	"no":"575677355677",
	"list":[
		{
		"datetime":"2013-06-25 10:44:05",	/*时间*/
		"remark":"已收件",					/*描述*/
		"zone":"台州市"						/*区域,视快递公司情况,不保证一定有信息*/
		},
		{
		"datetime":"2013-06-25 11:05:21",
		"remark":"快件在 台州 ,准备送往下一站 台州集散中心 ",
		"zone":"台州市"
		},
		{
		"datetime":"2013-06-25 20:36:02",
		"remark":"快件在 台州集散中心 ,准备送往下一站 台州集散中心 ",
		"zone":"台州市"
		},
		{
		"datetime":"2013-06-25 21:17:36",
		"remark":"快件在 台州集散中心 ,准备送往下一站 杭州集散中心 ",
		"zone":"台州市"
		},
		{
		"datetime":"2013-06-26 12:20:00",
		"remark":"快件在 杭州集散中心 ,准备送往下一站 西安集散中心 ",
		"zone":"杭州市"
		},
		{
		"datetime":"2013-06-27 05:48:42",
		"remark":"快件在 西安集散中心 ,准备送往下一站 西安 ",
		"zone":"西安市/咸阳市"
		},
		{
		"datetime":"2013-06-27 08:03:03",
		"remark":"正在派件..",
		"zone":"西安市/咸阳市"
		},
		{
		"datetime":"2013-06-27 08:51:33",
		"remark":"派件已签收",
		"zone":"西安市/咸阳市"
		},
		{
		"datetime":"2013-06-27 08:51",
		"remark":"签收人是:已签收 ",
		"zone":"西安市/咸阳市"
		}
		]
        "status": "1", /*0或1。0表示此单号信息还有更新的可能;1表示此单号信息不会再更新
(签收、退回等最终状态),您可将单号信息存入数据库,不必再次往聚合发送更新请求。*/
	}
}
XML返回示例:
<root>
	<resultcode>200</resultcode>
	<reason>查询成功!</reason>
	<result>
		<company>顺丰</company>
		<com>sf</com>
		<no>575677355677</no>
		<list>
			<item>
				<datetime>2013-06-25 10:44:05</datetime>
				<remark>已收件</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-25 11:05:21</datetime>
				<remark>快件在 台州 ,准备送往下一站 台州集散中心</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-25 20:36:02</datetime>
				<remark>快件在 台州集散中心 ,准备送往下一站 台州集散中心</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-25 21:17:36</datetime>
				<remark>快件在 台州集散中心 ,准备送往下一站 杭州集散中心</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-26 12:20:00</datetime>
				<remark>快件在 杭州集散中心 ,准备送往下一站 西安集散中心</remark>
				<zone>杭州市</zone>
			</item>
			<item>
				<datetime>2013-06-27 05:48:42</datetime>
				<remark>快件在 西安集散中心 ,准备送往下一站 西安</remark>
				<zone>西安市/咸阳市</zone>
			</item>
			<item>
				<datetime>2013-06-27 08:03:03</datetime>
				<remark>正在派件..</remark>
				<zone>西安市/咸阳市</zone>
			</item>
			<item>
				<datetime>2013-06-27 08:51:33</datetime>
				<remark>派件已签收</remark>
				<zone>西安市/咸阳市</zone>
			</item>
			<item>
				<datetime>2013-06-27 08:51</datetime>
				<remark>签收人是:已签收</remark>
				<zone>西安市/咸阳市</zone>
			</item>
		</list>
		<status>1</status>
	</result>
</root>

1.2快递公司编号对照表

接口地址: http://v.juhe.cn/exp/com
支持格式: json/xml/jsonp
请求方式: http post get
请求示例: http://v.juhe.cn/exp/com?key=key
调用样例及调试工具: API测试工具
请求参数说明:
 名称类型必填说明
     
返回参数说明:
 名称类型说明
    
JSON返回示例:
{
"resultcode":"200",
"reason":"成功的返回",
"result":[
	{
	"com":"顺丰",
	"no":"sf"
	},
	{
	"com":"申通",
	"no":"sto"
	},
	{
	"com":"圆通",
	"no":"yt"
	},
	{
	"com":"韵达",
	"no":"yd"
	},
	{
	"com":"天天",
	"no":"tt"
	},
	{
	"com":"EMS",
	"no":"ems"
	},
	{
	"com":"中通",
	"no":"zto"
	},
	{
	"com":"汇通",
	"no":"ht"
	}
]
}

2.快递在线下单

应用场景:普通用户在线向快递公司在线下单,快递公司收到申请快递员上门取件

接口文档:https://www.juhe.cn/docs/api/id/229

2.1获取快递公司列表

接口地址: http://v.juhe.cn/expressonline/test/getCarriers.php
支持格式: json/xml
请求方式: http get/post
请求示例: http://v.juhe.cn/expressonline/test/getCarriers.php?key=APPKEY
接口备注: 获取支持的快递公司列表
调用样例及调试工具: API测试工具
请求参数说明:
 名称类型必填说明
 dtypestring结果数据返回类型(json/xml)
 keystring您申请的appkey
 ex_categorystringrecommend:推荐快递公司;
返回参数说明:
 名称类型说明
 error_codeint返回码
 reasonstring返回说明
 resultstring返回结果集
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>

2.2在线下单发快递

接口地址: 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)异步发快递: 用户将订单信息提交到平台
注:开发测试,下单成功后请及时撤销订单,否则快递公司会打电话上门取件
调用样例及调试工具: API测试工具
请求参数说明:
 名称类型必填说明
 dtypestring结果数据返回类型(json/xml)
 keystring您申请的appkey
 send_methodstring接口方法名称
(addOrderInfoMes:普通发快递,
(1)普通用户在线向快递公司在线下单,
(2)快递公司收到申请快递员上门取件;
addOrderInfoAsy:异步发快递,
(1)用户将订单信息提交到开放平台,
(2)开放平台通过订单状态推送用户发件结果,
(3)快递公司收到申请快递员上门取件)
 order_nostring订单编号10-32位唯一的数字字符串(例:20160129121200956523)
 isWaybillstring是否为电子运单( 1 普通订单(默认为1),暂仅支持普通)
 carrier_codestring快递公司编码.建议使用宅急送(zjs)进行功能和流程测试
 sender_namestring发件人姓名
 sender_telphonestring发件人手机号码
 sender_phonestring发件人固定电话
 sender_province_namestring发件地址省名称
 sender_city_namestring发件地址市名称
 sender_district_namestring发件地址区名称
 sender_addressstring发件地址详细信息
 sender_post_codestring发件地址邮政编码
 receiver_namestring收件人姓名
 receiver_telphonestring收件人手机号码
 receiver_phonestring收件人固定电话
 receiver_province_namestring收件地址省名称
 receiver_city_namestring收件地址市名称
 receiver_district_namestring收件地址区名称
 receiver_addressstring收件地址详细信息
 receiver_org_namestring收件机构
 receiver_post_codestring收件地址邮政编码
 remarkstring备注
 item_weightdouble重量(double,单位kg)
 item_namestring货物名称
 item_specstring规格
 send_start_timestring预约开始时间(时间格式为:yyyy-MM-dd HH:mm:ss)
 send_end_timestring预约结束时间(时间格式为:yyyy-MM-dd HH:mm:ss)
返回参数说明:
 名称类型说明
 error_codeint返回码
 reasonstring返回说明
 resultstring返回结果集
JSON返回示例:
{
    "reason": "下单成功",
    "result": {
         "order_no":"20160129121200956523",/*订单编号*/
         "carrier_code":"zjs"/*快递公司编号*/
    },
    "error_code": 0
}

2.3撤销订单

接口地址: http://v.juhe.cn/expressonline/test/cancleSend.php
支持格式: json/xml
请求方式: http post
请求示例: http://v.juhe.cn/expressonline/test/cancleSend.php?key=APPKEY&
接口备注: 用户下单后,不想发快递了,可以及时取消;由于快递公司IT系统原因,暂支持 宅急送、优速、百世汇通、圆通、中通、德邦快递公司撤销发件
调用样例及调试工具: API测试工具
请求参数说明:
 名称类型必填说明
 dtypestring结果数据返回类型(json/xml)
 keystring您申请的appkey
 order_nostring订单编号 10-32位唯一的数字字符串
 carrier_codestring快递公司编码
返回参数说明:
 名称类型说明
 error_codeint返回码
 reasonstring返回说明
 resultstring返回结果集
JSON返回示例:
{
    "reason": "取消成功",
    "result": {
        "order_no": "20160129121200956523",/*订单号*/
        "carrier_code": "zjs"/*快递公司编码 (宅急送)*/
    },
    "error_code": 0
}

2.4推送接口设置

接口地址: http://v.juhe.cn/expressonline/setPush.php
支持格式: json/xml
请求方式: http post
请求示例: http://v.juhe.cn/expressonline/setPush.php?key=APPKEY&
接口备注: 用户设置订单状态更新信息推送接口 (测试阶段不予以推送状态更新)
调用样例及调试工具: API测试工具
请求参数说明:
 名称类型必填说明
 dtypestring结果数据返回类型(json/xml)
 keystring您申请的appkey
 namestring公司名
 state_methodstring订单状态更新推送地址
 content_methodstring物流信息更新推送地址
返回参数说明:
 名称类型说明
 error_codeint返回码
 reasonstring返回说明
 resultstring返回结果集
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": "到北京市【北京分拨中心】"
				}
			]
		}
	]
}

  

转载于:https://www.cnblogs.com/annie00/p/6038517.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值