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

Contents

General 3

Description of interface 3

Specification of the received data 3

1 Content format of the interface files specification: 3

2 Definitions of file names 4

3 Field description 4

4 Sample data 6

Returned interface of express status： 6

1. Interface file format 6

2. Definitions of file names 6

3. Sample data 9

Matters needing attention 10

Notes for unloading files 10

Delivery status code table (The red part is reserved for later-stage status code without current status e) 10

 

 

General

This file mainly deals with the systemic interface scheme, interactive process, delivery ways, interface specification and the related matters needing attention. 

Interactive process：

 

发送快递交接数据 Sending the express handover data 

上海综合管理系统 Shanghai comprehensive management system

入网公司系统 Access to company system 

发送快递投递状态数据 Sending express delivery status data 

Description of interface 

Network Access Company transfers files to the FTP Server of EMS.

IP address of FTP: undetermined ( Address deployed by former server ）

User  name: undetermined (Address deployed by former server)

Password: undetermined (Address deployed by former server)

Port number: 22or 21

Uploading contents: undetermined (Address deployed by the late server)

Transport protocol: SFTP or FTP

Specification of the received data

1 Content format of the interface files specification:

a) The interface file is the text file separated by “|”among fields. Each line of data is a piece of compete mail information. Information of each field is not allowed to cover “Enter” or “|” character. 

b) File coding adopts UTF-8 code.

c) Other issues refer to matters needing attention at the file ending part.

2 Definitions of file names  

File name of interface files is “Access Network Company code_”+“Standard express or economic express mark _”

+YYYYMMDDHHMMSS.txt.

Access Network Company code is defined by express company and notified after defining. Attention shall be paid not to disorder the code to avoid data corruption. 

For example,

ZYD_00_20121206160011.txt ZYD: standing for Access Network Company code; 00: standing for standard express

ZYD_01_20121204102000.txt ZYD: standing for Access Network Company code; 01: standing for economic express

3 Field description 

Name of field  Description  Type Length  Null or not Notes

MAIL_NUM Mail number Text 32 Yes

CONSIGNATION_DATE Posting date & time Date No Format: YYYYMMDDH HMMSS

ORDER_NUM Order number Text 32 Yes

TO_PEOPLE Recipient’s name Text 20 No

TELL_NUM Recipient’s Contact number Text 50 No Numerous contact telephone numbers shall be separated by “,”.

TO_COMPANY_NAME Recipient’s Unit name Text 32 No

TO_ADDRESS Recipient’s address Text 50 No

POST_CODE Recipient’s post code Text 10 No

ARRIVE_OFF_ADDRESS Delivered place Text 50 No

GOODS_NUM Total number Digit Yes

GOODS_WEIGHT Actual mail weight Digit Yes

CHARGED_WEIGHT Chargeable weight Digit Yes

TOTAL_VOLUME Total volume Text 50 No

GOODS_NAME Name of inside article Text 32 No

GOODS_ATTRIBUTE Property of inside article Text 12 No

INSURANCE_FLAG Support value (whether selecting insurance support value) Text 1 Yes 1. Supporting value

2. Not supporting value

CAST_COMPLETED_SINGLE Short message service for delivered prompt Text 10 Yes

REAL_RETURN_SINGLE Returned order for material object Text 10 Yes

ELECTRONIC_RETURN_SINGLE Electronic returned order Text 10 Yes

OTHERS Others Text 10 Yes

COLLECTION_ON_DELIVERY Collection on delivery Text 10 Yes

COLLECTION_AMOUNT Collecting amount on delivery Digit Yes

POSTAGE Postage Digit No

PACKAGE_FEE Packaging cost Digit Yes

INSURANCE_FEE Support value charge Digit Yes

OTHER_COST Other charges Digit Yes

PAYMENT1 Payer Text 20 Yes

PAYMENT2 Types of payment Text 20 Yes

REMARK Notes Text 200 Yes

GOODS_ATTRIBUTE1 Inside article 2 Text 20 Yes

GOODS_ATTRIBUTE2 Inside article 3 Text 20 Yes

4 Sample data 

Mail number | Posting date & time| Order number | Recipient’s name | Contact number | Recipient Unit name | Client’s address | Post code | Delivered city | Total number | Actual weight | Chargeable weight |Total volume |Name of inside article | Property of inside article |Support value | Short message service for delivered prompt | Returned order for material object | Electronic returned order | Others | Collection on delivery | Collecting amount on delivery| Postage |Packaging cost | Support value charge |Other charges | Payer | Types of payment| Note 1| Note 2 | Note 3

ET155128123CS|20120417000000|0215094908| Meng Lili1|2147483647|null| No. 142 Aimin Village, Gaoqiao, Miao Town, Chongming County, Shanghai |200000| Shanghai Downtown|1|0.48|0.5|40*65*31| Made in Jiangsu Maple Jinjian 200G| Article |||||||0|0|0|0|0|Sender Payment |Swiping card| Notifying us by telephone for returning orders| Brown |Square

Returned interface of express status：

This interface plays a role in returning the express status to Access Network Company 

1. Interface file format 

Interface file is the text file, separated by “|”among fields.

2. Definitions of file names

File name of interface files is “Access Network Company code_”+“Standard express or economic express mark _”

+YYYYMMDDHHMMSS.txt.

