1.URL

http://124.223.60.234:8080/system/maintenance/service/queryMaintenanceServiceList

2.请求参数

2.1请求头

token:对应登录验证成功后，data里面对应的tokenId

2.2.参数示例

{
    "vehicleIds":["A9663EC8624649AC9DD7CD6507A5FDC3","E98E3532A36745C99A8EF34298291005"],
    "key":"",
    "startTime":"2025-11-01 00:00:00",
    "endTime":"2025-11-20 00:00:00",
    "pageNum":1,
    "pageSize":20
}

2.3.参数说明

字段 类型 说明 是否必须
vehicleIds List 资产唯一标识集合 Y
key String 模糊查询key Y
startTime String 开始时间（UTC） Y
endTime String 结束时间（UTC） Y
pageNum int 分页查询当前页码，默认1 Y
pageSize int 分页查询每页显示条数，默认20 Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "total": 2,
        "size": 1,
        "data": [
            {
                "autoId": 1,
                "orgId": "CDC0381F93B14C3DBB6EC10BB2FD928B",
                "orgName": "河北兆雪科技有限公司",
                "vehicleId": "A9663EC8624649AC9DD7CD6507A5FDC3",
                "vehicleInfo": {
                    "vehicleId": "A9663EC8624649AC9DD7CD6507A5FDC3",
                    "vehicleNum": "VL300-4209",
                    "vehicleIcon": 0,
                    "make": null,
                    "model": null,
                    "vin": null,
                    "year": null
                },
                "serviceTypeId": "C647C6DC090E479395D4FDB94C07496F",
                "serviceType": "Oil Change",
                "supplierId": "41415068A1434A258ABE0AA22FB361AD",
                "supplier": "TOYOTA",
                "occurrence": 0,
                "status": 0,
                "dateTime": "2025-11-13 00:00:00",
                "mileage": 126.0,
                "engineHours": 0.0,
                "currentMileage": 122.5,
                "currentEngineHours": 0.0,
                "serviceName": "xxxxxxxx",
                "cost": 260.0,
                "invoiceNum": "545454SSVC5656",
                "descInfo": "ssssssssssssssssssss",
                "workInfoList": [
                    {
                        "id": "4C1BA7C87D2D48A3BA80DF0200A526CE",
                        "workName": "Oil",
                        "workTypeId": "E2B51D968EFE419F96CC154B7312EF15",
                        "workType": "Oil Change",
                        "count": 2,
                        "price": 30.0,
                        "completed": 0,
                        "descInfo": null
                    },
                    {
                        "id": "DF29C1ADA353496084C5110BC36DAC2C",
                        "workName": "Oil Change",
                        "workTypeId": "E2B51D968EFE419F96CC154B7312EF15",
                        "workType": "Oil Change",
                        "count": 2,
                        "price": 30.0,
                        "completed": 0,
                        "descInfo": null
                    }
                ],
                "partInfoList": [
                    {
                        "id": "12D109E9EF9D4BBC88F8293A52556F17",
                        "partName": "Oil X",
                        "partCode": null,
                        "partTypeId": "C46ED44B0D1A4B72B2063A4C2A2B6693",
                        "partType": "Oil",
                        "supplierId": "969C410D86A24F6E8F0530056F732E79",
                        "supplier": "BYD",
                        "count": 2,
                        "price": 30.0,
                        "descInfo": null
                    },
                    {
                        "id": "44B54D74E38343A08B883D3AD93364E3",
                        "partName": "Oil",
                        "partCode": null,
                        "partTypeId": "C46ED44B0D1A4B72B2063A4C2A2B6693",
                        "partType": "Oil",
                        "supplierId": "969C410D86A24F6E8F0530056F732E79",
                        "supplier": "BYD",
                        "count": 2,
                        "price": 40.0,
                        "descInfo": null
                    }
                ],
                "createTime": "2025-11-13 08:52:47",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "LEAVE"
            },
            {
                "autoId": 2,
                "orgId": "03D7372C6F494C60BAD4A240692B6FA6",
                "orgName": "2022",
                "vehicleId": "E98E3532A36745C99A8EF34298291005",
                "vehicleInfo": {
                    "vehicleId": "E98E3532A36745C99A8EF34298291005",
                    "vehicleNum": "413050336196",
                    "vehicleIcon": 0,
                    "make": null,
                    "model": null,
                    "vin": null,
                    "year": null
                },
                "serviceTypeId": "C647C6DC090E479395D4FDB94C07496F",
                "serviceType": "Oil Change",
                "supplierId": "41415068A1434A258ABE0AA22FB361AD",
                "supplier": "TOYOTA",
                "occurrence": 0,
                "status": 0,
                "dateTime": "2025-11-13 00:00:00",
                "mileage": 3546.0,
                "engineHours": 0.0,
                "currentMileage": 261.3,
                "currentEngineHours": 0.0,
                "serviceName": "cccccccc",
                "cost": 260.0,
                "invoiceNum": "545454SSVC5656",
                "descInfo": "ssssssssssssssssssss",
                "workInfoList": [
                    {
                        "id": "4C1BA7C87D2D48A3BA80DF0200A526CE",
                        "workName": "Oil",
                        "workTypeId": "E2B51D968EFE419F96CC154B7312EF15",
                        "workType": "Oil Change",
                        "count": 2,
                        "price": 30.0,
                        "completed": 0,
                        "descInfo": null
                    },
                    {
                        "id": "DF29C1ADA353496084C5110BC36DAC2C",
                        "workName": "Oil Change",
                        "workTypeId": "E2B51D968EFE419F96CC154B7312EF15",
                        "workType": "Oil Change",
                        "count": 2,
                        "price": 30.0,
                        "completed": 0,
                        "descInfo": null
                    }
                ],
                "partInfoList": [
                    {
                        "id": "12D109E9EF9D4BBC88F8293A52556F17",
                        "partName": "Oil X",
                        "partCode": null,
                        "partTypeId": "C46ED44B0D1A4B72B2063A4C2A2B6693",
                        "partType": "Oil",
                        "supplierId": "969C410D86A24F6E8F0530056F732E79",
                        "supplier": "BYD",
                        "count": 2,
                        "price": 30.0,
                        "descInfo": null
                    },
                    {
                        "id": "44B54D74E38343A08B883D3AD93364E3",
                        "partName": "Oil",
                        "partCode": null,
                        "partTypeId": "C46ED44B0D1A4B72B2063A4C2A2B6693",
                        "partType": "Oil",
                        "supplierId": "969C410D86A24F6E8F0530056F732E79",
                        "supplier": "BYD",
                        "count": 2,
                        "price": 40.0,
                        "descInfo": null
                    }
                ],
                "createTime": "2025-11-13 08:52:47",
                "creatorId": "F940B79790004404AAC277418FC71C5D",
                "creator": "LEAVE"
            }
        ]
    }
}

