跳转至

清洁运输数据接口技术文档

📄 创建: 段晋明 2026-08-07 · 修改: JimWb 2026-08-07

https://doc.xpku.com/raw/products/emission/mjsjjkxusm.md

中建材信云智联科技有限公司 · 2025 年 4 月

修订历史

版本 变更日期 描述 修订人
V1.0 2025-04-16 初始版本 于灯超
V1.1 2025-05-26 修改进厂记录、台账接口 于灯超

一、概述

超低排放系统在各工厂建立全流程电子台账,记录车辆档案、出入数据、环保设施运行数据与排放数据等,通过工业互联网平台进行数据采集,经数据治理后形成高质量的超低排放数据资产,再通过驾驶舱、报表等方式展示,实现数据可视、可追溯,便于第三方审查与监督。

二、接口需求

根据相关政策和指南要求,门禁系统需向超低排放系统上报以下三项数据:

  1. 进出厂运输车辆台账
  2. 车辆进厂历史记录
  3. 车辆出厂历史记录

三、接口方式

目前提供两种接口方式,网络允许情况下优先使用第一种(企业内网推送)。

测试环境

  • Host:dns.hedpy.cn
  • Port:5182

门禁系统通过企业内网向超低排放系统推送数据,统一采用 POST 方式,在请求 Header 中携带 token 进行认证,请求体为 JSON 数组

3.1 车辆台账

内容
请求地址 http://host:port/emission-api/vehicle/vehicleRecords
请求方式 POST
认证 Header token
请求体 JSON 数组,字段如下
字段 类型 说明
belongsCompany string 所有人(单位)
brandModel string 车辆品牌型号
carList string 随车清单
corpCode string 公司编码
emissionStage string 排放阶段(枚举,见第五部分)
engineNo string 发动机号码
entryGateNo string 进口道闸编号
entryNo string 入口编号
entryTime datetime 进厂时间
exitGateNo string 出口道闸编号
exitNo string 出口编号
exitTime datetime 出厂时间
fuelType string 燃料类型(枚举,见第五部分)
licensePhoto string 行驶证照片地址
licensePlate string 车牌号
networkStatus string 联网状态(枚举,见第五部分)
plateColor string 车牌颜色(枚举,见第五部分)
productDate string 出产登记日期
registrationDate string 注册登记日期
vin string 车辆识别代码

3.2 车辆进厂历史记录

内容
请求地址 http://host:port/emission-api/vehicle/entry
请求方式 POST
认证 Header token
请求体 JSON 数组,字段如下
字段 类型 说明
accessType string 访问类型(进厂:in
brandModel string 车辆品牌型号
corpCode string 公司编码
emissionStage string 排放阶段(枚举,见第五部分)
engineNo string 发动机号码
entryCargoName string 进厂运输货物名称
entryGateNo string 进口道闸编号
entryGrossWeight number 进厂毛重(吨)
entryNetWeight number 进厂净重(吨)
entryNo string 入口编号
entryPhoto string 进厂照片存储路径
entryTareWeight number 进厂皮重(吨)
entryTime datetime 进厂时间
exitCargoName string 出厂运输货物名称
exitGateNo string 出口道闸编号
exitGrossWeight number 出厂毛重(吨)
exitNetWeight number 出厂净重(吨)
exitNo string 出口编号
exitPhoto string 出厂照片存储路径
exitTareWeight number 出厂皮重(吨)
exitTime datetime 出厂时间
fleetName string 车队名称
fuelType string 燃料类型(枚举,见第五部分)
licensePhoto string 行驶证照片路径
licensePlate string 车牌号
liftingMethod string 抬杆方式(枚举,见第五部分)
manifestAttachment string 随车清单附件路径
manualLiftPhoto string 手动抬杆照片路径
networkStatus string 联网状态(枚举,见第五部分)
plateColor string 车牌颜色(枚举,见第五部分)
registrationDate date 注册登记日期
usageType string 使用性质(枚举,见第五部分)
vehicleType string 车辆类型(枚举,见第五部分)
vin string 车辆识别代码

3.3 车辆出厂历史记录

内容
请求地址 http://host:port/emission-api/vehicle/exit
请求方式 POST
认证 Header token
请求体 JSON 数组,字段与「3.2 车辆进厂历史记录」一致,仅 accessType 固定为 out(出厂)

提示:进厂与出厂接口字段完全相同,区别仅在于 accessTypein / out),可共用同一套字段解析逻辑。

