【一，前言】：韵达快递单号的官方追踪接口运行原理是：首先需要把你运行追踪程序的电脑所在的IP发给韵达官方IT，让他帮你把你的IP加入白名单。（因为白名单不是随便想加就加的，所以建议你把你的服务器的固定公网IP地址发给韵达IT，以后追踪就用服务器去追踪韵达单号即可。）

然后，必须先把韵达单号提交到韵达订阅接口里，然后再批量查询追踪这些已经提交订阅的单号轨迹。所以钮门公司专门针对这种情况，开发了1个订阅追踪程序。

这个程序需要付费授权。相关情况请联系您的专属销售工程师。

---

【二，钮门对接韵达官方的订阅接口】：

【1】韵达官方接口文档：http://dev.yundasys.com:15146/showdoc/index.php?s=/1&page_id=7

这个接口文档要求是先用测试环境测试，证明你开发程序没问题，才给您开通韵达接口的正式环境。

因为钮门已经做好了，

所以你找韵达IT直接要正式环境的接口参数就行了。

---

【三，如何找韵达官方去申请开通订阅查单接口】：

（1）首先你得能联系到韵达官方的IT人员。并且你是韵达官方的客户的角色。（不是随便什么人就能要到这个接口的）

（2）如果你不知道怎么沟通，我帮你写好了。你直接复制粘贴下面的原话给韵达IT人员即可↓

我这边的开发人员，已经把韵达快递的订阅追踪接口调试通过了。 我们这边开发的韵达订阅追踪接口的url地址是： 【订阅】 → http://par.api.yundasys.com:10566/interface.php 【查询】→ http://par.api.yundasys.com:10566/query/mail.php?partnerid=账号&mailno=运单号&type=json或xml 我的服务器ip是：***.***.***.***（这4个星号请换成你们自己云服务器的IP地址以后再发韵达IT）需要你们加到韵达白名单里。 还有把属于我的韵达账号的正式环境的“partnerid”和“appsecret”给我。

---

【四，为了方便示范，假设你的密钥参数如下】：

partnerid：ZhangSankd

appsecret：QADFdsdf445sasdfD

（上面2个是我随便乱写的，不是真实的ID和密钥，只是为了下面演示教程用）

---

【五，升级快递软件，并设置密钥】：

请把快递软件升级到最新，先升级钮门服务器端程序，然后再升级其他所有办公电脑的客户端程序。

然后点击“网站 → 设定自动追踪信息的内容改造”

进入这个界面以后，在左侧，找到“韵达”，双击它，然后把你的“partnerid”复制到“客户代码”里。

然后“扩展代码”空着，不要填。

然后点击“保存特殊扩展设置”按钮，

全过程如下图：

设置好以后，重启一下服务器。

---

【六，安装和配置韵达订阅追踪程序，这一步可以钮门工程师帮你操作】：

在你的服务器的EMMIS快递软件所在的盘，比如我这里示范的服务器，EMMIS软件安装在D盘。

在D盘创建1个文件夹，文件夹名是：CSTrackAgent

文件夹里放上这几个文件↓

（如果不方便让工程师在服务器上安装，这整个文件夹，钮门工程师会帮你把参数都配置好，然后压缩打包发给你，其他步骤照着这个教程弄就行了。）

这个4个文件缺一不可。

先做基础配置，

---

TrackAgent_Set.txt →这个文件里放软件的付费的注册码，以及wcid。其他配置按默认的来，在没搞懂配置之前，不要乱改。↓

---

TK_YUNDA_set_1.txt →这个配置文件必须认真配置，详细的注意事项，我直接标注在图片上了。仔细看下图：

---

CSTrackAgent.exe “”→这个就是自动运行的韵达订阅程序。需要你在服务器上安装。前面示范的时候说过。你的这个文件夹是放D盘的。

那么这个自动运行程序的路径就是：D:\CSTrackAgent\CSTrackAgent.exe

那么你在服务器上，点击“开始 – 运行”，直接运行框里输入这段DOS命令↓

D:\CSTrackAgent\CSTrackAgent.exe -i

如下图：

敲回车以后，会弹出1个黑色DOS框，短暂停留1到2秒，然后自动消失。

↓

然后你打开服务器本地的“控制面板 → 管理工具 → 服务”

打开以后找到“CSTrackAgent”这个服务名称，点击鼠标右键，点启动。

如果“启动”选项是灰色的，表示已经启动了。不需要再点。继续往下看，

还是这个“CSTrackAgent”这个服务名称，鼠标右键，点属性，如下图：

打开1个框以后，点击“恢复”，把下面的三次失败后的操作选项，都改成“重启启动服务”，然后点确定，如下图：

---

【七，确保你的快递类别关联追踪网络都是“韵达”】：比如我这个客户的系统，它只有1个韵达有关的快递类别，就叫“韵达快递”。

那么确保这个快递类别的关联追踪网络位置，必须是“韵达”，↓

 

如果你还有其他快递类别，都把追踪网络改成“韵达”，并且保存。

---

【八，确保程序正常运行，最好再次重启一下服务器】：照做即可。

---

【九，程序开始工作以后的几个注意事项】：因为这个韵达订阅追踪接口，。只支持60天内的韵达单号。如果有你的韵达单号追踪不到，你要看看是否超过60天。。

还有这个钮门的韵达订阅追踪程序，是先提交订阅，然后才能追踪。

所以你程序刚刚安装好，是不可能马上就能追踪到信息的，耐心等。

我建议程序安装好以后。如果你有很多韵达数据在钮门系统里了，等半个小时到1个小时以后再来看。

↓

我们程序对于已经订阅的单号是加了标记的。

怎么看呢？继续往下看↓

对于已经“提交了订阅”的单号，在“查单界面”输入这个单号敲回车↓

可以看见“整数扩展5”这个字段，变成250了，你不用管这个数字有什么意义，只要它显示“250”就表示这个单号提交过订阅了。系统可以追踪它了。就算你不追踪它。钮门系统的自动跟踪程序到了你预先设定的时间点，也会自动工作开始跟踪它。

↓

另外还可以看见“日期扩展5”这个字段有了日期数据，这个表示在具体几月几日几点几分几秒，钮门的这个韵达订阅接口程序提交了订阅。

↓

如下图：

重申一次：这2个字段只要是空的，或者没有“250”这个数字，表示没有订阅。

只要显示250，并且有具体的时间，就表示已经提交订阅。

↓

如何批量查看呢？继续往下看：

在“核单界面”添加2个字段“整数扩展5”和“日期扩展5”，如下图：

↓

如果忘记了如何在核单界面添加新的字段，学习这个教程：https://www.ems-help.com/ems-help/138/d.htm

↓

添加好了以后，就可以在核单界面批量查看你的韵达单号哪些已经提交过订阅，哪些没有提交过订阅。

↓↓设置成功以后，等待半小时以后，就可以批量追踪↓↓