15. 航班

接口说明

运输商用于包裹上传航班信息。

路径

HTTP Verb	URL
Post	/services/carrier/lineHaul

请求字段

1

Field (API)

Data Type

Length

Mandatory

Details

2

bizType

Number

M

运输类型，当选择如下序号时：

1：Air Transport; 2：Land Transportation

3：Ocean Transport; 4：Railway Transport

3

mawb

String

40

M

航空主单号

4

flightNo

String

80

M

航班号

5

etd

String

19

M

预计出发时间

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-04-12 08:01:02

6

eta

String

19

M

预计到达时间

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-04-12 08:01:02

7

origin

String

80

M

出发地机场代码

8

destination

String

80

M

目的地机场代码

9

totalParcels

String

80

M

包裹数

10

dataType

Number

M

数据类型

此接口支持两种关联方式二选一

小包级别（Tracking No.）
大袋级别（Bag No.）

11

dataNos

List

200

M

当dataType选择 1 的时候应输入Tracking No.

当dataType选择 2 的时候应输入Bag No.

12

atd

String

19

O

实际出发时间

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-05-31 14:20:05

13

ata

String

19

O

实际到达时间

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-05-31 17:30:05

14

airlineCheckIn

String

19

O

航司办理登机手续时间

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-05-31 18:30:05

15

recovery

String

19

O

其他用途字段

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-05-31 18:40:05

16

handoverTime

String

19

O

交货时间

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-05-31 19:30:05

17

rcsTime

String

19

O

其他用途字段

格式：yyyy-MM-dd HH:mm:ss

- 例：2022-05-31 17:30:05

18

via1

String

3

O

经停点1

19

via2

String

3

O

经停点2

20

hawb

String

32

O

航空分单号

21

grossWeight

Double

O

毛重量（单位：Kg）

22

volumetricWeight

Double

O

体积重量（单位：Kg）

23

chargeableWeight

Double

O

计费重量（单位：Kg）

24

comments

String

O

25

remark

String

255

O

备注

响应内容

1	字段	类型	非空	说明
2	status	String	是	Success/Failure
3	code	Number	否	返回代码，请参考以下code和Message关系表
4	message	String	否	响应信息，请参考以下code和Message关系表

1	code	message
2	999400	mawb is required (航空主单号不可以为空）
3	300051	The bag no is error（大袋号错误）
4	140007	XXX Barcode already exists（已经存在）
5	2000000	XXX is required. (XXX字段不可以为空）
6	1002000	Time is invalid. (时间是无效的)
7	1003000	Data is empty（参数为空）

请求报文

Request

{
    "bizType":"1",
    "mawb":"78467878565",
    "flightNo":"CZ455",
    "etd":"2022-04-12 08:01:02",
    "eta":"2022-04-13 08:01:02",
    "origin":"CAN",
    "destination":"AMS",
    "atd":"2022-05-31 14:20:05",
    "ata":"2022-05-31 17:30:05",
    "totalParcels":"2",
    "dataType":1,
    "dataNos":[
               "JB000013817",
               "000013802"
              ]
}

响应报文

Response

{
    "status":"Succeeded",
    "code":0,
    "message":null
}

页面树结构

15. 航班

接口说明

路径

请求字段

响应内容

响应报文