新增车辆

请求地址

https://www.xxyb.cn/union/api/wlpt/consignor/createVehicle

参数名	必选	类型	说明
Token	是	String	应用令牌
cid	是	String	合作ID

注意事项

部分字段是否必填由业务决定，请联系对接方获取

请求参数

参数名	必选	类型	层级	说明	备注
vehicleBasicDomain	是	Object	1	车辆基础信息
licensePlateNumber	是	String	2	车辆牌号
licensePlateColor	是	Enum	2	车牌颜色	见下方`车牌颜色`
vehicleAuthDomain	否	Object	1	车辆认证信息
vehicleType	是	Enum	2	车型	见下方`车型`
vehicleLength	是	Decimal	2	车长	单位：米
vehicleEnergyType	是	Enum	2	车辆能源类型	见下方`车辆能源类型`
vehicleIdentificationNumber	是	String	2	车辆识别代码
vehicleLicenseFrontImg	是	String	2	行驶证正面图片
vehicleLicenseBackImg	是	String	2	行驶证反面图片
vehicleLicenseClipImg	否	String	2	行驶证夹页面图片
vehicleLicenseRegisterTime	是	String	2	行驶证注册时间	yyyy-MM-dd
vehicleLicenseExpireTime	是	String	2	行驶证证有效期	yyyy-MM
vehicleLicenseIssuingAuthority	是	String	2	行驶证发证机关
vehicleLicenseIssuingTime	是	String	2	行驶证发证时间	yyyy-MM-dd
roadTransportLicense	否	String	2	道路运输许可证
roadTransportLicenseImg	否	String	2	道路运输许可证图片
roadTransportLicenseAnnualInspectionImg	否	String	2	道路运输许可年检页图片
roadTransportLicenseExpireTime	否	String	2	道路运输许可证有效期	yyyy-MM-dd
roadTransportBusinessLicense	否	String	2	道路运输经营许可证
trailerLicenseNumber	否	String	2	挂车牌照号
trailerLicenseImg	否	String	2	挂车正本图片
trailerLicenseBackImg	否	String	2	挂车副本图片
groupPhotoImg	否	String	2	人车合照
totalMass	是	Decimal	2	总质量	单位：吨
approvedLoad	是	Decimal	2	核定载质量	单位：吨
curbWeight	否	Decimal	2	整备质量	单位：吨
overallDimensions	否	String	2	外廓尺寸	6820X2500X3540mm 单位：毫米
useNature	是	String	2	使用性质
creditCode	否	String	2	统一社会信用代码/身份证号
vehicleOwner	是	String	2	车辆所有人
vehicleOwnerExpireTime	否	String	2	车辆所有人有效期
vehicleOwnerAuthDomain	否	Object	1	车辆自有认证信息	车老板模式时此字段生效
ownerId	是	String	2	所有人ID	车老板ID
affiliationAgreement	否	Array	2	挂靠协议
purchaseContract	否	Array	2	购车合同
registrationCertificate	否	Array	2	机动车登记证
ownershipMaterial	否	Array	2	所有权材料

入参示例

json

