帮助中心
3.5.2 海运综合订阅推送

# 1.描述

  • 推送说明 当调用了【海运综合订阅查询】接口且配置了回调接口后,在船司、港区、港区船计划数据任何一部分数据首次获取成功或者后续任何一部分数据有变化后,壹沓会采用全量(所有字段)的方式调用回调接口,推送数据给客户
  • 注意事项 请在收到推送请求后第一时间返回HTTP状态码STATUS=200,我方才认为本次推送成功。如果500ms之后没有收到200响应,会认定本次推送异常,并发起重试推送。重试次数3次,每次间隔2分钟

# 2.推送请求方式

  • POST
  • Content-Type: application/json

# 3.通用请求参数

参数名 必选 类型 说明
customerId string 客户id
refreshTime string 数据更新时间
dataType Integer 数据类型 1-船司 2-港口 3-船计划 4-空运 7-美国码头 8-海运综合
data Object 数据

# 4. 业务请求参数

参数名 类型 说明
carrierCd string 船司代码 (订阅时的传参)
yxbCarrierCd string 物流可视规则匹配上的船司代码
subNo string 订阅单号 (订阅时的传参)
extraInfo string 扩展信息(订阅时的传参)
portCd string 港区代码 (订阅时的传参)
importAndExportFlag string 进出口标识 (订阅时的传参)
isCompleted string 流程是否结束 Y-是 N-否 (船司港区均结束时为Y,否则为N;)
bkgNo string 订舱号
blNo string 提单号
pol string 起运港
polCd string 起运港五字码
dtp string 目的港
dtpCd string 目的港五字码
reception string 起运地
receptionCd string 起运地五字码
destination string 目的地
destinationCd string 目的地五字码
terminalCd string 目的港码头代码
terminal string 目的港码头名称
vslNameEnL string 目的港船名
voyL string 目的港航次
vslNameEnF string 起运港船名
voyF string 起运港航次
transshipmentPort string 转运港
etdPol string 起运港最新预计离港时间 (若官网不再提供该时间,我们会保留最后一次获取到的时间)
etaPld string 目的港最新预计到港时间 (若官网不再提供该时间,我们会保留最后一次获取到的时间)
ataPld string 目的港到港时间
atdPol string 起运港离港时间
etaDestination string 目的地预计到达时间
estimatedOnboardDate string 起运港预计装船时间
routingInfoList Array 航段信息
routeFlag Integer 航程 1-n
containerNo string 箱号
blNo string 提单号(目前仅EMC会存在)
loading string 起运港/装货港
loadingCd string 起运港/装货港五字码
discharging string 目的港/卸货港
dischargingCd string 目的港/卸货港五字码
vslName string 船名
voy string 航次
legType string 航段类型(F: 首程,T: 中转港, L:最后一程, N: 直达)
etd string 预计开航时间 (若官网不再提供该时间,我们会保留最后一次获取到的时间)
atd string 实际开航时间
eta string 预计到达时间 (若官网不再提供该时间,我们会保留最后一次获取到的时间)
ata string 实际到达时间
containerInfoList Array 集装箱信息
containerNo string 箱号
blNo string 箱子所属的提单号
size string 尺寸
containerType string 箱型
sealNo string 铅封号
boxPosition string 场箱位
statusDesc string 箱状态描述
containerHolder string 箱属(持箱人)
containerPieces string 箱总件数
containerWeight string 箱总毛重
containerVolume string 箱总体积
tareWeight string 箱皮重
customsClearance string 海放(官方原始值) , 部分港区支持,具体见 支持的港区 (opens new window)
customsClearanceFlag string 海放标记(壹沓标准映射,Y/N) , 部分港区支持,具体见 支持的港区 (opens new window)
customsClearanceTime string 海放时间,部分港区支持,具体见 支持的港区 (opens new window)
terminalClearance string 码放(官方原始值) , 部分港区支持,具体见 支持的港区 (opens new window)
terminalClearanceFlag string 码放标记(壹沓标准映射,Y/N) , 部分港区支持,具体见 支持的港区 (opens new window)
terminalClearanceTime string 码放时间 , 部分港区支持,具体见 支持的港区 (opens new window)
importVessel string 进口英文船名
importVesselName string 进口中文船名
importVoyage string 进口航次
vslNameZh string 出口中文船名
vslNameEn string 出口船名
voy string 出口航次
transshipmentPort string 转运港
emptyOrFull string 空重 (官方原始值)
emptyOrFullFlag string 空重标记 (壹沓标准映射,E/F)
vgmFlag string vgm标识 (部分港区支持,具体见支持的港区 (opens new window)
vgmWharfWeighing string VGM码头称重
vgmShip string VGM称重(船公司)
vgmMessageReceiving string VGM报文接收时间
shipTo string 运抵状态(官方原始值)
shipToFlag String 运抵状态标记(壹沓标准映射,Y/N)
arrivalMessageSendingTime string 运抵报文发送时间
maritimeAffairs string 海事
nationalInspection string 国检
externalManagement string 外理
storageDays string 堆存天数
triplicate string 三联单状态
manifest string 预配舱单 (部分港区支持,具体见支持的港区 (opens new window)
manifestSendingTime string 舱单发送时间 (部分港区支持,具体见支持的港区 (opens new window)) )
customsInspection string 海关查验
customsArea string 关区 (部分港区支持,具体见支持的港区 (opens new window)
messageType string 报文类型 (部分港区支持,具体见支持的港区 (opens new window)
receiptContent string 回执内容 (部分港区支持,具体见支持的港区 (opens new window)
carNumber string 拖车号
freezerSign string 冷冻箱标志 (部分港区支持,具体见支持的港区 (opens new window)
freezingTemperature string 冷冻温度 (部分港区支持,具体见支持的港区 (opens new window)
ventilation string 通风 (部分港区支持,具体见支持的港区 (opens new window)
heightExceed string 超高 (部分港区支持,具体见支持的港区 (opens new window)
unNumber string 危险品/联合国编号 (部分港区支持,具体见支持的港区 (opens new window)
overrunCode string 超限代码 (部分港区支持,具体见支持的港区 (opens new window)
frontBackExceed string 前/后超长(CM) (部分港区支持,具体见支持的港区 (opens new window)
leftRightExceed string 左/右超宽(CM) (部分港区支持,具体见支持的港区 (opens new window)
declareInfoList Array 报关信息
subOrderNo string 分提单号
pieces string 件数
weight string 重量
volume string 体积
customsDeclarationNo string 报关单号
customsClearance string 海关放行
customsClearanceTime string 海放时间
operation string 船公司操作
detailsPlanList Array 集装箱改配计划集合
planType string 计划类型
operationProcess string 操作过程
acceptanceTime string 受理时间
scheduledStartTime string 计划开始时间
scheduledEndTime string 计划结束时间
status string 状态
containerStatusInfoList Array 集装箱状态信息
containerNo string 箱号
statusCd string 状态代码, 如ECPU代表提空箱; 具体见箱动态代码 (opens new window)
statusTime string 状态时间 ;如提空箱时间
isEst string 是否预计时间(Y=是,N=否)
statusPlace string 状态地点
vslName string 船名
voy string 航次
statusDescription string 状态描述
statusTerminal string 码头
source string 0/1/2/3四种,0代表物流可视默认值,1代表港区箱货,2代表船计划,3代表船司
terminalPlanList Array 港区船计划信息
fetchTime string 获取数据时间
wharf string 码头名称
status string 靠泊状态
vslNameZh string 中文船名
vslNameEn string 英文船名
importVoy string 进口航次
exportVoy string 出口航次
loadAtWharfST string 进箱开始时间
loadAtWharfDT string 进箱截止时间
terminalCutOffTime string 港区截单时间
etb string 计划靠泊时间
atb string 实际靠泊时间
predictionOrConfirmation string 预报/确报
eta string 预计到港时间
ata string 实际到港时间
etd string 预计离港时间
atd string 实际离港时间
position string 抵港位置
vesselType string 船舶类型
previousPort string 上一港
agent string 船代
closingTime string 关闸时间
approachEndTime string 截止进场时间
**portInfoList ** Array 港口信息
containerNo string 箱号
blNo string 提单号
type Integer 港口类型 1- 起运地 2- 起运港 3-中转港 4-目的港 5-目的地
location string 港口名称
locationCd string 港口五字码
eta string 预计到达时间
ata string 实际到达时间
vslNameArrive string 到达船名
voyArrive string 到达航次
etd string 预计出发时间
atd string 实际出发时间
vslNameDeparture string 出发船名
voyDeparture string 出发航次

# 5.请求示例

{
    "customerId":"1",
    "dataType":8,
    "refreshTime":"2023-03-17 14:10:35",
    "data":{
        "portCd":"CNSHA",
        "importAndExportFlag":"I",
        "carrierCd":"HMM",
        "subNo":"HDMUPUSA84679100",
        "extraInfo":null,
        "yxbCarrierCd":"HMM",
        "terminalCd":"",
        "terminalPlanList":[
            {
                "exportVoy":"0143W",
                "terminalCutOffTime":null,
                "agent":"鹏海船代",
                "importVoy":"0142E",
                "predictionOrConfirmation":"确报",
                "loadAtWharfDT":null,
                "atb":"2023-03-1506:00:00",
                "ata":"2023-03-1402:00:00",
                "atd":"2023-03-1604:00:00",
                "vesselType":"全集装箱船",
                "etb":"2023-03-1505:30:00",
                "eta":"2023-03-1402:00:00",
                "vslNameEn":"HYUNDAITOKYO",
                "etd":"2023-03-1604:00:00",
                "closingTime":"",
                "approachEndTime":"",
                "fetchTime":"1679414347794",
                "wharf":"振东(外2)",
                "position":"长江口",
                "loadAtWharfST":null,
                "previousPort":"光阳",
                "status":"已离泊",
                "vslNameZh":"现代东京"
            }
        ],
        "estimatedOnboardDate":"",
        "etaDestination":null,
        "blNo":"PUSA84679100",
        "routingInfoList":[
            {
                "loadingCd":"KRBUS",
                "voy":"0143W",
                "containerNo":"CRYU9802966",
                "routeFlag":1,
                "blNo":"",
                "legType":"N",
                "vslName":"HYUNDAITOKYO",
                "loading":"BUSAN,KOREA",
                "ata":"2023-03-1506:00:00",
                "atd":"2023-03-1020:00:00",
                "dischargingCd":"CNSHA",
                "discharging":"SHANGHAI,CHINA",
                "eta":null,
                "etd":null
            }
        ],
        "portInfoList":[
            {
                "containerNo":"CRYU9802966",
                "blNo":"PUSA84679100",
                "vslNameArrive":"",
                "type":1,
                "vslNameDeparture":"",
                "ata":null,
                "locationCd":"KRBUS",
                "atd":null,
                "voyArrive":"",
                "eta":null,
                "etd":null,
                "voyDeparture":"",
                "location":"BUSAN,KOREA"
            },
            {
                "containerNo":"CRYU9802966",
                "blNo":"PUSA84679100",
                "vslNameArrive":"",
                "type":2,
                "vslNameDeparture":"HYUNDAITOKYO",
                "ata":null,
                "locationCd":"KRBUS",
                "atd":"2023-03-1020:00:00",
                "voyArrive":"",
                "eta":null,
                "etd":null,
                "voyDeparture":"0143W",
                "location":"BUSAN,KOREA"
            },
            {
                "containerNo":"CRYU9802966",
                "blNo":"PUSA84679100",
                "vslNameArrive":"HYUNDAITOKYO",
                "type":4,
                "vslNameDeparture":"",
                "ata":"2023-03-1506:00:00",
                "locationCd":"CNSHA",
                "atd":null,
                "voyArrive":"0143W",
                "eta":null,
                "etd":null,
                "voyDeparture":"",
                "location":"SHANGHAI,CHINA"
            },
            {
                "containerNo":"CRYU9802966",
                "blNo":"PUSA84679100",
                "vslNameArrive":"",
                "type":5,
                "vslNameDeparture":"",
                "ata":null,
                "locationCd":"CNSHA",
                "atd":null,
                "voyArrive":"",
                "eta":null,
                "etd":null,
                "voyDeparture":"",
                "location":"SHANGHAI,CHINA"
            }
        ],
        "bkgNo":"PUSA84679100",
        "destination":"SHANGHAI,CHINA",
        "destinationCd":"CNSHA",
        "containerStatusInfoList":[
            {
                "isEst":"N",
                "voy":"",
                "containerNo":"CRYU9802966",
                "statusDescription":"ExportEmptyContainerReleased",
                "statusTime":"2023-02-2800:02:00",
                "vslName":"",
                "statusCd":"ECPU",
                "source":0,
                "statusPlace":"BUSAN,KOREA",
                "statusTerminal":""
            },
            {
                "isEst":"N",
                "voy":"",
                "containerNo":"CRYU9802966",
                "statusDescription":"ExportTruckGateIntoTerminal",
                "statusTime":"2023-03-0814:30:00",
                "vslName":"",
                "statusCd":"GIPOL",
                "source":0,
                "statusPlace":"BUSAN,KOREA",
                "statusTerminal":""
            },
            {
                "isEst":"N",
                "voy":"0143W",
                "containerNo":"CRYU9802966",
                "statusDescription":"VesselLoadingatPOL",
                "statusTime":"2023-03-1018:55:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"LOAD",
                "source":0,
                "statusPlace":"BUSAN,KOREA",
                "statusTerminal":""
            },
            {
                "isEst":"N",
                "voy":"0143W",
                "containerNo":"CRYU9802966",
                "statusDescription":"VesselDeparturefromPOL",
                "statusTime":"2023-03-1020:00:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"DPOL",
                "source":0,
                "statusPlace":"BUSAN,KOREA",
                "statusTerminal":""
            },
            {
                "isEst":"N",
                "voy":"0142E",
                "containerNo":"CRYU9802966",
                "statusDescription":"",
                "statusTime":"2023-03-1402:00:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"ETA",
                "source":0,
                "statusPlace":"CNSHA",
                "statusTerminal":"振东(外2)"
            },
            {
                "isEst":"Y",
                "voy":"0142E",
                "containerNo":"CRYU9802966",
                "statusDescription":"",
                "statusTime":"2023-03-1402:00:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"APOD",
                "source":0,
                "statusPlace":"CNSHA",
                "statusTerminal":"振东(外2)"
            },
            {
                "isEst":"N",
                "voy":"0142E",
                "containerNo":"CRYU9802966",
                "statusDescription":"",
                "statusTime":"2023-03-1402:00:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"APOD",
                "source":0,
                "statusPlace":"CNSHA",
                "statusTerminal":"振东(外2)"
            },
            {
                "isEst":"Y",
                "voy":"0142E",
                "containerNo":"CRYU9802966",
                "statusDescription":"",
                "statusTime":"2023-03-1505:30:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"BPOD",
                "source":0,
                "statusPlace":"CNSHA",
                "statusTerminal":"振东(外2)"
            },
            {
                "isEst":"N",
                "voy":"0142E",
                "containerNo":"CRYU9802966",
                "statusDescription":"",
                "statusTime":"2023-03-1506:00:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"BPOD",
                "source":0,
                "statusPlace":"CNSHA",
                "statusTerminal":"振东(外2)"
            },
            {
                "isEst":"N",
                "voy":"0142E",
                "containerNo":"CRYU9802966",
                "statusDescription":"卸船进场",
                "statusTime":"2023-03-1509:41:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"DIPOD",
                "source":0,
                "statusPlace":"",
                "statusTerminal":"振东(外2)"
            },
            {
                "isEst":"N",
                "voy":"0142E",
                "containerNo":"CRYU9802966",
                "statusDescription":"单提空箱",
                "statusTime":"2023-03-1613:49:00",
                "vslName":"HYUNDAITOKYO",
                "statusCd":"GOPOD",
                "source":0,
                "statusPlace":"",
                "statusTerminal":"振东(外2)"
            }
        ],
        "pol":"BUSAN,KOREA",
        "polCd":"KRBUS",
        "vslNameEnF":"HYUNDAITOKYO",
        "voyF":"0143W",
        "etdPol":null,
        "dtpCd":"CNSHA",
        "receptionCd":"KRBUS",
        "vslNameEnL":"HYUNDAITOKYO",
        "voyL":"0142E",
        "reception":"BUSAN,KOREA",
        "etaPld":"2023-03-1402:00:00",
        "isCompleted":"Y",
        "dtp":"SHANGHAI,CHINA",
        "atdPol":"2023-03-1020:00:00",
        "terminal":"振东(外2)",
        "ataPld":"2023-03-1402:00:00",
        "containerInfoList":[
            {
                "blNo":"",
                "containerHolder":"SOC",
                "freezingTemperature":"",
                "containerVolume":"1.000",
                "transshipmentPort":"/",
                "importVessel":"HYUNDAITOKYO",
                "messageType":"",
                "terminalClearance":"N",
                "shipToFlag":"N",
                "importVoyage":"0142E",
                "maritimeAffairs":"N",
                "triplicate":"",
                "frontBackExceed":"/",
                "carNumber":"",
                "vgmShip":"",
                "freezerSign":"",
                "size":"20'TK8'6''",
                "vslNameEn":"",
                "emptyOrFull":"",
                "vslNameZh":"",
                "customsArea":"",
                "customsClearanceFlag":"Y",
        				"customsClearanceTime": "2023-05-05 11:04:57",
        				"terminalClearanceTime": null,
                "containerNo":"CRYU9802966",
                "vgmWharfWeighing":"",
                "manifestSendingTime":null,
                "ventilation":"",
                "containerWeight":"3840",
                "receiptContent":"",
                "externalManagement":"",
                "storageDays":"",
                "unNumber":"",
                "customsClearance":"Y",
                "declareInfoList":[
                    {
                        "pieces":"1",
                        "volume":"1",
                        "subOrderNo":"HDMUPUSA84679100",
                        "customsClearance":"特殊核销",
                        "customsDeclarationNo":"222520233000001384",
                        "weight":"0",
                        "customsClearanceTime":null,
                        "operation":""
                    }
                ],
                "heightExceed":"",
                "terminalClearanceFlag":"N",
                "voy":"",
                "customsInspection":"",
                "overrunCode":"",
                "importVesselName":"现代东京",
                "statusDesc":"IE/进口空箱",
                "sealNo":"NIL",
                "nationalInspection":"",
                "containerType":"",
                "manifest":"",
                "leftRightExceed":"/",
                "vgmFlag":"",
                "detailsPlanList":[
                    {
                        "operationProcess":"场―车",
                        "planType":"单提空箱(上海市内)",
                        "scheduledStartTime":"2023-03-1600:00:00",
                        "acceptanceTime":"2023-03-1608:52:00",
                        "scheduledEndTime":"2023-03-1723:59:00",
                        "status":"完成"
                    }
                ],
                "containerPieces":"1.000",
                "boxPosition":"场外",
                "arrivalMessageSendingTime":null,
                "vgmMessageReceiving":null,
                "emptyOrFullFlag":"",
                "tareWeight":"3840",
                "shipTo":"N"
            },
            {
                "blNo":"",
                "containerHolder":"SOC",
                "freezingTemperature":"",
                "containerVolume":"1.000",
                "transshipmentPort":"/",
                "importVessel":"HYUNDAITOKYO",
                "messageType":"",
                "terminalClearance":"N",
                "shipToFlag":"",
                "importVoyage":"0142E",
                "maritimeAffairs":"N",
                "triplicate":"",
                "frontBackExceed":"/",
                "carNumber":"",
                "vgmShip":"",
                "freezerSign":"",
                "size":"20'TK8'6''",
                "vslNameEn":"",
                "emptyOrFull":"",
                "vslNameZh":"",
                "customsArea":"",
                "customsClearanceFlag":"Y",
                "containerNo":"CRYU9803448",
                "vgmWharfWeighing":"",
                "manifestSendingTime":null,
                "ventilation":"",
                "containerWeight":"3840",
                "receiptContent":"",
                "externalManagement":"",
                "storageDays":"",
                "unNumber":"",
                "customsClearance":"Y",
                "declareInfoList":[
                    {
                        "pieces":"1",
                        "volume":"1",
                        "subOrderNo":"HDMUPUSA84679100",
                        "customsClearance":"特殊核销",
                        "customsDeclarationNo":"222520233000001384",
                        "weight":"0",
                        "customsClearanceTime":null,
                        "operation":""
                    }
                ],
                "heightExceed":"",
                "terminalClearanceFlag":"N",
                "voy":"",
                "customsInspection":"",
                "overrunCode":"",
                "importVesselName":"现代东京",
                "statusDesc":"IE/进口空箱",
                "sealNo":"NIL",
                "nationalInspection":"",
                "containerType":"",
                "manifest":"",
                "leftRightExceed":"/",
                "vgmFlag":"",
                "detailsPlanList":[
                    {
                        "operationProcess":"场―车",
                        "planType":"单提空箱(上海市内)",
                        "scheduledStartTime":"2023-03-1600:00:00",
                        "acceptanceTime":"2023-03-1608:52:00",
                        "scheduledEndTime":"2023-03-1723:59:00",
                        "status":"完成"
                    }
                ],
                "containerPieces":"1.000",
                "boxPosition":"场外",
                "arrivalMessageSendingTime":null,
                "vgmMessageReceiving":null,
                "emptyOrFullFlag":"",
                "tareWeight":"3840",
                "shipTo":"N"
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
最近更新时间: { "value": "2023-07-20", "effect": true }