DB2102T+0125—2024集装箱闸口电子操作条接口规范.docxVIP

ICS03.220

CCSR20

DB2102

大 连 市 地 方 标 准

DB2102/T0125—2024

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

2024

2024-06-25发布

2024-07-25实施

大连市市场监督管理局

发布

DB2102/T0125

DB2102/T0125—2024

前 言

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

请注意本文件的部分内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由大连市人民政府口岸办公室提出并归口。

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

本文件主要起草人：杨惠云、毛钧、周明华、武琦、刘广会、张春玲、李志芳、张迈、邹德文、季珊珊、冯君、吕艳霞、肖玉、邱云鹏、张晋。

本文件发布实施后，任何单位和个人如有问题和意见建议，均可通过来电、来函等方式进行反馈，有关单位将及时答复并认真处理，根据实际情况依法进行评估及复审。

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

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

1

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

范围

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

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

规范性引用文件

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

术语和定义3.1

集装箱闸口containergate

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

3.2

电子操作条electronicoperationstrip

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

缩略语

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

UTF-8：是一种针对Unicode的可变长度字符编码（UnicodeTransformationFormat8-bit）HTTP：超文本传输协议（HyperTextTransferProtocol）

JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）MD5：信息学中使用广泛的哈希算法（Message-DigestAlgorithm5）

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

电子操作条内容

模板消息

模板消息是电子操作的关键内容，正常情况下司机可以根据模板消息进行作业，不需要进入详情页面查看完整信息，模板消息由业务类型、车牌号、箱号及场位数据项组成，见表1。

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

1

表1推送模板消息数据项

序号

数据项名称

注释

标记

1

业务类型

包括提箱、送箱、出门、搬移等

M

2

车牌号

拖车的车牌号

M

3

箱号

集装箱号

C

4

场位

集装箱所在的场地位置

C

详情页面信息

详情页面显示电子操作条的完成内容，异常情况司机需要进入详情页面查看详细信息，详情页面信息由车信息、箱号、场区场位、错误信息、注意事项、残损信息、打印通道、地磅重量、操作人、操作时间等数据项组成，见表2。

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

表2详情页面信息数据项

序号

数据项名称

注释

标记

1

车信息

车牌号

M

2

箱信息

包括船名航次及箱号

C

3

场区场位

集装箱场区场位

C

4

错误信息

作业错误信息

C

5

注意事项

作业注意事项

C

6

残损信息

作业集装箱的残损信息

C

7

打印通道

进门通道

M

8

地磅重量

箱子称重重量

C

9

操作人

操作人员信息

M

10

操作时间

进闸口时间

M

交互要求

交互协议

采用HTTP协议作为交互协议，且采用同步接口方式，即调用和反馈在一次接口交互中完成。

文本编码均采用UTF-8编码，以防止中文字符乱码，保证解析处理准确。

调用方请求使用HTTP的post类型的请求方式。

调用方的请求参数及应答方的反馈数据均使用JSON类型的数据格式。

各数据项的具体值类型均为文本类型，在程序中其他类型的数值可由交互双方协定为固定格式的文字表示。

加签算法

加签功能是调用方获取invokerid及用于加密操作的公钥，使用MD5算法及RSA算法。

由双方协定用于进行加签操作的原始明文生成规则，按照原始明文生成规则生成明文。

获得原始明文后，首先使用MD5算法对原始明文数据进行处理，获得原始明文的MD5值，对此MD