站长答疑:(张先生) 手机:18616712339 在线QQ: .
 
 
返回首页 · 软件简介 · 软件逻辑 · 安装试用 · 购买预算方案 · 设备推荐购买 · 相关电脑知识 · 业务操作教程 · 快递网站 · 常见问题
 
分享和转发请复制下面链接,或者直接点开下面的链接,然后分享静态格式链接↓
分享链接加载中....



钮门快递软件 >> 常见问题

如何调用钮门api接口的打印接口? | Ginfo.dll?DoApi | 3.4.1_sGetLabel

钮门打印接口调用的前提是“钮门系统的快递公司用户”是否已经购买安装并且配置好了“EMSDATA”接口的相关配置文件,教程:http://www.ems-help.com/ems-help/5251/d.htm →这个教程的就是提到PDF打印接口,接下来要说的就是对于上面教程的的详细补充↓(ERP第三方开发人员需要看的

,另外这个pdf打印接口也是1个额外授权,需要授权码,授权码的获取请联系您的销售工程师,具体授权方式,也是上面的教程(http://www.ems-help.com/ems-help/5251/d.htm)的【步骤④】是关于PDF打印接口开通授权的步骤。

——————————————————————

下载关于钮门系统的打印接口文档: help_DoApi.txt

下载下来以后,统一只用1个接口:,请开发人员认真看完接口文档。

注意不用管E邮宝打印接口“”或者其他下家打印接口

系统会根据预录单号(内单号),以及当时预录单时选择的快递类别,自动判断输出“自定义PDF标签打印”还是“下家接口打印模版”。

我这里弄1个样本案例(用的是我自己的测试服务器,已开通钮门api接口),是我自己在写这个教程的时候,当场获取的时间戳和MD5

我当前演示的时候,这一串接口URL是通的,可以下载的。但是【时间戳和MD5】只能30分钟有效。

所以,您作为开发人员当前测试的这一组URL的【时间戳和MD5】您要改一下。直接浏览器敲回车是通的。

先说具体参数↓(这些参数测试数据,一直在我的系统里不会删,您要做的只是改一下时间戳和MD5就可以提交测试)

 

测试服务器IP121.199.52.229

测试服务器web端口:80

icid(客户档案ID):65

客户密钥:06PrKGnqPNnKf5n

(小包业务以及其他业务)快递类别名称:杭州邮局

E邮宝业务)快递类别名称:国际EUB.164

cModelNamePDF模版名称):TESTPDF

小包业务预录的内单号(给2个测试的):TEST1000000498DPTEST1000000484DP

E邮宝业务预录的内单号(给2个测试的):TEST1000000511DPTEST1000000507DP

比如我这里写好1个样里,只提交1个单号↓

如果是多个单号同时获取,请用中括号括起来,逗号隔开,如下格式

 

 

浏览器直接敲回车,出现PDF下载框(如果第一次出现SERVER错误,那么可能是浏览器的原因,也可能服务器恰好在维护,请在重复一次动作就可以下载了)。

这个就是把这个单号数据,直接用TESTPDF这个标签模版输出 PDF

看看下载的PDF样子(这个是我自定义的PDF模版)

然后我在提交1URL.,关于E邮宝的单号(已获取过转单号操作了),

E邮宝比较特殊,必须先提交数据获取转单号,才能同步获取PDF标签,这个E邮宝的PDF标签不是来自自定义模版,而是来自下家接口。我这里为了方便你开发人员能做测试,我直接在后台就把E邮宝单号取了,标签也有了。

转单号获取以后,在调用标签,请用转单号

我这里用转单号获取EUB标签,也弄1个测试URL(关于EUB标签的转单号标签有获取名称,接口文档有说明)

在浏览器敲回车以后,不是弹出PDF下载框,而是一串\u转码的提示,其实这个返回的就是下家接口EUB接口输出的PDF标签下载链接

 

以后出现这种cmess提示,不管是错误提示,还是正确提示,你不知道怎么看这个转码。或者不知道这个错误提示啥意思,那是因为没有做过转码。

你是做开发的人,应该有转码的工具,没有没关系,百度搜索“\u转码还原”

我这里给1个在线工具:http://www.msxindl.com/tools/unicode16.asp

比如上面的这个返回的E邮宝PDF标签下载链接,我放到里面看一下↓

还原以后是这个样子↓

http://labels.ems.com.cn/partner/api/public/p/static/batch/download/fce20172b79b46b49aa05200239fe0b9.pdf

打开看看↓

 

 

关于钮门系统里面自定义的PDF模版名称,可以提前先调用读取“自定义”的模版名称↓

http://121.199.52.229/cgi-bin/GInfo.dll?ajxEmsQueryPDFLabel&r=0.123456 【直接浏览器里敲回车】

