站长答疑:(张先生) | 手机:18616712339 | 在线QQ: | . |
|
钮门快递软件 >> 常见问题 关于钮门系统对接Fedex接口下单的功能升级补充描述_更新时间-2022年7月
【前言】:Fedex官方api下单接口有所调整。在之前已经写好的《***如何通过钮门系统获取fedex转单号***》的教程『https://www.ems-help.com/ems-help/8117/d.htm』的基础上补充。因为系统升级,上面教程没有提到的。 【先简单概括】:(1)放在钮门服务器上的WWWROOT -> CGI-BIN 这个路径的文件夹里的”Fdex”下家接口配置文件:“FEDEX_set_1.txt”或者“FEDEX_set_*.txt”都要调整。(具体怎么调整,后面再上图)。 (2)这次Fedex的api接口升级,增加了ETD电子发票的问题,钮门的api接口程序可以帮你生成,并上传到Fedex官方服务器里。这样的话,客户和你货代公司,都不需要额外打印纸质的Fedex发票了。 不过这里要注意的是:有些国家是必须要电子发票;有些国家是可以要、可以不要;有些国家是完全不要。 【直接上图,对比升级前后的FEDEX配置文件的区别】:图片会标注,为了保护客户隐私。密钥的部分,都是乱写的并且带有*号。你知道啥意思就行了。 上图过后,我会提供1个最新版本的Fedex下家接口配置文件的下载。以供更方便的参考。 针对上面的纸张定义,补充下: 截至目前(文章发布时间),一共3个纸张定义格式, 打印A4纸格式 → 纸张定义=PAPER_7X4.75 打印热敏(2种热敏格式) → 纸张定义=STOCK_4X6 或者 纸张定义=STOCK_4X8 我以A4纸为例↓我用自己的测试服务器打印出来是2张: 其中1个放大看看效果: ↓ 【第5个改变】,服务类别(ServiceType)字段变了。 旧版本的【INTERNATIONAL_ECONOMY】这个代码对应的产品,Fedex官网后续不再支持了。 旧版本的【INTERNATIONAL_PRIORITY】变成【FEDEX_INTERNATIONAL_PRIORITY】。 新的产品代码以我下面5个为准。
【TermsOfSale】和【PackagingType】参数还是和之前一样。 ↓ 【第6个改变,直接上图】:在“付款人信息设定结束”这个配置代码的下面,继续增加一段, 关于ETD电子发票的相关配置,如下图: 【改变细节详细描述1】:关于新增了固定长宽高的设置。默认都是0. 如果默认都写0,系统就以客户在网站后台下单填写的长、宽、高为准。 客户下单的时候如果不填长宽高、系统就会弹出错误提示。因为fedex接口要求必须有长宽高数据提交。 如果这个位置你改成大于0的数字,系统就固定全部都提交这个长宽高数据,不管客户的长宽高怎么填。 ### 不过最终fedex取件员取走快递会当场称重,会以他的官方称重、量体积的数据为准。 ### 如果是想提升客户体验,那就这里设置成固定的3个1吧。 【改变细节详细描述2】:关于ETD电子发票的相关配置。很重要。下面的教程注意事项都务必仔细看。如果系统上传过ETD电子发票。那么打印出来的fedex标签会带上”ETD”3个字母标记,如下图: 这个标签能打出来,并且上面显示“ETD”3个字母,就表示电子发票数据已经上传过了,而且已经成功上传到fedex官方服务器里了。 ↓ 要上传fedex电子发票。必须先设置发票抬头。 Fedex的发票抬头需要你做2张png格式的图片。 制作很简单,不一定非要用作图工具。 你就用腾讯QQ聊天窗口自带的截图工具都可以做。 你先打开1个空白的记事本,把文字内容打上去。 要做2张图。这2张图的文件名必须分别是title.png 和 sign.png 而且!! title.png 必须是像素尺寸为:700x50 sign.png 必须是像素尺寸为:400x50 ↓ 我用腾讯QQ聊天窗口自带截图工具,先做title.png示范下,如下图: 第1行,写固定发件方姓名,电话 第2行,写固定发件方的地址、邮编、城市、国家 都是英文。 点“完成”按钮,这个截图就自动显示在聊天窗口里了,这个时候不要发送。 直接复制聊天窗口里的这个图片,到桌面上, 然后把文件名改成:title.png 有的人的电脑操作系统是默认不显示后缀名的,那你就只把文件名改成title就行了。 因为腾讯QQ聊天窗口的截图的图片文件就是png图片后缀。 ↓ 再示范签名图片,sign.png,文字弄大一些。 在记事本上先调好字体大小,就1个英文发件姓名。 点“完成”按钮,这个截图就自动显示在聊天窗口里了,这个时候不要发送。 直接复制聊天窗口里的这个图片,到桌面上, 然后把文件名改成:sign.png 有的人的电脑操作系统是默认不显示后缀名的,那你就只把文件名改成sign就行了。 因为腾讯QQ聊天窗口的截图的图片文件就是png图片后缀。 ↓ 2个图片都做好了以后,放到你自己的云服务器的桌面上。(后续的操作在云服务器上去做、) ↓ 这个时候。你下载我这个文件:。这个exe程序下载下来以后,别着急双击打开。 下载链接:http://www.ems-help.com/emmis/EMMisSpx.exe 这个exe,钮门销售工程师帮你第一次配置fedex接口的时候,会帮你放好。如果没有。你可以在点击我这个图标进行下载。 这个是1个特殊的客户端启动程序,你下载下来以后。 远程桌面链接你的云服务器,然后把这个exe程序放到你的云服务器的D盘 -> Emmis文件夹里。 和你的服务器上的emmis.exe正式版在同1个文件夹里。如下图: ↓ 然后你还需要打开你的云服务器的 WWWROOT文件夹 -> CGI-BIN文件夹里面有个:FEDEX_set_1.txt 如下图: 前提是你已经把这个fedex下家接口配置文件已经正确的配置了。 把这个“FEDEX_set_1.txt”复制粘贴到前面说的D盘 -> EMMIS文件夹里面。 和 EMMisSpx.exe在同1个文件夹。如下图: ↓ 双击,弹出登录框,就输入你正式版快递系统的账号密码就可以了。 登录提示版本太低,无视它,不用管,点确定。 进入文件共享中心界面以后,就是这个样子: ↓ 先示范如何上传FEDEX的ETD电子发票的标头, 上传成功提示: IMAGE_1 ↓ 再示范如何上传FEDEX的ETD的电子发票签名 上传成功提示:IMAGE_2 ↓ 如果你的cgi-bin里面配置了多个FEDEX_set_1.txt这种配置文件。 比如还有FEDEX_set_2.txt、、、FEDEX_set_3.txt、、、FEDEX_set_3.txt、、、以此类推。 但是!!!但是!!重点来了。 如果你的FEDEX_set_2.txt或者FEDEX_set_3.txt或者其他。要上传电子发票抬头。 再你做好title.png图片和sign.png图片之后, 你也放到服务器上了。 比如你的第2个fdex账号对应的配置文件FEDEX_set_2.txt, 你现在要上传你的2号fedex配置文件对应的fedex账号对应的电子发票抬头。 你需要把emmis文件夹里的前面你配置过的已经存在的FEDEX_set_1.txt删除。 然后把你这的FEDEX_set_2.txt文件放到emmis文件夹里, 必须!!把FEDEX_set_2.txt文件名改成FEDEX_set_1.txt. 因为我们设计的这个钮门程序只能固定识别固定的文件名FEDEX_set_1.txt。 ↓ ↓ ↓ 接下来再说FEDEX_set_1.txt、以及FEDEX_set_***.txt所有配置文件的这关于ETD国家代码设置的注意事项。 在<ETD>和</ETD>之间,配置的是需要上传电子发票的国家代码。 一旦设置,客户在你的网站后台下单,在取转单号之后,打印下家发票按钮,网页会提示错误。 因为程序逻辑也是对的,你已经上传过ETD电子发票了,那么这个国家的发票就不需要打印纸质了,所以接口也提供打印发票服务了。 在<NOTETD>和</NOTETD>之间,配置的是不需要上传电子发票的国家代码。 ↓ 备注:有些国家是强制要求必须要上传ETD电子发票的,有些国家是可要可不要ETD电子发票。有些国家是压根就不需要ETD电子发票。 ↓ 设置技巧:你先整体判断评估下,你的业务范围里、集合你自己的客户的需求, 需要etd发票的国家的情况在你的业务比例里,是占多数,还是占少数。 然后你只需要设置<NOTETD>或<ETD>其中1个设置就行了。 钮门快递软件|EMMIS[2022.07.11-14:20]编辑:钮门快递软件|EMMIS 访问:1402
|
|
关于本网站
|
... |
物流查询工具
|
网站快速通道
|
其他服务与支持
|