DB2102T 0125-2024 集裝箱閘口電子操作條接口規(guī)范

ICS03.220CCSR20

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