盗墓笔记,梦入神机,欢乐颂第三季

上海翻譯公司完成接口開發(fā)規(guī)范中文翻譯

時間:2018-09-13 09:07 來源:未知作者:dl 點擊:次

上海翻譯公司完成接口開發(fā)規(guī)范中文翻譯

1 關(guān)于本手冊

1.1 資源

http://www.w3.org/XML/

1.2 支持

Please contact [email protected]

2 貨物跟蹤

2.1 貨物跟蹤服務(wù)介紹

您可以使用聯(lián)邦快遞國內(nèi)限時貨物跟蹤服務(wù)獲得實時的貨物跟蹤信息。

2.2 根據(jù)運單號進行貨物跟蹤

2.2.1 說明

您可以通過運單號跟蹤國內(nèi)限時服務(wù)的包裹。

2.2.2 請求格式

采用GET方法請求，具體樣例參見

2.2.3 應(yīng)答格式

共有3種應(yīng)答格式，詳見如下：

2.2.3.1 單件貨物詳細信息

樣例：

<?xml version="1.0" encoding="UTF-8"?>

<fedex-express>

<status>到達聯(lián)邦快遞工作地點</status>

<scan>到達聯(lián)邦快遞工作地點</scan>

聯(lián)邦快遞國內(nèi)服務(wù)接口開發(fā)規(guī)范

Page 3 Printed 12/21/2012

</activity>

</activity>

<scan>貨件已裝車，派送途中</scan>

</activity>

<scan>位于當(dāng)?shù)氐穆?lián)邦快遞遞送站</scan>

</activity>

</activity>

</activities>

</detail>

</tracking>

</fedex-express>

字段含義：

字段名含義類型

tn 運單號 String

ptn 主運單號，為空時表示改件為一票一件 String

destination 目的地 String

shipdate 寄件日期 String

sentby 寄件人 String

deliveredto 收件人 String

signedforby 簽收人 String

servicetype 服務(wù)類型 String

deliverydate 收件日期 String

status 該件貨物最新狀態(tài) String

datetime 該件貨物該次活動時間 String

scancode 該件貨物該次活動內(nèi)容 String

location 該件貨物該次活動地點 String

details 該件貨物該次活動詳細信息 String

2.2.3.2 多件貨物匯總

樣例：

<?xml version="1.0" encoding="UTF-8"?>

<fedex-express>

<ts>

<status>到達聯(lián)邦快遞工作地點</status>

</ts>

<ts>

<status>到達聯(lián)邦快遞工作地點</status>

</ts>

</single>

<mps>

<ts>

<status>遞送例外情況</status>

</ts>

</mps>

</missing>

</invalid>

</summary>

</tracking>

</fedex-express>

字段含義：

字段名含義類型

tn 運單號 String

status 該件貨物最新狀態(tài) String

datetime 該件貨物最新狀態(tài)時間 String

destination 目的地 String

service 服務(wù) String

2.2.3.3 一票多件匯總

樣例：

<?xml version="1.0" encoding="UTF-8"?>

<fedex-express>

<mps>

<status>遞送例外情況</status>

</ts>

<status>遞送例外情況</status>

</ts>

</mps>

</tracking>

</fedex-express>

字段含義：

字段名含義類型

tn 運單號 String

status 該件貨物最新狀態(tài) String

datetime 該件貨物最新狀態(tài)時間 String

destination 目的地 String

service 服務(wù) String

2.2.4 查詢單個運單

2.2.4.1 請求方法：

本查詢支持中文和英文，默認為中文：

GET http://example.example.ex/service/track/xxxxxxxxxxxx

英文訪問地址為:

GET http://example.example.ex/service/track.en/xxxxxxxxxxxx

2.2.4.2 應(yīng)答：

如果該件貨物為一票多件，返回內(nèi)容為匯總信息，參見2.2.3.3，如欲查詢該票貨物下某一件貨物詳細信息，需要再次發(fā)送請求，請求方法為:

GET http://example.example.ex/service/track/xxxxxxxxxxxx/XXXXXXXXXXXX

獲得的應(yīng)答內(nèi)容參見2.2.3.1

如果該件貨物為一票一件，返回內(nèi)容參見2.2.3.1

