还空、集港预约

POST

/api/recvEmptyCtnApi

请求参数

Body 参数application/xml

Ctnresult

object

箱信息对象

必需

UNVesselName

string

船舶UN代码

必需

carJobnumber

string

作业号

必需

carLicense

string

集卡

必需

ctnNo

string

箱号

必需

ctnOperatorCode

string

箱主

必需

ctnSizeType

string

箱型尺寸

必需

ctnStatus

string

空重

必需

deliveryPlace

string

提箱地

必需

deliveryReceitpNo

string

交接单号

必需

hazardFlag

string

危

可选

inboundVoyage

string

进口航次

必需

inspectPlace

string

验箱堆场

可选

inspectTime

string

验箱时间

可选

inspected

string

是否验箱

可选

odFlag

string

超

可选

receivePlace

string

收箱地

可选

reeferFlag

string

冷

可选

tradeNw

string

内外贸

必需

vesselNameC

string

中文船名

必需

vesselNameE

string

英文船名

必需

string

必需

Plannumber

string

计划号

必需

SuitcaseRTime

string

预约还空时间

必需

SuitcaseSRTime

string

（司机）预约还空开始时间

必需

SuitcaseTRTime

string

预约还空时间

必需

jobId

string

业务类型jobId CTBUSREE或CTBUSRJG

必需

operCode

string

U:预约 C:取消预约

必需

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rec="http://recvemptyctn.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <rec:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{"Ctnresult":{"UNVesselName":"CN3104383","carJobnumber":"8LV","carLicense":"ZJB-3Z276","ctnNo":"SEGU3475591","ctnOperatorCode":"NUC","ctnSizeType":"20GP","ctnStatus":"E","deliveryPlace":"","deliveryReceitpNo":"","hazardFlag":"","inboundVoyage":"2403S","inspectPlace":"","inspectTime":"","inspected":"N","odFlag":"","receivePlace":"","reeferFlag":"","tradeNw":"N","vesselNameC":"正吉8","vesselNameE":"ZHENGJI8"},"ID":"BLCTRU240603000333118693","Plannumber":"BLCTRU240603000333118693","SuitcaseRTime":"2024-06-03","SuitcaseSRTime":"2024-06-03 00","SuitcaseTRTime":"2024-06-03 01","jobId":"CTBUSREE","operCode":"U"}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </rec:invoke>
   </soapenv:Body>
</soapenv:Envelope>

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/recvEmptyCtnApi' \
--header 'Content-Type: application/xml' \
--data-raw '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:rec="http://recvemptyctn.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <rec:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{"Ctnresult":{"UNVesselName":"CN3104383","carJobnumber":"8LV","carLicense":"ZJB-3Z276","ctnNo":"SEGU3475591","ctnOperatorCode":"NUC","ctnSizeType":"20GP","ctnStatus":"E","deliveryPlace":"","deliveryReceitpNo":"","hazardFlag":"","inboundVoyage":"2403S","inspectPlace":"","inspectTime":"","inspected":"N","odFlag":"","receivePlace":"","reeferFlag":"","tradeNw":"N","vesselNameC":"正吉8","vesselNameE":"ZHENGJI8"},"ID":"BLCTRU240603000333118693","Plannumber":"BLCTRU240603000333118693","SuitcaseRTime":"2024-06-03","SuitcaseSRTime":"2024-06-03 00","SuitcaseTRTime":"2024-06-03 01","jobId":"CTBUSREE","operCode":"U"}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </rec:invoke>
   </soapenv:Body>
</soapenv:Envelope>'

返回响应

🟢200成功

application/xml

Body

string

必需

jobId

string

业务类型

必需

msgId

string

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

必需

plannumber

string

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

必需

示例

异常示例成功示例

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><ns2:invokeResponse xmlns:ns2="http://recvemptyctn.ygt.api.service.ctos3.nbport.com/"><return>{"checkValue":"","id":"BLCTRU240603000333118693","jobId":"CTBUSREE","msgDESC":"[参数-箱号:SEGU3475591][原因:该箱正在进场或已经进场，请联系调度确认是否航次关闭]","msgId":"9999","plannumber":"BLCTRU240603000333118693"}</return></ns2:invokeResponse></soap:Body></soap:Envelope>

修改于 2025-02-21 01:38:28

船期信息接口

出口特种箱申报及预录入接口