For example： ZYD_00_20121206160011.txt Standard express

ZYD_01_20121204102000.txt Economic express

 

Field description 

Name of field  Description  Type Length  Null or not Notes

MAIL_NUM Mail number Text Yes

C_FLAG Express type Text 0 stands for standard express

1stnads for economic express

CONSIGNATION_DATE Posting date & time Date No Format: YYYYMMDDH HMMSS

PICKUP_DATE Receiving date & time Date No Format: YYYYMMDDH HMMSS

DELIVERY_DATE Delivery date & time| Date No Format: YYYYMMDDH HMMSS

DELIVERY_RESULT Delivery status Text 10 Yes

DELIVERY_FLAG Desired delivered result Text 10 Yes

ENTERPRISE_CODE Access network company Text 32 Yes

ORDER_NUM Order number Text 32 Yes

TO_PEOPLE Recipient’s name Text 20 No

TELL_NUM Recipient’s contact number Text 50 No Numerous contact telephone numbers shall be separated by “,”.

TO_COMPANY_NAME Recipient Unit name Text 32 No

TO_ADDRESS Recipient’s address Text 50 No

POST_CODE Recipient’s post code Text 10 No

ARRIVE_OFF_ADDRESS Delivered place Text 50 No

GOODS_NUM Total number Digit Yes

GOODS_WEIGHT Actual weight of mail Digit Yes

CHARGED_WEIGHT Chargeable weight Digit Yes

TOTAL_VOLUME Total volume Text 50 No

GOODS_NAME Name of inside article Text 32 No

GOODS_ATTRIBUTE Property of inside article Text 12 No

INSURANCE_FLAG Support value (whether selecting insurance support value) Text 1 Yes 1. Supporting value

2. Not supporting value 

CAST_COMPLETED_SINGLE Short message service for desired delivery Text 10 Yes

REAL_RETURN_SINGLE Returned order for material object Text 10 Yes

ELECTRONIC_RETURN_SINGLE Electronic returned order Text 10 Yes

OTHERS Others Text 10 Yes

COLLECTION_ON_DELIVERY Collection on delivery Text 10 Yes

COLLECTION_AMOUNT Collecting amount on delivery Digit Yes

POSTAGE Postage Digit No

PACKAGE_FEE Packaging cost Digit Yes

INSURANCE_FEE Support value charge Digit Yes

OTHER_COST Other charges Digit Yes

PAYMENT1 Payer Text 20 Yes

PAYMENT2 Types of payment Text 20 Yes

REMARK Notes information Text 200 Yes

GOODS_ATTRIBUTE1 Inside article 2 Text 20 Yes

GOODS_ATTRIBUTE2 Inside article 3 Text 20 Yes

MAIL_STATE_TIME Current status time of mail Date Yes

MAIL_STATE_ADDR Current place of mail Text 100 Yes

MAIL_STATE Current status of mail Text 200 Yes

3. Sample data 

Mail number | Express type |Posting date & time| Receiving date & time| Delivery date & time| Delivery status | Desired delivered result | Access network company | Order number |Recipient’s name | Contact number | Recipient Unit name | Recipient’s address | Post code | Delivered city | Total number | Actual weight | Chargeable weight |Total volume |Name of inside article | Property of inside article |Support value | Short message service for delivered prompt | Returned order for material object | Electronic returned order | Others | Collection on delivery | Collecting amount on delivery| Postage |Packaging cost | Support value charge |Other charges | Payer | Types of payment| Notes information| Note 1| Note 2 | Current status time of mail | Current place of mail | Current status of mail 

 

 

EC395897059CS|0|20120417000000||2012098090000|02|1|test|0215094908| Meng Lili 10|2147483647|null| No. 142 Aimin Village, Gaoqiao, Miao Town, Chongming County, Shanghai |200000| Shanghai Downtown||1|0.48|0.5|40*65*31| Made in Jiangsu Maple Jinjian 200G| Article

|null|null|null|null|null|null|0|0|0|0|0| Sender Payment |Swiping card| Notifying us by telephone for returning orders| Brown |Square |2012-11-19 12:18:00 |

 

Shanghai EMS (Express Mail Service) Logistics Changning Office

Telephone number: 021-50247231) | 

Matters needing attention 

(1) Access Network Company uploads the files to the corresponding file folder as per the regulation. Pay attention not to send repeatedly. 

(2) Generally the record of text file does not exceed 5000 lines. 

(3) File coding adopts UTF-8 code. 

(4) All the date format shall be defined as YYYYMMDDHHMMSS. Connectors are not required. 

(5) The first line data of files is the title bar, which is indispensible. 

(6) Considering that fields of the interface is separated by “|”, pay attention not to put the content with “|” or “Enter” to each field lest the data format becomes wrong. Each line of data shall be a complete unit. 

Notes for unloading files

Uploading files systemically shall abide by the format defined as per the Interface Files. Communication and exchange shall be made for any changes. 

Delivery status code table (The red part is reserved for later-stage status code without current status e)

Delivery status code Description (Signed status for receiving) Notes

01 Received（Received the delivered article） Starting of logistics links

02 Desired delivered (signed for receiving) Clients’ signing 

03 Completed partial delivery 

04 Lost

05 Declining for receiving 

06 Returning of articles  Clients’ returning 

07 Delivery failed 

08 In transit（Unsigned） In the process of delivering