四、数据基本信息(表结构)

4.1 车辆台账

字段 类型 说明
id int 自增主键
license_plate varchar(100) 车牌号
vin varchar(50) 车辆识别代码
plate_color varchar(100) 车牌颜色
product_date date 出产登记日期
registration_date date 注册登记日期
brand_model varchar(100) 车辆品牌型号
engine_no varchar(50) 发动机号码
fuel_type varchar(20) 燃料类型
emission_stage varchar(10) 排放阶段
network_status varchar(20) 联网状态
car_list varchar(255) 随车清单
license_photo varchar(255) 行驶证
belongs_company varchar(50) 所有人(单位)
transport_type varchar(20) 运输类型(默认 0)
def1 ~ def10 varchar(255) 备用属性 1 ~ 10
corp_code varchar(50) 公司编码
created_by bigint 创建人
created_time datetime 创建时间
updated_by bigint 更新人
updated_time datetime 更新时间
entry_no varchar(100) 入口编号
exit_no varchar(100) 出口编号
entry_gate_no varchar(200) 进口闸刀编号
exit_gate_no varchar(255) 出口闸刀编号
entry_time datetime 进厂时间
exit_time datetime 出厂时间

4.2 车辆进出厂历史记录

字段 类型 说明
id int 自增主键
entry_no varchar(100) 入口编号
exit_no varchar(100) 出口编号
entry_gate_no varchar(200) 进口闸刀编号
exit_gate_no varchar(255) 出口闸刀编号
lifting_method varchar(20) 抬杆方式(自动识别 / 人工抬杆 / 远程控制)
entry_time datetime 进厂时间
exit_time datetime 出厂时间
vehicle_type varchar(50) 车辆类型(字典)
plate_color varchar(100) 车牌颜色
license_plate varchar(100) 车牌号
registration_date date 注册登记日期
vin varchar(50) 车辆识别代码
brand_model varchar(100) 车辆品牌型号
engine_no varchar(50) 发动机号码
fuel_type varchar(20) 燃料类型
emission_stage varchar(10) 排放阶段
usage_type varchar(50) 使用性质
network_status varchar(20) 联网状态
entry_cargo_name varchar(100) 进厂运输货物名称
entry_net_weight decimal(20,8) 进厂净重(吨)
entry_gross_weight decimal(20,8) 进厂毛重(吨)
entry_tare_weight decimal(20,8) 进厂皮重(吨)
exit_cargo_name varchar(100) 出厂运输货物名称
exit_net_weight decimal(20,8) 出厂净重(吨)
exit_gross_weight decimal(20,8) 出厂毛重(吨)
exit_tare_weight decimal(20,8) 出厂皮重(吨)
fleet_name varchar(100) 车队名称
entry_photo varchar(255) 进厂照片存储路径
exit_photo varchar(255) 出厂照片存储路径
manifest_attachment varchar(255) 随车清单附件路径
license_photo varchar(255) 行驶证照片路径
manual_lift_photo varchar(255) 手动抬杆照片路径
def1 ~ def10 varchar(255) 备用属性 1 ~ 10
corp_code varchar(50) 公司编码
created_by bigint 创建人
created_time datetime 创建时间
updated_by bigint 更新人
updated_time datetime 更新时间
access_type varchar(20) 访问类型

五、数据字典(附件)

以下枚举值供上述接口字段引用。

5.1 抬杆方式(lifting_method)

字典值 说明
AUTO 自动识别
HAND 人工抬杆
REMOTE 远程控制

