世联翻译公司完成FTP数据传输规范说明_世联翻译公司

首页 > 新闻中心 > 翻译公司资讯 >

世联翻译公司完成FTP数据传输规范说明

世联翻译公司完成FTP数据传输规范说明
概述
接口说明
 
接收数据规范:
1.接口文件内容格式
2.文件名定义
3.字段描述
4.示例数据
快递状态返回接口
1.接口文件格式
2.文件名定义
3.字段描述
4.示例数据
注意事项
上传文件说明
送货状态代码表(红色为暂时没有状态的状态码后期预留)

 
概述
本文主要说明与入网公司系统对接方案。交互流程、传输方式、接口规范及相关注意事项。
交互流程:

发送快递交接数据  
上海综合管理系统  
入网公司系统  
发送快递投递状态数据  
 
接口说明:
入网公司传输文件到EMS的FTP服务器。
FTP服务器IP地址:待定(正式服务器部署的地址)
用户名:待定(正式服务器部署的地址)
密码:待定(正式服务器部署的地址)
端口号:22或21
上传目录:待定(后期服务器部署的地址)
传输协议:SFTP 或FTP
 
接收数据规范
1       接口文件内容格式规范:
a)      接口文件为文本文件,各字段间用“|”分隔。每行数据为一条完整的邮件信息。每个字段信息中不允许包含回车或者“|”字符
b)      文件的编码采用UTF-8的编码
c)      其他问题参见文档尾部注意事项。
2       文件名定义
接口文件的文件名为“入网公司代码_”+“标准快递或经济快递标示_”
+YYYYMMDDHHMMSS.txt.
入网公司代码由速递公司定义,定义完之后再通知入网公司,注意入网公司代码不能混乱以免数据造成混乱。
例如:        ZYD_00_20121206160011.txt         ZYD:代表入网公司代码,00:代表标准快递
ZYD_01_20121204102000.txt         ZYD:代表入网公司代码,01:代表经济快递
 
3       字段描述
字段名 描述 类型 长度 是否可以为空 备注
MAIL_NUM 邮件号码 文本 32  
CONSIGNATION_DATE 交寄日期 日期   格式:YYYYMMDDH HMMSS
ORDER_NUM 订单号码 文本 32  
TO_PEOPLE 收件人姓名 文本 20  
TELL_NUM 收件人联系电话 文本 50 多个联系电话以,分隔开
TO_COMPANY_NAME 收件人单位名称 文本 32  
TO_ADDRESS 收件人地址 文本 50  
POST_CODE 收件人邮政编码 文本 10  
ARRIVE_OFF_ADDRESS 寄达地 文本 50  
GOODS_NUM 总件数 数字    
GOODS_WEIGHT 邮件实际重量 数字    
CHARGED_WEIGHT         计费重量 数字    
TOTAL_VOLUME 总体积 文本 50  
GOODS_NAME 内件品名 文本 32  
GOODS_ATTRIBUTE 内件属性 文本 12  
INSURANCE_FLAG 保价(是否保险保价) 文本 1 1.表示保价
2.表示不保价
CAST_COMPLETED_SINGLE 妥投短信 文本 10  
REAL_RETURN_SINGLE 实物返单 文本 10  
ELECTRONIC_RETURN_SINGLE 电子返单 文本 10  
OTHERS 其他 文本 10  
COLLECTION_ON_DELIVERY 代收货款 文本 10  
COLLECTION_AMOUNT 代收金额 数字    
POSTAGE 邮费 数字    
PACKAGE_FEE 封装费用 数字    
INSURANCE_FEE 保价费用 数字    
OTHER_COST 其他费用 数字    
PAYMENT1 付款人 文本 20  
PAYMENT2 付款方式 文本 20  
REMARK 备注信息 文本 200  
GOODS_ATTRIBUTE1 内件品名2 文本 20  
GOODS_ATTRIBUTE2 内件品名3 文本 20  
 
4       示例数据
邮件号码|交寄日期|订单号码|收件人姓名|联系电话|收件人单位名称|客户地址|邮政编码|寄达城市|总件数|实际重量|计费重量|总体积|内件品名|内件属性|保价|妥投短信|实物返单|电子返单|其他|代收货款|代收金额|邮费|封装费用|保价费|其他费用|付款人|付款方式|备注1|备注2|备注3
 
ET155128123CS|20120417000000|0215094908|孟玲莉1|2147483647|null|上海市崇明县庙镇高桥爱民村142号|200000|上海市区|1|0.48|0.5|40*65*31|苏产Maple金健200G|物品|||||||0|0|0|0|0|寄件人付|刷卡|退单先电话通知我们|褐色|方形
 
快递状态返回接口:
本接口用于将快递状态返回给入网公司
  1. 接口文件格式
接口文件为文本文件,各字段间用“|”分隔。
  1. 文件名定义
接口文件的文件名为“入网公司代码_”+“标准快递或经济快递代码”
+YYYYMMDDHHMMSS.txt.
例如:     ZYD_00_20121206160011.txt                  标准快递
ZYD_01_20121204102000.txt                  经济快递
 