{
  "vehicleBasicDomain": {
    "licensePlateNumber": "京A12345",
    "licensePlateColor": "YELLOW"
  },
  "vehicleAuthDomain": {
    "vehicleType": "HEAVY_ORDINARY_TRUCK",
    "vehicleLength": 9.6,
    "vehicleEnergyType": "B",
    "vehicleIdentificationNumber": "LSVAG21J0J3000000",
    "vehicleLicense": "1234567890123456789",
    "vehicleLicenseFrontImg": "https://example.com/vehicle_license_front.jpg",
    "vehicleLicenseBackImg": "https://example.com/vehicle_license_back.jpg",
    "vehicleLicenseClipImg": "https://example.com/vehicle_license_clip.jpg",
    "vehicleLicenseRegisterTime": "2015-01-01",
    "vehicleLicenseExpireTime": "2025-01",
    "vehicleLicenseIssuingAuthority": "北京市公安局交通管理局",
    "vehicleLicenseIssuingTime": "2015-01-01",
    "roadTransportLicense": "RT123456789",
    "roadTransportLicenseImg": "https://example.com/road_transport_license.jpg",
    "roadTransportLicenseAnnualInspectionImg": "https://example.com/road_transport_license.jpg",
    "roadTransportLicenseExpireTime": "2025-01-01",
    "roadTransportBusinessLicense": "RTBL123456789",
    "trailerLicenseNumber": "京B12345",
    "trailerLicenseImg": "https://example.com/trailer_license.jpg",
    "trailerLicenseBackImg": "https://example.com/trailer_license.jpg",
    "groupPhotoImg": "https://example.com/group_photo.jpg",
    "totalMass": 48.87,
    "approvedLoad": 40.00,
    "curbWeight": 8.87,
    "overallDimensions": "6820X2500X3540mm",
    "useNature": "货运",
    "creditCode": "91110105MA00123456",
    "vehicleOwner": "张三",
    "vehicleOwnerExpireTime": "2025-01-01"
  },
  "vehicleOwnerAuthDomain": {
    "ownerId": "123456789",
    "affiliationAgreement": [
      "https://example.com/affiliation_agreement_1.pdf",
      "https://example.com/affiliation_agreement_2.pdf"
    ],
    "purchaseContract": [
      "https://example.com/purchase_contract_1.pdf",
      "https://example.com/purchase_contract_2.pdf"
    ],
    "registrationCertificate": [
      "https://example.com/registration_certificate_1.pdf",
      "https://example.com/registration_certificate_2.pdf"
    ],
    "ownershipMaterial": [
      "https://example.com/ownership_material_1.pdf",
      "https://example.com/ownership_material_2.pdf"
    ]
  }
}

入参对象

java


@Setter
@Getter
@AllArgsConstructor
@NoArgsConstructor
@Schema(description = "创建车辆")
public class ApiConsignorVehicleCreateReq {

    @Schema(description = "车辆基础信息")
    @Valid
    @NotNull(message = "车辆基础信息不能为空")
    private ApiVehicleBasicDomain vehicleBasicDomain;

    @Schema(description = "车辆认证信息")
    @Valid
    private ApiVehicleAuthDomain vehicleAuthDomain;

    @Schema(description = "车辆自有认证信息")
    @Valid
    private ApiVehicleOwnerAuthDomain vehicleOwnerAuthDomain;

    @Setter
    @Getter
    @Accessors(chain = true)
    @Schema(description = "车辆基础信息")
    public class ApiVehicleBasicDomain {

        @Schema(description = "车辆牌号")
        @NotBlank(message = "车辆牌号不能为空")
        @Pattern(regexp = "^(([京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z](([0-9]{5}[ABCDEFGHJK])|([ABCDEFGHJK]([A-HJ-NP-Z0-9])[0-9]{4})))|([京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领]\\d{3}\\d{1,3}[领])|([京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z][A-HJ-NP-Z0-9]{4}[A-HJ-NP-Z0-9挂学警港澳使领]))$", message = "车牌号格式不合法")
        private String licensePlateNumber;

        @Schema(description = "车牌颜色", example = "YELLOW")
        @NotNull(message = "车牌颜色不能为空")
        private ColorEnum licensePlateColor;

    }

    @Setter
    @Getter
    @Accessors(chain = true)
    @Schema(description = "车辆认证信息")
    public class ApiVehicleAuthDomain {

        @Schema(description = "车型", example = "HEAVY_ORDINARY_TRUCK")
        @NotNull(message = "车型不能为空")
        private VehicleTypeEnum vehicleType;

        @Schema(description = "车长（米）", example = "9.6")
        @NotNull(message = "车长不能为空")
        private BigDecimal vehicleLength;

        @Schema(description = "车辆能源类型", example = "B")
        @NotNull(message = "车辆能源类型不能为空")
        private VehicleEnergyTypeEnum vehicleEnergyType;

