|
【收费预算】
不管是下面那种模式的API查询接口,都是统一收费7600元,一次性收费,无后期费用,升级免费。
但是你要自备独享服务器,可以是台式机服务器放ADSL网络下用花生壳的模式,也可以是放在固定IP的机房托管或云服务器模式。
【快递查询API接口①:C2C】,快递公司购买这个API接口
!
【电商网站平台】和【快递物流公司】之间的“内单号”的API追踪信息对接!
先描述下这个效果:
【1】首先你这家【快递物流公司】要购买7600元的API接口程序。由我们销售工程师负责给您在您自己事先准备的服务器上安装,并且帮你开通设置API接口。
【2】然后你把下面这个API接口文档,发给你要合作的【电商网站平台】的IT开发人员看↓
三、已完成订单信息查询接口<GInfo 注册用户即可使用>
3.1:接口名称:EmsTrackState
3.2:接口参数:共2个
cno:运单号,(每个单号长度7-30字符),如果ntype=10,多票详细数据查询,逗号“,”分割
ntype:追踪选择,默认值为0(单票状态查询,仅返回一个状态数字),
+10:多票(包括单票)详细数据查询,多票运单号之间用半角逗号“,”分割,一次最多50个单号。
+10000:返回Json格式数据。
3.3:返回数据:为CSV格式:运单号,状态,签收日期时间,"签收人"
返回值含义:
-9:数据库内部错误
-5:服务器版本类型不支持
-4:系统未获有效注册
-3:运单号长度不对(8-30)
-2:没有查询结果
//--记录状态含义
0:未发送
1:已发送
2:转运中
3:送达
4:超时
5:扣关
6:地址错误
7:快件丢失
8:退件
9:其它异常
10:销毁
3.4:例子:
a: http://网址/cgi-bin/GInfo.dll?EmsTrackState&cno=086010007473
b: http://网址/cgi-bin/GInfo.dll?EmsTrackState&cno=086010007473&ntype=10
c: http://网址/cgi-bin/GInfo.dll?EmsTrackState&cno=086010007473,086010007474, 086010007150,086010007475,086010007476,086010007477&ntype=10 |
【3】然后由【电商网站平台】的IT人员做出相应的开发,就可以把你【快递物流公司】的网站,集成到他们【电商网站平台】的“物流公司选项”里面。
当有人在这家【电商网站平台】上卖出商品,选择物流公司发货,就可以直接在这个【电商网站平台】的“物流公司选项”里,选择你这家【快递物流公司】,并且填写你的快递内部单号,就可以直接在【电商网站平台】上查看到调取的追踪信息了。
【快递查询API接口②:P2C】,电商网站平台购买这个API接口!
【1】由【电商网站平台】自备服务器,购买这个API接口,然后由自己公司的开发人员,把“圆通、中通、EMS、申通、顺丰”等这样知名的快递公司的追踪查询接口,开发集成到自己的【电商网站平台】里。相关API文档如下图:
一、接口调用方式
1、服从标准HTTP协议,由接口程序http://域名:端口/cgi-bin/GInfo.dll提供。
2、使用GET、POST方式发送请求均可。
3、参数:
cno:运单号,5-60字符,必须。
cemskind:渠道,参见EMMis软件帮助,必须。
lan:语言选择,默认为0(中文),1(英文)。+10000,返回json数据
cpostcode:邮编,默认无,有的渠道需要。
cdes:目的地,默认无,有的渠道需要。
cphone:电话,默认无,有的渠道需要。
cdate:发件日期,默认无,考虑到重单,有的渠道需要。
4、请求可以为如下任一表述:
a: /cgi-bin/GInfo.dll?EmmisTrackGenData&cemskind=中通&cno=701008694693
b:/cgi-bin/GInfo.dll?MfcISAPICommand=EmmisTrackGenData&cemskind=中通&cno=200894053360
c: /cgi-bin/GInfo.dll?EmmisTrackGenData&cemskind=中通&cno=701008694693, 701008694708, 717020997826, 761706846248
*对于支持多票批量追踪的网络,运单号之间用半角逗号(,)隔开。
*支持批量追踪的网络,可在EMMis管理软件查询:
菜单:帮助->系统跟踪物流网络列表,查看“批追”列,为批量追踪支持的最大运单数量。
*请求字符集必须为GBK
*在ems.ini中配置“开通通用追踪数据=1”
*在ems.ini中配置“[通用追踪数据允许IP开始] ”,避免未授权的访问
二、返回数据:为变通的XML格式数据,GBK编码
样例1,单票追踪:
100
<EMS_INFO>
<KIND>中通</KIND>
<NUM>200894053360</NUM>
<STATE>3</STATE>
<ADATE>2011-07-31 18:20</ADATE>
<SIGN>阳政</SIGN>
</EMS_INFO>
<TRACK_DATA>
<DATETIME>2011-07-29 23:54</DATETIME><PLACE>佛山</PLACE><INFO>快件到达 佛山中心 ,正在分捡中,上一站是 顺德大良</INFO>
<DATETIME>2011-07-29 23:55</DATETIME><PLACE>佛山</PLACE><INFO>快件离开 佛山中心 ,已发往 东莞中心</INFO>
<DATETIME>2011-07-30 00:08</DATETIME><PLACE>顺德大良</PLACE><INFO>顺德大良 五沙啊宝 已收件,进入公司分捡</INFO>
<DATETIME>2011-07-30 00:12</DATETIME><PLACE>顺德大良</PLACE><INFO>快件离开 顺德大良 ,已发往 佛山中心</INFO>
<DATETIME>2011-07-30 03:48</DATETIME><PLACE>东莞</PLACE><INFO>快件离开 东莞中心 ,已发往 南宁中转</INFO>
<DATETIME>2011-07-30 21:34</DATETIME><PLACE>南宁中转</PLACE><INFO>快件到达 南宁中转 ,正在分捡中,上一站是 东莞中心</INFO>
<DATETIME>2011-07-30 21:36</DATETIME><PLACE>南宁中转</PLACE><INFO>快件离开 南宁中转 ,已发往 柳州中转</INFO>
<DATETIME>2011-07-31 04:54</DATETIME><PLACE>柳州中转</PLACE><INFO>快件离开 柳州中转 ,已发往 桂林</INFO>
<DATETIME>2011-07-31 10:09</DATETIME><PLACE>桂林</PLACE><INFO>快件到达 桂林 ,正在分捡中,上一站是 柳州中转</INFO>
<DATETIME>2011-07-31 12:39</DATETIME><PLACE>桂林</PLACE><INFO>快件离开 桂林 ,已发往 桂林十字街</INFO>
<DATETIME>2011-07-31 14:03</DATETIME><PLACE>桂林十字街</PLACE><INFO>快件到达 桂林十字街 ,正在分捡中,上一站是 桂林</INFO>
<DATETIME>2011-07-31 14:55</DATETIME><PLACE>桂林十字街</PLACE><INFO>桂林十字街 林桂民 正在派件</INFO>
<DATETIME>2011-07-31 18:20</DATETIME><PLACE>桂林十字街</PLACE><INFO>桂林十字街 派件已 签收 ,签收人是 阳政</INFO>
</TRACK_DATA>
样例2,多票批量追踪:
100
<MULTY_BILL_1_13>
<EMS_INFO>
<KIND>中通</KIND>
<NUM>200894053360</NUM>
<STATE>3</STATE>
<ADATE>2011-07-31 18:20</ADATE>
<SIGN>阳政</SIGN>
</EMS_INFO>
<TRACK_DATA>
<DATETIME>2011-07-29 23:54</DATETIME><PLACE>佛山</PLACE><INFO>快件到达 佛山中心 ,正在分捡中,上一站是 顺德大良</INFO>
<DATETIME>2011-07-29 23:55</DATETIME><PLACE>佛山</PLACE><INFO>快件离开 佛山中心 ,已发往 东莞中心</INFO>
<DATETIME>2011-07-30 00:08</DATETIME><PLACE>顺德大良</PLACE><INFO>顺德大良 五沙啊宝 已收件,进入公司分捡</INFO>
<DATETIME>2011-07-30 00:12</DATETIME><PLACE>顺德大良</PLACE><INFO>快件离开 顺德大良 ,已发往 佛山中心</INFO>
<DATETIME>2011-07-30 03:48</DATETIME><PLACE>东莞</PLACE><INFO>快件离开 东莞中心 ,已发往 南宁中转</INFO>
<DATETIME>2011-07-30 21:34</DATETIME><PLACE>南宁中转</PLACE><INFO>快件到达 南宁中转 ,正在分捡中,上一站是 东莞中心</INFO>
<DATETIME>2011-07-30 21:36</DATETIME><PLACE>南宁中转</PLACE><INFO>快件离开 南宁中转 ,已发往 柳州中转</INFO>
<DATETIME>2011-07-31 04:54</DATETIME><PLACE>柳州中转</PLACE><INFO>快件离开 柳州中转 ,已发往 桂林</INFO>
<DATETIME>2011-07-31 10:09</DATETIME><PLACE>桂林</PLACE><INFO>快件到达 桂林 ,正在分捡中,上一站是 柳州中转</INFO>
<DATETIME>2011-07-31 12:39</DATETIME><PLACE>桂林</PLACE><INFO>快件离开 桂林 ,已发往 桂林十字街</INFO>
<DATETIME>2011-07-31 14:03</DATETIME><PLACE>桂林十字街</PLACE><INFO>快件到达 桂林十字街 ,正在分捡中,上一站是 桂林</INFO>
<DATETIME>2011-07-31 14:55</DATETIME><PLACE>桂林十字街</PLACE><INFO>桂林十字街 林桂民 正在派件</INFO>
<DATETIME>2011-07-31 18:20</DATETIME><PLACE>桂林十字街</PLACE><INFO>桂林十字街 派件已 签收 ,签收人是 阳政</INFO>
</TRACK_DATA>
</MULTY_BILL_1_13>
<MULTY_BILL_2_12>
<EMS_INFO>
<KIND>中通</KIND>
<NUM>200894053361</NUM>
<STATE>3</STATE>
<ADATE>2011-07-31 15:39</ADATE>
<SIGN>宋</SIGN>
</EMS_INFO>
<TRACK_DATA>
<DATETIME>2011-07-28 23:58</DATETIME><PLACE>佛山</PLACE><INFO>快件到达 佛山中心 ,正在分捡中,上一站是 顺德大良</INFO>
<DATETIME>2011-07-29 01:17</DATETIME><PLACE>顺德大良</PLACE><INFO>顺德大良 五沙啊宝 已收件,进入公司分捡</INFO>
<DATETIME>2011-07-29 01:18</DATETIME><PLACE>顺德大良</PLACE><INFO>快件离开 顺德大良 ,已发往 佛山中心</INFO>
<DATETIME>2011-07-29 03:34</DATETIME><PLACE>广州</PLACE><INFO>快件离开 广州中心 ,已发往 石家庄</INFO>
<DATETIME>2011-07-29 04:01</DATETIME><PLACE>广州</PLACE><INFO>快件离开 广州中心 ,已发往 石家庄</INFO>
<DATETIME>2011-07-30 04:11</DATETIME><PLACE>北京</PLACE><INFO>快件到达 北京 ,正在分捡中,上一站是 广州</INFO>
<DATETIME>2011-07-30 06:19</DATETIME><PLACE>北京</PLACE><INFO>快件离开 北京 ,已发往 石家庄</INFO>
<DATETIME>2011-07-31 07:02</DATETIME><PLACE>石家庄</PLACE><INFO>快件到达 石家庄 ,正在分捡中,上一站是 北京</INFO>
<DATETIME>2011-07-31 08:57</DATETIME><PLACE>石家庄</PLACE><INFO>快件离开 石家庄 ,已发往 新华三部</INFO>
<DATETIME>2011-07-31 14:09</DATETIME><PLACE>新华三部</PLACE><INFO>快件到达 新华三部 ,正在分捡中,上一站是 石家庄</INFO>
<DATETIME>2011-07-31 14:10</DATETIME><PLACE>新华三部</PLACE><INFO>新华三部 杨文革 正在派件</INFO>
<DATETIME>2011-07-31 15:39</DATETIME><PLACE>新华三部</PLACE><INFO>新华三部 派件已 签收 ,签收人是 宋</INFO>
</TRACK_DATA>
</MULTY_BILL_2_12>
返回值,第一行,状态,100表示追踪成功,其它返回值含义:
-1:没有追踪结果,也可能是网络无效
-2:运单号无效
-4:未在ems.ini中配置“开通通用追踪数据=1”
-5:系统未获有效注册
-6:系统未获有效注册
-3:运单号长度不对(8-30)
-7:请求验证未获通过
-8:IP地址校验未获通过
//--记录状态含义
0:未发送
1:已发送
2:转运中
3:送达
4:超时
5:扣关
6:地址错误
7:快件丢失
8:退件
9:其它异常
10:销毁
<MULTY_BILL_2_12> 含义:
第一个数字为多票解析时运单号的位置,后面的数字为追踪信息的条数
|
【2】作为1个【电商网站平台】,要想做大做强的话,对于各种知名的快递物流公司的追踪查询的支持,是非常有必要。 我们这个API接口支持全国以及其他国家邮政等5000多家知名的国际、国内快递公司的单号查询,而且后期提供免费升级。而且还可以设置白名单访问模式,防止你的服务器的API接口被人盗链。
【购买联系咨询】
销售工程师: 张先生 |
QQ在线咨询: |
QQ号码: 154392081 |
手机号码: 186,1671,2339 |
【相关售后服务】
后期售后维护费用方面:http://www.ems-help.com/ems-help/4075/d.htm
后期服务的免费部分:http://www.ems-help.com/ems-help/4078/d.htm
|