2024年1月24日发(作者:)

4PX物流接口参数说明

深圳递四方速递

2012-06

版本信息

版本

0.1

0.2

最后修改日期

2012-6-27

2012-11-14

修改人

陈宏波

陈宏波

修改内容

建立文档

修改文档

备注

目 录

版本信息 .............................................................................................................................................. 2

1.

概述.................................................................................................................................................. 4

1.1.

写作目的 ................................................................................................................................. 4

1.2.

本文读者 ................................................................................................................................. 4

1.3.

调用方式 ................................................................................................................................. 4

1.

API 接口参数 .................................................................................................................................. 5

1.1.

创建订单 ................................................................................................................................. 5

1.2.

预报订单 ................................................................................................................................. 9

1.3.

创建并预报订单 ................................................................................................................... 11

1.4.

修改订单 ............................................................................................................................... 15

1.5.

删除订单 ............................................................................................................................... 19

1.6.

查询订单 ............................................................................................................................... 21

1.7.

运费试算 ............................................................................................................................... 25

1.8.

查询轨迹 ............................................................................................................................... 28

1.9.

申请拦截 ............................................................................................................................... 30

1.10.

查询跟踪号 ....................................................................................................................... 32

1. 概述

1.1. 写作目的

本文档是4PX提供的物流接口参数说明,以供开发人员和测试人员参考。

1.2. 本文读者

本文主要读者为开发员和测试员。

1.3. 调用方式

1.3.1. WSDL

在线订单操作Sandbox:

:8090/OrderOnline/ws/?wsdl

在线订单工具Sandbox:

:8090/OrderOnlineTool/ws/?wsdl

1.3.2. SDK

4PX提供的SDK调用方式,封装了我司API接口。

1.3.3. 测试环境网站

URL : :8094/

可以通过该网站看到测试环境API上传的订单情况.

注:无论是WSDL或者SDK调用方式,如要上线,必需向我司申请正式WSDL或SDK。

1. API 接口参数

1.1. 创建订单

类 型: 在线订单操作

接口名称:createOrderService

1.1.1. 请求参数

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

< DeclareInvoice>

String

String

String

String

String

String

< /DeclareInvoice>

1

2

2.1

2.2

Argument

AuthToken

Type

String

Required Meaning

调用API唯一标识,由4PX提供

OrderNo

TrackingNumber

2.3

ProductCode

2.4

CargoCode

2.5

PaymentCode

2.6

InitialCountryCode

2.7

DestinationCountryCode

length = 32

CreateOrderServiceRequest

String

客户订单号码,由客户自己定义

length <=20

String

服务商跟踪号码,由4PX提供,客户如果有相应服务商跟踪号,也可以提供,但我司会校验是否有效,无效则重新分配

Length < =30

String

产品代码,指DHL、新加坡小包挂号、联邮通挂号等,参照产品代码表

Length = 2

String

货物类型(默认:P),参照货物类型表

Length = 1

String

付款类型(默认:P),参照付款类型表

Length = 1

String

起运国家二字代码,参照国家代码表

Length = 2

String

目的国家二字代码,参照国家代

2.8

2.9

2.10

2.11

2.12

Pieces

InsurType

InsurValue

BuyerId

ReturnSign

String

String

String

String

String

2.13

2.14

2.15

2.16

2.17

2.18

2.19

2.20

2.21

2.22

2.23

2.24

2.25

2.26

2.27

CustomerWeight

TransactionId

ShipperCompanyName

ShipperName

ShipperAddress

ShipperTelephone

ShipperFax

ShipperPostCode

ConsigneeCompanyName

ConsigneeName

Street

City

StateOrProvince

ConsigneeTelephone

ConsigneeFax

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

码表

Length = 2

货物件数(默认:1)

0 < Amount <= 999

保险类型,参照保险类型表

Length = 2

保险价值(单位:USD)

0 < Amount <= [10,2]

买家ID

Length <= 30

小包退件标识

Y: 发件人要求退回

N: 无须退回(默认)

Length = 1

客户自己称的重量(单位:KG)

0 < Amount <= [10,2]

交易ID

Length <= 30

发件人公司名称

Length <= 60

发件人姓名

Length <= 60

发件人地址

Length <= 180

发件人电话号码

Length <= 30

发件人传真号码

Length <= 30

发件人邮编

Length <= 10

收件人公司名称

Length <= 60

收件人姓名

Length <= 60

街道

Length <= 60

城市

Length <= 60

州 / 省

Length <= 60