调用以后就是这个样子↓

这些就是来自我自己系统自定义设置的PDF标签模版↓

建议第三方ERP软件,能把这个PDF模版调用直接做成下拉菜单。可以让下单的电商客户自己选择。

因为这个PDF自定义模版是 钮门系统用户在系统里自己维护设置的,有时候可能会改名字,有时候可能直接删掉。

如果做成活的,能从钮门系统里读取当前已经设置好的PDF模版,并且让使用 ERP软件的电商卖家可以自由选择打印模版,这样对于双方软件公司都省心。

补充1】:调用PDF打印模版接口,只跟单号有关,跟快递类别无关。

只是在前面传输数据的时候,跟快递类别有关。单号预录到对应的快递类别以后,取单号,取标签就是钮门系统判断了。至于判断的如何,还要看使用钮门系统的快递公司用户,是否配置好相关的接口配置文件。

补充2】:调用自定义PDF打印模版接口,需要先调用系统已经设置好的自定义PDF模版,然后在匹配“cModelName”值。

补充3】:调用下家接口的PDF打印模版接口,要看下家的接口文档,是否提供调用。比如E邮宝,它是固定死的2种格式,于是我们钮门对于E邮宝的就是写死2个“cModelName”值。至于其他下家的PDF打印模版接口,要看对方的打印模版有几种格式,是否能提供调用?还是说固定的格式名称?以下家接口文档为准。

补充4】:如果下家接口只提供取转单号,并不提供“PDF标签打印接口”,这样的话,就提取转单号以后,调用钮门系统自定义的PDF标签来打印,也是一样的,提供下拉菜单样式,然后快递公司在钮门系统上自定义设置“该下家接口的要求的格式的打印模版”,让电商卖家自己选择打印模版。


更新补充(日期:2018年7月12日)
————————

如果是调用钮门系统的自定义PDF标签,
请直接提交数据给emsdata.dll以后获取内单号,注意是内单号。

然后用如下接口案例样子(IP改为你的服务器IP),获取钮门系统自定义设置的PDF标签,可能获取多个,然后让跟你们对接的开发人员,在他们对接的软件界面上,把获取到的多个自定义标签,下拉菜单的形式显示,让打单的人可以选择↓
http://121.199.52.229/cgi-bin/GInfo.dll?ajxEmsQueryPDFLabel&r=0.123456

然后用如下接口案例样子(IP改为你的服务器IP,ICID用钮门系统客户ID),用获取的内单号,提交给ginfo.dll的DOapi接口,并且附带自定义PDF标签的名称,一起提交,如下案例:

http://121.199.52.229/cgi-bin/GInfo.dll?DoApi&{"RequestName":"sGetLabel","icID":65,"TimeStamp":1488319656000,"MD5":"b6b9504506c4202db3b32b3a3261e6c2","iNoType":0,"iTable":1,"cModelName":"TESTPDF","aNo":"TEST1000000498DP"}

————————————————
如果是调用钮门系统的下家接口标签,最终的派送网络的标签。
直接提交数据给emsdata.dll的doapi接口获取转单号,注意是转单号。
(其实在获取转单号的同时,钮门系统已经把转单号对应的下家接口的pdf标签已经下载到钮门数据库的某个表里了)
然后用转单号提交给ginfo.dll的doapi接口,注意这个时候不是提交给emsdata.dll的doapi,而是提交给ginfo.dll的doapi,
附带1个"iSP_Type":"9999"的参数,
就可以直接从钮门数据库的某个表里,把下载的下家标签输出出来。

————————————————
例子如下↓
IP是你的服务器IP。

单票打印↓格式如下:
http://121.199.36.127/cgi-bin/ginfo.dll?DoApi&{"RequestName":"sEPostPdf","icID":"542","TimeStamp":1531331627489,"MD5":"ee9dcb8780056e318952046d210ca701","iSP_Type":"9999","cqNo":"9374869903502965452970"}

批量打印↓(把接口名称sEPostPdf后面加1个小写的b,把“sEPostPdf”改成“sEPostPdfb”),多个单号用中括号括起来,然后半角逗号隔开
如下格式,
另外运单号字段要把cqNo改成aqNo,字段含义是运单号数组的意思,注意必须转单号数组哦。
http://121.199.36.127/cgi-bin/ginfo.dll?DoApi&{"RequestName":"sEPostPdf","icID":"542","TimeStamp":1531331627489,"MD5":"ee9dcb8780056e318952046d210ca701","iSP_Type":"9999","aqNo":["9374869903502965452970","9374869903502965452971"]}
————————————————

