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



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

日本专线关键数据[收件电话、收件姓名、收件地址、收件邮编]校验和修正的定制api接口,可以让客户提交钮门api接口之前,先提交这个api接口把数据检查并修正一下

因为【Emsdata → DoApp → PreInputSet】这个接口,对于日本专线的数据,只检查邮编是否正确,不会检查其他数据。接下来的接口,是让技术人员在给上面这个接口提交数据之前,先通过这个接口提交检查一下数据。

先说说需求的背景情况。

# ————————————————————————————————

做日本专线,如果要日本清关顺利,那么提供给日本清关行的数据就不能马虎,标准很严格。

数据不做好,影响清关效率、打在标签上的文字让日本快递员看不明白,影响派送。

尤其是下面4个关键数据↓

1)收件姓名

2)收件电话

3)收件邮编

4)收件地址

# ---------------------------------------------------------------

# 简单概括一下上面4个数据要注意的事项↓

# ------------

1)收件姓名:

必须是全名全姓。而且很多中文简体汉字在日文系统里是无法识别的。那就需要把中文简体汉字转化成日文系的汉字。另外日文姓名的英文不是真正意义上的欧美英文姓名、而是罗马注音格式的。

另外日本人姓名可能是纯日语系汉字、也可能是罗马注音姓名、也可能是中国人汉语拼音、也可能是日文平假名、也可能是日文片假名、也可能是假名和汉字混合体。不管是哪种组合,必须保证有姓有名”。

# ------------

2)收件电话:

座机是10位数、手机是11位数,而且开头都是0,而且座机号码和手机号码,对应的号码第2位数有限制范围的。另外,提供的数据如果开头没有0,还需要补0,还要智能去掉开头字符里包含的日本年国际区号。

# ------------

3)收件邮编:

必须是7位数,不足7位要开头补0.超过7位就是错的.日本有将近14万个邮编,每个邮编对应不同的地址。

# ------------

4)收件地址:

收件地址的日文汉字都是日语系的汉字,如果是英文就是罗马注音。而且要完整的包含:都道府県、市区町村、丁目番号、街道门牌信息(一共4级地址数据)。而且日文地址要求数字和字母是全角。而且很多中文的标点符号在日文系统是乱码,比如中划线这个常见的标点符号在日文表达里有标准的字符。等等很多细节。

# ---------------------------------------------------------------

# 以上4个数据,要检查的逻辑细节也非常多!以上的介绍只是关键要注意的细节。因为篇幅原因,这里就不多作描述了。你只需要会用下面即将介绍的api接口就行了

上面4个数据检查,全部交给api就行了↓

# ----------------------------------------------

直接看posttman截图,然后再对接口做详细介绍

电话号码、收件姓名,如果你不想检查,也可以提交空值,我的程序就当作你不要求检查这2个数据。

 

接口文档详细描述,技术人员或者客服人员再给你这个教程的时候,会额外附带下面几个关键参数,注意参数字段名是大小写敏感。

提交的Json数据包介绍↓

接口Url

必填】http://www.abc.com:8084/CheckJapanLineData_before_EmsdataDoAppPreInputSet?

上面的域名就是提交Emsdata的DoApp接口用到的域名。后面的端口不是80,一般默认是8084

icID

必填就是你提交DoApp接口用到的客户icid,这里用整数型或者字符串都行。我的接口自会处理。

ApiKey

必填就是你提交DoApp接口用到的api密钥。

cRPostcode

必填收件邮编,如果有标点符号或者空格,或者开头没有0,我的api会帮你智能处理

cRAddr

必填收件地址,可以是英文、也可以是日语系的汉字,我的api后端程序会帮你智能处理。

cRPhone

非必填】收件电话如果你提交空值,程序就视作你不需要检查收件电话。

如果你提交了,程序就会帮你先智能修正、去掉标点、去掉国际区号、智能补0、检查位数。

cReceiver

非必填】收件姓名如果你提交空值,程序就视作你不需要检查收件姓名。

如果你提交了,程序会帮你检查姓氏、名字、以及额外提供英文翻译。

如果是罗马注音格式的英文姓名,程序也会提供日文翻译参考数据。

 

返回的Json数据包介绍

不管成功还是失败。

都会有【ApiRunResult】和【ApiRunStatus

ApiRunResult】这个是接口提交成功或者失败的1个文字描述。如果是失败,这里会显示失败原因。

ApiRunStatus】这个只有2个值:【Success】和【Fail】,注意大小写敏感。

你提交接口只要关注这个字段值。

 

 

# ——————————

如果【ApiRunStatus=【Fail

返回的Json数据包只有【ApiRunResult】和【ApiRunStatus】这2个字段。

 

 

# ————————————

如果【ApiRunStatus=【Success

返回的Json数据包有【ApiRunResult】和【ApiRunStatus】和【JpLineData_CheckResultJson】这3个字段。

接下来介绍【JpLineData_CheckResultJson】这个字段值里每个子元素字段介绍

Address_4Part_List

数组列表类型,强制分拆4段。

第1段:都道府县(日文)

第2段:市区町村(日文)

第3段:丁目番号(日文)

第4段:剩余街道门牌信息(日文)

Address_NewStr_EN

强制标准化生成的、罗马注音格式的英文地址

Address_NewStr_JP

强制标准化生成的、日文地址

Address_OldMod

将你的原始地址数据的汉字部分、强制转日文系汉字之后的地址

Address_OldStr

你的原始地址数据、没有做过任何处理的样子、你初次提交的样子

Name_DataType

收件姓名识别成功后,属于哪种情况的数据

Name_NewStr_EN

收件姓名强制提取罗马注音格式的英文姓名

Name_NewStr_JP

收件姓名强制提取日文姓名

Name_OldMod

将你的原始姓名数据的汉字部分、强制转日文系汉字之后的地址

Name_OldStr

你的原始姓名数据、没有做过任何处理的样子、你初次提交的样子

PhoneNo_DataType

收件电话识别成功后,属于哪种情况的数据

PhoneNo_NewStr_1

收件电话强制标准化处理之后,只保留数字

PhoneNo_NewStr_2

收件电话强制标准化处理之后,智能加上中划线间隔符号

PhoneNo_OldStr

你的原始电话数据、没有做过任何处理的样子、你初次提交的样子

Postcode_NewStr

收件邮编标准化处理之后,只保留数字

Postcode_OldStr

你的原始邮编数据、没有做过任何处理的样子、你初次提交的样子

上面是返回给你的Json数据包,

你获取之后,正式提交到【Emsdata → DoApp → PreInputSet】这个接口需要用到上面数据,

我建议

 

 

cRPostcode = Postcode_NewStr

 

cRAddr = Address_NewStr_JP

 

cRPhone = PhoneNo_NewStr_1

 

cReceiver = Name_OldMod

 


钮门快递软件|EMMIS[2024.09.03-12:06]编辑:钮门快递软件|EMMIS 访问:123
[关闭窗口]  


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

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 | 快递云服务器 | 快递公司来电监听 | 屏蔽快递单号抓取信息关键词 | 快件签收邮件通知