【前言】:Fedex官方api下单接口有所调整。在之前已经写好的《***如何通过钮门系统获取fedex转单号***》的教程『http://www.emmishelp.com/cgi-bin/GInfo.dll?DispInfo&w=emmishelp&nid=6261』的基础上补充。因为系统升级,上面教程没有提到的。
【先简单概括】:(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个为准。
INTERNATIONAL_FIRST FEDEX_INTERNATIONAL_PRIORITY INTERNATIONAL_PRIORITY_FREIGHT FEDEX_INTERNATIONAL_CONNECT_PLUS FEDEX_INTERNATIONAL_PRIORITY_EXPRESS |
【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程序下载下来以后,别着急双击打开。
下载链接:https://www.emmishelp.com/6262/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个设置就行了。