在2022年7月,因为fedex官方调整api接口,钮门的api接口配置也需要对应的配合做一些小小的调整。
以下的教程还是继续照着做。但是这个下面的教程基础上,增加一些补充设置,
请先看完当前完整的教程之后,然后再看我这个【补充教程】:
http://www.emmishelp.com/cgi-bin/GInfo.dll?DispInfo&w=emmishelp&nid=6262
【前言】:跟钮门api对接的fedex亚太接口,我们钮门已经开发好,并且集成了fedex亚太接口的正式开发环境了。
但是如果你要使用这个接口。你得先要去fedex官网申请测试接口的密钥,然后通过钮门的api接口的相关配置,生产测试环境下的1个fedex标签的PDF。
然后你再次登录后台去申请正式环境的api密钥。
然后把这个pdf作为附件,以及标准格式的邮件内容表格填写好正式环境api密钥,一起发给指定的FEDEX官方审核专员Eva的邮箱(Eva的E-mail:apacwebservices@fedex.com),最迟是5个工作日内给回复,正常情况下,快的话当天内就给回复了,回复你。。
(标准邮件内容格式申请表的样子下面的教程会有提到。如果没有,可以联系钮门工程师,然后把邮件内容模板直接邮件形式转发给你,你在这个邮件基础上修改邮件表格里面的内容改成你自己的内容就行了。)
【步骤⒈】:首先你得打开fedex的中国官网:https://www.fedex.com/zh-cn/home.html
然后点击右上角的“注册”。
根据你们的业务实际情况选择注册,↓
注册好以后,再次回到fedex的联邦官网,点击右上角的“登录”。
↓
如果你已经有这个官网的会员账号和密码,直接点击右上角的“登录”。
【步骤⒉】:登录成功以后,右上角的登录图标旁边,会显示您的网站账号昵称。如下图:
然后你重新打开这个网址,要打开英文版本的↓
https://www.fedex.com/en-us/developer.html
如上图,点击“FEDEX WEB SERVICES”,
点击以后就是这个样子↓
点击上面图片的“GET STARTED”,打开新的页面,如下图,点击“GET YOUR TEST KEY”,
点击以后再次打开1个新的页面,打勾2个同意,点击“I Accept”,如下图:
点击同意以后,出现这个界面↓
这个界面上箭头所指的位置,我这里重点交代提醒下:
l Country选择China
l ZIP/Postal code是邮编,必须要填。而且要填对。
l City必须你公司所在的城市。
l Phone手机号码必须前面要“+86”,手机号码中间不要有空格或者其他符号。
l Country 必须选择US and Global
↓
确认完毕以后,点击“Continue”
↓
再次弹出新的页面,点击“I Accept”
↓
再次弹出1个新页面,把下图箭头所指的位置的
“Developer Test Key”、
“Test Account Number”、
“Test Meter Number”、
一共3个参数的冒号后面的参数,请复制下面,保存好。后面教程提到的fedex的相关配置文件,需要用到,后面教程会提到↓
【步骤⒊】:你这个fedex网站账号注册时关联的邮箱,会收到1封邮件。这个邮件的内容很重要。
邮件内容大致如下↓邮件里面的重点找到下面的关键参数:“Test Password”,如下图:
这个参数也要记住,后面的钮门专用的fedex配置文件需要用到。
【步骤⒋】:现在上面的配置参数配置到fedex的下家接口配置文件里。
先看钮门专用的fedex接口配置文件↓
<配置定义开始>下面的服务器网址,因为现在是测试调试阶段,所以要填写测试的网址:“wsbeta.fedex.com”,
下面的位置【1】的UserKey等号右边就是前面提到的“Developer Test Key”、
位置【2】的UserPwd等号右边的就是前面提到的【步骤3】收到的邮件里的密码-“Test Password”,
位置【3】的AccountNumber等号右边的就是前面提到的“Test Account Number”、
位置【4】的MeterNumber等号右边的就是前面提到的“Test Meter Number”、
【步骤⒌】:以下截图的,用红色框框起来的这个位置都是默认的,不要改动它↓
【步骤⒍】:还是接上面的配置文件,往下看,有个关键设置 - <关联快递类别开始>
类似这样的格式↓
FEDEXIE=INTERNATIONAL_ECONOMY=DDU=YOUR_PACKAGING
我把这个格式翻译下↓
【快递类别】=【ServiceType】=【TermsOfSale】=【PackagingType】
注意,一共是4个参数,用3个等号隔开。
↓
第1个:是快递类别,就是你的系统里的跟fedex有关的快递类别名称,直接复制过来
↓
第2个:ServiceType,根据fedex的api文档描述,这个参数有3个选项
INTERNATIONAL_ECONOMY,很多国家没开放服务
INTERNATIONAL_FIRST,没有折扣
INTERNATIONAL_PRIORITY,这些也是根据实际情况选择,但第二个没有折扣
大多数情况都是做“INTERNATIONAL_ECONOMY”和“INTERNATIONAL_PRIORITY”也就是简称的FEDEX-IE和FEDEX-IP、
↓
第3个:TermsOfSale,这个参数的选项就多了。
CIF,FOB,DDU,DDP,FCA,FCA/FOB,CIP,CIP/CIF,CPT,C&F,CPT/C&F,EXW,DAP,DAT
能走的业务就只有DDU和DDP了。
但是DDU是关税到付业务,也就是收件人付关税。
DDP是客户付关税,也就是发件方付关税。
基本用我们钮门系统的客户,我接触的经验。基本都是做DDP。
↓
第4个:PackingType,这个参数的选项也很多。
FEDEX_10KG_BOX,FEDEX_25KG_BOX,FEDEX_BOX,FEDEX_PAK,FEDEX_TUBE,YOUR_PACKAGING
最后1个“YOUR_PACKAGING”这个是自己的包装纸箱,
其他的参数选项都是FEDEX官方规格的纸箱或者防水袋什么的。
根据我的经验,大部分用我们钮门系统的做fedex业务的客户,基本都是“YOUR_PACKAGING”。也就是自己提供的纸箱。
但是fedex的官方api接口文档里描述,如果选择“YOUR_PACKAGING”,必须提供“长、宽、高”的体积数据。
也就是如果使用钮门系统对接了FEDEX接口,在钮门系统里录入 fedex业务的时候,必须录入“长、宽、高”。
钮门系统录单时录入体积尺寸的教程:https://www.ems-help.com/ems-help/1044/d.htm
具体对应什么参数,建议你还是问一下你交接联系的FEDEX业务经理去确认!然后对应的组合去创建你的快递类别。 记住:1个组合对应1个快递类别。 而且快递类别名称也有讲究,方便你分辨,带上参数的代号。 |
【步骤⒎】:如果你理解了fedex接口配置文件的参数的含义。
我再结合我客户的系统做演示。
经过跟客户的再次沟通确认,还有我客户跟他的fedex业务经理的确认,以上的参数需要调整,而且快递类别名称也要调整,
(1)客户fedex业务的“ServiceType”是“INTERNATIONAL_ECONOMY”和“INTERNATIONAL_PRIORITY”
(2)客户fedex业务的“TermsOfSale”是“DDP”和“FCA”
(3)客户fedex业务的“PackagingType”是“YOUR_PACKAGING”,也就是只做自备包装。
如果是这样,按照这个组合,那就得创建4个新的快递类别,之前创建的2个,名称是不合理的。。
于是我就帮客户先定好快递类别名称,并且直接创建好。
因为钮门系统的快递类别名称字数有限,最多只支持15个字符,1个英文和1个英文标点分别占1个字符。 所以你要合理规划字母代号,既不能超出字数,又要包含参数含义。 |
别忘了!每个fedex快递类别,都要打勾“客户可见”,如下图:
其他3个按同样的设置,都要打勾“客户可见”,
还有1点特别注意,“客户录单显示名称”必须得弄的和“快递类别名称”一样 ,不然后期api对接,后台下单系统运用,都会造成误导,非常麻烦。请听我的劝,这个是我的经验,不然麻烦事很多。
↓
弄好了上面的设置,就可以开始弄配置文件了。,
这个配置文件就可以这样配置了↓
<关联快递类别开始> FEDEX-IP-DDP-Y=INTERNATIONAL_PRIORITY=DDP=YOUR_PACKAGING FEDEX-IE-DDP-Y=INTERNATIONAL_ECONOMY=DDP=YOUR_PACKAGING FEDEX-IP-FCA-Y=INTERNATIONAL_PRIORITY=FCA=YOUR_PACKAGING FEDEX-IE-FCA-Y=INTERNATIONAL_ECONOMY=FCA=YOUR_PACKAGING <关联快递类别结束> |
【步骤⒏】:配置文件继续往下看↓
“发件人信息设定”和“付款人信息设定”。
这里就填写你当时注册fedex网站的账号时,填写的发件人信息。
总之别空着,都填满。
其中“邮编”这个不要自己想当然的填。必须跟你登录fedex官网后台以后,在注册信息里填写的邮编一模一样。
【步骤⒐】:填好以后,保存这个配置文件,把这个配置文件放在服务器的这个位置↓
“D盘 → WWWROOT文件 → CGI-BIN文件”,如下图:
如果你是第2个fedex账号,就弄另外1个fedex下家接口配置文件,也就是
FEDEX_set_2.txt
文件名的后面的数字改成2就行了。
第3个联邦账号就的下划线3.
↓
另外在这个cgi-bin文件夹里,找到“emsdata.ini”文件,打开它:
找到<转单号生成定义开始>,
在<转单号生成定义开始>和<转单号生成定义结束>之间,
写上快递类别名称=0,
↓
同样的原理,找到<内单号生成定义开始>,
在<内单号生成定义开始>和<内单号生成定义结束>之间,
写上快递类别名称=0,
↓
全部设置好如下图:
↓
设置好以后,保存这个“emsdata.ini”并关闭。
【步骤⒑】:还是在这个cgi-bin文件夹里,找到ems_api.ini,打开它
找到<运单号生成定义开始>,然后把你新创建的fedex快递类别也放这个里面,放一份。
只放快递类别名称,不要写等号,1个快递类别名称占1行,【其他就按默认,别碰,不懂不要碰】如下图:
弄好以后,保存它,关闭它。
【步骤⒒】:在桌面上编辑emskind_x.txt文档。
相关介绍:https://www.ems-help.com/ems-help/5710/d.htm
↓
示范图。
保存,并关闭emskind_x.txt
把这个文件放到你的服务器桌面上,。
在服务器本地登录emmis快递软件,(记得要用emmis的管理员账号登录系统)
然后点击“信息 → 文件共享中心”,如下图:
↓
级别填写:255
类别填写:系统配置
标题和关键词都填写:emskind_x.txt
然后点下面的文件夹图标,把桌面上的“emskind_x.txt”文件,上传进来。点保存
↓
↓
关闭快递软件,重新登录。
【步骤⒓】:然后测试录入1票数据,虚拟1个内单号。
我用我的系统做示范,测试单号:SFJ12345678YT
录入收件人信息:11965 Venice Blvd. Suite 405, Los Angeles, CA 90066
录入物品信息,单价。
尤其是收件邮编,要写正确的。虽然是测试1票,也要录入真实的邮编。
↓
复制这1单,在“核单”界面,搜索出来
↓
然后点击“核单”界面的右上部位的“取转单/传数据”按钮,如下图:
↓
↓
转单号没有提取成功,但是转单号位置,弹出了错误提示,如下图:
↓
我们拉宽一点看看。
注意,这里的错误提示,可能还有其他情况,比如缺少邮编、省州错误、等等。提示信息都是英文,如果不懂英文,就抄下来,用翻译工具翻译下基本就知道你当前这1票业务缺少什么信息或者填错了什么信息。 |
这个应该是fedex_set_1.txt里的配置文件的里的发件人信息的邮编没有写对。要根你fedex官网后台登录以后,的邮编显示一样。
对应的修改fedex_set里的配置文件↓
改好了。保存
我这里只是拿我客户的系统做示范,他的邮编是265500.你的fedex账号对应不是这个。 我只是让你学这个原理,不是让你跟我截图的这个搞一模一样。 |
↓
并且重启服务器的WWW服务,https://www.ems-help.com/ems-help/856/d.htm
↓
然后重新回到“核单”界面再试试。提取成功!!!转单号发生了变化,
这个就是fedex的转单号。
↓
另外我还要把这个fedex获取转单号对应的fedex标签也下载下来。
实际上,钮门系统的api接口的原理是:如果能取到转单号,那就肯定fedex标签也同时下载下来了。
存放在钮门系统某个界面里。
↓
点击“信息 → 文件共享中心”
↓
进入这个界面以后,可以看到左侧有2个栏目。分别是“SPX_Ivc”和“SPX_Lbl”,如下图:
和
这2个pdf就是这个fedex的面单标签和发票标签。都下载下来,放桌面上,如下图:
和
这2个pdf保存好。,后面的步骤,因为前面都是fedex测试环境的确认。后面需要申请正式环境的时候,还要发送一次电子邮件,而且这2个pdf要作为附件,发送给fedex的官方客服邮箱的。这个是后话,。后面步骤会演示到的。别着急,。这里只是提前插一句。 |
↓
言归正传,让我们看看这2个PDF标签的样子↓
和
【步骤⒔】:接下来我们开始申请正式的fedex账号对应的api接口。
再次打开fedex的英文官网 - https://www.fedex.com/en-us/developer.html
点确认自己是登录状态,右上角有显示你的账户名↓
继续点击“FEDEX WEB SERVICES”↓
点击进去以后,不要再点击“GET STARTED”了,这个是之前的测试接口申请环境,
这次要点击“MOVE TO PRODUCTION”↓
进入以后,点击“GET PRODUCTION KEY”↓
进入下1个界面以后,照着我的选项一模一样的选↓选择好以后,点击“Continue”,如下图:
↓
进入下1个界面,点击“I Accept”,如下图:
↓
点击以后进入下1个页面了。这个界面会默认显示你的账号信息,
但是默认的信息有很多可能不符合规范的。你不要着急点右下角的“Continue”!!!
先把信息按我截图的规范填好。否则申请失败!认真往下看,我会截图并配上注意事项↓
接着还是这个图的下半部分↓
这个填写好,下面还有填地址信息的。你就照着上面截图一模一样再填一份。
最终填好的样子,如下图,点击“Continue”↓
点击进入下1个界面,
打勾,并且再次点击“Continue”↓
点击以后就进入成功界面了↓
上面就箭头的位置,请复制下来,保存好,后面的配置文件要用到!!!!
↓
然后你的邮件里会收到1封邮件。
邮件里会提到正式环境的密钥,
这些都要复制保存好。
然后对应的修改配置文件 – FEDEX_SET_1.TXT。
【步骤⒕】:发送确认邮件,激活你的联邦账号的正式api接口环境。
发送邮件的地址:apacwebservices@fedex.com
发送邮件时带的附件,就是前面的步骤,用测试环境生成的2个PDF标签。
发送邮件的内容格式:可以联系钮门工程师,转发给你,大概样子如下:
把表格里的发件人信息、密钥信息改成你自己的。
如果不懂怎么填,可以问钮门销售工程师。
一定要用你自己的这个联邦网站账号对应绑定的邮件来发。
↓
邮件发过去以后,等待审核确认回复邮件。如果确认不行。还得按他的要求来改。
↓
如果正式环境审核通过,会收到这样的邮件,会有这么一句话↓
这个就表示你正式通过了。
【步骤⒖】:以上是1个fedex账号的整个过程。如果你有多个联邦账号。
下1个账号重复走一遍前面14步流程。
【注意1】:第1个联邦账号的下家配置文件是Fedex_set_1.txt,那么第2个联邦账号的下家配置文件就是Fedex_set_2.txt,第3个就是Fedex_set_3.txt,,,依此类推。
【注意2】:对应的快递类别放在对应的fedex_set配置文件里。别放重复了。会导致接口运行不了的。
【注意3】:钮门系统api运行原理是先从第1个下家配置文件开始运行,如果你使用一段时间以后,第1个联邦账号如果停用了,那么对应的fedex_set_1.txt你必须改掉文件名字,或者删除。后面的fedex_set_2改成fedex_set_1,后面的fedex_set_3改成fedex_set_2.总之,意思就是如果联邦账号停用,而且你配置了多个联邦账号的下家接口配置文件,你得把停用的这些fedex配置文件改一下文件名或者删除或者备份转移到别的文件夹里去。然后把剩下能用的fedex_set配置文件的文件名后面的数字改成从1开始的数字顺序,才能恢复正常!切记!
【最后】:如果看了教程觉得复杂,看不懂,或者懒得学,
我这里收费2000元,你啥都不用管,只管配合我收邮件。其他我全部代劳。