        @Schema(description = "车辆识别代码")
        @NotBlank(message = "车辆识别代码不能为空")
        private String vehicleIdentificationNumber;

        @Schema(description = "行驶证件号")
        private String vehicleLicense;

        @Schema(description = "行驶证正面图片", example = "https://xx/yy.png")
        @NotBlank(message = "行驶证正面图片不能为空")
        private String vehicleLicenseFrontImg;

        @Schema(description = "行驶证反面图片", example = "https://xx/yy.png")
        @NotBlank(message = "行驶证反面图片不能为空")
        private String vehicleLicenseBackImg;

        @Schema(description = "行驶证夹页面图片", example = "https://xx/yy.png")
        private String vehicleLicenseClipImg;

        @Schema(description = "行驶证注册时间", example = "yyyy-MM-dd")
        @NotBlank(message = "行驶证注册时间不能为空")
        @Pattern(regexp = "^\\d{4}-\\d{2}-\\d{2}$", message = "行驶证注册时间格式不正确")
        private String vehicleLicenseRegisterTime;

        @Schema(description = "行驶证证有效期", example = "yyyy-MM")
        @NotBlank(message = "行驶证证有效期不能为空")
        @Pattern(regexp = "^\\d{4}-\\d{2}$", message = "行驶证证有效期格式不正确")
        private String vehicleLicenseExpireTime;

        @Schema(description = "行驶证发证机关")
        @NotBlank(message = "行驶证发证机关不能为空")
        private String vehicleLicenseIssuingAuthority;

        @Schema(description = "行驶证发证时间", example = "yyyy-MM-dd")
        @NotBlank(message = "行驶证发证时间不能为空")
        @Pattern(regexp = "^\\d{4}-\\d{2}-\\d{2}$", message = "行驶证发证时间格式不正确")
        private String vehicleLicenseIssuingTime;

        @Schema(description = "道路运输许可证件号")
        private String roadTransportLicense;

        @Schema(description = "道路运输许可证图片", example = "https://xx/yy.png")
        private String roadTransportLicenseImg;

        @Schema(description = "道路运输许可年检页图片", example = "https://xx/yy.png")
        private String roadTransportLicenseAnnualInspectionImg;

        @Schema(description = "道路运输许可证有效期", example = "yyyy-MM-dd")
        @Pattern(regexp = "^\\d{4}-\\d{2}-\\d{2}$", message = "道路运输许可证有效期格式不正确")
        private String roadTransportLicenseExpireTime;

        @Schema(description = "道路运输经营许可证")
        private String roadTransportBusinessLicense;

        @Schema(description = "挂车牌照号")
        private String trailerLicenseNumber;

        @Schema(description = "挂车正副本图片", example = "https://xx/yy.png")
        private String trailerLicenseImg;

        @Schema(description = "人车合照", example = "https://xx/yy.png")
        private String groupPhotoImg;

        @Schema(description = "总质量（吨）", example = "48.87")
        @NotNull(message = "总质量不能为空")
        private BigDecimal totalMass;

        @Schema(description = "核定载质量（吨）", example = "40")
        @NotNull(message = "核定载质量不能为空")
        private BigDecimal approvedLoad;

        @Schema(description = "整备质量（吨）", example = "8.87")
        private BigDecimal curbWeight;

        @Schema(description = "外廓尺寸", example = "6820X2500X3540mm")
        private String overallDimensions;

        @Schema(description = "使用性质")
        @NotBlank(message = "使用性质不能为空")
        private String useNature;

        @Schema(description = "统一社会信用代码/身份证号")
        private String creditCode;

        @Schema(description = "车辆所有人")
        @NotBlank(message = "车辆所有人不能为空")
        private String vehicleOwner;

        @Schema(description = "车辆所有人有效期", example = "yyyy-MM-dd")
        @Pattern(regexp = "^\\d{4}-\\d{2}-\\d{2}$", message = "车辆所有人有效期格式不正确")
        private String vehicleOwnerExpireTime;

    }

