易港通管空预约接口 - CTOS接口文档

请求参数

Body 参数application/xml

string

必需

RSV1

string

可选

RSV10

string

可选

RSV2

string

可选

RSV3

string

可选

RSV4

string

可选

RSV5

string

可选

RSV6

string

可选

RSV7

string

可选

RSV8

string

可选

RSV9

string

可选

barCode

string

条形码

必需

blNo

string

提单号

必需

ctnOperatorCode

string

箱主代码

必需

ctnSizeType

string

尺寸箱型

必需

damageFlag

string

残损标记

必需

destinationPort

string

目的港

必需

eirNo

string

eir号

必需

hazardFlag

string

危险品标记

必需

jobId

string

CTNTK

必需

odFlag

string

超限箱标记

必需

operCode

string

必需

/**

操作类型

D
*/

planNumber

string

planNumber

必需

reeferFlag

string

冷箱标记

必需

releaseDetail

array[string]

必需

remarks

string

必需

shipRemarks

object

必需

demand

string

必需

destination

string

必需

innerVesselVoyage

string

必需

l5Flag

string

必需

oneWayFlag

string

必需

oneWayNo

string

必需

reeferflag

string

必需

vesselEirNo

string

必需

subscribFlag

string

必需

subscribTerm

string

必需

tkAddress

string

必需

tkDriver

array [object {11}]

必需

carJobnumber

string

港区作业号

可选

carTrucklicense

string

集卡车牌号

可选

driverName

string

提箱司机姓名

可选

driverTel

string

提箱司机电话

可选

rsv1

string

可选

rsv2

string

可选

rsv3

string

可选

rsv4

string

可选

rsv5

string

可选

tkEDTime

string

（司机）预约提箱开始时间

可选

tkSDTime

string

（司机）预约提箱结束时间

可选

tkValidity

string

必需

tkValidityBegin

string

必需

transferPort

string

可选

vesselNameE

string

船舶英文船名

必需

vesselUnCode

string

船舶UN代码

必需

vesselVoyage

string

航次代码

必需

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctn="http://ctntk.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctn:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{
  "ID": "lxdV9RUyCHWSoaQfF5",
  "RSV1": "浙江天时利蜻蜓供应链科技有限公司",
  "RSV10": "",
  "RSV2": "",
  "RSV3": "",
  "RSV4": "105",
  "RSV5": "15",
  "RSV6": "DC60956450",
  "RSV7": "",
  "RSV8": "",
  "RSV9": "W",
  "barCode": "933126292498",
  "blNo": "QTNGBCB24019542",
  "ctnOperatorCode": "RCL",
  "ctnSizeType": "45GP",
  "damageFlag": "",
  "destinationPort": "RIYADH",
  "eirNo": "QTNGBCB24019542001",
  "hazardFlag": "",
  "jobId": "CTNTK",
  "odFlag": "",
  "operCode": "Y",
  "planNumber": "ZJYGTTKC240602sKyeh3",
  "reeferFlag": "",
  "releaseDetail": [],
  "remarks": "",
  "shipRemarks": {
    "demand": "",
    "destination": "",
    "innerVesselVoyage": "",
    "l5Flag": "",
    "oneWayFlag": "",
    "oneWayNo": "",
    "reeferflag": "",
    "vesselEirNo": ""
  },
  "subscribFlag": "N",
  "subscribTerm": "N",
  "tkAddress": "通达堆场",
  "tkDriver": [
    {
      "carJobnumber": "LU3",
      "carTrucklicense": "ZJB-86B10",
      "driverName": "刘明久",
      "driverTel": "18119570868",
      "rsv1": "",
      "rsv2": "01",
      "rsv3": "",
      "rsv4": "",
      "rsv5": "",
      "tkEDTime": "2024-06-03 06",
      "tkSDTime": "2024-06-03 04"
    }
  ],
  "tkValidity": "2024-06-08 00:00:00",
  "tkValidityBegin": "",
  "transferPort": "SADMM",
  "vesselNameE": "WAN HAI 611",
  "vesselUnCode": "UN9224506",
  "vesselVoyage": "W070"
}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </ctn:invoke>
   </soapenv:Body>