如果該件貨物未能正常查詢出來，返回內(nèi)容參見2.2.3.2

2.2.5 查詢多個運單

2.2.5.1 請求方法

GET http://example.example.ex/service/track/xxxxxxxxxxxx,xxxxxxxxxxxx

運單號之間以“，”分隔。

2.2.5.2 應(yīng)答

返回內(nèi)容為匯總信息，參見2.2.3.2，如欲查詢其中某一件貨物詳細信息，需要再次發(fā)送請求，請求方法為：

GET http://example.example.ex/service/track/xxxxxxxxxxxx,xxxxxxxxxxxx/XXXXXXXXXX如果該件貨物為一票一件，返回內(nèi)容參見2.2.3.1

如果該件貨物為一票多件，返回內(nèi)容為匯總信息，參見2.2.3.3，如欲查詢該票貨物下某一件貨物詳細信息，需要再次發(fā)送請求，請求方法為:

GET

http://example.example.ex/service/track/xxxxxxxxxxxx,xxxxxxxxxxxx/XXXXXXXXXXXX/xxxxxxxxxxxx

獲得的應(yīng)答內(nèi)容參見2.2.3.1

2.3 根據(jù)訂單號進行貨物跟蹤請求接口及應(yīng)答

2.3.1 說明

您可以通過訂單號跟蹤國內(nèi)限時服務(wù)的包裹。

2.3.2 請求格式

采用GET方法請求，具體樣例參見

2.3.3 應(yīng)答格式

共有2種應(yīng)答格式，詳見如下：

2.3.3.1 單件貨物詳細信息

樣例：

<?xml version="1.0" encoding="UTF-8"?>

<fedex-express>

<status>到達聯(lián)邦快遞工作地點</status>

<scan>到達聯(lián)邦快遞工作地點</scan>

</activity>

</activity>

<scan>貨件已裝車，派送途中</scan>

</activity>

<scan>位于當(dāng)?shù)氐穆?lián)邦快遞遞送站</scan>

</activity>

字段含義：

字段名含義類型

order 訂單號 String

tn 運單號 String

ptn 主運單號，為空時表示改件為一票一件 String

destination 目的地 String

shipdate 寄件日期 String

sentby 寄件人 String

deliveredto 收件人 String

signedforby 簽收人 String

servicetype 服務(wù)類型 String

deliverydate 收件日期 String

status 該件貨物最新狀態(tài) String

datetime 該件貨物該次活動時間 String

scancode 該件貨物該次活動內(nèi)容 String

location 該件貨物該次活動地點 String

details 該件貨物該次活動詳細信息 String

2.3.3.2 一票多件匯總

樣例：

<?xml version="1.0" encoding="UTF-8"?>

<fedex-express order=”0953770932427”>

<mps>

<status>遞送例外情況</status>

</activity>

</activities>

</detail>

</tracking>

</fedex-express>

</ts>

<status>遞送例外情況</status>

</ts>

</mps>

</tracking>

</fedex-express>

字段含義：

字段名含義類型

order 訂單號 String

tn 運單號 String

status 該件貨物最新狀態(tài) String

datetime 該件貨物最新狀態(tài)時間 String

destination 目的地 String

service 服務(wù) String

2.3.4 查詢訂單

2.3.4.1 請求方法：

本查詢支持中文和英文，默認為中文：

GET http://example.example.ex/service/mctrack/xxxx/xxxxxxxxxxxx

英文訪問地址為:

GET http://example.example.ex/service/mctrack.en/xxxx/xxxxxxxxxxxx

2.3.4.2 應(yīng)答：

如果該件貨物為一票多件，返回內(nèi)容為匯總信息，參見2.3.3.2，如欲查詢該票貨物下某一件貨物詳細信息，需要再次發(fā)送請求，請求方法為:

GET http://example.example.ex/service/mctrack/xxxx/xxxxxxxxxxxx/XXXXXXXXXXXX

獲得的應(yīng)答內(nèi)容參見2.3.3.1

如果該件貨物為一票一件，返回內(nèi)容參見2.3.3.1

2.4 訪問地址

由于不同客戶使用的訪問地址可能不同，具體地址請和銷售部門聯(lián)系，謝謝。

3 SERVICE CHECKING

