世联翻译公司完成开发规范中文翻译

时间:2018-09-13 09:06 来源:未知作者:dongli 点击:次

世联翻译公司完成开发规范中文翻译

Version 1.3.3

Date: Dec 21, 2012

Note: Content is subject to changed according to the project process

联邦快递国内服务接口开发规范

Page II Printed 12/21/2012

Key Contacts

Role Name Phone Number Email Address

PM Han-Yue Li +86 186 1031 5964 599943@fedex.com

Reference Documents

Document Name

(Format)

Document Relationship Owner and

Location

联邦快递国内服务接口开发规范

Page III Printed 12/21/2012

联邦快递国内服务接口开发规范

Page 1 Printed 12/21/2012

1 1 关于本手册

1.1 资源

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

1.2 支持

Please contact 599943@fedex.com

联邦快递国内服务接口开发规范

Page 2 Printed 12/21/2012

2 货物跟踪

2.1 货物跟踪服务介绍

您可以使用联邦快递国内限时货物跟踪服务获得实时的货物跟踪信息。

2.2 根据运单号进行货物跟踪

2.2.1 说明

您可以通过运单号跟踪国内限时服务的包裹。

2.2.2 请求格式

采用 GET 方法请求，具体样例参见

2.2.3 应答格式

共有 3 种应答格式，详见如下：

2.2.3.1 单件货物详细信息

样例：

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

<fedex-express>

<status>到达联邦快递工作地点</status>

<scan>到达联邦快递工作地点</scan>

联邦快递国内服务接口开发规范

Page 3 Printed 12/21/2012

字段含义：

字段名含义类型

tn 运单号String

ptn 主运单号，为空时表示改件为一票一件String

destination 目的地String

shipdate 寄件日期String

</activity>

</activity>

<scan>货件已装车，派送途中</scan>

</activity>

<scan>位于当地的联邦快递递送站</scan>

</activity>

</activity>

</activities>

</detail>

</tracking>

</fedex-express>

联邦快递国内服务接口开发规范

Page 4 Printed 12/21/2012

sentby 寄件人String

deliveredto 收件人String

signedforby 签收人String

servicetype 服务类型String

deliverydate 收件日期String

status 该件货物最新状态String

datetime 该件货物该次活动时间String

scancode 该件货物该次活动内容String

location 该件货物该次活动地点String

details 该件货物该次活动详细信息String

2.2.3.2 多件货物汇总

样例：

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

<fedex-express>

<ts>

<status>到达联邦快递工作地点</status>

</ts>

<ts>

<status>到达联邦快递工作地点</status>

</ts>

</single>

<mps>

<ts>

<status>递送例外情况</status>

联邦快递国内服务接口开发规范

Page 5 Printed 12/21/2012

</ts>

</mps>

</missing>

</invalid>

</summary>

</tracking>

</fedex-express>

字段含义：

字段名含义类型

tn 运单号String

status 该件货物最新状态String

datetime 该件货物最新状态时间String

destination 目的地String

service 服务String

2.2.3.3 一票多件汇总

样例：

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

<fedex-express>

<mps>

<status>递送例外情况</status>

</ts>

联邦快递国内服务接口开发规范

Page 6 Printed 12/21/2012

<status>递送例外情况</status>

</ts>

</mps>

</tracking>

</fedex-express>

字段含义：

字段名含义类型

tn 运单号String

status 该件货物最新状态String

datetime 该件货物最新状态时间String

destination 目的地String

service 服务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 应答：

如果该件货物为一票多件，返回内容为汇总信息，参见2.2.3.3，如欲查询该票货物下某一件货物详细信

息，需要再次发送请求，请求方法为:

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

获得的应答内容参见2.2.3.1

如果该件货物为一票一件，返回内容参见2.2.3.1

如果该件货物未能正常查询出来，返回内容参见2.2.3.2

联邦快递国内服务接口开发规范

Page 7 Printed 12/21/2012

2.2.5 查询多个运单

2.2.5.1 请求方法

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

运单号之间以“,” 分隔。

2.2.5.2 应答

返回内容为汇总信息，参见2.2.3.2，如欲查询其中某一件货物详细信息，需要再次发送请求，请求方法

为：

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

如果该件货物为一票一件，返回内容参见2.2.3.1

如果该件货物为一票多件，返回内容为汇总信息，参见2.2.3.3，如欲查询该票货物下某一件货物详细信

息，需要再次发送请求，请求方法为:

GET

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

xxxxxxxxxxx

获得的应答内容参见2.2.3.1

2.3 根据订单号进行货物跟踪请求接口及应答

2.3.1 说明

您可以通过订单号跟踪国内限时服务的包裹。

2.3.2 请求格式

采用 GET 方法请求，具体样例参见

2.3.3 应答格式

共有 2 种应答格式，详见如下：

2.3.3.1 单件货物详细信息

样例：

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

<fedex-express>

联邦快递国内服务接口开发规范

Page 8 Printed 12/21/2012

<status>到达联邦快递工作地点</status>

<scan>到达联邦快递工作地点</scan>

</activity>

</activity>

<scan>货件已装车，派送途中</scan>

</activity>

<scan>位于当地的联邦快递递送站</scan>

</activity>

联邦快递国内服务接口开发规范

Page 9 Printed 12/21/2012

字段含义：

字段名含义类型

order 订单号String

tn 运单号String

ptn 主运单号，为空时表示改件为一票一件String

destination 目的地String

shipdate 寄件日期String

sentby 寄件人String

deliveredto 收件人String