字段描述
字段名 描述 类型 长度 是否可以为空 备注
MAIL_NUM 邮件号码 文本    
C_FLAG 快递类型 文本     0表示标准快递
1表示经济快递
CONSIGNATION_DATE 交寄日期 日期   格式:YYYYMMDDH HMMSS
PICKUP_DATE 收寄日期 日期   格式:
YYYYMMDDH HMMSS
DELIVERY_DATE 投递日期 日期   格式:
YYYYMMDDH HMMSS
DELIVERY_RESULT 投递状态 文本 10  
DELIVERY_FLAG 妥投结果 文本 10  
ENTERPRISE_CODE 入网公司 文本 32  
ORDER_NUM 订单号码 文本 32  
TO_PEOPLE 收件人姓名 文本 20  
TELL_NUM 收件人联系电话 文本 50 多个联系电话以,分隔开
TO_COMPANY_NAME 收件人单位名称 文本 32  
TO_ADDRESS 收件人地址 文本 50  
POST_CODE 收件人邮政编码 文本 10  
ARRIVE_OFF_ADDRESS 寄达地 文本 50  
GOODS_NUM 总件数 数字    
GOODS_WEIGHT 邮件实际重量 数字    
CHARGED_WEIGHT         计费重量 数字    
TOTAL_VOLUME 总体积 文本 50  
GOODS_NAME 内件品名 文本 32  
GOODS_ATTRIBUTE 内件属性 文本 12  
INSURANCE_FLAG 保价(是否保险保价) 文本 1 1.表示保价
2.表示不保价
CAST_COMPLETED_SINGLE 妥投短信 文本 10  
REAL_RETURN_SINGLE 实物返单 文本 10  
ELECTRONIC_RETURN_SINGLE 电子返单 文本 10  
OTHERS 其他 文本 10  
COLLECTION_ON_DELIVERY 代收货款 文本 10  
COLLECTION_AMOUNT 代收金额 数字    
POSTAGE 邮费 数字    
PACKAGE_FEE 封装费用 数字    
INSURANCE_FEE 保价费用 数字    
OTHER_COST 其他费用 数字    
PAYMENT1 付款人 文本 20  
PAYMENT2 付款方式 文本 20  
REMARK 备注信息 文本 200  
GOODS_ATTRIBUTE1 内件品名2 文本 20  
GOODS_ATTRIBUTE2 内件品名3 文本 20  
MAIL_STATE_TIME 邮件状态时间 日期    
MAIL_STATE_ADDR 邮件状态地址 文本 100  
MAIL_STATE 邮件当前状态 文本 200  
 
3.      示例数据
邮件号码|快递类型|交寄日期|收寄日期|投递日期|投递状态|妥投结果|入网公司|订单号码|收件人姓名|联系电话|收件人单位名称|收件人地址|邮政编码|寄达地|总数量|邮件实际重量|邮件计费重量|总体积|内件品名|内件 属性|保价|妥投短信|实物返单|电子返单|其他|代收货款|代收金额|邮费|封装费|保价费|其他费用|付款人|付款方式|备注信息|备注1|备注2|邮件当前状态时间|邮件当前地点|邮件当前状态
EC395897059CS|0|20120417000000||2012098090000|02|1|test|0215094908|孟玲莉10|2147483647|null|上海市崇明县庙镇高桥爱民村142号|200000|上海市区|1|0.48|0.5|40*65*31|苏产Maple金健200G|物品
|null|null|null|null|null|null|0|0|0|0|0|寄件人付|刷卡|退单先电话通知我们|褐色|方形|2012-11-19 12:18:00 |
上海邮政速递物流长宁经营部 021-50247231) |收寄
 
注意事项
1.      入网公司按照规定上传文件到对应文件夹,请控制不要重复发送。
2.      文本文件中的记录一般控制不超过5000行。
3.      文件的编码采用UTF-8的编码。
4.      所有的日期格式定义为YYYYMMDDHHMMSS,不需要连接符。
5.      文件中第一行数据为标题栏,必须有。
6.      由于该接口各字段由“|”分隔,请不要放有“|”的内容或者回车符号到各个字段,以免造成数据格式出错。每行数据为一个完整的单元。
 
上传文件说明
系统上传文件,应按照《接口文档》中定义的格式。如有变动,请及时沟通协商。
 
送货状态代码表(红色为暂时没有状态的状态码后期预留)
送货状态代码 描述(签收状态) 说明
01 已收货(收寄) 物流环节开始
02 妥投(签收) 客户签收
03 完成部分投递  
04 丢失  
05 拒收  
06 退货 客户退货
07 投递失败  
08 在途(未签收) 投递过程中
 

世联翻译-让世界自由沟通!专业的全球语言翻译供应商,上海翻译公司专业品牌。丝路沿线56种语言一站式翻译与技术解决方案,专业英语翻译日语翻译等文档翻译、同传口译、视频翻译、出国外派服务,加速您的全球交付。 世联翻译公司在北京、上海、深圳等国际交往城市设有翻译基地,业务覆盖全国城市。每天有近百万字节的信息和贸易通过世联走向全球!积累了大量政商用户数据,翻译人才库数据,多语种语料库大数据。世联品牌和服务品质已得到政务防务和国际组织、跨国公司和大中型企业等近万用户的认可。