    @Setter
    @Getter
    @Accessors(chain = true)
    @Schema(description = "车辆自有认证信息")
    public class ApiVehicleOwnerAuthDomain {

        @Schema(name = "所有人ID")
        @NotBlank(message = "所有人ID不能为空")
        private String ownerId;

        @Schema(name = "挂靠协议")
        private List<String> affiliationAgreement;

        @Schema(name = "购车合同")
        private List<String> purchaseContract;

        @Schema(description = "机动车登记证")
        private List<String> registrationCertificate;

        @Schema(description = "所有权材料")
        private List<String> ownershipMaterial;

    }

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174

返回参数

参数名	类型	层级	说明
code	int	1	状态码
msg	String	1	请求结果
total	int	1	返回总条数
requestId	String	1	请求编号
data	Object	1	返回数据
id	String	2	业务数据ID

反参示例

json

{
  "code": 200,
  "data": {
    "id": "131321321"
  },
  "msg": "业务处理成功",
  "total": null,
  "requestId": "1eb7cb0e"
}

反参对象

java


@Setter
@Getter
@Schema(description = "创建车辆")
public class ApiConsignorVehicleCreateRes {

    @Schema(description = "业务数据ID")
    private String id;

}

车牌颜色：

Name	Message
BLUE	蓝色
YELLOW	黄色
GREEN	绿色

车型：

Name	Message
HEAVY_SEMI_TRAILER	重型半挂牵引车
SMALL_CAR	小型轿车
SMALL_ORDINARY	小型普通客车
HEAVY_DUMP_TRUCK	重型自卸货车
HEAVY_BARN_TYPE_SEMI_TRAILER	重型仓栅式半挂车
HEAVY_ORDINARY_TRUCK	重型普通货车
HEAVY_TRAILER	重型全挂牵引车
HEAVY_GENERAL_SEMI_TRAILER	重型普通半挂车
LARGE_UNLOADED_WORK_CAR	大型非载货专项作业车
MEDIUM_DUMP_TRUCK	中型自卸货车
LIGHT_WAREHOUSE_GRID_TRUCK	轻型仓栅式货车
LIGHT_TRAILER	轻型全挂牵引车
MINIVAN	小型面包车
HEAVY_SILO_TRUCK	重型仓栅式货车
VAN	轻型厢式货车
HEAVY_FLAT_DUMP_TRUCK	重型平板自卸车
HEAVY_VAN	重型厢式货车
HEAVY_BOX_TRUCK	重型箱式货车
LIGHT_ORDINARY_TRUCK	轻型普通货车
HEAVY_SPECIAL_STRUCTURE_TRUCK	重型特殊结构货车
HEAVY_FENDER_TRUCK	重型栏板货车
HEAVY_FENDER_SEMI_TRAILER	重型栏板半挂车
HEAVY_FLAT_TRUCK	重型平板货车
MEDIUM_WAREHOUSE_GRID_TRUCK	中型仓栅式货车
MEDIUM_VAN	中型厢式货车
HEAVY_TANK_TRUCK	重型罐式货车
HEAVY_CONTAINER_TRUCK	重型集装箱车
MEDIUM_ORDINARY_TRUCK	中型普通货车
HEAVY_TRANSPORT_TRUCK	重型车辆运输车
MEDIUM_FENDER_TRUCK	中型栏板货车
HEAVY_KEY_DUMP_TRUCK	重型键式自卸货车
OTHER	其它

车辆能源类型：

Name	Message
A	汽油
B	柴油
C	电
D	混合油
E	天然气
F	液化石油气
L	甲醇
M	乙醇
N	太阳能
O	混合动力
Y	无
Z	其他

新增车辆 ​

请求地址 ​

Header ​

注意事项 ​

请求参数 ​

入参示例 ​

入参对象 ​

返回参数 ​

反参示例 ​

反参对象 ​