新增车辆

请求地址

https://www.xxyb.cn/union/api/link/createVehicle

Header

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

注意事项

车辆信息非必填字段根据实际系统配置情况填写，请联系平台获取

证件有效期为长期时，填写长期

请求参数

ApiConsignorVehicleCreateReq 创建车辆请求

字段	类型	层级	描述	必填	备注
vehicleBasicDomain	ApiVehicleBasicDomain	1	车辆基础信息	是
vehicleAuthDomain	ApiVehicleAuthDomain	1	车辆认证信息	否

ApiVehicleBasicDomain 车辆基础信息

字段	类型	层级	描述	必填	备注
licensePlateNumber	String	2	车辆牌号	是
licensePlateColor	ColorEnum	2	车牌颜色	是

ApiVehicleAuthDomain 车辆认证信息

字段	类型	层级	描述	必填	备注
vehicleType	VehicleTypeEnum	2	车型	是
vehicleLength	BigDecimal	2	车长	是
vehicleEnergyType	VehicleEnergyTypeEnum	2	车辆能源类型	是
vehicleIdentificationNumber	String	2	车辆识别代码	否
vehicleLicense	String	2	行驶证	否
vehicleLicenseFrontImg	String	2	行驶证正面图片	是
vehicleLicenseBackImg	String	2	行驶证反面图片	是
vehicleLicenseClipImg	String	2	行驶证副页背面图片	否
vehicleLicenseRegisterTime	String	2	行驶证注册日期	否
vehicleLicenseExpireTime	String	2	行驶证证有效期	是
vehicleLicenseIssuingAuthority	String	2	行驶证发证机关	否
vehicleLicenseIssuingTime	String	2	行驶证发证日期	否
roadTransportLicense	String	2	道路运输证	否
roadTransportLicenseImg	String	2	道路运输证照片	否
roadTransportLicenseAnnualInspectionImg	String	2	道路运输证年检照片	否
roadTransportLicenseExpireTime	String	2	道路运输证有效期至	否
roadTransportBusinessLicense	String	2	道路运输经营许可证	否
trailerLicenseNumber	String	2	挂车牌照号	否
trailerLicenseImg	String	2	挂车副本照片	否
trailerLicenseBackImg	String	2	挂车副本照片	否
groupPhotoImg	String	2	人车合照	否
totalMass	BigDecimal	2	总质量	否
approvedLoad	BigDecimal	2	核定载质量	否
curbWeight	BigDecimal	2	整备质量	否
overallDimensions	String	2	外廓尺寸	否
useNature	String	2	使用性质	否
creditCode	String	2	统一社会信用代码/身份证号	否
vehicleOwner	String	2	车辆所有人	否
vehicleOwnerExpireTime	String	2	车辆所有人有效期	否
affiliationAgreement	List<String>	2	挂靠协议	否

请求参数示例

{
  "vehicleBasicDomain": {
    "licensePlateNumber": "京A12345",
    "licensePlateColor": "BLUE"
  },
  "vehicleAuthDomain": {
    "vehicleType": "TRUCK",
    "vehicleLength": 9.6,
    "vehicleEnergyType": "DIESEL",
    "vehicleIdentificationNumber": "LSVAM2180E2123456",
    "vehicleLicense": "11010120250601001",
    "vehicleLicenseFrontImg": "https://img.example.com/license/front.jpg",
    "vehicleLicenseBackImg": "https://img.example.com/license/back.jpg",
    "vehicleLicenseClipImg": "https://img.example.com/license/clip.jpg",
    "vehicleLicenseRegisterTime": "2020-01-15",
    "vehicleLicenseExpireTime": "2030-01-15",
    "vehicleLicenseIssuingAuthority": "北京市公安局交通警察支队",
    "vehicleLicenseIssuingTime": "2020-01-15",
    "roadTransportLicense": "RTB20250601001",
    "roadTransportLicenseImg": "https://img.example.com/transport/license.jpg",
    "roadTransportLicenseAnnualInspectionImg": "https://img.example.com/transport/inspection.jpg",
    "roadTransportLicenseExpireTime": "2026-06-01",
    "roadTransportBusinessLicense": "RBL20250601001",
    "trailerLicenseNumber": "京B1234挂",
    "trailerLicenseImg": "https://img.example.com/trailer/license.jpg",
    "trailerLicenseBackImg": "https://img.example.com/trailer/back.jpg",
    "groupPhotoImg": "https://img.example.com/group/photo.jpg",
    "totalMass": 25000.00,
    "approvedLoad": 15000.00,
    "curbWeight": 10000.00,
    "overallDimensions": "12000x2500x3800",
    "useNature": "货运",
    "creditCode": "91110101MA01234567",
    "vehicleOwner": "北京运输有限公司",
    "vehicleOwnerExpireTime": "2030-12-31",
    "affiliationAgreement": [
      "https://img.example.com/agreement/001.pdf",
      "https://img.example.com/agreement/002.pdf"
    ]
  }
}

返回参数

字段名	类型	层级	描述
id	String	1	车辆ID

返回参数示例

{
  "code": 200,
  "msg": "业务处理成功",
  "data": {
    "id": "VEHICLE_20250601_001"
  },
  "requestId": "REQ_20250601_001"
}