ICS 03.220 CCS R 20 DB2102 大 连 市 地 方 标 准 DB2102/T 0125—2024 集装箱闸口电子操作条接口规范 2024 - 06 - 25发布 2024 - 07 - 25实施 大连市市场监督管理局 发布 DB2102/T 0125—2024 1 前 言 本文件按照 GB/T 1.1 -2020《标准化工作导则 第1部分：标准化文件的结构和起草规 则》的规定起 草。 请注意本文件的部分内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由大连市人民政府口岸办公室提出 并归口。 本文件起草单位：大连口岸物流网股份有限公司。 本文件主要起草人：杨惠云、毛钧、周明华、 武琦、刘广会、张春玲、李志芳、张迈、邹德文、季 珊珊、冯君、吕艳霞、肖玉 、邱云鹏、张晋。 本文件发布实施后，任何单位和个人如有问题和意见建议，均可通过来电、来函等方式进行反馈， 有关单位将及时答复并认真处理，根据实际情况依法进行评估及复审。 归口管理部门通讯地址： 大连市人民政府口岸办公室 （大连市中山区港湾街 2号航运交易市场 5楼）， 联系电话： 0411-82623276 。 文件起草单位通讯地址： 大连口岸物流网股份有限公司 （大连市中山区港湾街 2号航运交易市场 3 楼），联系电话： 0411-82798088 。 DB2102/T 0125—2024 1 集装箱闸口电子操作条接口规范 1 范围 本文件规定了电子操作条内容、交互要求及接口定义。 本文件适用于口岸集装箱场站或码头应用标准化数据流规范集装箱提送箱闸口业务。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 3.1 集装箱闸口 container gate 是进出口集装箱和各种运输机械的出 入口，是区分码头内外责任和交接相关资料的地点 。 3.2 电子操作条 electronic operation strip 借助即时通讯工具指导进出码头或场站的集装箱卡车进行业务操作的电子小票。 4 缩略语 下列缩略语适用于本文件。 UTF-8：是一种针对 Unicode的可变长度字符编码（ Unicode Transformation Format 8 -bit ） HTTP：超文本传输协议（ Hyper Text Transfer Protocol ） JSON：一种轻量级的数据交换格式（ JavaScript Object Notation ） MD5：信息学中使用广泛的哈希算法（ Message-Digest Algorithm 5 ） RSA：是一种非对称加密算法（ Ron Rivest 、Adi Shamir 和Leonard Adleman 三人姓氏开头字母组成） 5 电子操作条内容 5.1 模板消息 模板消息是电子操作的关键内容，正常情况下司机可以根据模板消息进行作业，不需要进入详情页 面查看完整信息， 模板消息由业务类型、车牌号、箱号及场位数据项组成，见表 1。 约束条件 ：数据项标记中， M表示必选项， C表示可选项。 DB2102/T 0125—2024 2 表1 推送模板消息数据项 序号 数据项名称 注释 标记 1 业务类型 包括提箱、送箱、出门、搬移等 M 2 车牌号 拖车的车牌号 M 3 箱号 集装箱号 C 4 场位 集装箱所在的场地位置 C 5.2 详情页面信息 详情页面显示电子操作条的完成内容，异常情况司机需要进入详情页面查看详细信息， 详情页面信 息由车信息、箱号、场区场位、错误信息、注意事项、残损信息、打印通道、地磅重量、操作人、操作 时间等数据项组成，见表 2。 约束条件：数据项标记中， M表示必选项， C表示可选项。 表2 详情页面信息数据项 序号 数据项名称 注释 标记 1 车信息 车牌号 M 2 箱信息 包括船名航次及箱号 C 3 场区场位 集装箱场区场位 C 4 错误信息 作业错误信息 C 5 注意事项 作业注意事项 C 6 残损信息 作业集装箱的残损信息 C 7 打印通道 进门通道 M 8 地磅重量 箱子称重重量 C 9 操作人 操作人员信息 M 10 操作时间 进闸口时间 M 6 交互要求 6.1 交互协议 6.1.1 采用HTTP协议作为交互协议，且采用同步接口方式，即调用和反馈在一次接口交互中完成。 6.1.2 文本编码均采用 UTF-8编码，以防止中文字符乱码，保证解析处理准确。 6.1.3 调用方请求使用 HTTP的post类型的请求方式。 6.1.4 调用方的请求参数及应答方的反馈数据均使用 JSON类型的数据格式。 6.1.5 各数据项的具体值类型均为文本类型，在程序中其他类型的数值可由交互双方协定为固定格式 的文字表示。 6.2 加签算法 6.2.1 加签功能是调用方获取 invokerid 及用于加密操作的公钥，使用 MD5算法及RSA算法。 6.2.2 由双方协定用于进行加签操作的原始明文生成规则，按照原始明文生成规则生成明文。 6.2.3 获得原始明文后，首先使用 MD5算法对原始明文数据进行处理， 获得原始明文的 MD5值， 对此 MD5值使用RSA算法及公钥进行加密操作，获得密文。 DB2102/T 0125—2024 3 6.2.4 将invokerid 与密文使用“ -” （英文中划线字符）进行连接，即获得格式为“ invokerid -密文” 的数据。 6.2.5 签名数据在接口调用时，将获得的签名数据作为除正常接口调用参数外的附加参数进行接口调 用操作，参数名固定为“ signature ”。 7 接口定义 7.1 电子操作条接口 功能描述： 接收码头及场站电子操作条数据 。 请求参数见表 3。 表3 电子操作条接口 请求参数 参数内容 序号 数据项 类型长度 数据说明 备注/示例 1 param Object 参数明文 2 signature Object 参数密文 参数param信息 1 id NVARCHAR2 (50) 主键 11 2 workType NVARCHAR2 (10) 作业类型 收箱/提箱/出门 3 truckNo NVARCHAR2 ( 8) 车号 如辽B1234或辽B123456 4 errorCode NVARCHAR2 ( 50) 错误代码 ERR100001,ERR10002 5 notice NVARCHAR2 ( 100) 注意事项 如A22施工请绕行„ 6 dmgCode NVARCHAR2 ( 100) 残损信息 如CBHU1234567 箱顶凹损 7 workArea NVARCHAR2 (1) 通道所属作业区 C:一区 P:二区 8 inLane NVARCHAR2 (10) 入港通道 如C701 9 inGrossWeight FLOAT (10) 入港称重 12000KG 10 inUser NVARCHAR2 ( 10) 进港操作人 管理员 11 inPortTime DATE 入港时间（操作时 间） YYYYMMDDHHMISS 12 source NVARCHAR2 ( 10) 来源 DCT\DCTL 13 errorMsg NVARCHAR2 (200) 错误信息 14 feeFlag NVARCHAR2 (1) 网上支付标记 1:需要支付， 0:不需要支付 15 cntrList Object 箱信息列表 参数cntrList 信息 1 workType NVARCHAR2 (20) 作业类型 收箱/提箱/出门 2 cntrNo NVARCHAR2 (15) 箱号 如CBHU123456 3 shipName NVARCHAR2 (50) 船名 如WANHAI SHS 4 voyage NVARCHAR2 ( 10) 航次 如231S 5 BillNo NVARCHAR2 (50) 提单号 非必填 6 cntrEF NVARCHAR2 ( 1) 空重 E:空箱 F:重箱 7 tempFlag NVARCHAR2 (10) 冷藏温度 如-023℃ DB2102/T 0125—2024 4 表3 （续） 8 dangerText NVARCHAR2 ( 5) 危品标签 7 9 transitFlag NVARCHAR2 (1) 转关标记 1:是，0:否 10 checkFlag NVARCHAR2 (1) 查验箱标记 1:是，0:否 11 trunDoorFlag NVARCHAR2 (1) 调箱门标记 1:是，0:否 12 verticalFlag NVARCHAR2 (1) 直装直提标记 1:是，0:否 13 workArea NVARCHAR2(1) 箱所属作业区域 C :一区 P :二区 14 cntrPlace NVARCHAR2 (40) 箱位置 A02街02贝 15 cntrErrorCode NVARCHAR2 ( 50) 错误代码