收件人电话号码

Length <= 30

收件人传真号码

Length <= 30

2.28

2.29

2.30

ConsigneePostCode

ConsigneeEmail

Note

String

String

String

收件人邮编

Length <= 10

收件人Email

Length <= 50

订单备注信息

Length <= 256

2.31

2.31.1

EName

2.31.2

Name

2.31.3

DeclareUnitCode

2.31.4

DeclarePieces

2.31.5

UnitPrice

2.31.6

DeclareNote

DeclareInvoice

String

海关申报英文品名

Length <= 200

String

海关申报中文品名

Length <= 200

String

申报单位类型代码(默认: PCE),参照申报单位类型代码表

Length <= 3

String

件数(默认: 1)

0 < Amount <= 999

String

单价

0 < Amount <= [10,2]

String

配货备注

Length <= 256

1.1.2. 返回参数

String

String

String

String

String

String

String

String

String

String

Argument Type

1

Timestamp String

2

ReferenceNumber String

3

TrackingNumber String

4

Ack String

Meaning

服务器响应时间

引用单号,一般为客户单号

服务商跟踪号码

操作状态

成功: Success

失败: Failure

Error

错误代码

错误详细内容中文描述

错误的处理方法中文描述

错误详细内容英文描述

错误的处理方法英文描述

错误信息补充说明

5

5.1

5.2

5.3

5.4

5.5

5.6

Code

CnMessage

CnAction

EnMessage

EnAction

DefineMessage

String

String

String

String

String

String

1.2. 预报订单

类 型: 在线订单操作

接口名称:preAlertOrderService

1.2.1. 请求参数

String

String

Argument

AuthToken

ReferenceNumber

Type

String

String

Required

Meaning

调用API唯一标识,由4PX提供

length = 32

引用单号,可以是客户单号或服务商单号

length <= 30

1

2

1.2.2. 返回参数

< PreAlertOrderService >

String

String

String

String

String

String

String

String

String

String

Argument Type Meaning

1

Timestamp String

服务器响应时间

2

ReferenceNumber String

引用单号,一般为客户单号

3

TrackingNumber String

服务商跟踪号码

4

Ack String

操作状态

成功: Success

失败: Failure

5 Error

5.1

Code String

错误代码

5.2

CnMessage String

错误详细内容中文描述

5.3

CnAction String

错误的处理方法中文描述

5.4

EnMessage String

错误详细内容英文描述

5.5

EnAction String

错误的处理方法英文描述

5.6

DefineMessage String

错误信息补充说明

1.3. 创建并预报订单

类 型: 在线订单操作

接口名称:createAndPreAlertOrderService

1.3.1. 请求参数

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

< DeclareInvoice>

String

String

String

String

String

String

< /DeclareInvoice>

1

2

2.1

2.2

Argument

AuthToken

Type

String

Required Meaning

调用API唯一标识,由4PX提供

OrderNo

TrackingNumber

2.3

ProductCode

2.4

CargoCode

2.5

PaymentCode

2.6

InitialCountryCode

2.7

DestinationCountryCode

length = 32

CreateOrderServiceRequest

String

客户订单号码,由客户自己定义

length <=20

String

服务商跟踪号码,由4PX提供,客户如果有相应服务商跟踪号,也可以提供,但我司会校验是否有效,无效则重新分配

Length < =30

String

产品代码,指DHL、新加坡小包挂号、联邮通挂号等,参照产品代码表

Length = 2

String

货物类型(默认:P),参照货物类型表

Length = 1

String

付款类型(默认:P),参照付款类型表

Length = 1

String

起运国家二字代码,参照国家代码表

Length = 2

String

目的国家二字代码,参照国家代码表

2.8

2.9

2.10

2.11

2.12

Pieces

InsurType

InsurValue

BuyerId

ReturnSign

String

String

String

String

String

2.13

2.14

2.15

2.16

2.17

2.18

2.19

2.20

2.21

2.22

2.23

2.24

2.25

2.26

2.27

2.28

CustomerWeight

TransactionId

ShipperCompanyName

ShipperName

ShipperAddress

ShipperTelephone

ShipperFax

ShipperPostCode

ConsigneeCompanyName

ConsigneeName

Street

City

StateOrProvince

ConsigneeTelephone

ConsigneeFax

ConsigneePostCode

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

Length = 2

货物件数(默认:1)

0 < Amount <= 999

保险类型,参照保险类型表

Length = 2

保险价值(单位:USD)

0 < Amount <= [10,2]