</soapenv:Envelope>

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/ctnTkApi' \
--header 'Content-Type: application/xml' \
--data-raw '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctn="http://ctntk.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctn:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{
  "ID": "lxdV9RUyCHWSoaQfF5",
  "RSV1": "浙江天时利蜻蜓供应链科技有限公司",
  "RSV10": "",
  "RSV2": "",
  "RSV3": "",
  "RSV4": "105",
  "RSV5": "15",
  "RSV6": "DC60956450",
  "RSV7": "",
  "RSV8": "",
  "RSV9": "W",
  "barCode": "933126292498",
  "blNo": "QTNGBCB24019542",
  "ctnOperatorCode": "RCL",
  "ctnSizeType": "45GP",
  "damageFlag": "",
  "destinationPort": "RIYADH",
  "eirNo": "QTNGBCB24019542001",
  "hazardFlag": "",
  "jobId": "CTNTK",
  "odFlag": "",
  "operCode": "Y",
  "planNumber": "ZJYGTTKC240602sKyeh3",
  "reeferFlag": "",
  "releaseDetail": [],
  "remarks": "",
  "shipRemarks": {
    "demand": "",
    "destination": "",
    "innerVesselVoyage": "",
    "l5Flag": "",
    "oneWayFlag": "",
    "oneWayNo": "",
    "reeferflag": "",
    "vesselEirNo": ""
  },
  "subscribFlag": "N",
  "subscribTerm": "N",
  "tkAddress": "通达堆场",
  "tkDriver": [
    {
      "carJobnumber": "LU3",
      "carTrucklicense": "ZJB-86B10",
      "driverName": "刘明久",
      "driverTel": "18119570868",
      "rsv1": "",
      "rsv2": "01",
      "rsv3": "",
      "rsv4": "",
      "rsv5": "",
      "tkEDTime": "2024-06-03 06",
      "tkSDTime": "2024-06-03 04"
    }
  ],
  "tkValidity": "2024-06-08 00:00:00",
  "tkValidityBegin": "",
  "transferPort": "SADMM",
  "vesselNameE": "WAN HAI 611",
  "vesselUnCode": "UN9224506",
  "vesselVoyage": "W070"
}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </ctn:invoke>
   </soapenv:Body>
</soapenv:Envelope>'

返回响应

🟢200成功

application/xml

Body

java.lang.String

allowFlag

string

必需

applyNo

string

可选

barCode

string

条码

可选

bookingNo

string

可选

changeAdd

string

必需

string

必需

invoiceNote

string

可选

jobId

string

可选

msgDESC

string

码头返回定位错误信息，如有多个则用|隔开

必需

msgId

string

四位数字错误按照同一错误代码里返回， 0000 表示业务受理成功 1111 表示接收成功 9999 其他码头错误

必需

plannumber

string

必需

reserve1

string

可选

reserve2

string

可选

reserve3

string

可选

reserve4

string

可选

reserve5

string

可选

result

null

可选

rsv1

string

可选

rsv2

string

可选

rsv3

string

可选

rsv4

string

可选

rsv5

string

可选

yardMsgInfo

string

码头内部错误原因

可选

示例

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:invokeResponse xmlns:ns2="http://ctntk.ygt.api.service.ctos3.nbport.com/">
         <return>{"allowFlag":"Y","applyNo":"","barCode":"","bookingNo":"","changeAdd":"","checkValue":"","id":"lxdV9RUyCHWSoaQfF5","invoiceNote":"","jobId":"CTNTK","msgDESC":"","msgId":"0000","plannumber":"ZJYGTTKC240602sKyeh3","reserve1":"","reserve2":"","reserve3":"","reserve4":"","reserve5":"","result":null,"rsv1":"","rsv2":"","rsv3":"","rsv4":"","rsv5":"","yardMsgInfo":""}</return>
      </ns2:invokeResponse>
   </soap:Body>
</soap:Envelope>