浙北补贴箱接口

POST

/api/ctbuschApi

按政策规定，浙北区域经宁波港出运的集装箱（重箱）在到达干线码头后须给予优先保
障，所以在集装箱运抵码头前，浙北系统必须事先通知码头浙北出运箱的相关信息，方便码
头做好识别标记，以便后续操作
1、考虑由浙北平台通过 webservice 的方式将浙北标记推送至各出运码头；
2、发送时机：货代在浙北平台下单后，经兴港、泰利等受理后推送至各下游子系统，
待下游系统完成接单后，浙北自动将浙北标记信息推送至码头，具体流程如下：

请求参数

Body 参数application/xml

feeInfos

array [object {3}]

费用信息

必需

amount

integer

金额

可选

itemCode

string

明细费目代码

可选

itemName

string

明细费目名称

可选

reason

string

不可补贴原因（中文描述）

必需

blNo

string

提单号

必需

orderId

string

订单号

必需

operCode

string

操作类型

必需

truckLicense

string

车牌号

必需

batch

string

批次号

必需

msgId

string

必需

/**

四位数字

0000 表示成功

1111 表示数据接收成功（异步）

9999 其他错误.
*/

ctnSizeType

string

箱型尺寸

必需

voyage

string

航次

必需

jobId

string

业务类型 SENDCTNSUBSIDY

必需

outDoorTime

string

出门时间

必需

vesselIe

string

进出口类型

必需

actualLocation

string

码头代码

必需

vesselUnCode

string

UN代码

必需

ctnNo

string

箱号

必需

string

必需

inDoorEndTime

string

进门结束时间

必需

inDoorBeginTime

string

进门起始时间

必需

vesselName

string

英文船名

必需

status

string

是否可以补贴

必需

Flag

string

必需

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctb="http://ctbusch.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctb:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{
  "feeInfos": [
    {
      "amount": 700,
      "itemCode": "JTBT",
      "itemName": "码头进提补贴",
      "tailInfos": {}
    }
  ],
  "reason": "",
  "blNo": "WHL126E598670",
  "orderId": "ZJYGTJK0000009989252",
  "operCode": "T",
  "truckLicense": "",
  "batch": "202411",
  "msgId": "1111",
  "ctnSizeType": "45GP",
  "voyage": "020E",
  "jobId": "SENDCTNSUBSIDY",
  "outDoorTime": "2024-10-25 20:33:11",
  "vesselIe": "E",
  "tailInfos": {},
  "actualLocation": "BLCT",
  "vesselUnCode": "UN9267651",
  "ctnNo": "WHSU5419254",
  "id": "ZJYGTZBBT241114zL30w",
  "inDoorEndTime": "2024-11-01 20:33:11",
  "inDoorBeginTime": "2024-10-18 20:33:11",
  "vesselName": "KOTALIMA",
  "status": "N"
}</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/ctbuschApi' \
--header 'Content-Type: application/xml' \
--data-raw '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ctb="http://ctbusch.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ctb:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{
  "feeInfos": [
    {
      "amount": 700,
      "itemCode": "JTBT",
      "itemName": "码头进提补贴",
      "tailInfos": {}
    }
  ],
  "reason": "",
  "blNo": "WHL126E598670",
  "orderId": "ZJYGTJK0000009989252",
  "operCode": "T",
  "truckLicense": "",
  "batch": "202411",
  "msgId": "1111",
  "ctnSizeType": "45GP",
  "voyage": "020E",
  "jobId": "SENDCTNSUBSIDY",
  "outDoorTime": "2024-10-25 20:33:11",
  "vesselIe": "E",
  "tailInfos": {},
  "actualLocation": "BLCT",
  "vesselUnCode": "UN9267651",
  "ctnNo": "WHSU5419254",
  "id": "ZJYGTZBBT241114zL30w",
  "inDoorEndTime": "2024-11-01 20:33:11",
  "inDoorBeginTime": "2024-10-18 20:33:11",
  "vesselName": "KOTALIMA",
  "status": "N"
}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </ctb:invoke>
   </soapenv:Body>
</soapenv:Envelope>'

返回响应

🟢200成功

application/json

Body

feeInfos

array [object {4}]

必需

amount

integer

可选

itemCode

string

可选

itemName

string

可选

tailInfos

object

可选

reason

string

必需

orderId

string

必需

operCode

string

必需

batch

string

必需

msgId

string

易港通结果，北一返回1111，等待人口审核后异步发送，其他码头返回0000

必需

jobId

string

必需

yardMsgInfo

string

必需

ctnNo

string

必需

string

必需

msgDESC

string

必需

status

string

必需

actualLocation

string

码头代码

必需

示例

异常示例成功示例

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:invokeResponse xmlns:ns2="http://ctbusch.ygt.api.service.ctos3.nbport.com/">
         <return>{"feeInfos":[{"amount":700,"itemCode":"JTBT","itemName":"码头进提补贴","tailInfos":{}}],"reason":"","blNo":"WHL126E598670","orderId":"ZJYGTJK0000009989252","operCode":"T","truckLicense":"","batch":"202411","msgId":"9999","ctnSizeType":"45GP","voyage":"020E","jobId":"SENDCTNSUBSIDY","outDoorTime":"2024-10-25 20:33:11","vesselIe":"E","yardMsgInfo":"上一批次未确认不能发送新的批次","tailInfos":{},"actualLocation":"BLCT","vesselUnCode":"UN9267651","ctnNo":"WHSU5419254","id":"ZJYGTZBBT241114zL30w","inDoorEndTime":"2024-11-01 20:33:11","msgDESC":"上一批次未确认不能发送新的批次","inDoorBeginTime":"2024-10-18 20:33:11","vesselName":"KOTALIMA","status":"N"}</return>
      </ns2:invokeResponse>
   </soap:Body>
</soap:Envelope>

修改于 2025-02-25 01:13:46

易港通一般提重接口

特殊标记箱（浙北、海铁）发送码头接口总入口