5.2 车牌颜色(plate_color)

字典值 说明
1 蓝色车牌
2 黄色车牌
3 白色车牌
4 黑色车牌
5 绿色车牌
6 黄绿色车牌

5.3 汽车燃料类型(fuel_type)

字典值 说明
A 汽油
B 柴油
C 电力
D 混合油
E 天然气
F 液化石油气
L 甲醇
M 乙醇
N 太阳能
O 混合动力
P
Q 生物燃料
Y
Z 其他

5.4 排放阶段(emission_stage)

字典值 说明
0 国0
1 国1
2 国2
3 国3
4 国4
5 国五
6 国六
6a 国六a
6b 国六b
D 零排放
99 未登记

5.5 联网状态(network_status)

字典值 说明
0 已联网
1 未联网

5.6 使用性质(usage_type)

字典值 说明
01 营运车辆
02 非营运车辆
A 非营运
B 公路客运
C 公交客运
D 出租客运
E 旅游客运
F 货运
G 租赁
H 警用
I 消防
J 救护
K 工程抢险
L 营转非
M 出租转非
N 教练
O 幼儿校车
P 小学生校车
Q 初中生校车
R 危险品运输
S 中小学生校车

5.7 机械种类

字典值 说明
01 工程机械
02 农业机械
03 厂内运输
04 其它

5.8 运输类型(transport_type)

字典值 说明
01 火车
02 汽车

5.9 车辆类型(vehicle_type)

字典值编码规律:首字母表示大类(B=半挂车、G=全挂车、H=货车、K=客车、M=摩托车、N=三轮汽车、Q=牵引车、T=拖拉机、X=其它、Z=专项作业车),后续数字为细分。

