ICS03.220CCSR20

DB2102大 連 市 地 方 標(biāo) 準(zhǔn)DB2102/T0125—2024集裝箱閘口電子操作條接口規(guī)范2024-06-25發(fā)布 2024-07-25實施大連市市場監(jiān)督管理局 發(fā)布DB2102/T0125DB2102/T0125—202411前 言本文件按照GB/T1.1-2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件發(fā)布實施后，任何單位和個人如有問題和意見建議，均可通過來電、來函等方式進行反饋，有關(guān)單位將及時答復(fù)并認(rèn)真處理，根據(jù)實際情況依法進行評估及復(fù)審。250411-82623276。文件起草單位通訊地址：大連口岸物流網(wǎng)股份有限公司（大連市中山區(qū)港灣街2號航運交易市場3樓），聯(lián)系電話集裝箱閘口電子操作條接口規(guī)范范圍本文件規(guī)定了電子操作條內(nèi)容、交互要求及接口定義。本文件適用于口岸集裝箱場站或碼頭應(yīng)用標(biāo)準(zhǔn)化數(shù)據(jù)流規(guī)范集裝箱提送箱閘口業(yè)務(wù)。本文件沒有規(guī)范性引用文件。3.1集裝閘口 containergate是進出口集裝箱和各種運輸機械的出入口，是區(qū)分碼頭內(nèi)外責(zé)任和交接相關(guān)資料的地點。3.2電子作條 electronicoperationstrip借助即時通訊工具指導(dǎo)進出碼頭或場站的集裝箱卡車進行業(yè)務(wù)操作的電子小票。縮略語下列縮略語適用于本文件。UTF-8：是一種針對Unicode的可變長度字符編碼（UnicodeTransformationFormat8-bit）HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）JSON：一種輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）MD5：信息學(xué)中使用廣泛的哈希算法（Message-DigestAlgorithm5）（RonRivestAdiShamir和LeonardAdleman）。約束條件：數(shù)據(jù)項標(biāo)記中，M表示必選項，C表示可選項。DB2102/T0125DB2102/T0125—2024PAGEPAGE2表1 推送板息據(jù)項序號數(shù)據(jù)項名稱注釋標(biāo)記1業(yè)務(wù)類型包括提箱、送箱、出門、搬移等M2車牌號拖車的車牌號M3箱號集裝箱號C4場位集裝箱所在的場地位置C。約束條件：數(shù)據(jù)項標(biāo)記中，M表示必選項，C表示可選項。表2 詳情面息據(jù)項序號數(shù)據(jù)項名稱注釋標(biāo)記1車信息車牌號M2箱信息包括船名航次及箱號C3場區(qū)場位集裝箱場區(qū)場位C4錯誤信息作業(yè)錯誤信息C5注意事項作業(yè)注意事項C6殘損信息作業(yè)集裝箱的殘損信息C7打印通道進門通道M8地磅重量箱子稱重重量C9操作人操作人員信息M10操作時間進閘口時間MHTTPUTF-8HTTPpostJSONinvokeridMD5RSAMD5MD5MD5RSAinvokeridinvokeridsignature電子操作條接口功能描述：接收碼頭及場站電子操作條數(shù)據(jù)。請求參數(shù)見表3。表3 電子電子操作條接口功能描述：接收碼頭及場站電子操作條數(shù)據(jù)。請求參數(shù)見表3。表3 電子作接請參數(shù)參數(shù)內(nèi)容序號數(shù)據(jù)項類型長度數(shù)據(jù)說明備注/示例1paramObject參數(shù)明文2signatureObject參數(shù)密文參數(shù)param信息1idNVARCHAR2(50)主鍵112workTypeNVARCHAR2(10)作業(yè)類型收箱/提箱/出門3truckNoNVARCHAR2(8)車號如遼B1234或遼B1234564errorCodeNVARCHAR2(50)錯誤代碼ERR100001,ERR100025noticeNVARCHAR2(100)注意事項如A22施工請繞行?6dmgCodeNVARCHAR2(100)殘損信息如CBHU1234567箱頂凹損7workAreaNVARCHAR2(1)通道所屬作業(yè)區(qū)C:一區(qū)P:二區(qū)8inLaneNVARCHAR2(10)入港通道如C7019inGrossWeightFLOAT(10)入港稱重12000KG10inUserNVARCHAR2(10)進港操作人管理員11inPortTimeDATE入港時間（操作時間）YYYYMMDDHHMISS12sourceNVARCHAR2(10)來源DCT\DCTL13errorMsgNVARCHAR2(200)錯誤信息14feeFlagNVARCHAR2(1)網(wǎng)上支付標(biāo)記1:需要支付，0:不需要支付15cntrListObject箱信息列表參數(shù)cntrList信息1workTypeNVARCHAR2(20)作業(yè)類型收箱/提箱/出門2cntrNoNVARCHAR2(15)箱號如CBHU1234563shipNameNVARCHAR2(50)船名如WANHAISHS4voyageNVARCHAR2(10)航次如231S5BillNoNVARCHAR2(50)提單號非必填6cntrEFNVARCHAR2(1)空重E:空箱F:重箱7tempFlagNVARCHAR2(10)冷藏溫度如-023℃DB2102/T0125—DB2102/T0125—2024表3 （續(xù)）PAGEPAGE48dangerTextNVARCHAR2(5)危品標(biāo)簽79transitFlagNVARCHAR2(1)轉(zhuǎn)關(guān)標(biāo)記1:是，0:否10checkFlagNVARCHAR2(1)查驗箱標(biāo)記1:是，0:否11trunDoorFlagNVARCHAR2(1)調(diào)箱門標(biāo)記1:是，0:否12verticalFlagNVARCHAR2(1)直裝直提標(biāo)記1:是，0:否13workAreaNVARCHAR2(1)箱所屬作業(yè)區(qū)域C:一區(qū)P:二區(qū)14cntrPlaceNVARCHAR2(40)箱位置A02街02貝15cntrErrorCodeNVARCHAR2(50)錯誤代碼ERR100001,ERR1000216cntrErrorMsgNVARCHAR2(200)錯誤信息17barCodeNVARCHAR2(20)條形碼CBHU1234567GP218cntrNoteNVARCHAR2(100)箱備注非必填返回對象：序號數(shù)據(jù)項類型長度數(shù)據(jù)說明備注1statusNVARCHAR2(4)提示信息代碼SUCC：處理成功FAIL：處理失敗2statusNVARCHAR2(100)提示信息描述返回提示信息描述7.2 功能描述：接收場站或碼頭車輛停牌數(shù)據(jù)，即把場站或碼頭限制車輛作業(yè)的信息通知給司機。請求參數(shù)見表4。表4 車輛牌口求數(shù)參數(shù)內(nèi)容序號數(shù)據(jù)項類型長度數(shù)據(jù)說明備注/示例1paramObject參數(shù)明文2signatureObject參數(shù)密文參數(shù)param信息1sourceNVARCHAR2(10)來源2idNVARCHAR2(50)主鍵3truckNoNVARCHAR2(8)車牌號4illTimeDATE違規(guī)時間YYYYMMDDHHMISS5illDescNVARCHAR2(100)違規(guī)描述6illBcsNVARCHAR2(100)違規(guī)原因7beginTimeDATE停牌開始時間YYYYMMDDHHMISS8endTimeDATE停牌結(jié)束時間YYYYMMDDHHMISS9truckTeamNVARCHAR2(20)車隊10managerNVARCHAR2(20)管理11operNameNVARCHAR2(20)操作人12operDateDATE操作時間YYYYMMDDHHMISS13remarkNVARCHAR2(20)備注DB2102/T0125—DB2102/T0125—2024表4 （續(xù)）PAGEPAGE514delFlagNVARCHAR2(1)刪除標(biāo)記15delOperNameNVARCHAR2(20)刪除操作人16delDateDATE刪除時間YYYYMMDDHHMISS17checkUserNVARCHAR2(10)違規(guī)查處人18businessTypeNVARCHAR2(1)業(yè)務(wù)類型C:新增,D:刪除返回對象序號數(shù)據(jù)項類型長度數(shù)據(jù)說明備注/示例1statusNVARCHAR2(4)提示信息代碼SUCC：處理成功FAIL：處理失敗2statusNVARCHAR2(100)提示信息描述返回提示信息描述虛擬提箱接口功能描述：調(diào)用虛擬提箱接口，根據(jù)優(yōu)先提箱作業(yè)區(qū)虛擬提箱并推送提箱操作條信息。請求參數(shù)見表5。虛擬提箱接口功能描述：調(diào)用虛擬提箱接口，根據(jù)優(yōu)先提箱作業(yè)區(qū)虛擬提箱并推送提箱操作條信息。請求參數(shù)見表5。表5 虛擬箱口求數(shù)異常車輛重新入港接口功能描述：調(diào)用車輛重新入港操作，并推送電子操作條。請求參數(shù)見表6。表6 異常輛新港口求參數(shù)即時通訊推送狀態(tài)同步接口序號數(shù)據(jù)項類型長度數(shù)據(jù)說明備注/示例1bizIdNVARCHAR2(36)車輛ID2workAreaNVARCHAR2(1)優(yōu)先提箱區(qū)P:二區(qū)，C:一區(qū)7.4參數(shù)內(nèi)容序號數(shù)據(jù)項類型長度數(shù)據(jù)說明備注/示例1bizIdNVARCHAR2(36)車輛ID返回結(jié)果序號數(shù)據(jù)項類型長度數(shù)據(jù)說明備注/示例1statusNVARCHAR2(4)處理信息SUCC：處理成功FAIL：處理失敗7.5功能描述：推送電子操作條后調(diào)用，更新推送狀態(tài)。請