易港通一般提重接口

POST

/api/ctbusinApi

请求参数

Body 参数application/xml

applyCompanyCode

string

为统一代码中的公司代码（集团结算代码，自提箱默认为ZT）.

必需

applyCompanyId

string

公司ID.由易港通发来

必需

applyCompanyType

string

公司类型。A:船公司、B:货代、C:船代、T:车队、Y:港外堆场、W:无水港

必需

ctnChargeInfo

array[string]

费用信息

必需

ctnresult

array [object {12}]

返回的箱信息

必需

UNVesselName

string

可选

bookingNo

string

提箱条码

可选

carJobnumber

string

作业号

可选

ctnNo

string

箱号

可选

ctnSizeType

string

箱型尺寸

可选

ctnStatus

string

空重

可选

damageFlag

string

残

可选

hazardFlag

string

危

可选

inboundVoyage

string

进口航次

可选

odFlag

string

超

可选

reeferFlag

string

冷

可选

tradeNw

string

内外贸

可选

string

必需

jobId

string

固定项为CTBUSIN

必需

operCode

string

操作类型

必需

/**

(A-查询费用)，

(J-激活计划通知码头【单证、码头、外理】同时获取预约号)，

(U-修改提箱截止时间)，

(C-计划预约取消)，

(Y-预约提箱时间通知码头)

(S-预约提箱时间取消).

(T-通知码头【司机补交费用成功】)，
*/

paymentTerm

string

付费方式

必需

/**

Y（易港通公司代收，现付）

N（易港通公司代收，托收，集卡出场之后才收费）.
*/

plannumber

string

计划号

必需

suitcaseRTime

string

预约提箱截止时间（年-月-日）

必需

suitcaseSRTime

string

（司机）预约提箱开始时间（年-月-日时）.

必需

suitcaseTRTime

string

（司机）预约提箱结束时间（年-月-日时）.

必需

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctb="http://ctbusin.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctb:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{"applyCompanyCode":"NUC","applyCompanyId":"5119","applyCompanyType":"B","ctnChargeInfo":[],"ctnresult":[{"UNVesselName":"CN3104307","bookingNo":"5834671622","carJobnumber":"QEU","ctnNo":"LYGU8027356","ctnSizeType":"22GP","ctnStatus":"F","damageFlag":"N","hazardFlag":"N","inboundVoyage":"24604S","odFlag":"N","reeferFlag":"N","tradeNw":"N"}],"id":"B2SCTY240314235914033816","jobId":"CTBUSIN","operCode":"Y","paymentTerm":"N","plannumber":"ZJYGTSD0000002110872","suitcaseRTime":"2024-03-14","suitcaseSRTime":"2024-03-15 00","suitcaseTRTime":"2024-03-15 01"}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </ctb:invoke>
   </soapenv:Body>
</soapenv:Envelope>

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/ctbusinApi' \
--header 'Content-Type: application/xml' \
--data-raw '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctb="http://ctbusin.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctb:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{"applyCompanyCode":"NUC","applyCompanyId":"5119","applyCompanyType":"B","ctnChargeInfo":[],"ctnresult":[{"UNVesselName":"CN3104307","bookingNo":"5834671622","carJobnumber":"QEU","ctnNo":"LYGU8027356","ctnSizeType":"22GP","ctnStatus":"F","damageFlag":"N","hazardFlag":"N","inboundVoyage":"24604S","odFlag":"N","reeferFlag":"N","tradeNw":"N"}],"id":"B2SCTY240314235914033816","jobId":"CTBUSIN","operCode":"Y","paymentTerm":"N","plannumber":"ZJYGTSD0000002110872","suitcaseRTime":"2024-03-14","suitcaseSRTime":"2024-03-15 00","suitcaseTRTime":"2024-03-15 01"}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </ctb:invoke>
   </soapenv:Body>
</soapenv:Envelope>'

返回响应

🟢200成功

application/xml

Body

msgId

string

必需

plannumber

string

必需

jobId

string

必需

yardMsgInfo

string

必需

string

必需

msgDESC

string

必需

ctnChargeInfo

array[string]

必需

示例

异常示例成功示例

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:invokeResponse xmlns:ns2="http://ctbusin.ygt.api.service.ctos3.nbport.com/">
         <return>{"msgId":"9999","plannumber":"ZJYGTSD0000002110872","jobId":"CTBUSIN","yardMsgInfo":"","id":"B2SCTY240314235914033816","msgDESC":"[报错原因:在场箱数据不存在]","ctnChargeInfo":[]}</return>
      </ns2:invokeResponse>
   </soap:Body>
</soap:Envelope>

修改于 2024-11-25 08:47:21

易港通进重预约接口总入口

浙北补贴箱接口