字典值 说明
01 载货汽车
02 客车
03 特种车
04 罐车
05 厢式货车
06 自卸车
07 牵引车
X99 其它
B11 重型栏板半挂车
B12 重型厢式半挂车
B13 重型罐式半挂车
B14 重型平板半挂车
B15 重型集装箱半挂车
B16 重型自卸半挂车
B17 重型特殊结构半挂车
B18 重型仓栅式半挂车
B19 重型旅居半挂车
B1A 重型专项作业半挂车
B1B 重型低平板半挂车
B1C 重型车辆运输半挂车
B1D 重型罐式自卸半挂车
B1E 重型平板自卸半挂车
B1F 重型集装箱自卸半挂车
B1G 重型特殊结构自卸半挂车
B1H 重型仓栅式自卸半挂车
B1J 重型专项作业自卸半挂车
B1K 重型低平板自卸半挂车
B1L 重型专门用途半挂车
B1U 重型中置轴旅居挂车
B1V 重型中置轴车辆运输挂车
B1W 重型中置轴普通挂车
B21 中型栏板半挂车
B22 中型厢式半挂车
B23 中型罐式半挂车
B24 中型平板半挂车
B25 中型集装箱半挂车
B26 中型自卸半挂车
B27 中型特殊结构半挂车
B28 中型仓栅式半挂车
B29 中型旅居半挂车
B2A 中型专项作业半挂车
B2B 中型低平板半挂车
B2C 中型车辆运输半挂车
B2D 中型罐式自卸半挂车
B2E 中型平板自卸半挂车
B2F 中型集装箱自卸半挂车
B2G 中型特殊结构自卸半挂车
B2H 中型仓栅式自卸半挂车
B2J 中型专项作业自卸半挂车
B2K 中型低平板自卸半挂车
B2L 中型专门用途半挂车
B2U 中型中置轴旅居挂车
B2V 中型中置轴车辆运输挂车
B2W 中型中置轴普通挂车
B31 轻型栏板半挂车
B32 轻型厢式半挂车
B33 轻型罐式半挂车
B34 轻型平板半挂车
B35 轻型自卸半挂车
B36 轻型仓栅式半挂车
B37 轻型旅居半挂车
B38 轻型专项作业半挂车
B39 轻型低平板半挂车
B3C 轻型车辆运输半挂车
B3D 轻型罐式自卸半挂车
B3E 轻型平板自卸半挂车
B3F 轻型集装箱自卸半挂车
B3G 轻型特殊结构自卸半挂车
B3H 轻型仓栅式自卸半挂车
B3J 轻型专项作业自卸半挂车
B3K 轻型低平板自卸半挂车
B3L 轻型专门用途半挂车
B3U 轻型中置轴旅居挂车
B3V 轻型中置轴车辆运输挂车
B3W 轻型中置轴普通挂车
B41 微型栏板半挂车
B42 微型厢式半挂车
B43 微型罐式半挂车
B44 微型平板半挂车
B45 微型自卸半挂车
B46 微型仓栅式半挂车
B47 微型旅居半挂车
B48 微型专项作业半挂车
B49 微型低平板半挂车
B4C 微型车辆运输半挂车
B4D 微型罐式自卸半挂车
B4E 微型平板自卸半挂车
B4F 微型集装箱自卸半挂车
B4G 微型特殊结构自卸半挂车
B4H 微型仓栅式自卸半挂车
B4J 微型专项作业自卸半挂车
B4K 微型低平板自卸半挂车
B4L 微型专门用途半挂车
B4U 微型中置轴旅居挂车
B4V 微型中置轴车辆运输挂车
B4W 微型中置轴普通挂车
D11 无轨电车
D12 有轨电车
G11 重型栏板全挂车
G12 重型厢式全挂车
G13 重型罐式全挂车
G14 重型平板全挂车
G15 重型集装箱全挂车
G16 重型自卸全挂车
G17 重型仓栅式全挂车
G18 重型旅居全挂车
G19 重型特殊用途全挂车
G1A 重型厢式自卸全挂车
G1B 重型罐式自卸全挂车
G1C 重型平板自卸全挂车
G1D 重型集装箱自卸全挂车
G1E 重型仓栅式自卸全挂车
G1F 重型特殊用途自卸全挂车
G21 中型栏板全挂车
G22 中型厢式全挂车
G23 中型罐式全挂车
G24 中型平板全挂车
G25 中型集装箱全挂车
G26 中型自卸全挂车
G27 中型仓栅式全挂车
G28 中型旅居全挂车
G29 中型特殊用途全挂车
G2A 中型厢式自卸全挂车
G2B 中型罐式自卸全挂车
G2C 中型平板自卸全挂车
G2D 中型集装箱自卸全挂车
G2E 中型仓栅式自卸全挂车
G2F 中型特殊用途自卸全挂车
G31 轻型栏板全挂车
G32 轻型厢式全挂车
G33 轻型罐式全挂车
G34 轻型平板全挂车
G35 轻型自卸全挂车
G36 轻型仓栅式全挂车
G37 轻型旅居全挂车
G38 轻型特殊用途全挂车
G3A 轻型厢式自卸全挂车
G3B 轻型罐式自卸全挂车
G3C 轻型平板自卸全挂车
G3D 轻型集装箱自卸全挂车
G3E 轻型仓栅式自卸全挂车
G3F 轻型特殊用途自卸全挂车
G41 微型栏板全挂车
G42 微型厢式全挂车
G43 微型罐式全挂车
G44 微型平板全挂车
G45 微型自卸全挂车
G46 微型仓栅式全挂车
G48 微型特殊用途全挂车
G4A 微型厢式自卸全挂车
G4B 微型罐式自卸全挂车
G4C 微型平板自卸全挂车
G4D 微型集装箱自卸全挂车
G4E 微型仓栅式自卸全挂车
G4F 微型特殊用途自卸全挂车
H11 重型栏板货车
H12 重型厢式货车
H13 重型封闭式货车
H14 重型罐式货车
H15 重型平板货车
H16 重型集装箱车
H17 重型自卸货车
H18 重型特殊结构货车
H19 重型仓栅式货车
H1A 重型车辆运输车
H1B 重型厢式自卸货车
H1C 重型罐式自卸货车
H1D 重型平板自卸货车
H1E 重型集装箱自卸货车
H1F 重型特殊结构自卸货车
H1G 重型仓栅式自卸货车
H1J 重型专门用途货车
H21 中型栏板货车
H22 中型厢式货车
H23 中型封闭式货车
H24 中型罐式货车
H25 中型平板货车
H26 中型集装箱车
H27 中型自卸货车
H28 中型特殊结构货车
H29 中型仓栅式货车
H2A 中型车辆运输车
H2B 中型厢式自卸货车
H2C 中型罐式自卸货车
H2D 中型平板自卸货车
H2E 中型集装箱自卸货车
H2F 中型特殊结构自卸货车
H2G 中型仓栅式自卸货车
H2J 中型专门用途货车
H31 轻型栏板货车
H32 轻型厢式货车
H33 轻型封闭式货车
H34 轻型罐式货车
H35 轻型平板货车
H37 轻型自卸货车
H38 轻型特殊结构货车
H39 轻型仓栅式货车
H3A 轻型车辆运输车
H3B 轻型厢式自卸货车
H3C 轻型罐式自卸货车
H3D 轻型平板自卸货车
H3F 轻型特殊结构自卸货车
H3G 轻型仓栅式自卸货车
H3H 轻型多用途货车
H3J 轻型专门用途货车
H41 微型栏板货车
H42 微型厢式货车
H43 微型封闭式货车
H44 微型罐式货车
H45 微型自卸货车
H46 微型特殊结构货车
H47 微型仓栅式货车
H4A 微型车辆运输车
H4B 微型厢式自卸货车
H4C 微型罐式自卸货车
H4F 微型特殊结构自卸货车
H4G 微型仓栅式自卸货车
H4H 微型多用途货车
H4J 微型专门用途货车
H51 栏板低速货车
H52 厢式低速货车
H53 罐式低速货车
H54 自卸低速货车
H55 仓栅式低速货车
H5B 厢式自卸低速货车
H5C 罐式自卸低速货车
J11 轮式装载机械
J12 轮式挖掘机械
J13 轮式平地机械
K11 大型普通客车
K12 大型双层客车
K13 大型卧铺客车
K14 大型铰接客车
K15 大型越野客车
K16 大型轿车
K17 大型专用客车
K18 大型专用校车
K1A 大型旅居车
K21 中型普通客车
K22 中型双层客车
K23 中型卧铺客车
K24 中型铰接客车
K25 中型越野客车
K26 中型轿车
K27 中型专用客车
K28 中型专用校车
K2A 中型旅居车
K31 小型普通客车
K32 小型越野客车
K33 小型轿车
K34 小型专用客车
K38 小型专用校车
K39 小型面包车
K3A 小型旅居车
K41 微型普通客车
K42 微型越野客车
K43 微型轿车
K49 微型面包车
K4A 微型旅居车
M11 普通正三轮摩托车
M12 轻便正三轮摩托车
M13 正三轮载客摩托车
M14 正三轮载货摩托车
M15 侧三轮摩托车
M21 普通二轮摩托车
M22 轻便二轮摩托车
N11 三轮汽车
Q11 重型半挂牵引车
Q12 重型全挂牵引车
Q21 中型半挂牵引车
Q22 中型全挂牵引车
Q31 轻型半挂牵引车
Q32 轻型全挂牵引车
T11 大型轮式拖拉机
T21 小型轮式拖拉机
T22 手扶拖拉机
T23 手扶变形运输机
Z11 大型非载货专项作业车
Z12 大型载货专项作业车
Z21 中型非载货专项作业车
Z22 中型载货专项作业车
Z31 小型非载货专项作业车
Z32 小型载货专项作业车
Z41 微型非载货专项作业车
Z42 微型载货专项作业车
Z51 重型非载货专项作业车
Z52 重型载货专项作业车
Z71 轻型非载货专项作业车
Z72 轻型载货专项作业车