3.1 Service Checking 服務(wù)v1.2介紹

您可以通過提供一個郵編對（始發(fā)地郵編及目的地郵編）來查詢兩個郵編對之間存在的服務(wù)、遞送時限、電話取件截止時間等信息。

3.2 請求格式

采用POST 方法請求/ecs/service/

3.2.1 請求頭格式：

<?xml version="1.0" encoding="utf-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

elementFormDefault="qualified">

<xs:element name="RequestDocument" type="RequestDocumentType" />

<xs:complexType name="RequestDocumentType">

<xs:sequence>

<xs:element name="head" type="RequestDocumentHeadType"

minOccurs="1" maxOccurs="1" />

<xs:element name="body" type="xs:anyType" minOccurs="1"

maxOccurs="1" />

</xs:sequence>

</xs:complexType>

<xs:complexType name="RequestDocumentHeadType">

<xs:sequence>

<xs:element name="serialId" minOccurs="0" maxOccurs="1"

nillable="true"> <!-- serial id to match with the message request/response

pair -->

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:pattern

value="[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="serviceId" type="xs:string" minOccurs="1"

maxOccurs="1" />

<xs:element name="requesterId" type="xs:string" minOccurs="1"

maxOccurs="1" />

</xs:sequence>

<xs:attribute name="version" type="xs:string" default="1.0" />

</xs:complexType>

</xs:schema>

3.2.2 請求體格式

即RequestDocument的body內(nèi)部的格式

<?xml version="1.0" encoding="utf-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

targetNamespace="http://cndxp.apac.fedex.com/ecs/remote/schema"

xmlns="http://cndxp.apac.fedex.com/ecs/remote/schema"

elementFormDefault="qualified">

<xs:complexType name="LogisticServicePublicRequestType">

<xs:sequence>

<xs:element name="senderPostalCode" type="xs:string"

minOccurs="1" maxOccurs="1" />

<xs:element name="recipientPostalCode" type="xs:string"

minOccurs="1" maxOccurs="1" />

<xs:element name="pickupDate" type="xs:string"

minOccurs="1" maxOccurs="1" />

</xs:sequence>

<xs:attribute name="version" type="xs:string" default="1.0" />

</xs:complexType>

</xs:schema>

具體參見樣例

3.2.3 請求樣例：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<head version="1.0"> 請求消息頭版本號，缺省為1.0

<serialId>1e690757-87e1-4b0a-84fa-2352f724ddd6</serialId> 消息對編號，uuid格式

<serviceId>SERVICE_0002</serviceId> 服務(wù)代碼，必填

<requesterId>CUSTOMER_ID</requesterId> 請求方代碼，必填，大小寫敏感

</head>

<body xsi:type="LogisticCodServicePublicRequestType" version="1.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<senderPostalCode>200042</senderPostalCode> 始發(fā)地郵編，必填

<recipientPostalCode>100017</recipientPostalCode> 目的地郵編，必填

<pickupDate>2013-01-05</pickupDate> 取件日期，必填

</body>

</RequestDocument>

3.2.4 字段含義：

字段名含義類型

serialId 消息對編號 UUID

serviceId 服務(wù)代碼 String

requesterId 請求方代碼 String

senderPostalCode 始發(fā)地郵編 String

recipientPostalCode 目的地郵編 String

pickupDate 取件日期 String

3.3 應(yīng)答格式

共有2 類應(yīng)答格式，正常應(yīng)答格式和異常應(yīng)答格式。

3.3.1 應(yīng)答頭格式：

<?xml version="1.0" encoding="utf-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

elementFormDefault="qualified">

<xs:element name="ResponseDocument" type="ResponseDocumentType" />

<xs:complexType name="ResponseDocumentType">

<xs:sequence>

<xs:element name="head" type="ResponseDocumentHeadType"

minOccurs="1" maxOccurs="1" />

<xs:element name="body" type="xs:anyType" minOccurs="1"

maxOccurs="1" nillable="true" />

</xs:sequence>

</xs:complexType>

<xs:complexType name="ResponseDocumentHeadType">

<xs:sequence>

<xs:element name="serialId" minOccurs="0" maxOccurs="1"

nillable="true"> <!-- serial id to match with the message request/response