下载接口的最终派送渠道的标签没办法选择什么样子的标签。我们emsdata在获取转单号的同时,默认下载了什么标签,
然后,
ginfo.dll就给你默认输出什么标签,没有选择。(除了早期开发的EUB,可以按纸张格式来)
_____________

可能返回的错误提示:
{"ReturnValue":0,...}: 没有结果或零处理
{"ReturnValue":1,...}: 大于零,结果数或处理记录数,为成功的标识
{"ReturnValue":-1,...}: 唯一性字段值重复,操作失败
{"ReturnValue":-2,...}: 记录不存在,操作失败
{"ReturnValue":-3,...}: 未提供必须的请求参数,操作失败
{"ReturnValue":-4,...}: 请求不支持,版本错误或请求未实现
{"ReturnValue":-5,...}: Json数据格式错误,未解析出"RequestName"
{"ReturnValue":-6,...}: Json数据格式错误,双引号(")配对异常
{"ReturnValue":-7,...}: 安全校验失败,不是配置的IP或数字签名错误
{"ReturnValue":-8,...}: 未获授权
{"ReturnValue":-9,...}: EmsData.dll程序错误,通常为数据库查询失败
{"ReturnValue":-9999,...}: 数据库忙,稍后再试!
{"ReturnValue":-710,...}: icID 错误,未提供或小于1
{"ReturnValue":-711,...}: icID 错误,客户不存在
{"ReturnValue":-720,...}: TimeStamp 错误,超出了同步阈值
{"ReturnValue":-730,...}: MD5 错误,长度不是32字符
{"ReturnValue":-731,...}: MD5 错误,不匹配
{"ReturnValue":-810,...}: cEmsKind错误,不支持
{"ReturnValue":-820,...}: iSP_Type错误,接口不支持
{"ReturnValue":-821,...}: iSP_Type错误,相关接口未初始化


_____________________________________________

另外还有一点值得注意的是:
因为是提取下家接口的标签,这种打印的前提是,下家接口输出的标签必须是PDF格式,如果下家的标签不是PDF格式,我们钮门系统是没办法打印的。
因为我们钮门系统只提取下家接口的打印标签为PDF格式的标签,其他格式不提取。

更新补充(日期:2018年10月12日)
————————

邮政小包标签获取【或者其他下家接口获取的标准通用格式】:

http://网址/cgi-bin/GInfo.dll?DoApi&{"RequestName":"sGetLabel","icID":1,"TimeStamp":1507837417000,"MD5":"b67dbca61cfadc49a94f2162273844ea","iNoType":1,"iTable":0,"cModelName":"FILE_STORE_PDF","aNo":"小包单号"}

只要转单号可以提取,并且先提取,并且还能在文件共享中心,看得到这个转单号对应的PDF标签。

那么就可以通过文件共享中心,通过ginfo的doapi接口下载。

上面的格式中↓

“网址”改为:你的钮门服务器的IP或者域名

icid改为:你的客户id

TimeStamp时间戳和MD5改成你这边自己当场生成的。

iNoType、iTable不变。

cModelName的参数和上面格式一样“FILE_STORE_PDF”,它代表就是“文件共享中心”

aNo改成你的下家接口获取的转单号

钮门快递软件|EMMIS[2017.03.01-15:18]编辑:钮门快递软件|EMMIS 访问:7089
[关闭窗口]  


您可能还感兴趣的关联教程文章↓

QQ快递资源群分享1(国际快递代理)
用微信或者QQ扫描即可添加
 
QQ快递资源群分享2(邮政国际小包)
用微信或者QQ扫描即可添加
 
QQ快递资源群分享2(国际快递|航空专线)
用微信或者QQ扫描即可添加
 
钮门快递软件.信息载入中...
 
 
 
友情链接维护中。。。。
人气指数: 高质量高人气,快递行业QQ群(资源分享):      
 
 
关于本网站
...
物流查询工具
网站快速通道
其他服务与支持
购买:186-1671-2339
QQ:154392081
E-mail:emmis@qq.com
快递订单管理系统
瘦客户端了解更多>>
总单插件了解更多>>
 
版权所有 ems-help.com Copyright © ems-help.com | Manager.

软件功能■关键词①: 快递软件 | 快递管理软件 | 快递管理系统 | 快递系统 | 快递查单软件 | 快递财务软件 | 快递面单打印软件 | 快递单号批量查询 | 国际航空小包软件 | 快递查单网站制作
软件公司■关键词②: 钮门快递管理系统 | 钮门软件 | 上海钮门 | 钮门网络科技 | 钮门快递系统 | 钮门系统
其他应用■关键词③: 快递电子秤 | 快递PDA | 快递云服务器 | 快递公司来电监听 | 屏蔽快递单号抓取信息关键词 | 快件签收邮件通知