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算法及公钥进行加密操作，获得密文。