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楼），

联系电话

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

楼），联系电话

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获得原始明文后，首先使用MD5算法对原始明文数据进行处理，获得原始明文的MD5值，对此

MD5值使用RSA算法及公钥进行加密操作，获得密文。

2

DB2102/T0125—2024

6.2.4将invokerid与密文使用“-”（英文中划线字符）进行连接，即获得格式为“invokerid-密文”

的数据。

6.2.5签名数据在接口调用时，将获得的签名数据作为除正常接口调用参数外的附加参数进行接口调

用操作，参数名固定为“signature”。

7接口定义

7.1电子操作条接口

功能描述：接收码头及场站电子操作条数据。

请求参数见表3。

表3电子操作条接口请求参数

参数内容

序号数据项类型长度数据说明备注/示例

1paramObject参数明文

2signatureObject参数密文

参数param信息

1idNVARCHAR2(50)主键11

2workTypeNVARCHAR2(10)作业类型收箱/提箱/出门

3truckNoNVARCHAR2(8)车号如辽B1234或辽B123456

4errorCodeNVARCHAR2(50)错误代码ERR100001,ERR10002

5noticeNVARCHAR2(100)注意事项如A22施工请绕行„

6dmgCodeNVARCHAR2(100)残损信息如CBHU1234567箱顶凹损

7workAreaNVARCHAR2(1)通道所属作业区C:一区P:二区

8inLaneNVARCHAR2(10)入港通道如C701

9inGrossWeightFLOAT(10)入港称重12000KG

10inUserNVARCHAR2(10)进港操作人管理员

入港时间（操作时YYYYMMDDHHMISS

11inPortTimeDATE

间）

12sourceNVARCHAR2(10)来源DCT\DCTL

13errorMsgNVARCHAR2(200)错误信息

14feeFlagNVARCHAR2(1)网上支付标记1:需要支付，0:不需要支付

15cntrListObject箱信息列表

参数cntrList信息

1workTypeNVARCHAR2(20)作业类型收箱/提箱/出门

2cntrNoNVARCHAR2(15)箱号如CBHU123456

3shipNameNVARCHAR2(50)船名如WANHAISHS

4voyageNVARCHAR2(10)航次如231S

5BillNoNVARCHAR2(50)提单号非必填

6cntrEFNVARCHAR2(1)空重E:空箱F:重箱

7tempFlagNVARCHAR2(10)冷藏温度如-023℃

3

DB2102/T0125—2024

表3（续）

8dangerTextNVARCHAR2(5)危品标签7

9transitFlagNVARCHAR2(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,ERR10002

16cntrErrorMsgNVARCHAR2(200)错误信息

17barCodeNVARCHAR2(20)条形码CBHU1234567GP2

18cntrNoteNVARCHAR2(100)箱备注非必填

返回对象：

序号数据项类型长度数据说明备注

SUCC：处理成功

1statusNVARCHAR2(4)提示信息代码

FAIL：处理失败

2statusNVARCHAR2(100)提示信息描述返回提示信息描述

7.2车辆停牌接口

功能描述：接收场站或码头车辆停牌数据，即把场站或码头限制车辆作业的信息通知给司机。

请求参数见表4。

表4车辆停牌接口请求参数

参数内容

序号数据项类型长度数据说明备注/示例

1paramObject参数明文

2signatureObject参数密文

参数param信息

1sourceNVARCHAR2(10)来源

2idNVARCHAR2(50)主键

3truckNoNVARCHAR2(8)车牌号

4illTimeDATE违规时间YYYYMMDDHHMISS

5illDescNVARCHAR2(100)违规描述

6illBcsNVARCHAR2(100)违规原因

7beginTimeDATE停牌开始时间YYYYMMDDHHMISS

8endTimeDATE停牌结束时间YYYYMMDDHHMISS

9truckTeamNVARCHAR2(20)车队

10managerNVARCHAR2(20)管理

11operNameNVARCHAR2(20)操作人

12operDateDATE操作时间YYYYMMDDHHMISS

13remarkNVARCHAR2(20)备注

4

DB2102/T0125—2024

表4（续）

14delFlagNVARCHAR2(1)删除标记

15delOperNameNVARCHAR2(20)删除操作人

16delDateDATE删除时间YYYYMMDDHHMISS

17checkUserNVARCHAR2(10)违规查处人

18businessTypeNVARCHAR2(1)业务类型C:新增,D:删除

返回对象

序号数据项类型长度数据说明备注/示例

SUCC：处理成功

1statusNVARCHAR2(4)提示信息代码

FAIL：处理失败

2statusNVARCHAR2(100)提示信息描述返回提示信息描述

7.3虚拟提箱接口

功能描述：调用虚拟提箱接口，根据优先提箱作业区虚拟提箱并推送提箱操作条信息。

请求参数见表5。

表5虚拟提箱接口请求参数

序号数据项类型长度数据说明备注/示例

1bizIdNVARCHAR2(36)车辆ID

2workAreaNVARCHAR2(1)优先提箱区P:二区，C:一区

7.4异常车辆重新入港接口

功能描述：调用车辆重新入港操作，并推送电子操作条。

请求参数见表6。

表6异常车辆重新入港接口请求参数

参数内容

序号数据项类型长度数据说明备注/示例

1bizIdNVARCHAR2(36)车辆ID

返回结果

序号数据项类型长度数据说明