买家ID

Length <= 30

小包退件标识

Y: 发件人要求退回

N: 无须退回(默认)

Length = 1

客户自己称的重量(单位:KG)

0 < Amount <= [10,2]

交易ID

Length <= 30

发件人公司名称

Length <= 60

发件人姓名

Length <= 60

发件人地址

Length <= 180

发件人电话号码

Length <= 30

发件人传真号码

Length <= 30

发件人邮编

Length <= 10

收件人公司名称

Length <= 60

收件人姓名

Length <= 60

街道

Length <= 60

城市

Length <= 60

州 / 省

Length <= 60

收件人电话号码

Length <= 30

收件人传真号码

Length <= 30

收件人邮编

2.29

2.30

ConsigneeEmail

Note

String

String

Length <= 10

收件人Email

Length <= 50

订单备注信息

Length <= 256

2.31

2.31.1

EName

2.31.2

Name

2.31.3

DeclareUnitCode

2.31.4

DeclarePieces

2.31.5

UnitPrice

2.31.6

DeclareNote

DeclareInvoice

String

海关申报英文品名

Length <= 200

String

海关申报中文品名

Length <= 200

String

申报单位类型代码(默认: PCE),参照申报单位类型代码表

Length <= 3

String

件数(默认: 1)

0 < Amount <= 999

String

单价

0 < Amount <= [10,2]

String

配货备注

Length <= 256

1.3.2. 返回参数

String

String

String

String

String

String

String

String

String

String

Argument Type

1

Timestamp String

2

ReferenceNumber String

3

TrackingNumber String

4

Ack String

Meaning

服务器响应时间

引用单号,一般为客户单号

服务商跟踪号码

操作状态

成功: Success

失败: Failure

Error

错误代码

错误详细内容中文描述

错误的处理方法中文描述

错误详细内容英文描述

错误的处理方法英文描述

错误信息补充说明

5

5.1

5.2

5.3

5.4

5.5

5.6

Code

CnMessage

CnAction

EnMessage

EnAction

DefineMessage

String

String

String

String

String

String

1.4. 修改订单

类 型: 在线订单操作

接口名称:modifyOrderService

1.4.1. 请求参数

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

< DeclareInvoice>

String

String

String

String

String

String

< /DeclareInvoice>

Argument Type Required Meaning

1

AuthToken String

调用API唯一标识,由4PX提供

length = 32

2

CreateOrderServiceRequest

2.1

OrderNo String

客户订单号码,由客户自己定义

length <=20

2.2

TrackingNumber

String

服务商跟踪号码,由4PX提供,客户如果有相应服务商跟踪号,也可以提供,但我司会校验是否有效,无效则重新分配

Length < =30

2.3

ProductCode String

产品代码,指DHL、新加坡小包

2.4

CargoCode String

2.5

PaymentCode String

2.6

InitialCountryCode String

2.7

DestinationCountryCode String

2.8

2.9

2.10

2.11

2.12

Pieces

InsurType

InsurValue

BuyerId

ReturnSign

String

String

String

String

String

2.13

2.14

2.15

2.16

2.17

2.18

2.19

2.20

2.21

CustomerWeight

TransactionId

ShipperCompanyName

ShipperName

ShipperAddress

ShipperTelephone

ShipperFax

ShipperPostCode

ConsigneeCompanyName

String

String

String

String

String

String

String

String

String

挂号、联邮通挂号等,参照产品代码表

Length = 2

货物类型(默认:P),参照货物类型表

Length = 1

付款类型(默认:P),参照付款类型表

Length = 1

起运国家二字代码,参照国家代码表

Length = 2

目的国家二字代码,参照国家代码表

Length = 2

货物件数(默认:1)

0 < Amount <= 999

保险类型,参照保险类型表

Length = 2

保险价值(单位:USD)

0 < Amount <= [10,2]

买家ID

Length <= 30

小包退件标识

Y: 发件人要求退回

N: 无须退回(默认)

Length = 1

客户自己称的重量(单位:KG)

0 < Amount <= [10,2]

交易ID

Length <= 30

发件人公司名称

Length <= 60

发件人姓名

Length <= 60

发件人地址

Length <= 180

发件人电话号码

Length <= 30

发件人传真号码

Length <= 30

发件人邮编

Length <= 10

收件人公司名称

2.22

2.23

2.24

2.25

2.26

2.27

2.28

2.29

2.30

ConsigneeName

Street

City

StateOrProvince

ConsigneeTelephone

ConsigneeFax

