 |
|
| 站长答疑：(张先生) | 手机：18616712339 | 在线QQ： | . |
|
|
钮门快递软件 >> 常见问题 第三方电商平台软件对接钮门系统API接口的注意事项？ | 电商卖家平台管理软件对接钮门api接口emsdata接口的注意事项和设置？
这个事情有3个角色，需要这三方配合才能完成。
角色1 → 钮门公司 → 钮门公司在快递公司的服务器上，安装和配置好api接口，而api接口是通过这个emsdata.dll程序包来支持的。钮门工程师负责安装好，并且确认接口是通的。 角色2 → 快递公司 → 快递公司在钮门工程师安装配置好以后，在根据快递公司自己的需求，设置相关的渠道参数，这个需要快递公司自己学会怎么配置的。 角色3 → 第三方电商平台的开发人员 → 需要在快递公司在自己系统设置好，并提供的参数的基础上，根据接口文档进行相关开发。 这里所说的第三方电商平台是指：“速脉ERP、全球交易助手、马帮、店小秘、芒果店长、通途”等等这样知名的电商卖家熟知的电商订单信息管理软件。这些软件公司的开发人员，需要配合做开发。 这3个角色，分别都有各自要做的事情，我负责过我自己客户的，关于“速脉ERP和全球交易助手”的对接工作的三方沟通和培训，中间碰到很多关键问题，不过后面都对接成功了。 开发和沟通对接的过程中，有很多关键设置和细节问题，都是快递公司和第三方电商平台开发人员都需要注意的。我分别详细的图文指示，写出来，如下： 总的来说，还有第4个角色，就是电商卖家。但是电商卖家不参与这3方配合工作，因为他只需要系统好用就行。 这个三方配合的开发对接的效果： 【1】某电商卖家是快递公司的客户。因为电商卖家需要发包裹给快递公司，电商卖家需要购买快递公司的物流服务。 电商卖家同样也是第三方电商平台软件的客户，因为电商卖家自己的订单信息庞杂，需要这样的软件来管理电商卖家自己的订单信息。 而快递公司是钮门公司的客户，快递公司自己也有庞大的物流快递数据需要钮门公司的快递软件来管理。 【2】电商卖家把各大电商网站上的订单信息，通过第三方电商平台软件选择快递发货信息推送给快递公司， 然后快递公司的系统接口当场可以提取小包或者E邮宝单号，并且自动回传给第三方电商平台软件，并且批量打印小包标签，贴在包裹上、 等包裹到了快递公司的仓库，快递公司操作人员只需要扫描扫描订单号条形码，复重扫描接货处理，然后包裹就可以发走了。 【3】整个过程的信息数据的流通，不需要任何人力手工操作，参与excel导出导入，根本上杜绝了人工手工操作导致的信息丢失或者信息误差。 而且大大减轻了电商卖家和快递公司的重复劳动成本和人力成本、时间成本！ 【4】费用方面：快递公司购买钮门软件这边的预算是固定的，最低套餐17600元一次性永久授权（包含1万元API接口+7600元管理程序） 另外自己购买阿里云服务器，根据业务量评估，每年费用大约在3000元到5000元之间不等。 ↓ 至于快递公司和第三方电商平台软件，之间，做这个对接钮门系统，需要多少开发费用。这个不好说。这个需要你快递公司和第三方电商平台软件去谈的。 有的第三方电商平台软件公司是不收费这个额外对接钮门的费用的，并且为了方便，直接设置了对接钮门系统的参数配置界面。比如速脉ERP，对接教程：http://www.ems-help.com/ems-help/5202/d.htm 有的第三方电商平台软件公司是要收费的，这个到底收高还是收低，就看他们是否在乎使用钮门软件的快递公司的这一块市场。或者说跟钮门软件做免费对接，未来有多大的市场潜力，这个要自己掂量了。 钮门工程师安装Emsdata接口要做的工作↓ 【步骤①】：安装好了以后，确认安装接口是否成功？以及版本号，以及授权日期等等信息。 在服务器本机，打开IE浏览器，直接复制这个“http://127.0.0.1/cgi-bin/emsdata.dll?” 比如，我用我自己的测试服务器做示范↓ 如果能出现下面这个界面，就表示工程师给你这个Emsdata接口已经安装了。
↓ 然后具体在看这个信息。
V6.6是版本号，如果你想更新最新版本，学习教程：http://www.ems-help.com/ems-help/5207/d.htm 299907表示到期日期是2999年7月。只要是2999年就表示是永久授权。 ↓
这个就是接口是否开通的标志。 接口后面的下划线如果是1，表示开通了。 下划线后面是0，表示没有开通。 ↓
SPX:下面的接口下面的数字，表示对应的接口文件，你配置了多少个下家接口。 比如EUB_3，就表示配置了3个邮局的E邮宝接口。因为不同邮局的E邮宝接口密钥是不一样的。 具体如果多个邮局配置E邮宝接口，学习教程：http://www.ems-help.com/ems-help/5201/d.htm ↓
【步骤②】：在服务器上的这个路径的文件，是1个重要配置文件↓ D盘\WWWROOT文件夹\cgi-bin文件夹\emsdata.ini 点击鼠标右键，用记事本格式打开，如下图：
而且还要确认：启用亦米容器=1 【步骤③】：在服务器上的这个路径的文件，还有1个重要配置文件↓ D盘\WWWROOT文件夹\cgi-bin文件夹\ems.ini 点击鼠标右键，用记事本格式打开，如下图：
上面这个文件有几个重要的中文开关代码。这个要确认和我上面图片是一样的。 等号左边的汉字要一模一样，等号右边的数字要一模一样。 如果你的系统你仔细确认找了。没有找到的中文代码，就换行直接写进去。1个字不差的写进去。
【步骤④】：在服务器上的这个路径的文件，还有1个重要配置文件↓ D盘\WWWROOT文件夹\cgi-bin文件夹\ems_api.ini 如果服务器上没有这个配置文件，先下载下来，放到上面路径的cgi-bin文件夹里面去。下载： 下载下来以后，配置到cgi-bin文件， 点击鼠标右键，用记事本格式打开，如下图：
这个文件里也有1个授权码。请联系您的销售工程师进行授权！ 这个配置文件主要是用于第三方电商平台开发人员，通过接口，读取快递公司系统里的自己设置的PDF打单模版。 这个是有专门的开发文档，后面会介绍到的。 配置完成以后，要记得重启服务器的WWW服务，或者直接重启服务器。 快递公司IT人员要学会配置相关参数↓ 【步骤⑤】：首先要把系统里允许客户下单的渠道，打勾“客户可见”， 并且把“内单号自动生成ID”和“转单号自动生成ID”都设置为0。 最终要点保存按钮，如下图：
↓ 这里创建的渠道千万千万一定要注意 “客户可见”选项前面的“客户录单显示名称”： 一定必须要和 快递类别名称，要一模一样： 虽然你默认创建好快递类别就是一样的，但是还是重点强调，请不要自作聪明，乱改。 否则，影响接口读取这个渠道，以及影响接口提取这个渠道的转单号，会取不到转单号。 ↓ 凡是你想把你系统里的快递渠道显示在第三方平台软件里，可以让电商卖家选择下单的渠道，你想显示的就要打勾“客户可见”。钮门接口会把所有打勾“客户可见”的渠道，让第三方电商平台软件可以读取并且显示出来。
↓ 不想显示的，就不打勾。没有打勾“客户可见”的渠道，接口是读取不到的。第三方平台软件也不会显示出来。 ↓ 但是，如果在确认要打勾“客户可见”之间，得看相关其他配置文件是否配置好了。否则，即使开放了渠道，结果因为配置没有配置好，导致电商卖家在使用第三方电商平台软件的时候，虽然可以看见这个渠道，但是选择这个渠道下单的时候，却无法提取转单号，或者软件出错。等等问题。 至于怎么配置，请继续认真往下看。 【步骤⑥】：你打算开放给接口的快递类别，就是上面提到的，准备要打勾“客户可见”的渠道。 必须提前导入了号码段。 导入号码段的教程：http://www.ems-help.com/ems-help/1033/d.htm ↓ 导入号码段是针对小包业务的方式， 如果你是有做E邮宝业务，这个钮门接口自带E邮宝接口对接。而，E邮宝的号码生成不是通过号码段生成的，是通过E邮宝接口提取的，这个E邮宝是额外设置的，教程：http://www.ems-help.com/ems-help/5201/d.htm 【步骤⑦】：然后把你所有打勾“客户可见”的快递类别名称， 设置到你快递服务器上的D盘\WWWROOT文件夹\cgi-bin文件夹\emsdata.ini文件里面。如下图：
在<转单号生成定义开始>和<转单号生成定义结束> 以及 <内单号生成定义开始>和<内单号生成定义结束> 之间 都要写上你的快递类别名称等于0的等式。 每个快递类别占1行。 比如上面图片我示范写的是“德国邮政=0” ↓ 把你所有打勾“客户可见”，并且想对接接口的渠道名称，都设置到上面这个文件里面。 这个设置的作用是让第三方平台软件可以通过你这个渠道，往你的系统写入预录报数，也就是说可以把订单信息通过你这个渠道把订单信息传输到你的emmis系统里。另外可以从你的这个渠道提取转单号。 【步骤⑧】：给你系统里已经创建好的客户档案，创建对应客户他自己的api密钥 这里测试用。创建了1个客户叫“张三”
直接点击这个红色的“密钥”2个字，是由钮门系统自动生成的客户密钥。保证你以后创建增加新的对接客户，都不会重复。 ↓ 另外还要注意系统里每个客户都有1个ID号，唯一ID号。这个是后面开发要用的到的。 或者
【步骤⑨】：打开你的快递服务器上的D盘\WWWROOT文件夹\cgi-bin文件夹\ems_api.ini文件里面。 点击鼠标右键，用记事本格式打开，如下图： 在<客户定义开始>和<客户定义结束>之间， 定义你要对接的客户的ID号和密钥，以及客户名称，前面不要加#号。
上面图片为什么这么写，是用我自己系统数据做示范，在我前面【步骤⑧】里示范，提到的张三这个客户， ID对应是 密钥是 每个客户ID密钥信息占1行。 ↓ 然后还是同样的这个文件，找到“运单号生成定义”， 在<运单号生成定义开始>和<运单号生成定义结束>之间， 把打勾“客户可见”的快递类别名称写在这里。 注意这里写的快递类别名称不要等于0，只是写1个快递类别名称， 有多个，就每个占1行。 如下图，我自己测试系统的“德国邮政”这个快递类别，就填在这个位置。
切记，这里的快递类别名称不要等于0。 这个设置的作用是让第三方平台软件可以通过你这个渠道，读取你系统里，预设的PDF打印模版。 在EMMIS系统设置客户打印的PDF标签模版的教程，仔细学习：http://www.ems-help.com/ems-help/5190/d.htm 为了方便你学习设置PDF。我把PDF相关的设置的，我做好的现成的模版以及模版的背景图， 放在这里提供下载，点击下载： 【步骤⑩】：以上参数都配置设置好以后。。 就把下面字段你的系统的这个张三测试客户的密钥信息发给他们公司技术开发人员，。 （每个需要对接第三方软件平台的客户都要单独开1个不一样的密钥） 以下参数只是我举例子做示范的。你自己系统弄出来什么参数。你自己设置好。对照下面的格式，去发给第三方电商平台软件公司的开发人员。先做测试。
↓ 通过API接口测试提交数据，提交成功的话，在预录单列表就会看到这一票数据
↓
↓ 全部配置好以后，或者哪怕你做里面1个小小的参数改动，都要记得重启服务器的WWW服务，或者重启整个服务器。！！！ 这个钮门api接口的EMSDATA.DLL程序不是自动更新的，只能手动更新，更新教程：http://www.ems-help.com/ems-help/5207/d.htm第三方电商平台软件开发人员要看接口文档做开发时要注意的关键细节↓ 【步骤⑾】：整个钮门API接口文档的压缩包下载链接↓ http://www.ems-help.com/ems-help/415049BDD3BFDA456D7364617461/130/1/c.htm 下载最新的接口文档压缩包以后，解压开，如下图：
上面的压缩文档里有个接口测试程序，
但是作为开发人员，你可以用这个程序来帮你了解提交数据的规格格式。 ↓ 你主要需要参照看阅的开发文档，在看这个 ↓ 关于获取单号的问题不用管。只要快递公司在系统配置文件配置好。 你通过 如果是E邮宝渠道不需要通过特殊的E邮宝接口来提取吗，也是这个 补充说明：
其他的都在文档里有描述 【步骤⑿】：你提交的数据测试，。你可以用你自己的程序开发软件。 或者只要数据规格符合。可以直接用IE浏览器测试提交，也一样是OK的。是否成功失败都有返回值。 每个返回值的负数说明，在文档里也有详细描述。 ↓ 但是一定一定要注意，你测试提交的数据里，凡是有汉字的，一定一定必须要转码。 包括快递公司在钮门系统里创建的快递渠道数据“ 快递类别参数就用cemskind就行了。 ↓ 这个提交的数据是必须要转码的，转码说明在文档的1开始就做了详细说明↓
↓ 比如提交的目的地数据的汉字名称是：“美国”，那么转码后的数据就是“\u7F8E\u56FD” 比如提交的快递类别数据的汉字名称是：“德国邮政”，那么转码后的数据就是“\u5FB7\u56FD\u90AE\u653F” 只要提交的数据里有汉字，就必须要转码！切记！ 【步骤⒀】：如果快递公司希望电商卖家通过你的第三方平台软件可以打印PDF格式标签模版， 而且这个PDF模版是要快递公司自己去设计制作PDF模版， 你作为第三方电商平台软件的开发人员，希望通过接口来获取这些PDF模版。 这个就不是上面提到的api接口文档了。这个是单独的1个接口文档， 请下载点击下载： 下载下来打开这个文档以后，其中获取PDF打印模版的接口名称就是这个文档里的“ 这个接口的提交也有汉字需要转码的问题，切记。 ↓ 还有，这个接口里的这个参数“iSP_Type”不用提交不用管。钮门接口会自动判断和生成的。否则会提示错误的。 ↓ 包括我在前面【步骤⑿】提到的接口文档，里面也有涉及到这个参数“iSP_Type”也不用管。 尤其关于E邮宝的问题，不需要单独使用E邮宝接口，就使用提交运单的接口就行了，这个是当时和某开发人员的对话记录↓ ↓ 在使用 你不用管你提交的快递渠道数据 你只管按照读取的快递类别 至于你向某个渠道提交数据，它返回什么，取决于快递公司自己的IT人员在钮门系统配置文件里是怎么配置的。 如果他把这个渠道配置成E邮宝渠道，那么你这边获取的就是E邮宝服务器接口的E邮宝单号和E邮宝标签。 如果他配置成小包渠道，那么你这边开发获取的就是他自己在钮门系统里导入的小包号码段的单号，和他自己在钮门系统里设置的PDF小包标签。 
关于这个钮门api的PDF打印接口调用，我这里增加了详细的补充：http://www.ems-help.com/ems-help/5426/d.htm 【步骤⒁】：建议第三方电商平台软件的开发人员： 直接像速脉ERP一样免费做1个对接钮门系统的界面（或者至少费用能少一些，因为你们开发1次，后面都是固定的了，不用在投入开发成本，钮门的接口肯定是不会变化，因为我们自己的用户群体很大，改变成本太高！）。 让客户直接设置参数就行了。就可以直接用了。 其实也是方面你们的客户电商卖家，因为电商卖家的需求不仅仅是管理自己的订单信息， 电商卖家也关心他的包裹是否更安全更低成本的把货发出去。 目前使用钮门系统的快递公司截止目前超过3000多家，还是高速的增长中。建议重视这一块的市场。 给前来对接钮门的快递公司方便，其实也是给你们自己的用户电商卖家方便。 ↓ 参考速脉ERP开发对接钮门设置：http://www.ems-help.com/ems-help/5202/d.htm 钮门快递软件|EMMIS[2016.07.21-17:25]编辑：钮门快递软件|EMMIS 访问：12747
※※相关信息专题※※ §钮门快递软件-高手应用 §钮门接口
|
|
|
关于本网站
|
... |
物流查询工具
|
网站快速通道
|
其他服务与支持
|
