易港通驳空预约接口

POST

/api/ctnBkApi

请求参数

Body 参数application/xml

applyCompanyId

string

申请公司代码唯一标识符 TDDC

必需

applyCompanyType

string

申请公司类别 E

必需

applyContact

string

联系人

必需

applyTel

string

联系电话

必需

applyTime

string

申请时间

必需

applyUser

string

申请用户ID

必需

bkCtn

array [object]

驳箱信息

可选

bkDriver

array [object {12}]

司机预约信息，Y时需要

可选

bkEDTime

string

（司机）预约提箱开始时间例：2019-09-10 08

可选

bkSDTime

string

（司机）预约提箱结束时间例：2019-09-10 10

可选

carJobnumber

string

港区作业号，例：Z50

可选

carTrucklicense

string

集卡车牌号，例：ZJB-12345

可选

driverName

string

提箱司机姓名

可选

driverTel

string

提箱司机电话

可选

rsv1

string

可选

rsv2

string

可选

rsv3

string

可选

rsv4

string

可选

rsv5

string

可选

seqno

string

驳箱序列

可选

bookingNo

string

码头预约号

必需

ctnChargeInfo

array [object]

必需

ctnNumber

string

驳箱个数

必需

ctnOperatorCode

string

箱主代码

必需

epNo

string

中远海ep号

必需

string

必需

jobId

string

CTNBK

必需

operCode

string

操作类型

必需

A：堆场预约
C：堆场取消预约
Y：司机预约
S：司机取消预约

planBeginTime

string

计划提箱时间（起）格式:YYYY-MM-DD HH:mm:ss 如：2015-12-12 09:10:21

必需

planEndTime

string

计划提箱时间（止）格式:YYYY-MM-DD HH:mm:ss 如：2015-12-15 09:10:21

必需

planNumber

string

计划号

必需

sizeType

string

尺寸箱型

必需

tradeNw

string

内外贸标志

必需

vesselNameE

string

英文船名

必需

vesselUnCode

string

必需

vesselVoyage

string

航次

必需

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctn="http://ctnbk.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctn:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{"applyCompanyId":"","applyCompanyType":"","applyContact":"","applyTel":"","applyTime":"2024-05-31 08:39:37","applyUser":"13857460870","bkCtn":[{}],"bkDriver":[{"bkEDTime":"2024-06-02 01:00","bkSDTime":"2024-06-02 00:00","carJobnumber":"DWT","carTrucklicense":"ZJB-5Z118","driverName":"廖旭东","driverTel":"18162018270","rsv1":"","rsv2":"","rsv3":"","rsv4":"","rsv5":"","seqno":"950891939270"}],"bookingNo":"DEG6002659","ctnChargeInfo":[{}],"ctnNumber":"","ctnOperatorCode":"SML","epNo":"","id":"BLCT552026436578082816","jobId":"CTNBK","operCode":"Y","planBeginTime":"","planEndTime":"2024-06-30 08:38:41","planNumber":"ZJYGTBKPL000000052008240","sizeType":"45GP","tradeNw":"","vesselNameE":"","vesselUnCode":"","vesselVoyage":""}</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/ctnBkApi' \
--header 'Content-Type: application/xml' \
--data-raw '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctn="http://ctnbk.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctn:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{"applyCompanyId":"","applyCompanyType":"","applyContact":"","applyTel":"","applyTime":"2024-05-31 08:39:37","applyUser":"13857460870","bkCtn":[{}],"bkDriver":[{"bkEDTime":"2024-06-02 01:00","bkSDTime":"2024-06-02 00:00","carJobnumber":"DWT","carTrucklicense":"ZJB-5Z118","driverName":"廖旭东","driverTel":"18162018270","rsv1":"","rsv2":"","rsv3":"","rsv4":"","rsv5":"","seqno":"950891939270"}],"bookingNo":"DEG6002659","ctnChargeInfo":[{}],"ctnNumber":"","ctnOperatorCode":"SML","epNo":"","id":"BLCT552026436578082816","jobId":"CTNBK","operCode":"Y","planBeginTime":"","planEndTime":"2024-06-30 08:38:41","planNumber":"ZJYGTBKPL000000052008240","sizeType":"45GP","tradeNw":"","vesselNameE":"","vesselUnCode":"","vesselVoyage":""}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </ctn:invoke>
   </soapenv:Body>
</soapenv:Envelope>'

返回响应

🟢200成功

application/xml

Body

allowFlag

string

必需

applyNo

string

必需

barCode

string

必需

bookingNo

string

必需

changeAdd

string

必需

checkValue

string

必需

string

必需

invoiceNote

string

必需

jobId

string

必需

msgDESC

string

必需

msgId

string

必需

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://ctnbk.ygt.api.service.ctos3.nbport.com/">
         <return>{"allowFlag":"","applyNo":"","barCode":"","bookingNo":"","changeAdd":"","checkValue":"","id":"BLCT552026436578082816","invoiceNote":"","jobId":"CTNBK","msgDESC":"[接口参数错误][报错原因:当OperCode是Y时（司机）预约提箱实际可预约数不足]","msgId":"9999","plannumber":"","reserve1":"","reserve2":"","reserve3":"","reserve4":"","reserve5":"","result":null,"rsv1":"","rsv2":"","rsv3":"","rsv4":"","rsv5":"","yardMsgInfo":""}</return>
      </ns2:invokeResponse>
   </soap:Body>
</soap:Envelope>

修改于 2024-11-26 02:34:05

易港通管空预约接口

invoke