pair -->

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:pattern

value="[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}" />

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="serviceId" type="xs:string" minOccurs="1"

maxOccurs="1" />

<xs:element name="successFlag" type="xs:boolean"

minOccurs="1" maxOccurs="1" />

<xs:element name="errorCode" type="xs:string" minOccurs="0"

maxOccurs="1" nillable="true" /> <!-- predefined error code if the

successFlag is false -->

<xs:element name="errorMessage" type="xs:string"

minOccurs="0" maxOccurs="1" nillable="true" /> <!-- the detail error

message of the error code -->

</xs:sequence>

<xs:attribute name="version" type="xs:string" default="1.0" />

</xs:complexType>

</xs:schema>

3.3.2 應(yīng)答體格式：

即ResponseDocument的body 內(nèi)部的格式

<?xml version="1.0" encoding="utf-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

targetNamespace="http://cndxp.apac.fedex.com/ecs/remote/schema"

xmlns="http://cndxp.apac.fedex.com/ecs/remote/schema"

elementFormDefault="qualified">

<xs:complexType name="LogisticServicePublicResponseType">

<xs:sequence>

<xs:element name="logisticService" type="LogisticServicePublicType"

minOccurs="0" maxOccurs="unbounded" nillable="true" />

</xs:sequence>

<xs:attribute name="version" type="xs:string" default="1.0" />

</xs:complexType>

<xs:complexType name="LogisticServicePublicType">

<xs:sequence>

<xs:element name="serviceCode" type="xs:string" minOccurs="1"

maxOccurs="1" />

<xs:element name="cutOffTime" type="xs:string" minOccurs="1"

maxOccurs="1" />

<xs:element name="isCod" type=”xs:int"

minOccurs="1" maxOccurs="1" />

<xs:element name="transitDays" type=”xs:int"

minOccurs="1" maxOccurs="1" />

<xs:element name="transitDate" type="xs:string"

minOccurs=”1” maxOccurs=”1”/>

</xs:sequence>

</xs:complexType>

</xs:schema>

詳見如下樣例

3.3.3 正常應(yīng)答樣例：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<head version="1.0"> 響應(yīng)消息頭版本號，缺省為1.0

<serialId>1e690757-87e1-4b0a-84fa-2352f724ddd6</serialId> 消息對編號，UUID格式（與所處理的請求消息的消息編號一致）

<serviceId>SERVICE_0002</serviceId> 服務(wù)代碼

<successFlag>true</successFlag> 服務(wù)是否正常響應(yīng)，若為true，則從body 中獲取響應(yīng)內(nèi)容

</head>

<body xsi:type="sch:LogisticServicePublicResponseType" version="1.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">響應(yīng)消息體版本號，缺省為1.0

<serviceCode>PDS</serviceCode> 服務(wù)代碼

<cutOffTime>17:30:00</cutOffTime> 截止取件時間

<isCod>1</isCod> 有COD 業(yè)務(wù)

<transitDays>1</transitDays> 運送天數(shù)

<transitDate>2013-01-03 18:00:00</transitDate> 預(yù)計送達日期時間

</logisticService>

<serviceCode>99TS</serviceCode> 服務(wù)代碼

<cutOffTime>17:30:00</cutOffTime> 截止取件時間

<isCod>1</ isCod> 有COD 業(yè)務(wù)

<transitDays>3</transitDays> 運送天數(shù)

<transitDate>2013-01-05 18:00:00</transitDate> 預(yù)計送達日期時間

</logisticService>

</body>

</ResponseDocument>

3.3.4 異常應(yīng)答樣例（請求中沒有填寫始發(fā)地郵編）：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<serviceId>SERVICE_0002</serviceId>

<successFlag>false</successFlag> 服務(wù)是否正常響應(yīng)，若為false，則從errorCode中獲取異常代碼，從errorMessage中獲取異常信息

<errorCode>BUS_ERR_000004</errorCode> 異常代碼,BUS前綴為業(yè)務(wù)異常，SYS前綴為系統(tǒng)異常

<errorMessage>Not found sender postal code!</errorMessage> 異常消息

</head>

</ResponseDocument>

3.3.5 異常應(yīng)答樣例（請求中沒有填寫目的地郵編）：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<serviceId>SERVICE_0002</serviceId>