ConsigneePostCode

ConsigneeEmail

Note

String

String

String

String

String

String

String

String

String

Length <= 60

收件人姓名

Length <= 60

街道

Length <= 60

城市

Length <= 60

州 / 省

Length <= 60

收件人电话号码

Length <= 30

收件人传真号码

Length <= 30

收件人邮编

Length <= 10

收件人Email

Length <= 50

订单备注信息

Length <= 256

2.31

2.31.1

EName

2.31.2

Name

2.31.3

DeclareUnitCode

2.31.4

DeclarePieces

2.31.5

UnitPrice

2.31.6

DeclareNote

DeclareInvoice

String

海关申报英文品名

Length <= 200

String

海关申报中文品名

Length <= 200

String

申报单位类型代码(默认: PCE),参照申报单位类型代码表

Length <= 3

String

件数(默认: 1)

0 < Amount <= 999

String

单价

0 < Amount <= [10,2]

String

配货备注

Length <= 256

1.4.2. 返回参数

String

String

String

String

String

String

String

String

String

String

Argument Type Meaning

1

Timestamp String

服务器响应时间

2

ReferenceNumber String

引用单号,一般为客户单号

3

TrackingNumber String

服务商跟踪号码

4

Ack String

操作状态

成功: Success

失败: Failure

5 Error

5.1

Code String

错误代码

5.2

CnMessage String

错误详细内容中文描述

5.3

CnAction String

错误的处理方法中文描述

5.4

EnMessage String

错误详细内容英文描述

5.5

EnAction String

错误的处理方法英文描述

5.6

DefineMessage String

错误信息补充说明

1.5. 删除订单

类 型: 在线订单操作

接口名称:removeOrderService

1.5.1. 请求参数

String

String

Argument

AuthToken

ReferenceNumber

Type

String

String

Required

Meaning

调用API唯一标识,由4PX提供

length = 32

引用单号,可以是客户单号或服务商单号

length <= 30

1

2

1.5.2. 返回参数

String

String

String

String

String

String

String

String

String

Argument Type Meaning

1

Timestamp String

服务器响应时间

2

ReferenceNumber String

引用单号,一般为客户单号

3

Ack String

操作状态

成功: Success

失败: Failure

4 Error

4.1

Code String

错误代码

4.2

4.3

4.4

4.5

4.6

CnMessage

CnAction

EnMessage

EnAction

DefineMessage

String

String

String

String

String

错误详细内容中文描述

错误的处理方法中文描述

错误详细内容英文描述

错误的处理方法英文描述

错误信息补充说明

1.6. 查询订单

类 型: 在线订单操作

接口名称:findOrderService

1.6.1. 请求参数

String

String

String

String

String

Argument Type Required

1 AuthToken String √

2

2.1

Meaning

调用API唯一标识,由4PX提供

length = 32

ReferenceNumber

2.2

StartTime

2.3

EndTime

FindOrderRequest

String √

引用单号,可以是客户单号或服务商单号

length <= 30

String

开始时间,默认为创建订单时间,结合订单状态(Status)查询

length <= 30

String

结束时间,默认为创建订单时间,结合订单状态(Status)查询

length <= 30

2.4

Status

String

订单状态,参照订单状态表

length = 1

1.6.2. 返回参数

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

< DeclareInvoiceItem>

String

String

String

String

String

String

< /DeclareInvoiceItem>

String

String

String

String

String

String

Argument Type Meaning

1

Timestamp String

服务器响应时间

2

ReferenceNumber String

引用单号,一般为客户单号

3

Ack String

4

4.1

4.2

4.3

4.4

4.5

4.6

5

5.1

5.2

Code

CnMessage

CnAction

EnMessage

EnAction

DefineMessage

OrderNo

TrackingNumber

5.3

5.4

5.5

5.6

5.7

5.8

5.9

5.10

5.11

5.12

5.13

ChannelHawbCode

ProductCode

CargoCode

PaymentCode

InitialCountryCode

DestinationCountryCode

Pieces

InsurType

InsurStatus

InsurValue

ODACheckSign

5.14

ODASign

5.15

HoldSign

5.16

5.17

5.18

5.19

5.20

5.21

BuyerId

CreateDate

ModifyDate

PrintDate

ConfirmDate

PostDate

操作状态

成功: Success

失败: Failure

Error

String

错误代码

String

错误详细内容中文描述

String

错误的处理方法中文描述

String

错误详细内容英文描述

String

错误的处理方法英文描述

String

错误信息补充说明