3.2.返回结果说明

字段 类型 说明
code int 返回状态
message String 返回结果描述
data object 返回结果体

data说明

字段 类型 说明
total String 总条数
size String 多少页
data object 每页的结果集合

data说明

字段 类型 说明
autoId String 唯一标识
orgId String 组织唯一标识
orgName String 组织名称
vehicleId String 车辆唯一标识
vehicleInfo Object 车辆信息
serviceTypeId String 服务类型唯一标识
serviceType String 服务类型
supplierId String 供应商唯一标识
supplier String 供应商
occurrence Integer 执行次数（0：单次服务；1：周期服务）
status Integer 状态（默认为 0； 0 - 待处理、1 - 已完成）
dateTime String 业务发生时间，格式为 “yyyy-MM-dd HH:mm:ss”
mileage String 当时里程值
engineHours String 当时发动机工作时长
currentMileage String 当前里程值
currentEngineHours String 当前发动机工作时长
serviceName String 服务名称
cost String 服务金额
invoiceNum String 发票编号，唯一标识一张发票
workInfoList List 工作项信息列表
workInfoList.id String 工作项唯一标识
workInfoList.workName String 工作项
workInfoList.workTypeId String 工作项类型
workInfoList.workType String 工作项类型名称
workInfoList.count Integer 工作项数量
workInfoList.price Double 工作项单价
workInfoList.completed String 是否完成
partInfoList List 配件信息列表
partInfoList.id String 配件唯一标识
partInfoList.count Integer 配件数量
partInfoList.price Double 配件单价
createTime String 创建时间
creatorId String 创建用户唯一标识
creator String 创建用户
vehicleInfo车辆信息
字段 类型 说明
vehicleId String 车辆唯一标识
vehicleNum String 资产编号
vehicleIcon String 资产图标
make String 制造商
model String 型号
vin String VIN
year String 生产年份
Author：admin  Create time：2025-11-13 16:20
Last editor：admin  Update time：2025-11-24 14:17