signedforby 签收人String

servicetype 服务类型String

deliverydate 收件日期String

status 该件货物最新状态String

datetime 该件货物该次活动时间String

scancode 该件货物该次活动内容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>

联邦快递国内服务接口开发规范

Page 10 Printed 12/21/2012

</ts>

<status>递送例外情况</status>

</ts>

</mps>

</tracking>

</fedex-express>

字段含义：

字段名含义类型

order 订单号String

tn 运单号String

status 该件货物最新状态String

datetime 该件货物最新状态时间String

destination 目的地String

service 服务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 应答：

如果该件货物为一票多件，返回内容为汇总信息，参见2.3.3.2，如欲查询该票货物下某一件货物详细信

息，需要再次发送请求，请求方法为:

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

联邦快递国内服务接口开发规范

Page 11 Printed 12/21/2012

获得的应答内容参见2.3.3.1

如果该件货物为一票一件，返回内容参见2.3.3.1

2.4 访问地址

由于不同客户使用的访问地址可能不同，具体地址请和销售部门联系，谢谢。

联邦快递国内服务接口开发规范

Page 12 Printed 12/21/2012

3 SERVICE CHECKING

3.1 Service Checking 服务v1.2介绍

您可以通过提供一个邮编对（始发地邮编及目的地邮编）来查询两个邮编对之间存在的服务、递送时

限、电话取件截止时间等信息。

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>

联邦快递国内服务接口开发规范

Page 13 Printed 12/21/2012

<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 内部的格式）

<?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

联邦快递国内服务接口开发规范

Page 14 Printed 12/21/2012

3.2.4 字段含义：

字段名含义类型

serialId 消息对编号UUID

serviceId 服务代码String

requesterId 请求方代码String

senderPostalCode 始发地邮编String

recipientPostalCode 目的地邮编String

pickupDate 取件日期String

3.3 应答格式

共有 2 类应答格式，正常应答格式和异常应答格式。

3.3.1 应答头格式：

<?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>

<serialId>1e690757-87e1-4b0a-84fa-2352f724ddd6</serialId> 消息对编号，uuid

格式

<serviceId>SERVICE_0002</serviceId> 服务代码，必填

<requesterId>CUSTOMER_ID</requesterId> 请求方代码，必填，大

小写敏感

</head>

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

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

<senderPostalCode>200042</senderPostalCode> 始发地邮编，必填

<recipientPostalCode>100017</recipientPostalCode> 目的地邮编，必填

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

</body>

</RequestDocument>

联邦快递国内服务接口开发规范

Page 15 Printed 12/21/2012

<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>

联邦快递国内服务接口开发规范

Page 16 Printed 12/21/2012

3.3.2 应答体格式：

即 ResponseDocument的body 内部的格式

<?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>

联邦快递国内服务接口开发规范

Page 17 Printed 12/21/2012

详见如下样例

3.3.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> 服务代码

<successFlag>true</successFlag> 服务是否正常响应，若为true，则从body 中

获取响应内容

</head>

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

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 响应消息体版本号，缺省为1.0

<serviceCode>PDS</serviceCode> 服务代码

<cutOffTime>17:30:00</cutOffTime> 截止取件时间

<isCod>1</isCod> 有COD 业务

<transitDays>1</transitDays> 运送天数

<transitDate>2013-01-03 18:00:00</transitDate> 预计送达日期时间

</logisticService>

<serviceCode>99TS</serviceCode> 服务代码

<cutOffTime>17:30:00</cutOffTime> 截止取件时间

<isCod>1</ isCod> 有COD 业务

<transitDays>3</transitDays> 运送天数

<transitDate>2013-01-05 18:00:00</transitDate> 预计送达日期时间

</logisticService>

</body>

</ResponseDocument>

3.3.4 异常应答样例（请求中没有填写始发地邮编）：

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

<serviceId>SERVICE_0002</serviceId>

<successFlag>false</successFlag> 服务是否正常响应，若为false, 则

联邦快递国内服务接口开发规范

Page 18 Printed 12/21/2012

从errorCode 中获取异常代码，从errorMessage中获取异常信息

<errorCode>BUS_ERR_000004</errorCode> 异常代码,BUS前缀为业务异

常，SYS 前缀为系统异常

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

</head>

</ResponseDocument>

3.3.5 异常应答样例（请求中没有填写目的地邮编）：

<?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 服务代码String

successFlag 服务是否正常响应(若为false,则从errorCode中获取异

常代码，从errorMessage 中获取异常信息)

Boolean

serviceCode 服务代码String

cutOffTime 截至取件时间String

isCod COD 业务：1=有，0=无Int

transitDays 运输天数Int

TransitDate 预计派送日期时间YYYY-MM-DD hh24:mi:ss String

errorCode 异常代码(BUS 前缀为业务异常，SYS前缀为系统异常) String

errorMessage 异常消息String

联邦快递国内服务接口开发规范

Page 19 Printed 12/21/2012

3.4 异常代码

3.4.1 业务异常代码：

异常代码含义

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 系统异常代码：

异常代码含义

SYS_ERR_0000

CAUSED_BY_SYSTEM_OF_SERVICE_QUERY_LOGISTIC_SERVICE

SYS_ERR_0000

CAUSED_BY_SYSTEM_OF_INERNAL_SERVICE_QUERY_LOGISTIC_S

ERVICE

3.5 服务地址

请和Sales 联系。

联邦快递国内服务接口开发规范

Page 20 Printed 12/21/2012

Revision History

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

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