DB3201/T 1241-2024 航运物流数据交互规范

《航运物流数据交互规范》主要内容总结

1. ​​范围与目的​​

• 适用于南京市航运物流企业、政府部门间的数据共享与标准化建设，涵盖船舶、车辆、集装箱及干散货的数据交互。
• 规范数据元定义、接口交互方式及安全要求，旨在提升航运物流数据交换的效率和一致性。

2. ​​规范性引用文件​​

• 引用国家标准如GB/T 1.1（标准化文件起草规则）、GB/T 39477-2020（政务数据安全要求）、JT/T 697系列（交通信息数据元标准）等，确保技术合规性。

3. ​​术语与定义​​

• ​​数据元​​：由属性定义的最小数据单元，如“MMSI编号”“中文船名”。
• ​​属性​​：描述数据特性的字段，如数据类型、格式、长度。
• ​​符号规范​​：a（字母/汉字）、n（数字）、YYYYMMDDhhmmss（日期时间格式）。

4. ​​数据元标准化​​

分为船舶、车辆、集装箱、干散货四类，共35个核心数据元表，部分示例如下：

​​4.1 船舶数据​​

• ​​船舶信息​​：MMSI编号（9位数字）、中文/英文船名（字符型）、船籍、总吨/净吨（数值型）、船尺寸（长/宽）等。
• ​​航线与航次​​：航线名称（如“上海-南京”）、航向代码、进出口航次编号、靠泊/离泊时间（日期时间型）。
• ​​进出港动态​​：到达港/下一港名称、泊位信息、动态状态（进/出港标识）。

​​4.2 车辆数据​​

• ​​集装箱运输车辆进出闸​​：箱号（12位字符）、箱主、箱型（如GP通用箱）、提单号（20位字符）、进出场标识。

​​4.3 集装箱数据​​

• ​​基础信息​​：箱号、箱主、箱型、空重状态（空箱/重箱）。
• ​​作业动态​​：装卸船关联的船名、航次、提单号；铁水联运到发站、进/出港量统计（数值型）。
• ​​铁水联运箱动态​​：作业时间、运输方式（铁路/水路）、货名、箱位分类及位置。

​​4.4 干散货数据​​

• 装卸船关联的货主、货物类型（如煤炭/矿石）、装卸量、操作时间。

​​数据元属性规范​​

• ​​数据类型​​：字符型（an）、数值型（n）、日期时间型（YYYYMMDDhhmmss）。
• ​​长度限制​​：如中文船名最长70字符，提单号20字符。
• ​​引用来源​​：多数船舶数据元引用JT/T 697.5，港口数据引用JT/T 697.3。

5. ​​交互与接口要求​​

​​5.1 交互方式​​

• ​​API调用​​：支持HTTP的POST/GET请求。
• ​​主动推送​​：数据变动时实时推送（如船舶离港）。
• ​​被动轮询​​：定时查询接口获取数据（如每日统计报表）。

​​5.2 接口规范​​

• ​​地址与URI​​：直观标识功能（如/api/ship/arrival）。
• ​​参数格式​​：输入/输出采用JSON，例如：

  {  "MMSI": "123456789",  "ShipName": "长江号",  "ArrivalTime": "20231015143000"}

• ​​状态码​​：附录C示例（如000000成功，102104签名失效）。

6. ​​数据安全​​

• ​​传输加密​​：强制使用SSL/TLS协议。
• ​​数据脱敏​​：敏感信息（如货主名称）需脱敏处理。
• ​​监控与阻断​​：实时监控传输过程，异常时告警并阻断连接。
• ​​合规性​​：符合GB/T 39477-2020中政务数据共享的安全框架。

7. ​​附录内容​​

• ​​附录A（规范性）​​：详细定义所有数据元的标识、类型、格式及引用来源。
• ​​附录B（资料性）​​：交互方式示意图（主动推送/被动轮询流程）。
• ​​附录C（资料性）​​：状态码示例（共14种，覆盖接口调用各类异常）。

8. ​​实施与责任​​

• ​​归口单位​​：南京市交通运输局。
• ​​起草单位​​：南京航运交易中心、华设设计集团等。
• ​​适用范围​​：虽为南京市地方标准，但技术框架可扩展至其他区域。

9. ​​核心价值​​

• ​​标准化​​：统一数据定义，消除企业间数据异构性。
• ​​效率提升​​：通过API实现自动化交互，减少人工干预。
• ​​安全合规​​：强化数据保护，满足法规要求。
• ​​可扩展性​​：支持铁水联运等复杂业务场景的数据整合。