CLP预录入接口 - CTOS接口文档

装箱单报文（转码头）
记录00 HEAD RECORD 头记录 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9(2) 00 M
2 MESSAGE TYPE 报文类型 X(6) COSTCO M
3 FILE DESCRIPTION 文件说明 X(35) CONTAINER LOAD PLAN C
4 FILE FUNCTION 文件功能 X(2) 9=原始 M
5 SENDER CODE 发送方代码 X(13) M
6 RECEIVER CODE 接收方代码 X(13) 转码头，填写实际接收码头代码 M
7 FILE CREATE TIME 文件建立时间 9(12) YYYYMMDDHHMM M
8 SENDER PORT CODE 发送港代码 X(5) C
9 RECEIVER PORT CODE 接收港代码 X(5) C
10 MESSAGE REFERENCE 报文参考号 X(14) C

记录01 OTHER RECEIVERS 其他接收方 C
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9(2) 01 M
2 RECEIVER CODE 接收方代码 X(13) M
3 RECEIVER CODE (1-8) 接收方代码 X(13) C

记录10 VSL. & VOY. FIELDS 描述船舶有关信息 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 10 M
2 VESSEL CODE 船名代码 X (9) M
3 VESSEL 船名 X(35) M
4 VOYAGE 航次 X (11) 包括一位的航向(进口I/出口E) M
5 SHIPPING LINE CODE 船公司代码 X(13) C
6 SHIPPING LINE 船公司 X(35) C
7 LINER ID 班轮 X (1) Y = 班轮 N = 非班轮
H = 核心班轮 C
8 NATIONALITY CODE 船舶国籍代码 X (2) C

记录11 LOAD-DISCHARGE PORT 描述装/卸港信息 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 11 M
2 DISCHARGE PORT CODE 卸货港代码 X (5) M
3 DISCHARGE PORT 卸货港 X(35) C
4 LOAD PORT CODE 装货港代码 X (5) M
5 LOAD PORT 装货港 X(35) C
6 TRANSFER PORT CODE 中转港代码 X (5) M
7 TRANSFER PORT 中转港 X(35) C
8 PLACE CODE OF DELIVERY
交货地代码 X(5) C
9 PLACE OF DELIVERY 交货地 X(70) C

记录50 CONTAINER INFORMATION 描述装箱有关的箱信息 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 50 M
2 CTN. NO. 箱号 X(12) 箱号可留空 C
3 CTN. SIZE & TYPE 集装箱尺寸类型 X (4) M
4 CTN. STATUS 集装箱状态 X (1) F = 整 L = 拼 M
5 I/O 进出口标志 X (1) O = 出口 M
6 STUFFING TIME 装箱时间 9(12) CCYYMMDDHHMM C
7 SEAL NO. 铅封号 X(30) 与箱号对应 C
8 CTN. OPERATOR CODE 箱经营人代码 X(13) M
9 CTN. OPERATOR 箱经营人 X(35) 如果是沿海捎带箱填SD C
10 OVER LENGTH FRONT 前超 9 (4) 厘米 C
11 OVER LENGTH BACK 后超 9 (4) 厘米 C
12 OVER WIDTH RIGHT 右超 9 (4) 厘米 C
13 OVER WIDTH LEFT 左超 9 (4) 厘米 C
14 OVER HEIGHT 超高 9 (4) 厘米 C
15 COSTCO NO. 电子装箱单编号 X (20) M
16 FORWARD NAME 货代 X (10) 码头间转码头填写ZMT M
17 TRADE FLAG 内外贸 X (1) N/W – 内贸/外贸 M
18 TYPIST 操作人代码 X (10) C
19 SEALNO2 2号铅封 X (30) C
20 SEALNO3 3 号铅封 X (30) C

记录59 CFS INFO 疏箱信息 C
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 59 C
2 CUSTIM CONTROL CODE 海关控制代码 X (2) IP/TS C
3 FP_SG 废品/疏港标志 X(2) FP/SG C
4 instruction ID 指令号 X (35) C
5 TRAILER TRADEMARK 拖车牌号 X(17) C
6 DISCHARGE TIME卸船时间 9(12) CCYYMMDDHHMM C

