通用数据追踪接口定义

使用这个接口只需要7600元,购买永久使用授权产品,永久免费升级.

一、接口调用方式

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> 含义：
   第一个数字为多票解析时运单号的位置，后面的数字为追踪信息的条数