一、 维修保养品牌

日期	版本	修订内容摘要
2024-09-20	v1.0.0

1.维修保养报告品牌下单接口

1.协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	multipart/form-data
URL	https://wsapi.253.com/open/vehicleMaintenance/brandManReportPurchase

2.请求参数说明

请求参数 Body 以 multipart/form-data 方式提交

参数名	类型	是否必填	说明
appId	String	是	请在https://www.chuanglan.com/ 登录后获取
appKey	String	是	请在https://www.chuanglan.com/ 登录后获取
vin	String	是	车架号
xszUrl	String	是	行驶证照片URL
callbackUrl	String	是	推送回调地址，推送该订单的状态，示例{"ret_code":2000,"order_no":"f6de58d199014f23b6861b15a3006b23"}
carNum	String	是	车牌号
eng	String	是	发动机编号

3.响应参数说明

响应 body 数据为 JSON 格式

字段名	类型	说明
chargeStatus	int	1:收费；0：不收费
code	String	响应 code 码。200000：成功，50000：失败
reqId	String	请求 ID
chargeCount	String	计费条数
message	String	响应 code 码解释
data	Object	返回对象
result	String	业务数据，需 base64 解码，具体见下方示例

4.查询成功示例

复制成功
{
    "code": "200000",
    "message": "success",
    "reqId": "3234152489695715498",
    "chargeStatus": 1,
    "chargeCount": "1",
    "data": {
        "result": "eyJvcmRlcklkIjoiZjZkZTU4ZDE5OTAxNGYyM2I2ODYxYjE1YTMwMDZiMjMifQ=="
    }
}

复制成功
result的base64解码后如下，该数据用于维保查询的请求参数。
{"orderId":"f6de58d199014f23b6861b15a3006b23"}

2.维修保养报告品牌查询接口

1.协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	multipart/form-data
URL	https://wsapi.253.com/open/vehicleMaintenance/brandManReportQuery

2.请求参数说明

请求参数 Body 以 multipart/form-data 方式提交

参数名	说明
order_no	订单号，报告下单接口返回的数据。

3.响应参数说明

响应 body 数据为 JSON 格式

字段名	类型	说明
chargeStatus	int	1:收费；0：不收费
code	String	响应 code 码。200000：成功，50000：失败
reqId	String	请求 ID
chargeCount	String	计费条数
message	String	响应 code 码解释
data	Object	业务数据对象，具体见下方示例

data 解码后的字段描述

字段名	类型	说明
lastTimeToShop	String	最后到店时间
brand	String	信息
orderId	String	订单号
data	Array	具体的品牌维保信息
resultDescription	String	事物描述
date	String	时间
mileage	String	里程
material	String	材料
content	String	具体内容
remark	String	备注
createdAt	String	数据获取的时间

4.查询成功示例

复制成功
{
    "code": "200000",
    "message": "success",
    "reqId": "3234152489695715500",
    "chargeStatus": 0,
    "data": {
        "data": [
            {
                "date": "2022-11-14",
                "createdAt": "2024-09-27 14:21:02",
                "material": "鳄鱼纹系列包围脚垫-五座-克莱维;侧挡隔热膜-灰色风暴灰-;前挡隔热膜-太空美景-;大连鸿升装甲;",
                "content": "销售;膜;销售;脚垫;装潢美容;装甲;",
                "mileage": "20"
            },
            {
                "date": "2023-03-10",
                "createdAt": "2024-09-27 14:21:02",
                "material": "后悬架减震器总成;",
                "content": "索赔;后悬架减震器总成-右-更换;售后保修;索赔;",
                "mileage": "11844"
            },
            {
                "date": "2023-08-07",
                "createdAt": "2024-09-27 14:21:02",
                "content": "返工;车间诊断;返工;",
                "mileage": "30211"
            },
            {
                "date": "2023-08-17",
                "createdAt": "2024-09-27 14:21:02",
                "material": "彩屏收音机模块总成;",
                "content": "索赔;彩屏收音机模块总成-更换;索赔;售后保修;",
                "mileage": "31233"
            },
            {
                "date": "2024-07-08",
                "createdAt": "2024-09-27 14:21:02",
                "material": "彩屏收音机模块总成;",
                "content": "索赔;导航显示器模块总成-更换;索赔;售后保修;",
                "mileage": "70229"
            }
        ],
        "orderId": "f6de58d199014f23b6861b15a3006b23",
        "lastTimeToShop": "2024-07-08",
        "brand": "荣威"
    }
}

报告暂未生成提示示例

复制成功
{
    "code": "109",
    "message": "报告暂未生成，请稍后重试",
    "reqId": "3144076797768777824",
    "chargeStatus": 0,
    "data": null
}