<successFlag>false</successFlag>

<errorMessage>Not found recipient postal code!</errorMessage>

</head>

</ResponseDocument>

3.3.6 字段含義：

字段名含義類型

serialId 消息對編號 UUID

serviceId 服務(wù)代碼 String

successFlag 服務(wù)是否正常響應(yīng)(若為false, 則從errorCode 中獲取異 Boolean

常代碼，從errorMessage 中獲取異常信息)

serviceCode 服務(wù)代碼 String

cutOffTime 截至取件時間 String

isCod COD 業(yè)務(wù)：1=有，0=無 Int

transitDays 運輸天數(shù) Int

TransitDate 預(yù)計派送日期時間YYYY-MM-DD hh24:mi:ss String

errorCode 異常代碼(BUS 前綴為業(yè)務(wù)異常，SYS 前綴為系統(tǒng)異常) String

errorMessage 異常消息 String

3.4 異常代碼

3.4.1 業(yè)務(wù)異常代碼：

異常代碼含義

BUS_ERR_000001 NOT_FOUND_REQUEST_SERVICE

BUS_ERR_000002 NOT_FOUND_REQUEST_BODY

BUS_ERR_000003 MISMATCH_REQUEST_BODY_TYPE

BUS_ERR_000004 NOT_FOUND_SENDER_POSTAL

BUS_ERR_000005 NOT_FOUND_RECIPIENT_POSTAL

BUS_ERR_000006 RAISED_BY_INERNAL_SERVICE_QUERY_LOGISTIC_SERVICE

BUS_ERR_000007 ILLEGAL_INTERNAL_SERVICE_REQUEST_FORMAT

BUS_ERR_000008 ILLEGAL_INTERNAL_SERVICE_RESPONSE_FORMAT

BUS_ERR_000009 FAIL_CONVERT_INTERNAL_SERVICE_RESPONSE_TO_XML

BUS_ERR_0000010 NOT_FOUND_PICKUP_DATE

BUS_ERR_0000011 NOT_FOUND_SERVICE_SUPPORT_MESSAGE

BUS_ERR_0000012 NOT_FOUND_MSG_FROM_POSTAL_SERVICE

BUS_ERR_0000013 ERR_FORMAT_PICKUP_DATE

3.4.2 系統(tǒng)異常代碼：

異常代碼含義

SYS_ERR_0000 CAUSED_BY_SYSTEM_OF_SERVICE_QUERY_LOGISTIC_SERVICE

SYS_ERR_0000 CAUSED_BY_SYSTEM_OF_INERNAL_SERVICE_QUERY_LOGISTIC_S

02 ERVICE

3.5 服務(wù)地址

請和Sales 聯(lián)系。

Version Date Description of Change By

V 1.0 March 16, 2009 First Draft Li-xi Yao

V 1.1 August16, 2009 Adding tracking by order Li-xi Yao

V 1.2 Sep 26, 2009 Example update Xing-Kun Tang

V 1.3 Sep 22, 2011 Append Service Checking Ian Bao

V 1.3.1 Oct 11, 2011 CUSTOMER_ID Ian Bao

V 1.3.2 Dec 29, 2011 Change Key Contact & Doc Management Han-Yue Li

V 1.3.3 Dec 21, 2012 PDS Han-Yue Li

世聯(lián)翻譯-讓世界自由溝通！專業(yè)的全球語言翻譯供應(yīng)商，上海翻譯公司專業(yè)品牌。絲路沿線56種語言一站式翻譯與技術(shù)解決方案，專業(yè)英語翻譯、日語翻譯等文檔翻譯、同傳口譯、視頻翻譯、出國外派服務(wù)，加速您的全球交付。世聯(lián)翻譯公司在北京、上海、深圳等國際交往城市設(shè)有翻譯基地，業(yè)務(wù)覆蓋全國城市。每天有近百萬字節(jié)的信息和貿(mào)易通過世聯(lián)走向全球！積累了大量政商用戶數(shù)據(jù)，翻譯人才庫數(shù)據(jù)，多語種語料庫大數(shù)據(jù)。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國際組織、跨國公司和大中型企業(yè)等近萬用戶的認可。