OrderItem

String

客户订单号码,由客户自己定义

String

服务商跟踪号码,由4PX提供,客户如果有相应服务商跟踪号,也可以提供,但我司会校验是否有效,无效则重新分配

String

渠道转单号,由服务商换单后的号码

String

产品代码,指DHL、新加坡小包挂号、联邮通挂号等,参照产品代码表

String

货物类型(默认:P),参照货物类型表

String

付款类型(默认:P),参照付款类型表

String

起运国家二字代码,参照国家代码表

String

目的国家二字代码,参照国家代码表

String

货物件数(默认:1)

String

保险类型,参照保险类型表

String

保险状态,参照保险状态表

String

保险价值(单位:USD)

String

ODA校验标志

Y:表示已经校验过

N:表示尚未校验

String

ODA标志

Y:表示为ODA

N:表示非ODA

U:表示未知

String

拦截标志

Y:表示发件人要求拦截

N:表示放行

String

买家ID

String

创建订单时间

String

最后修改订单时间

String

打印标签时间

String

确认订单时间

String

预报订单时间

5.22

5.23

5.24

CheckInDate

CheckOutDate

ReturnSign

String

String

String

5.25

5.26

5.27

5.28

5.29

5.30

5.31

5.32

5.33

5.34

5.35

5.36

5.37

5.38

5.39

5.40

5.41

5.42

5.43

5.44

5.45

5.46

CustomerWeight

GrossWeight

VolumeWeight

ChargeWeight

TransactionId

ShipperCompany

ShipperName

ShipperAddress

ShipperTelephone

ShipperFax

ShipperPostCode

ConsigneeCompany

ConsigneeName

ConsigneeAddress1

ConsigneeAddress2

ConsigneeAddress3

ConsigneeTelephone

ConsigneeFax

ConsigneePostCode

ConsigneeEmail

OrderNote

5.46.1

EName

5.46.2

Name

5.46.3

DeclareUnitCode

5.46.4

DeclarePieces

5.46.5

UnitPrice

5.46.6

DeclareNote

签入时间

签出时间

小包退件标识

Y: 发件人要求退回

N: 无须退回(默认)

String

客户自己称的重量(单位:KG)

String

实际重量

String

体积重

String

计费重量

String

交易ID

String

发件人公司名称

String

发件人姓名

String

发件人地址

String

发件人电话号码

String

发件人传真号码

String

发件人邮编

String

收件人公司名称

String

收件人姓名

String

收件人地址1(街道)

String

收件人地址2(城市)

String

收件人地址3(州 / 省)

String

收件人电话号码

String

收件人传真号码

String

收件人邮编

String

收件人Email

String

订单备注信息

DeclareInvoiceItem

String

海关申报英文品名

String

海关申报中文品名

String

申报单位类型代码(默认: PCE),参照申报单位类型代码表

String

件数(默认: 1)

String

单价

String

配货备注

1.7. 运费试算

类 型: 在线订单工具

接口名称:chargeCalculateService

1.7.1. 请求参数

String

String

String

String

String

String

String

< StringArray>

String

String

Argument Type

1 AuthToken String

2

2.1

2.2

Required

Meaning

StartShipmentId

CountryCode

2.3

2.4

2.5

2.6

2.7

2.8

2.9

Weight

Length

Width

Height

CargoCode

DisplayOrder

ProductCode

调用API唯一标识,由4PX提供

length = 32

ChargeCalculateRequest

String

起运地ID,参照起运地ID表

Length <= 4

String √

目的国家二字代码,参照国家代码表

Length = 2

String √

计费重量,单位(kg)

0 < Amount <= [3,3]

String

长度(计算体积重使用)

0 < Amount <= [3,3]

String

宽度(计算体积重使用)

0 < Amount <= [3,3]

String

高度(计算体积重使用)

0 < Amount <= [3,3]

String

货物类型(默认:P)

Length = 1

String

计费结果产品显示级别(默认:1)

Length = 1

String[]

产品代码组,该属性不为空,只返回该产品组计费结果,参照产品代码表

2.10

PostCode String

Length = 2

邮编

Length <= 10

1.7.2. 返回参数

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

Argument

1

Timestamp

2

ReferenceNumber

3

Ack

Type

String

String

String

Meaning

4

4.1

4.2

4.3

4.4

4.5

4.6

Code

CnMessage

CnAction

EnMessage

EnAction

DefineMessage

FreightAmount

FreightOilAmount

IncidentalAmount

TotalAmount

