- 行業(yè)新聞
-
上海翻譯公司完成FTP數(shù)據(jù)傳輸規(guī)范說明
發(fā)布時(shí)間:2018-09-05 08:47 點(diǎn)擊:
上海翻譯公司完成FTP數(shù)據(jù)傳輸規(guī)范說明概述
接口說明
接收數(shù)據(jù)規(guī)范:
1.接口文件內(nèi)容格式
2.文件名定義
3.字段描述
4.示例數(shù)據(jù)
快遞狀態(tài)返回接口
1.接口文件格式
2.文件名定義
3.字段描述
4.示例數(shù)據(jù)
注意事項(xiàng)
上傳文件說明
送貨狀態(tài)代碼表(紅色為暫時(shí)沒有狀態(tài)的狀態(tài)碼后期預(yù)留)
概述
本文主要說明與入網(wǎng)公司系統(tǒng)對(duì)接方案。交互流程、傳輸方式、接口規(guī)范及相關(guān)注意事項(xiàng)。
交互流程:
發(fā)送快遞交接數(shù)據(jù) 上海綜合管理系統(tǒng) 入網(wǎng)公司系統(tǒng) 發(fā)送快遞投遞狀態(tài)數(shù)據(jù)
接口說明:
入網(wǎng)公司傳輸文件到EMS的FTP服務(wù)器。
FTP服務(wù)器IP地址:待定(正式服務(wù)器部署的地址)
用戶名:待定(正式服務(wù)器部署的地址)
密碼:待定(正式服務(wù)器部署的地址)
端口號(hào):22或21
上傳目錄:待定(后期服務(wù)器部署的地址)
傳輸協(xié)議:SFTP 或FTP
接收數(shù)據(jù)規(guī)范
1 接口文件內(nèi)容格式規(guī)范:
a) 接口文件為文本文件,各字段間用“|”分隔。每行數(shù)據(jù)為一條完整的郵件信息。每個(gè)字段信息中不允許包含回車或者“|”字符
b) 文件的編碼采用UTF-8的編碼
c) 其他問題參見文檔尾部注意事項(xiàng)。
2 文件名定義
接口文件的文件名為“入網(wǎng)公司代碼_”+“標(biāo)準(zhǔn)快遞或經(jīng)濟(jì)快遞標(biāo)示_”
+YYYYMMDDHHMMSS.txt.
入網(wǎng)公司代碼由速遞公司定義,定義完之后再通知入網(wǎng)公司,注意入網(wǎng)公司代碼不能混亂以免數(shù)據(jù)造成混亂。
例如: ZYD_00_20121206160011.txt ZYD:代表入網(wǎng)公司代碼,00:代表標(biāo)準(zhǔn)快遞
ZYD_01_20121204102000.txt ZYD:代表入網(wǎng)公司代碼,01:代表經(jīng)濟(jì)快遞
3 字段描述
字段名 描述 類型 長(zhǎng)度 是否可以為空 備注 MAIL_NUM 郵件號(hào)碼 文本 32 是 CONSIGNATION_DATE 交寄日期 日期 否 格式:YYYYMMDDH HMMSS ORDER_NUM 訂單號(hào)碼 文本 32 是 TO_PEOPLE 收件人姓名 文本 20 否 TELL_NUM 收件人聯(lián)系電話 文本 50 否 多個(gè)聯(lián)系電話以,分隔開 TO_COMPANY_NAME 收件人單位名稱 文本 32 否 TO_ADDRESS 收件人地址 文本 50 否 POST_CODE 收件人郵政編碼 文本 10 否 ARRIVE_OFF_ADDRESS 寄達(dá)地 文本 50 否 GOODS_NUM 總件數(shù) 數(shù)字 是 GOODS_WEIGHT 郵件實(shí)際重量 數(shù)字 是 CHARGED_WEIGHT 計(jì)費(fèi)重量 數(shù)字 是 TOTAL_VOLUME 總體積 文本 50 否 GOODS_NAME 內(nèi)件品名 文本 32 否 GOODS_ATTRIBUTE 內(nèi)件屬性 文本 12 否 INSURANCE_FLAG 保價(jià)(是否保險(xiǎn)保價(jià)) 文本 1 是 1.表示保價(jià)
2.表示不保價(jià)CAST_COMPLETED_SINGLE 妥投短信 文本 10 是 REAL_RETURN_SINGLE 實(shí)物返單 文本 10 是 ELECTRONIC_RETURN_SINGLE 電子返單 文本 10 是 OTHERS 其他 文本 10 是 COLLECTION_ON_DELIVERY 代收貨款 文本 10 是 COLLECTION_AMOUNT 代收金額 數(shù)字 是 POSTAGE 郵費(fèi) 數(shù)字 否 PACKAGE_FEE 封裝費(fèi)用 數(shù)字 是 INSURANCE_FEE 保價(jià)費(fèi)用 數(shù)字 是 OTHER_COST 其他費(fèi)用 數(shù)字 是 PAYMENT1 付款人 文本 20 是 PAYMENT2 付款方式 文本 20 是 REMARK 備注信息 文本 200 是 GOODS_ATTRIBUTE1 內(nèi)件品名2 文本 20 是 GOODS_ATTRIBUTE2 內(nèi)件品名3 文本 20 是
4 示例數(shù)據(jù)
郵件號(hào)碼|交寄日期|訂單號(hào)碼|收件人姓名|聯(lián)系電話|收件人單位名稱|客戶地址|郵政編碼|寄達(dá)城市|總件數(shù)|實(shí)際重量|計(jì)費(fèi)重量|總體積|內(nèi)件品名|內(nèi)件屬性|保價(jià)|妥投短信|實(shí)物返單|電子返單|其他|代收貨款|代收金額|郵費(fèi)|封裝費(fèi)用|保價(jià)費(fèi)|其他費(fèi)用|付款人|付款方式|備注1|備注2|備注3
ET155128123CS|20120417000000|0215094908|孟玲莉1|2147483647|null|上海市崇明縣廟鎮(zhèn)高橋愛民村142號(hào)|200000|上海市區(qū)|1|0.48|0.5|40*65*31|蘇產(chǎn)Maple金健200G|物品|||||||0|0|0|0|0|寄件人付|刷卡|退單先電話通知我們|褐色|方形
快遞狀態(tài)返回接口:
本接口用于將快遞狀態(tài)返回給入網(wǎng)公司
- 接口文件格式
- 文件名定義
+YYYYMMDDHHMMSS.txt.
例如: ZYD_00_20121206160011.txt 標(biāo)準(zhǔn)快遞
ZYD_01_20121204102000.txt 經(jīng)濟(jì)快遞
字段描述
字段名 描述 類型 長(zhǎng)度 是否可以為空 備注 MAIL_NUM 郵件號(hào)碼 文本 是 C_FLAG 快遞類型 文本 0表示標(biāo)準(zhǔn)快遞
1表示經(jīng)濟(jì)快遞CONSIGNATION_DATE 交寄日期 日期 否 格式:YYYYMMDDH HMMSS PICKUP_DATE 收寄日期 日期 否 格式:
YYYYMMDDH HMMSSDELIVERY_DATE 投遞日期 日期 否 格式:
YYYYMMDDH HMMSSDELIVERY_RESULT 投遞狀態(tài) 文本 10 是 DELIVERY_FLAG 妥投結(jié)果 文本 10 是 ENTERPRISE_CODE 入網(wǎng)公司 文本 32 是 ORDER_NUM 訂單號(hào)碼 文本 32 是 TO_PEOPLE 收件人姓名 文本 20 否 TELL_NUM 收件人聯(lián)系電話 文本 50 否 多個(gè)聯(lián)系電話以,分隔開 TO_COMPANY_NAME 收件人單位名稱 文本 32 否 TO_ADDRESS 收件人地址 文本 50 否 POST_CODE 收件人郵政編碼 文本 10 否 ARRIVE_OFF_ADDRESS 寄達(dá)地 文本 50 否 GOODS_NUM 總件數(shù) 數(shù)字 是 GOODS_WEIGHT 郵件實(shí)際重量 數(shù)字 是 CHARGED_WEIGHT 計(jì)費(fèi)重量 數(shù)字 是 TOTAL_VOLUME 總體積 文本 50 否 GOODS_NAME 內(nèi)件品名 文本 32 否 GOODS_ATTRIBUTE 內(nèi)件屬性 文本 12 否 INSURANCE_FLAG 保價(jià)(是否保險(xiǎn)保價(jià)) 文本 1 是 1.表示保價(jià)
2.表示不保價(jià)CAST_COMPLETED_SINGLE 妥投短信 文本 10 是 REAL_RETURN_SINGLE 實(shí)物返單 文本 10 是 ELECTRONIC_RETURN_SINGLE 電子返單 文本 10 是 OTHERS 其他 文本 10 是 COLLECTION_ON_DELIVERY 代收貨款 文本 10 是 COLLECTION_AMOUNT 代收金額 數(shù)字 是 POSTAGE 郵費(fèi) 數(shù)字 否 PACKAGE_FEE 封裝費(fèi)用 數(shù)字 是 INSURANCE_FEE 保價(jià)費(fèi)用 數(shù)字 是 OTHER_COST 其他費(fèi)用 數(shù)字 是 PAYMENT1 付款人 文本 20 是 PAYMENT2 付款方式 文本 20 是 REMARK 備注信息 文本 200 是 GOODS_ATTRIBUTE1 內(nèi)件品名2 文本 20 是 GOODS_ATTRIBUTE2 內(nèi)件品名3 文本 20 是 MAIL_STATE_TIME 郵件狀態(tài)時(shí)間 日期 是 MAIL_STATE_ADDR 郵件狀態(tài)地址 文本 100 是 MAIL_STATE 郵件當(dāng)前狀態(tài) 文本 200 是
3. 示例數(shù)據(jù)
郵件號(hào)碼|快遞類型|交寄日期|收寄日期|投遞日期|投遞狀態(tài)|妥投結(jié)果|入網(wǎng)公司|訂單號(hào)碼|收件人姓名|聯(lián)系電話|收件人單位名稱|收件人地址|郵政編碼|寄達(dá)地|總數(shù)量|郵件實(shí)際重量|郵件計(jì)費(fèi)重量|總體積|內(nèi)件品名|內(nèi)件 屬性|保價(jià)|妥投短信|實(shí)物返單|電子返單|其他|代收貨款|代收金額|郵費(fèi)|封裝費(fèi)|保價(jià)費(fèi)|其他費(fèi)用|付款人|付款方式|備注信息|備注1|備注2|郵件當(dāng)前狀態(tài)時(shí)間|郵件當(dāng)前地點(diǎn)|郵件當(dāng)前狀態(tài)
EC395897059CS|0|20120417000000||2012098090000|02|1|test|0215094908|孟玲莉10|2147483647|null|上海市崇明縣廟鎮(zhèn)高橋愛民村142號(hào)|200000|上海市區(qū)|1|0.48|0.5|40*65*31|蘇產(chǎn)Maple金健200G|物品
|null|null|null|null|null|null|0|0|0|0|0|寄件人付|刷卡|退單先電話通知我們|褐色|方形|2012-11-19 12:18:00 |
上海郵政速遞物流長(zhǎng)寧經(jīng)營(yíng)部 021-50247231) |收寄
注意事項(xiàng)
1. 入網(wǎng)公司按照規(guī)定上傳文件到對(duì)應(yīng)文件夾,請(qǐng)控制不要重復(fù)發(fā)送。
2. 文本文件中的記錄一般控制不超過5000行。
3. 文件的編碼采用UTF-8的編碼。
4. 所有的日期格式定義為YYYYMMDDHHMMSS,不需要連接符。
5. 文件中第一行數(shù)據(jù)為標(biāo)題欄,必須有。
6. 由于該接口各字段由“|”分隔,請(qǐng)不要放有“|”的內(nèi)容或者回車符號(hào)到各個(gè)字段,以免造成數(shù)據(jù)格式出錯(cuò)。每行數(shù)據(jù)為一個(gè)完整的單元。
上傳文件說明
系統(tǒng)上傳文件,應(yīng)按照《接口文檔》中定義的格式。如有變動(dòng),請(qǐng)及時(shí)溝通協(xié)商。
送貨狀態(tài)代碼表(紅色為暫時(shí)沒有狀態(tài)的狀態(tài)碼后期預(yù)留)
送貨狀態(tài)代碼 描述(簽收狀態(tài)) 說明 01 已收貨(收寄) 物流環(huán)節(jié)開始 02 妥投(簽收) 客戶簽收 03 完成部分投遞 04 丟失 05 拒收 06 退貨 客戶退貨 07 投遞失敗 08 在途(未簽收) 投遞過程中
世聯(lián)翻譯-讓世界自由溝通!專業(yè)的全球語言翻譯供應(yīng)商,上海翻譯公司專業(yè)品牌。絲路沿線56種語言一站式翻譯與技術(shù)解決方案,專業(yè)英語翻譯、日語翻譯等文檔翻譯、同傳口譯、視頻翻譯、出國(guó)外派服務(wù),加速您的全球交付。 世聯(lián)翻譯公司在北京、上海、深圳等國(guó)際交往城市設(shè)有翻譯基地,業(yè)務(wù)覆蓋全國(guó)城市。每天有近百萬字節(jié)的信息和貿(mào)易通過世聯(lián)走向全球!積累了大量政商用戶數(shù)據(jù),翻譯人才庫(kù)數(shù)據(jù),多語種語料庫(kù)大數(shù)據(jù)。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國(guó)際組織、跨國(guó)公司和大中型企業(yè)等近萬用戶的認(rèn)可。