记录51 B/L NO. 提单号信息 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 51 M
2 B/L NO. 提单号 X(20) M

记录52 CARGO INFORMATION 货物信息 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 52 M
2 CARGO SEQUENCE NO. 货物序号 9 (3) M
3 NUMBERS OF PACKAGES 件数 9 (6) 件数（箱内） M
4 PACKAGES KIND CODE 包装类型代码 X (2) M
5 PACKAGES KIND 包装类型 X(35) M
6 CARGO GROSS WEIGHT 货毛重 9(9) V9 千克（箱内） M
7 CARGO MEASUREMENT 货尺码(体积) 9(5) V999 立方（箱内） M
8 TEMPERATURE ID 温度计量单位 X (1) C = 摄氏
F = 华氏 C
9 TEMPERATURE SETTING 设置温度 X(5)
10 MIN. TEMPERATURE 冷藏最低温度 X(5) C
11 MAX. TEMPERATURE 冷藏最高温度 X(5) C
注: 温度中,除正(+)负(-)号及小数点外,最多只能三位数字.

记录53 CARGO DESCRIPTION 货物描述 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 53 M
2 CARGO DESCRIPTION(1-10) 货物描述 X(35) M

记录54 MARKS & NOS. 唛头 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 54 M
2 MARKS (1-10) 唛头 X(35) M

记录55 DANGEROUS INFORMATION 危险品描述 C
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 55 M
2 CLASS 危险品分类 X (5) M
3 PAGE 危险品页号 X (7) M
4 UNDG NO. 联合国危险品编号 9 (4) M
5 LABEL 危险品标签 X(32) M
6 FLASH POINT 危险货物闪点 X (5) 摄氏 C
7 EMS NO. 航运危险品应急措施号 X (6) C
8 MFAG NO. 医疗急救指南号 X (4) C
9 MPT(MARINE POLLUTANT) 海运污染 X(1) Y=有污染 N=无污染 C
注: 危险货物闪点中,除正(+)负(-)号及小数点外,最多只能三位数字.

记录56 CTN.NO. INFORMATION 描述箱有关信息 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9 (2) 56 M
2 CTN. NO. 箱号 X(12) M
3 CTN.NUMBER OF PACKAGE 件数 9 (6) M
4 CTN. TARE WEIGHT 箱皮重 9(5).9 千克（提单） C
5 CTN. NET WEIGHT 箱内货毛重 9(5).9 千克（提单） C
6 CTN. CARGO MEASUREMENT 货尺码(体积) 9(5).999 立方米（提单） C

记录99 TRAILER RECORD 尾记录 M
序号字段名格式注释标记
1 RECORD ID 记录类型标识 9(2) 99 NOT
2 RECORD TOTAL OF FILE 记录总数 9(6) 包括:头、尾记录 NOT

记录结构：
00 头记录 M1
01 其他接收方 C1
10 船舶信息 M1
11 装卸港信息 M1
50 集装箱信息 M1
51 提单号信息 M999
52 货物信息 M1
53 货物描述 M1
54 唛头 M1
55 危险品信息 C1
56 箱号信息 M1
99 尾记录 M1

请求参数

Body 参数application/xml

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:clp="http://clpinsert.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <clp:invoke>
         <!--Optional:-->
         <applydata>00:COSTCO:CONTAINER LOAD PLAN:9:EPORTHUB:BLCT:202406030008:::'10:UN9224506:WANHAI611:W070E:::Y:'11:QAHMD::CNNGB::QAHMD:::'50:FFAU1053369:45GP:F:O:202406030008:CE921403:KMD:::::::ZJYGT240603000803255:MZ:W:ZJYGT::'51:KMTCNBO8016903'52:1:557:CT:CT:8616:68::::'53:17:::::::::'54:N/M:::::::::'56:FFAU1053369:557:3800:8616:68'99:10'</applydata>
      </clp:invoke>
   </soapenv:Body>
</soapenv:Envelope>

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/xml

Bodyapplication/xml

示例

成功示例异常示例

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:invokeResponse xmlns:ns2="http://clpinsert.api.service.ctos3.nbport.com/">
         <return>1::</return>
      </ns2:invokeResponse>
   </soap:Body>
</soap:Envelope>