DB2102T 0125-2024 集装箱闸口电子操作条接口规范

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借助即时通讯工具指导进出码头或场站的集装箱卡车进行业务操作的电子小票。缩略语下列缩略语适用于本文件。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功能描述：推送电子操作条后调用，更新推送状态。请