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

ICS03.220

CCSR20

DB2102

大连市地方标准

DB2102/T0125—2024

集装箱闸口电子操作条接口规范

2024-06-25发布2024-07-25实施

大连市市场监督管理局发布

DB2102/T0125—2024

前言

本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起

草。

请注意本文件的部分内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由大连市人民政府口岸办公室提出并归口。

本文件起草单位：大连口岸物流网股份有限公司。

本文件主要起草人：杨惠云、毛钧、周明华、武琦、刘广会、张春玲、李志芳、张迈、邹德文、季

珊珊、冯君、吕艳霞、肖玉、邱云鹏、张晋。

本文件发布实施后，任何单位和个人如有问题和意见建议，均可通过来电、来函等方式进行反馈，

有关单位将及时答复并认真处理，根据实际情况依法进行评估及复审。

归口管理部门通讯地址：大连市人民政府口岸办公室（大连市中山区港湾街2号航运交易市场5楼），

联系电话：0411-82623276。

文件起草单位通讯地址：大连口岸物流网股份有限公司（大连市中山区港湾街2号航运交易市场3

楼），联系电话：0411-82798088。

1

DB2102/T0125—2024

集装箱闸口电子操作条接口规范

1范围

本文件规定了电子操作条内容、交互要求及接口定义。

本文件适用于口岸集装箱场站或码头应用标准化数据流规范集装箱提送箱闸口业务。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

3.1

集装箱闸口containergate

是进出口集装箱和各种运输机械的出入口，是区分码头内外责任和交接相关资料的地点。

3.2

电子操作条electronicoperationstrip

借助即时通讯工具指导进出码头或场站的集装箱卡车进行业务操作的电子小票。

4缩略语

下列缩略语适用于本文件。

UTF-8：是一种针对Unicode的可变长度字符编码（UnicodeTransformationFormat8-bit）

HTTP：超文本传输协议（HyperTextTransferProtocol）

JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）

MD5：信息学中使用广泛的哈希算法（Message-DigestAlgorithm5）

RSA：是一种非对称加密算法（RonRivest、AdiShamir和LeonardAdleman三人姓氏开头字母组成）

5电子操作条内容

5.1模板消息

模板消息是电子操作的关键内容，正常情况下司机可以根据模板消息进行作业，不需要进入详情页

面查看完整信息，模板消息由业务类型、车牌号、箱号及场位数据项组成，见表1。

约束条件：数据项标记中，M表示必选项，C表示可选项。

1

DB2102/T0125—2024

表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获得原始明文后，首先使用