运单开始
简要描述
ETC运单开始
请求地址
/v4/api/etc/operateWaybillStartHeader
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Token | 是 | string | 应用令牌 |
请求参数
| 参数名 | 必选 | 类型 | 层级 | 说明 | 示例 |
|---|---|---|---|---|---|
| bodyId | 否 | string | 1 | 承运主体 | 123456789 |
| waybillNum | 是 | string | 1 | 运单编号 | 123456789 |
| plateNum | 是 | string | 1 | 车牌号 | 鄂A12345 |
| plateColor | 是 | int | 1 | 车牌颜色 | 0 |
| sourceAddr | 是 | string | 1 | 运单开始地址 | 北京市 |
| destAddr | 是 | string | 1 | 运单目的地 | 北京市 |
| startTime | 是 | date | 1 | 运单开始时间 | 2024-12-12 00:00:00 |
| endTime | 是 | date | 1 | 运单预计完成时间 | 2024-12-12 00:00:00 |
| fee | 是 | long | 1 | 运单费用(大于0的整数,单位:分) | 2024-12-12 00:00:00 |
| source | 否 | string | 1 | 运单来源 | |
| driverName | 是 | string | 1 | 司机姓名 | 张三 |
| driverContract | 是 | string | 1 | 运输协议文件内容base64 | String driverContract = Base64.encode(bytes); |
| driverMobile | 是 | string | 1 | 司机手机号码 | 13800138000 |
| authorizationInvoice | 是 | string | 1 | 司机授权ETC发票归属运单所属企业(1-授权 2-未授权) | 1 |
| authorizationTime | 是 | string | 1 | 司机授权ETC发票归属运单所属企业时间 格式:yyyy-MM-DDTHH:mm:ss | yyyy-MM-DDTHH:mm:ss |
| authorizationIP | 是 | string | 1 | 司机授权ETC发票归属运单所属企业所持设备IP地址 格式:IPv4 ,如 111.111.111.111 | 111.111.111.111 |
| authorizationMAC | 是 | string | 1 | 司机授权ETC发票归属运单所属企业所持设备Mac地址 格式:xx-xx-xx-xx-xx-xx ,如 98-BD-80-54-68-A8 | 98-BD-80-54-68-A8 |
- 请求对象
java
@Schema(description = "承运主体")
private String bodyId;
@Schema(description = "运单编号")
@NotBlank(message = "运单编号不能为空")
private String waybillNum;
@Schema(description = "车牌号")
@NotBlank(message = "车牌号不能为空")
private String plateNum;
@Schema(description = "车牌颜色", example = "蓝色:0 黄色:1,黑色:2,白色:3,渐变绿色:4,黄绿渐变色:5,蓝白渐变色:6,未确定:9")
@NotNull(message = "车牌颜色不能为空")
private Integer plateColor;
@Schema(description = "运单开始地址,最大100字符")
@NotBlank(message = "运单开始地址不能为空")
private String sourceAddr;
@Schema(description = "运单目的地,最大100字符")
@NotBlank(message = "运单目的地不能为空")
private String destAddr;
@Schema(description = "运单开始时间")
@NotNull(message = "运单开始时间不能为空")
private Date startTime;
@Schema(description = "运单预计完成时间")
@NotNull(message = "运单预计完成时间不能为空")
private Date endTime;
@Schema(description = "运单费用", example = "大于0的整数,单位:分")
@NotNull(message = "运单费用不能为空")
@Min(value = 0, message = "运单费用不能小于0")
private long fee;
@Schema(description = "运单来源")
private String source;
@Schema(description = "司机姓名")
@NotBlank(message = "司机姓名不能为空")
private String driverName;
@Schema(description = "运输协议文件内容base64")
@NotBlank(message = "运输协议文件不能为空")
private String driverContract;
@Schema(description = "司机手机号码")
@NotBlank(message = "司机手机号码不能为空")
private String driverMobile;
@Schema(description = "司机授权ETC发票归属运单所属企业(1-授权 2-未授权)")
@NotNull(message = "司机授权ETC发票归属运单所属企业不能为空")
private Integer authorizationInvoice;
@Schema(description = "司机授权ETC发票归属运单所属企业时间 格式:yyyy-MM-DDTHH:mm:ss")
@NotBlank(message = "司机授权ETC发票归属运单所属企业时间不能为空")
private String authorizationTime;
@Schema(description = "司机授权ETC发票归属运单所属企业所持设备IP地址 格式:IPv4 ,如 111.111.111.111")
@NotBlank(message = "司机授权ETC发票归属运单所属企业所持设备IP地址不能为空")
private String authorizationIP;
@Schema(description = "司机授权ETC发票归属运单所属企业所持设备Mac地址 格式:xx-xx-xx-xx-xx-xx ,如 98-BD-80-54-68-A8")
@NotBlank(message = "司机授权ETC发票归属运单所属企业所持设备Mac地址不能为空")
private String authorizationMAC;返回参数
java
@Schema(description = "实时运单0,历史运单1")
private int waybillType;