ICS03.220CCSR20

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