接口入口

POST

/api/blRegisterApi

请求参数

Body 参数application/xml

blChangePosition

string

提单变化位

必需

blEndNo

string

提单结束编号

必需

blStartNo

string

提单起始编号

必需

blType

string

提单类型 P：前缀型，S：区间型

必需

ctnOperatorCode

string

箱经人代码

必需

forwarderCode

string

货代代码

必需

string

必需

jobId

string

业务类型(固定为BLREGISTER)

必需

operCode

string

操作类型 A:新增；D:删除；M：修改

必需

planNumber

string

易港通计划号

必需

postfixEndValue

string

后缀结束值

必需

postfixStartValue

string

后缀起始值

必需

prefixValue

string

提单号前缀值

必需

示例

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:blr="http://blregister.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <blr:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{
  "blChangePosition": "1204",
  "blEndNo": "COHEQY445NBX999",
  "blStartNo": "COHEQY445NBX000",
  "blType": "S",
  "ctnOperatorCode": "SOC",
  "forwarderCode": "ZXGYL",
  "id": "YGTBLRM240703164155480670",
  "jobId": "BLREGISTER",
  "operCode": "M",
  "planNumber": "ZJYGTBLR240410q3ZQC0",
  "postfixEndValue": "",
  "postfixStartValue": "",
  "prefixValue": ""
}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </blr:invoke>
   </soapenv:Body>
</soapenv:Envelope>

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/blRegisterApi' \
--header 'Content-Type: application/xml' \
--data-raw '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:blr="http://blregister.ygt.api.service.ctos3.nbport.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <blr:invoke>
         <!--Optional:-->
         <arg0>?</arg0>
         <!--Optional:-->
         <arg1>{
  "blChangePosition": "1204",
  "blEndNo": "COHEQY445NBX999",
  "blStartNo": "COHEQY445NBX000",
  "blType": "S",
  "ctnOperatorCode": "SOC",
  "forwarderCode": "ZXGYL",
  "id": "YGTBLRM240703164155480670",
  "jobId": "BLREGISTER",
  "operCode": "M",
  "planNumber": "ZJYGTBLR240410q3ZQC0",
  "postfixEndValue": "",
  "postfixStartValue": "",
  "prefixValue": ""
}</arg1>
         <!--Optional:-->
         <arg2>?</arg2>
         <!--Optional:-->
         <arg3>?</arg3>
      </blr:invoke>
   </soapenv:Body>
</soapenv:Envelope>'

返回响应

🟢200成功

application/xml

Body

string

ID :YGTBLRM240703164155480670

必需

jobId

string

业务类型 BLREGISTER

必需

msgDESC

string

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

必需

msgId

string

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

必需

示例

成功示例异常示例

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:invokeResponse xmlns:ns2="http://blregister.ygt.api.service.ctos3.nbport.com/">
         <return>{
  "checkValue": "",
  "id": "YGTBLRM240703164155480670",
  "jobId": "BLREGISTER",
  "msgDESC": "操作成功",
  "msgId": "0000"
}</return>
      </ns2:invokeResponse>
   </soap:Body>
</soap:Envelope>

修改于 2024-11-26 08:11:10

车队/货代危险品进重预约业务接口总入口

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