CurrencyCode

ProductCName

ProductEName

ProductCode

Deliveryperiod

Tracking

Volumn

TotalRmbAmount

FreightRmbAmount

FreightOilRmbAmount

IncidentalRmbAmount

Note

5

5.1

5.2

5.3

5.4

5.5

5.6

5.7

5.8

5.9

5.10

5.11

5.12

5.13

5.14

5.15

5.16

服务器响应时间

引用单号,一般为客户单号

操作状态

成功: Success

失败: Failure

Error

String

错误代码

String

错误详细内容中文描述

String

错误的处理方法中文描述

String

错误详细内容英文描述

String

错误的处理方法英文描述

String

错误信息补充说明

CalculateFee

String 运费金额

String 燃油附加费金额

String 杂费金额

String 总费用金额

String 币种

String 产品中文名称

String 产品英文名称

String 产品代码

String 递送时间

String 可跟踪

String 按体积重量计费

String 人民币总费用

String 人民币运费金额

String 人民燃油附加费金额

String 人民杂费金额

String 备注

1.8. 查询轨迹

类 型: 在线订单工具

接口名称:cargoTrackingService

1.8.1. 请求参数

String

String

Argument

AuthToken

ReferenceNumber

Type

String

String

Required

Meaning

调用API唯一标识,由4PX提供

length = 32

引用单号,可以是客户单号或服务商单号

length <= 30

1

2

1.8.2. 返回参数

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

String

Argument Type Meaning

1

Timestamp String

服务器响应时间

2

ReferenceNumber String

引用单号,一般为客户单号

3

Ack String

操作状态

成功: Success

失败: Failure

4

Error

4.1

Code String

错误代码

4.2

CnMessage String

错误详细内容中文描述

4.3

CnAction String

错误的处理方法中文描述

4.4

EnMessage String

错误详细内容英文描述

4.5

EnAction String

错误的处理方法英文描述

4.6

DefineMessage String

错误信息补充说明

5 Track

5.1 TrackingNumber String

服务商跟踪号码

5.2 ProductCode String

产品代码,参照产品代码表

5.3 SignForPerson String

签收人

5.4 SignForDate String

签收日期

5.5 DestinationCountryCode String

目的地国家代码

5.6 TrackInfo

5.10.1 TrackCode String

轨迹代码,参照轨迹代码表

5.10.2 TrackContent String

轨迹状态描述补充

5.10.3 OccurDate String

轨迹发生时间

5.10.4 OccurAddress String

轨迹发生地点

1.9. 申请拦截

类 型: 在线订单工具

接口名称:cargoHoldService

1.9.1. 请求参数

String

String

Argument Type Required

1 AuthToken String √

2 ReferenceNumber String √

Meaning

调用API唯一标识,由4PX提供

length = 32

引用单号,可以是客户单号或服务商单号

length <= 30

1.9.2. 返回参数

String

String

String

String

String

String

String

String

String

1

2

3

Argument

Timestamp

ReferenceNumber

Ack

Type

String

String

String

Meaning

服务器响应时间

引用单号,一般为客户单号

操作状态

成功: Success

失败: Failure

Error

错误代码

错误详细内容中文描述

错误的处理方法中文描述

错误详细内容英文描述

错误的处理方法英文描述

错误信息补充说明

4

4.1

4.2

4.3

4.4

4.5

4.6

Code

CnMessage

CnAction

EnMessage

EnAction

DefineMessage

String

String

String

String

String

String

1.10. 查询跟踪号

类 型: 在线订单工具

接口名称:findTrackingNumberService

1.10.1. 请求参数

String

String

Argument Type Required

1 AuthToken String √

2 ReferenceNumber String √

Meaning

调用API唯一标识,由4PX提供

length = 32

引用单号,可以是客户单号或服务商单号

length <= 30

1.10.2. 返回参数

String

String

String

String

String

String

String

String

String

String

String

Argument Type Meaning

1

Timestamp String

服务器响应时间

2

ReferenceNumber String

引用单号,一般为客户单号

3

TrackingNumber String

服务商跟踪号码

4

ChannelNumber String

渠道转单号

5

Ack String

操作状态

成功: Success

失败: Failure

6

Error

6.1

Code String

错误代码

6.2

CnMessage String

错误详细内容中文描述

6.3

CnAction String

错误的处理方法中文描述

6.4

EnMessage String

错误详细内容英文描述

6.5

EnAction String

错误的处理方法英文描述

6.6

DefineMessage String

错误信息补充说明