转码头提箱接口

POST

/api/sendTransPlanApi

请求参数

Body 参数application/xml

param

array [object {31}]

必需

applyer

string

申报船代

必需

approveTime

string

审批时间

必需

berthTime

string

靠泊时间

必需

billList

array[string]

提单集合

必需

ctnHazard

string

危险品等级

必需

ctnNo

string

箱号

必需

ctnOwner

string

箱主

必需

ctnSize

string

尺寸

必需

ctnStatus

string

空重

必需

ctnType

string

箱型

必需

ctnWeight

integer

箱重

必需

custNo

string

申报单号

必需

damage

string

残

必需

dischargePort

string

卸货港

必需

flag

string

操作标记 A新增 D删除 B绑定 U解绑

必需

inTerminal

string

二程码头

必需

inVesselCode

string

二程船UN代码

必需

inVesselName

string

二程船名

必需

inVoyage

string

二程航次

必需

isLdg

string

冷带干

必需

isNzw

string

是否内转外

必需

loadPort

string

装货港

必需

outTeminal

string

一程码头

必需

outVesselCode

string

一程船UN代码

必需

outVesselName

string

一程船名

必需

outVoyage

string

一程航次

必需

over

string

超

必需

sealNo

string

铅封

必需

temperature

string

温度

必需

transPort

string

中转港

必需

transType

string

转码头类型 ZYX-国际中转 NZX内支线 HTL-海铁 NW-内贸

必需

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sszz="http://sszz.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <sszz:sendTransPlanApi>
         <!--Optional:-->
         <applyData>{"param":[{"applyer":"向塘","approveTime":"20240603075854","berthTime":"20240605000000","billList":[],"ctnHazard":"","ctnNo":"BMOU5658001","ctnOwner":"CMA","ctnSize":"45","ctnStatus":"F","ctnType":"GP","ctnWeight":0,"custNo":"R24268289","damage":"","dischargePort":"ITGOA","flag":"A","inTerminal":"BLCTMS","inVesselCode":"UN9832717","inVesselName":"EVERGOVERN","inVoyage":"021W","isLdg":"","isNzw":"N","loadPort":"","outTeminal":"BLCT","outVesselCode":"FC0006217","outVesselName":"TIELUNANCHANG","outVoyage":"A240603","over":"","sealNo":"","temperature":"","transPort":"","transType":"HTL"},{"applyer":"向塘","approveTime":"20240603075854","berthTime":"20240605000000","billList":[],"ctnHazard":"","ctnNo":"TCLU6553721","ctnOwner":"CMA","ctnSize":"45","ctnStatus":"F","ctnType":"GP","ctnWeight":0,"custNo":"R24268289","damage":"","dischargePort":"ITGOA","flag":"A","inTerminal":"BLCTMS","inVesselCode":"UN9832717","inVesselName":"EVERGOVERN","inVoyage":"021W","isLdg":"","isNzw":"N","loadPort":"","outTeminal":"BLCT","outVesselCode":"FC0006217","outVesselName":"TIELUNANCHANG","outVoyage":"A240603","over":"","sealNo":"","temperature":"","transPort":"","transType":"HTL"}]}</applyData>
      </sszz:sendTransPlanApi>
   </soapenv:Body>
</soapenv:Envelope>

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/sendTransPlanApi' \
--header 'Content-Type: application/xml' \
--data-raw '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sszz="http://sszz.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <sszz:sendTransPlanApi>
         <!--Optional:-->
         <applyData>{"param":[{"applyer":"向塘","approveTime":"20240603075854","berthTime":"20240605000000","billList":[],"ctnHazard":"","ctnNo":"BMOU5658001","ctnOwner":"CMA","ctnSize":"45","ctnStatus":"F","ctnType":"GP","ctnWeight":0,"custNo":"R24268289","damage":"","dischargePort":"ITGOA","flag":"A","inTerminal":"BLCTMS","inVesselCode":"UN9832717","inVesselName":"EVERGOVERN","inVoyage":"021W","isLdg":"","isNzw":"N","loadPort":"","outTeminal":"BLCT","outVesselCode":"FC0006217","outVesselName":"TIELUNANCHANG","outVoyage":"A240603","over":"","sealNo":"","temperature":"","transPort":"","transType":"HTL"},{"applyer":"向塘","approveTime":"20240603075854","berthTime":"20240605000000","billList":[],"ctnHazard":"","ctnNo":"TCLU6553721","ctnOwner":"CMA","ctnSize":"45","ctnStatus":"F","ctnType":"GP","ctnWeight":0,"custNo":"R24268289","damage":"","dischargePort":"ITGOA","flag":"A","inTerminal":"BLCTMS","inVesselCode":"UN9832717","inVesselName":"EVERGOVERN","inVoyage":"021W","isLdg":"","isNzw":"N","loadPort":"","outTeminal":"BLCT","outVesselCode":"FC0006217","outVesselName":"TIELUNANCHANG","outVoyage":"A240603","over":"","sealNo":"","temperature":"","transPort":"","transType":"HTL"}]}</applyData>
      </sszz:sendTransPlanApi>
   </soapenv:Body>
</soapenv:Envelope>'

返回响应

🟢200成功

application/xml

Body

result

string

结果

必需

msgId

string

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

必需

msgDESC

string

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

必需

示例

成功示例异常示例

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:sendTransPlanApiResponse xmlns:ns2="http://sszz.api.service.ctos3.nbport.com/">
         <return>{"result":"","msgId":"000","msgDESC":"操作成功"}</return>
      </ns2:sendTransPlanApiResponse>
   </soap:Body>
</soap:Envelope>

修改于 2025-02-11 14:05:10

水水中转，TT信息接收接口

铅封机接口入口