# 司机端小程序 **Repository Path**: wlyGit/driver-side-applet ## Basic Information - **Project Name**: 司机端小程序 - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2021-11-30 - **Last Updated**: 2024-07-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 接口统一返回格式 ```json { "code": 100000, "data": "", "message": "提示信息" } ``` ### 参数解释： - code：返回状态码，下面详细说明 - data：返回数据 - message：提示信息 ### code说明： ```properties 100000 = 请求成功 返回以下错误码表示均授权失败，跳转到登录页面 101001 = 非法操作，请求中缺少参数 101002 = 未登录或登录信息过期，请重新登录 101003 = 密码错误，请重新输入 101004 = 账号不存在，请重新输入 101005 = 账号被锁定，请联系管理员 101006 = 用户没有角色，请联系管理员 101007 = 您未授权此操作，请联系管理员 返回其他编码表示业务处理失败，提示错误信息即可 ``` ## 环境 1. 正式环境：https://rtd.antwing.cn/rtd/tms/v2 2. 测试环境：https://small.antwing.cn/small/tms/v2 3. 本地环境：http://localhost:8010/rtd/tms/v2 ## 请求说明 1. 每个请求需要在请求头加上登录后的token，参数名称：access_token 2. 接口请求按环境拼接请求的URL，例如登录URL：http://localhost:8010/rtd/tms/v1/app/auth/dispatch/Login 3. RSA公钥 ```tex MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAyhhxMSSxQSCLg7UQWNawyj-fYkfa936lIffB4HdwEwM4UQ5Al_toWBWvfBjn74zn6jlMAb6zDd6UGfdX8tcki9sIEAJ1gNPPGJI7fAGdBo_6KHnJnhm2VRzmwrD6zEtLh-Qry4vqa9zUaCOku4i64ntuYQ4oqMbEoVza3k0EIepYAqgQO9rT_Ufz9Q-h5tPuHFFJ4ysqQZ_GZKbOaJ1eC5GwAo6VTwcSJT3EuDfTdbJJeliD1eZRtymaj2pmeAv6HhgnmqVuUwKlzWu6K4J4a3ZbPparQQaTXhO2KYNR3ywe5bI_21n0sNH4jpAnvfTs0WokIcEWm4ysDRgmgffJ3QIDAQAB ``` 4. 统一分页参数: ```json { "pageNum": 1, "pageSize": 20 } ``` 参数解释： - pageNum：开始页 - pageSize：每页数量 5. 统一分页返回参数 ```json { "code": 100000, "data": { "total": 2, "list": [ ], "currentPage": 1 } } ``` 参数解释： - total：总条数 - list：数据集合 - currentPage：当前页 ## 订单状态说明 ```java /** * 调度中(未调度) */ public final static int STATUS_DISPATCH = 2; /** * 已调度(未接单) */ public final static int STATUS_YES_DISPATCH = 3; /** * 待出车(已接单) */ public final static int STATUS_RECEIPT = 4; /** * 已出车 */ public final static int STATUS_OUT_DRIVE = 5; /** * 已到达 */ public final static int STATUS_ARRIVED = 6; /** * 已装货 */ public final static int STATUS_GOODS = 7; /** * 到达卸货地 */ public final static int STATUS_ARRIVED_GIVE = 15; /** * 待分配 */ public final static int STATUS_ARRIVED_GIVE = 16; /** * 已完成(签收) */ public final static int STATUS_SUCCESS = 8; ``` ## 数据字典说明 - reject_order：拒绝接单 - energy_type：能源类型 - motorcade_type：车队类型 - drive_type：驾驶证类型 - vehicle_type：车辆类型 - tail_stock：有无尾板 - register_city：注册城市 - leave_type：请假类型 - quit_type：离职类型 - driver_repair：维修申请类型 - repair_name：维修名称 ## 文件类型说明 - 费用 - 运费：7000 - 加油费：7001 - 过路费：7002 - 打印费：7003 - 维修费：7004 - 油卡费：7006 - 粤通卡费：7007 - 停车费：7008 - 报关/入仓费：7050 - 高速费：7051 - 过磅费：7052 - 装卸费：7053 - 压夜超时费：7054 - 提货费：7055 - 加点费：7056 - 其他费：7057 - 当前里程数：7058 - 加油升数：7059 - 订单 - 订单附件：6001 - 签收（卸货）：6010 - 装货：6011 - 到达：6012 - 异常：6020 - 司机 - 请假：5005 - 离职：5006 - 维修前：5007 - 维修后：5008 - 身份证正面：5000 - 身份证反面：5010 - 驾驶证：5001 - 从业资格证：5011 - 车辆 - 行驶证：3000 - 车辆图片：3001 - 道路运输证：3002 - 行驶证副件：3003 ## 系统配置说明 - DRIVER_LEAVE_KEY：请假说明 - DRIVER_QUIT_KEY：离职说明 - SALARY_TEXT_KEY：薪资协议 - SECRECY_PROMISE_KEY：保密承诺函 - COMMON_PROBLEM_KEY：常见问题 ## 全局通用接口 ### 1.获取省市区 #### 接口说明 省市区三级联动查询 #### 请求URL ```properties ${环境}/index/getCityList ``` #### 请求方式 GET #### 请求示例 ```json { "parentId": "000000" } ``` ##### 请求参数说明 - parentId：不传或传000000查询省份，传省份id查询市，传市id查询区/县 #### 返回示例 ```json { "code": 100000, "data": [ { "id": "110000", "name": "北京" }, { "id": "120000", "name": "天津" } ] } ``` ##### 返回参数说明 - id：省市区id - name：名称 ### 2.查询数据字典 #### 接口说明 返回所有需要的字典 #### 请求URL ```properties ${环境}/index/findDictInfo ``` #### 请求方式 GET #### 返回示例 ```json { "code": 10000, "data": { "drive_type": [ { "id": "af796cada32540b48a461e2cd00f3a34", "name": "C1" }, { "id": "74e093a22c0d48fa92bb387703203233", "name": "C2" } ], "register_city": [], "vehicle_type": [ { "id": "9aa972a74c15449b868c6c522c1e287d", "name": "4.2M/3吨车" }, { "id": "294a957aec5543fbb9f4da08f0e3060a", "name": "5.2M/5吨车" } ], "motorcade_type": [ { "id": "54f59dcb92c14806af86e537dbb4f68e", "name": "自营车队" }, { "id": "ad6a4dc760fa44bdb2ada6f0e511093e", "name": "个体车队" } ], "energy_type": [ { "id": "9e3152eb53504a41b291bae2a6a7af68", "name": "纯电动" }, { "id": "ee60a8bd733a457b8df7ad7e5dbb2e24", "name": "混合动力" }, { "id": "a52dd114712644a486c11c2e1984bcb8", "name": "燃油动力" } ], "tail_stock": [ { "id": "1", "name": "有尾板" }, { "id": "2", "name": "无尾板" } ] }, "message": null } ``` ##### 返回参数说明 - drive_type：驾驶证类型 - motorcade_type：车队信息 - energy_type：动力类型 - vehicle_type：车辆类型 - tail_stock：有无尾板 - register_city：注册城市 ### 3.查询指定字典 #### 请求URL ```properties ${环境}/index/findDictInfoByCode ``` #### 请求方式 GET #### 请求示例 ```json { "code":"字典code" } ``` ##### 请求参数说明 - code：字典code #### 返回示例 ```json { "code": 10000, "data": [ { "id": "20adcf329d8042f49448e8f5b9c94389", "name": "面包车" }, { "id": "9aa972a74c15449b868c6c522c1e287d", "name": "4.2M/3吨车" } ], "message": null } ``` ### 4.退出 #### 请求URL ```properties ${环境}/index/logout ``` #### 请求方式 GET、POST、DELETE #### 返回示例 ```json { "code": 100000, "data": true } ``` ### 5.文件上传 #### 5.1 上传图片 ##### 请求URL ```properties ${环境}/upload/img ``` ##### 请求方式 POST，表单(Content-Type = multipart/form-data; boundary=) ##### 请求示例 ```json { "file":"文件", "businessType": 3000 } ``` ###### 请求参数说明 - file：文件 - businessType：文件类型，定义如下 ```properties ## 车辆 3000=行驶证 3001=车辆图片 3002=道路运输证 3003=行驶证副件 # 驾驶员 5000=身份证正面 5010=身份证反面 5001=驾驶证 ``` ##### 返回示例 ```json { "code": 100000, "data": { "businessType": 6001, "id": "a4f9cb2648c643e68ee9581a6cf41743", "name": "bg3.png", "size": 1469295, "type": "image/png", "url": "/small/tms/annex/2021-11/a4f9cb2648c643e68ee9581a6cf41743.png" } } ``` ###### 返回参数说明 - id：文件ID，必传 - businessType：业务类型，必传 - url：文件URL，${环境}/URL，等于全路径 #### 5.2 上传文件 ##### 请求URL ```properties ${环境}/upload/file ``` ##### 请求说明 ```properties 参数返回值与上传图片无任何区别，区别在于上传图片会校验文件是否是图片类型 ``` #### 5.3 批量上传图片 ##### 请求URL ```properties ${环境}/upload/batchImg ``` ##### 请求说明 ```properties 参数返回值与上传图片无任何区别，区别在于上传图片会校验文件是否是图片类型 ``` ##### 请求示例 ```json { "files": [], "businessType": 3000 } ``` ###### 请求参数说明 - files：文件集合 - businessType：文件类型 #### 5.4 批量上传文件 ##### 请求URL ```properties ${环境}/upload/batchFile ``` ##### 请求说明 ```properties 参数返回值与上传图片无任何区别，区别在于上传图片会校验文件是否是图片类型 ``` ##### 请求示例 ```json { "files": [], "businessType": 3000 } ``` ###### 请求参数说明 - files：文件集合 - businessType：文件类型 ### 6.获取地址 #### 接口说明 根据GPS坐标系的经纬度获取当前位置全称 #### 请求URL ```properties ${环境}/index/getAddressFullName ``` #### 请求方式 POST #### 请求示例 ```json { "longitude": "114.026314", "latitude": "22.654718" } ``` ##### 请求参数说明 - longitude：经度 - latitude：纬度 - original：原始坐标系，可选值 - gps（默认） - mapbar - baidu - autonavi（不进行转换） ### 7.查询系统配置 #### 请求URL ```properties ${环境}/sysConfig/getConfigByCode ``` #### 请求方式 GET #### 请求示例 ```json { "code":"配置code" } ``` ##### 请求参数说明 - code：配置code #### 返回示例 ```json { "code": 10000, "data": { "id": "20adcf329d8042f49448e8f5b9c94389", "name": "面包车", "key": "code", "value": "内容" }, "message": null } ``` ### 8.获取业务文件 #### 接口说明 单独接口获取业务信息的文件 #### 请求URL ```properties ${环境}/index/findFileByTypeList ``` #### 请求方式 POST #### 请求示例 ```json { "businessId": "6f6646c6bdafb6dc33a16854c64c0c7d", "businessType":7059, "businessTypeList":[7059,7058] } ``` ##### 请求参数说明 - businessId：业务id，必填 - businessType：文件类型，可选 - businessTypeList：文件类型，可选 - 没有传入文件类型则查询出此业务信息的所有附件 #### 返回示例 ```json { "code": 10000, "data": [ { "businessType": 7059, "id": "9d969504c3cfe2e7e8d2938b4fbd9202", "name": "tmp_a3f15dfb3435b342d57ba6e5d5c33abe53891ebad186d6cc.jpg", "type": "image/jpeg", "url": "/small/tms/annex/2022-02/9d969504c3cfe2e7e8d2938b4fbd9202.jpg" }, { "businessType": 7058, "id": "24ec8ef9b867f38a7228cb05e84bc8a6", "name": "tmp_882ec0a1e63d90406bf657fe012b3f9189b54cac0860121b.jpg", "type": "image/jpeg", "url": "/small/tms/annex/2022-02/24ec8ef9b867f38a7228cb05e84bc8a6.jpg" } ], "message": "" } ``` ## 1.微信登录 ### 1.1 获取sessionId #### 请求URL ```properties ${环境}/driver/auth/getSessionId ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "code":"小程序获取的code" } ``` ##### 请求参数说明 - code：小程序获取的code，临时登录凭证，只有一次有效 #### 返回示例 ```json { "code": 100000, "data": "e269fca271214e04b953fbbd57c1f133" } ``` ##### 返回参数说明 - data：返回的sessionId ### 1.2 获取用户信息 #### 请求URL ```properties ${环境}/driver/auth/getUserInfo ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "sessionId":"第一步获取的sessionId", "signature":"签名", "rawData":"微信用户基本信息", "encryptedData":"消息密文", "iv":"加密算法的初始向量" } ``` ##### 请求参数说明 - sessionId：第一步获取的sessionId - signature：签名，微信返回 - rawData：微信用户基本信息，微信返回 - encryptedData：消息密文，微信返回 - iv：加密算法的初始向量，微信返回 #### 返回示例 ```json { "code": 100000, "data": { "nickName": "唐老板", "gender": 1, "avatarUrl": 1, "country":"国家", "province":"省", "city":"城市", "language":"" } } ``` ##### 返回参数说明 - nickName：昵称 - gender：性别，1男 - avatarUrl：头像 - country：国家 - province：省 - city：城市 - language：语言 ### 1.3 获取手机号 #### 请求URL ```properties ${环境}/driver/auth/getPhoneNumber ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "sessionId":"第一步获取的sessionId", "encryptedData":"消息密文", "iv":"加密算法的初始向量" } ``` ##### 请求参数说明 - sessionId：第一步获取的sessionId - encryptedData：消息密文，微信返回 - iv：加密算法的初始向量，微信返回 #### 返回示例 ```json { "code": 100000, "data": { "countryCode": "国家代码", "phoneNumber": 13113690059, "purePhoneNumber": 13113690059 } } ``` ##### 返回参数说明 - countryCode：国家代码 - phoneNumber：手机号，国外会带区号 - purePhoneNumber：真实手机号，不带区号(86) ### 1.4 维修授权登录 #### 请求URL ```properties ${环境}/driver/auth/login ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "sessionId":"第一步获取的sessionId", "phoneNumber":"手机号", "encryptedData":"消息密文", "iv":"加密算法的初始向量" } ``` ##### 请求参数说明 - sessionId：第一步获取的sessionId - encryptedData：与获取手机号的一致 - iv：与获取手机号的一致 - phoneNumber：手机号，不传则取微信绑定的手机号，现阶段暂时不传 #### 返回示例 ```json { "code": 100000, "data": { "id": "司机id", "registerStatus": 10, "contactPhone": "13113690059", "token": "1234" } } ``` ##### 返回参数说明 - code：全局code返回101004，则是未注册 - registerStatus：注册状态码 - 0：已提交信息，等待审核 - 1：已提交基本信息（第一步） - 2：已提交车辆信息（第二步） - 3：已提交照片信息（第三步） - 10：注册成功，或返回token - id：司机id - contactPhone：司机号码 - token：登录成功的token ### 1.5 是否绑定微信 #### 请求URL ```properties ${环境}/driver/auth/checkBindWeChat ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "sessionId":"第一步获取的sessionId" } ``` ##### 请求参数说明 - sessionId：第一步获取的sessionId #### 返回示例 ```json { "code": 100000, "data": false, "message":"当前微信已被【唐蕾】绑定,是否继续更新绑定" } ``` ##### 返回参数说明 - data： - true：代表无人绑定，直接调用【绑定微信】接口 - false：表示有绑定，弹出确认对话框，提示语使用message字段的内容 ### 1.6 绑定微信 #### 请求URL ```properties ${环境}/driver/auth/bindWeChat ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "sessionId":"第一步获取的sessionId" } ``` ##### 请求参数说明 - sessionId：第一步获取的sessionId #### 返回示例 ```json { "code": 100000, "data": true, "message":"" } ``` ##### 返回参数说明 - data：true ​ ## 2.注册 ### 2.1 第一步 #### 接口说明 修改信息时将id一起提交，有id则会进行修改操作，没有id进行注册操作 #### 请求URL ```properties ${环境}/driver/auth/register1 ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "id": "司机id", "registerCity": "深圳", "name": "唐蕾", "cardNo": "12345678901234567X", "motorcadeCode": "001X", "contactPhone": "13412341234", "proofType": "1234zxcv" } ``` ##### 请求参数说明 - id：司机id - registerCity：注册城市 - name：司机姓名 - cardNo：身份证号码 - proofType：驾驶证类型 - motorcadeCode：车队编码 - 自营车队编码：CD0001，隐式提交 - contactPhone：手机号，必填 - isHaveVehicle：是否自带车 - 1：是 - 2：否 #### 返回示例 ```json { "code": 100000, "data": "司机id" } ``` ##### 返回参数说明 - data：司机id ### 2.2 第二步 #### 请求URL ```properties ${环境}/driver/auth/register2 ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "id": "司机id", "bindVehicleInfo": { "vehiclePlate": "车牌号", "energyType": "能源类型", "vehicleType": "车辆类型", "isTailstock": "是否尾板" } } ``` ##### 请求参数说明 - id：司机id，必填 - bindVehicleInfo：车辆信息 - vehiclePlate：车牌号 - energyType：能源类型 - vehicleType：车辆类型 - isTailstock：是否尾板 #### 返回示例 ```json { "code": 100000, "data": "司机id" } ``` ##### 返回参数说明 - data：司机id ### 2.3 第三步 #### 请求URL ```properties ${环境}/driver/auth/register3 ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "id": "司机id", "enclosureInfoList": { "id": "文件id", "businessType": "业务类型" } } ``` ##### 请求参数说明 - id：司机id，必填 - enclosureInfoList：附件信息 - id：文件id - businessType：业务类型 ```properties # 业务类型定义，上传接口与调度端的小程序接口一致 3001 = 车辆图片 3000 = 车辆行驶证 3003 = 车辆行驶证-副件 3002 = 车辆道路运输证 5001 = 驾驶证 5000 = 身份证-正面 5010 = 身份证-反面 ``` #### 返回示例 ```json { "code": 100000, "data": "司机id" } ``` ##### 返回参数说明 - data：司机id ### 2.4 获取信息 #### 接口说明 根据registerStatus返回指定步骤信息，第一步的基本信息始终会返回 #### 请求URL ```properties ${环境}/driver/auth/getRegisterInfo ``` #### 请求方式 GET #### 请求示例 ```json { "driverId": "司机id", "registerStatus": 1 } ``` ##### 请求参数说明 - id：司机id，必填 - registerStatus：注册状态码，必填 - 1：已提交基本信息（第一步） - 2：已提交车辆信息（第二步） - 3：已提交照片信息（第三步） #### 返回示例 ```json { "code": 100000, "data": { "id": "司机id", "registerCity": "深圳", "name": "唐蕾", "cardNo": "12345678901234567X", "motorcadeCode": "001X", "contactPhone": "13412341234", "proofType": "1234zxcv", "bindVehicleInfo": { "vehiclePlate": "车牌号", "energyType": "能源类型", "vehicleType": "车辆类型", "isTailstock": "是否尾板" }, "enclosureInfoList": { "id": "文件id", "businessType": "业务类型" } } } ``` ##### 返回参数说明 - id：司机id - registerCity：注册城市 - name：司机姓名 - cardNo：身份证号码 - proofType：驾驶证类型 - motorcadeCode：车队编码 - contactPhone：手机号 - bindVehicleInfo：车辆信息 - vehiclePlate：车牌号 - energyType：能源类型 - vehicleType：车辆类型 - isTailstock：是否尾板 - enclosureInfoList：附件信息 ## 3.货源 ### 3.1 报价/抢单-订单列表 #### 请求URL ```properties ${环境}/app/driver/order/getReportOrderList ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "operateMode": 2, "takeCityList": [ { "province": "广东省", "city": "深圳市", "area": "宝安区" } ], "giveCityList": [ { "province": "广东省", "city": "深圳市", "area": "龙华区" } ], "sortField": "takeTimeDesc", "longitude": "114.026314", "latitude": "22.654718", "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - operateMode：订单模式，2:报价模式,3:抢单模式，**必填** - longitude：当前经度，没有经纬度则不会按距离排序也不会返回距离 - latitude：当前纬度 - takeCityList：提货点查询条件 - province：省 - city：市 - area：区 - giveCityList：卸货点查询条件 - province：省 - city：市 - area：区 - sortField：排序字段 - takeTimeAsc：提货时间升序 - takeTimeDesc：提货时间降序 - distanceAsc：距离从近到远 - distanceDesc：距离从远到近 #### 返回示例 ```json { "code": 10000, "data": { "total": 2, "pageSize": 20, "list": [ { "addressDistance": 17, "deadlineTime": "2021-12-20 12:00:00", "distance": "119.9km", "duration": "1小时57分", "giveRoute": "广州白云", "giveTime": "12月20日 12:00", "id": "64f644262b544fb19c698208c89266c5", "operateMode": 2, "orderNo": "ZCOD211217002", "orderType": "专车", "packType": "木托/实木托 3方", "remark": null, "settingPrice": null, "surplusTime": -10795, "takeRoute": "深圳光明", "takeTime": "12月18日 10:00", "vehicleType": "9.6M/15吨车" } ], "currentPage": 1 }, "message": null } ``` ##### 返回参数说明 - id：订单ID - addressDistance：距离(当前位置距提货点) - deadlineTime：截止时间 - distance：里程 - duration：耗时 - giveRoute：卸货点 - giveTime：卸货时间 - operateMode：与参数说明一致 - orderNo：订单号，暂时没有用到 - orderType：订单类型，暂时没有用到 - packType：包装类型 - remark：订单备注 - settingPrice：设置的价格，报价模式不返回 - surplusTime：剩余时间，单位：秒 - takeRoute：提货点 - takeTime：提货时间 - vehicleType：订单车型 ### 3.2 报价/抢单-订单详情 #### 请求URL ```properties ${环境}/app/driver/order/getReportOrderInfo ``` #### 请求方式 GET #### 请求示例 ```json { "orderId": "c56b86c346f04865b96da7a841731761" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": { "addressDtoList": [ { "id": "e7514ce074f547f3ba6adbf3e4bafc21", "requireTime": "12/16 17:00", "route": "东莞寮步", "type": 1 }, { "id": "3c2c3e8b80a5488f834269c2c31ad8cb", "requireTime": "12/17 10:00", "route": "滁州南谯", "type": 2 } ], "deadlineTime": "2021-12-17 12:00:00", "distance": "1359.2km", "duration": "15小时28分", "goodsName": "设备", "id": "c56b86c346f04865b96da7a841731761", "loadGoodsTime": "2021-12-16 17:00", "operateMode": 2, "orderNo": "ZCOD211216003", "orderType": "专车", "packType": "托盘", "rank": 1, "remark": null, "reportPrice": 1600.00, "reportStatus": 1, "settingPrice": "12345", "surplusTime": 0, "vehicleType": "8.2M/12吨车", "volume": "8吨40方" }, "message": null } ``` ##### 返回参数说明 - id：订单ID - addressDtoList - requireTime：要求到达/离场时间 - route：路线名称 - type：1=提货，2=卸货，3=报关 - deadlineTime：截止时间 - distance：里程 - duration：耗时 - goodsName：货物名称 - loadGoodsTime：装货时间 - operateMode：与参数说明一致 - orderNo：订单号，暂时没有用到 - orderType：订单类型，暂时没有用到 - packType：包装类型 - rank：当前排名 - reportPrice：报价金额 - reportStatus：报价状态,1:正在报价,2:取消,3:成交,4:未成交，这里只会返回1,4 - remark：订单备注 - settingPrice：设置的价格，报价模式不返回 - surplusTime：剩余时间，单位：秒 - vehicleType：订单车型 - volume：体积（件重体） ### 3.3 订单报价 #### 请求URL ```properties ${环境}/app/driver/order/orderReportPrice ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "64f644262b544fb19c698208c89266c5", "price": 600 } ``` ##### 请求参数说明 - orderId：订单id - price：输入价格 #### 返回示例 ```json { "code": 10000, "data": true, "message": null } ``` ### 3.4 修改报价 #### 请求URL ```properties ${环境}/app/driver/order/updateOrderOfferPrice ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "64f644262b544fb19c698208c89266c5", "price": 600 } ``` ##### 请求参数说明 - orderId：订单id - price：输入价格 #### 返回示例 ```json { "code": 10000, "data": true, "message": null } ``` ### 3.5 取消报价 #### 请求URL ```properties ${环境}/app/driver/order/cancelOrderOfferPrice ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "64f644262b544fb19c698208c89266c5", "cancelReason": "没时间了，不要了" } ``` ##### 请求参数说明 - orderId：订单id - cancelReason：取消原因 #### 返回示例 ```json { "code": 10000, "data": true, "message": null } ``` ### 3.6 抢单 #### 请求URL ```properties ${环境}/app/driver/order/grabOrder ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "5ca149c4d20143ce83c318cfff58e914" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": true, "message": null } ``` ### 3.7 报价/抢单-数字统计 #### 请求URL ```properties ${环境}/app/driver/order/getOrderReportCount ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "takeCityList": [ { "province": "广东省", "city": "深圳市", "area": "宝安区" } ], "giveCityList": [ { "province": "广东省", "city": "深圳市", "area": "龙华区" } ] } ``` ##### 请求参数说明 - takeCityList：提货点查询条件 - province：省 - city：市 - area：区 - giveCityList：卸货点查询条件 - province：省 - city：市 - area：区 #### 返回示例 ```json { "code": 10000, "data": { "grabNum": 1, "offerNum": 2 }, "message": "" } ``` ##### 返回参数说明 - grabNum：抢单数量 - offerNum：报价数量 ## 4.订单-任务中 ### 4.1 待中标列表 #### 请求URL ```properties ${环境}/app/driver/order/findStayGetOrderList ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "longitude": "114.026314", "latitude": "22.654718", "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - longitude：当前经度，没有经纬度则不会返回距离 - latitude：当前纬度 - searchDate：0:昨天,1:今天,2:明天,3:后天,4:自定义 - startDate：开始日期 - endDate：结束日期 - takeName：提货点 - giveName：卸货点 #### 返回示例 ```json { "code": 10000, "data": { "total": 1, "pageSize": 20, "list": [ { "addressDistance": 1246, "deadlineTime": "2021-12-31 12:00:00", "distance": "1488.4km", "duration": "17小时8分", "giveRoute": "广州番禺", "giveTime": "12月28日 13:00", "id": "264e9983aca54c55902058ea959131d8", "modeStatus": 1, "operateMode": 2, "orderNo": "ZCOD211223004", "orderType": "专车", "packType": "纸箱 9吨45方", "rank": 1, "remark": null, "reportPrice": 1600.00, "reportStatus": 1, "surplusTime": 348609, "takeRoute": "苏州昆山", "takeTime": "12月26日 17:00", "vehicleType": "9.6M/15吨车" } ], "currentPage": 1 }, "message": null } ``` ##### 返回参数说明 - id：订单ID - addressDistance：距离(当前位置距提货点) - deadlineTime：截止时间 - distance：里程 - duration：耗时 - giveRoute：卸货点 - giveTime：卸货时间 - operateMode：0:未分配,1:指派模式,2:报价模式,3:抢单模式 - orderNo：订单号，暂时没有用到 - orderType：订单类型，暂时没有用到 - packType：包装类型 - rank：当前排名 - reportPrice：报价金额 - reportStatus：报价状态,1:正在报价,2:取消,3:成交,4:未成交，这里只会返回1,4 - remark：订单备注 - surplusTime：剩余时间，单位：秒 - takeRoute：提货点 - takeTime：提货时间 - vehicleType：订单车型 ​ ### 4.2 待中标详情 与3.2订单详情一样，多返回了**报价金额**，**报价状态**，**排名** ### 4.3 进行中列表 #### 请求URL ```properties ${环境}/app/driver/order/findTaskOrderList ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "longitude": "114.026314", "latitude": "22.654718", "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - longitude：当前经度，没有经纬度则不会返回距离 - latitude：当前纬度 - searchDate：0:昨天,1:今天,2:明天,3:后天,4:自定义 - startDate：开始日期 - endDate：结束日期 - customerName：客户名称 - driverName：司机名称 - driverPhone：司机电话 - vehiclePlate：车牌号 - takeName：提货点 - giveName：卸货点 - takeFactoryName：提货工厂名称 - giveFactoryName：卸货工厂名称 #### 返回示例 ```json { "code": 10000, "data": { "total": 43, "pageSize": 20, "list": [ { "addressDistance": 17, "distance": "59km", "duration": "1小时16分", "giveRoute": "深圳盐田", "giveTime": "12月31日 12:00", "id": "92bf2a2ecd0e43bbbdae1ed98d813c1e", "levelCaptain": 1, "operateMode": 2, "orderNo": "ZCOD211228004", "orderType": "专车", "packType": "托盘 1方", "payFreightFee": "1430", "remark": null, "status": 3, "takeRoute": "深圳光明", "takeTime": "12月30日 10:36", "vehiclePlanDto": { "currentCity": null, "currentLatitude": null, "currentLongitude": null, "driverId": "fcea67465fee557693d34b954e81fd7c", "driverName": "文强", "driverPhone": "13247646405", "id": "bce3a9654c2340509ebec9433fc8ae23", "vehicleId": null, "vehiclePlate": null, "vehicleTypeName": null }, "vehicleType": "7.6M/10吨车" }, { "addressDistance": 20, "distance": "1554.7km", "duration": "17小时2分", "giveRoute": "苏州张家港", "giveTime": "12月15日 17:00", "id": "b0ae3f0a4f01451db59d56165c4f68b3", "levelCaptain": 1, "operateMode": 1, "orderNo": "ZCOD211211068", "orderType": "专车", "packType": "托盘 10吨50方", "payFreightFee": null, "remark": null, "takeRoute": "深圳宝安", "takeTime": "12月13日 15:00", "vehiclePlanDto": { "currentCity": "深圳宝安", "currentLatitude": 22.728625, "currentLongitude": 113.859740, "driverId": "4487e81dd61a4b788b1952048ae4b3e3", "driverName": "梁海龙", "driverPhone": "13538277055", "id": "8fbddfd7634245ee994649205b359917", "vehicleId": "e0bf08550e8340f69ecab91948524d67", "vehiclePlate": "粤BLM641", "vehicleTypeName": "9.6M/15吨车" }, "vehicleType": "9.6M/15吨车" } ], "currentPage": 1 }, "message": null } ``` ##### 返回参数说明 - id：订单ID - addressDistance：距离(当前位置距提货点) - distance：里程 - duration：耗时 - giveRoute：卸货点 - giveTime：卸货时间 - levelCaptain：是否车队长 - 1：车队长，显示分配车辆 - 2：司机 - operateMode：0:未分配,1:指派模式,2:报价模式,3:抢单模式 - 司机角色：指派模式才能拒绝接单，已接单 - 车队长角色：显示分配车辆/重新指派 - orderNo：订单号，暂时没有用到 - orderType：订单类型，暂时没有用到 - packType：包装类型 - payFreightFee：运费 - remark：订单备注 - status：订单状态，3接单，4已接单，详情看订单状态说明 - takeRoute：提货点 - takeTime：提货时间 - vehiclePlanDto：已分配的车辆信息 - currentCity：当前城市 - currentLongitude：当前经度 - currentLatitude：当前纬度 - driverId：司机id - driverName：司机名称 - driverPhone：司机电话 - id：调度id（暂时无用） - vehicleId：车辆id - vehiclePlate：指派车牌 - vehicleTypeName：指派车型 - vehicleType：订单车型 ### 4.4 进行中详情 #### 请求URL ```properties ${环境}/app/driver/order/getTaskOrderInfo ``` #### 请求方式 GET #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": { "addressDtoList": [ { "contactName": "石九零", "contactPhone": "13760186714", "fullAddress": "广东省深圳市坪山新区出口加工区兰竹西路10号 C仓", "id": "9d9ac8ce54694af1a2f47166af2b38e7", "requireTime": "12/14 14:38", "route": "深圳坪山", "type": 1 }, { "contactName": "雷鑫玲", "contactPhone": "13510904942", "fullAddress": "广东省深圳市福田区保税区市花路32号能健恒仓(即桃花路4号)", "id": "96c38835b30d4d83a16237274d722897", "requireTime": "12/14 18:00", "route": "深圳福田", "type": 2 } ], "cushionFee": "0", "distance": "56.9km", "duration": "1小时33分", "goodsName": "笔记本电脑", "id": "b17785ec383c4a959c5de49d711308b2", "incomeTotalFee": "0", "levelCaptain": 1, "loadGoodsTime": "2021-12-14 14:38", "motorcadeCode": "ZYCD", "operateMode": 1, "orderNo": "ZCOD211213005", "orderType": "专车", "packType": "托盘", "payFreightFee": null, "remark": "", "status": 5, "vehiclePlanDto": { "currentCity": "深圳龙华", "currentLatitude": 22.726000, "currentLongitude": 114.026509, "driverName": "陈玉斌", "driverPhone": "13928404884", "id": "62a5dc60c71749e382af9138f4fd86db", "motorcadeName": "自营车队", "vehiclePlate": "粤BMM162", "vehicleTypeName": "9.6M/15吨车" }, "vehicleType": "40HQ柜车", "volume": "24件8.5吨47.5方" }, "message": "" } ``` ##### 返回参数说明 - id：订单ID - addressDtoList - contactName：联系人 - contactPhone：联系电话 - fullAddress：地址全路径 - factoryName：工厂名称 - requireTime：要求到达/离场时间 - route：路线名称 - type：1=提货，2=卸货，3=报关 - arrivedTime：实际到达时间 - departureTime：实际离场时间 - distance：里程 - duration：耗时 - dispatchTime：调度时间 - goodsName：货物名称 - incomeTotalFee：总计 - levelCaptain：是否车队长 - 1=是，返回了vehiclePlanDto内容 - 2=否，显示异常、补录费用，显示下一步订单操作 - loadGoodsTime：装货时间 - orderNo：订单号 - orderType：订单类型 - packType：包装类型 - payFreightFee：运费 - status：订单状态，参考订单状态说明 - remark：订单备注 - vehicleType：订单车型 - volume：体积（件重体） - incomeTotalFee：总计 - cushionFee：代支费用 - motorcadeCode：车队类型 - ZYCD：自营车队 - 其他非自营 - vehiclePlanDto：分配的车辆信息 - currentCity：当前城市 - currentLongitude：当前经度 - currentLatitude：当前纬度 - driverName：司机名称 - driverPhone：司机电话 - id：调度id（暂时无用） - motorcadeName：车队名称 - vehiclePlate：指派车牌 - vehicleTypeName：指派车型 ### 4.5 接单 #### 请求URL ```properties ${环境}/app/driver/order/receiptOrder ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 4.6 拒单 #### 请求URL ```properties ${环境}/app/driver/order/rejectOrder ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2", "rejectReason": "拒绝原因" } ``` ##### 请求参数说明 - orderId：订单id - rejectReason：拒绝原因 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 4.7 订单状态改变 #### 请求URL ```properties ${环境}/app/driver/order/taskOrderStatusChange ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2", "orderStatus": 5, "longitude": 123, "latitude": 123, "enclosureInfoList": [ { "id":"文件id" } ] } ``` ##### 请求参数说明 - orderId：订单id - orderStatus：订单状态，参考订单状态说明 - longitude：经度 - latitude：纬度 - enclosureInfoList：每个节点状态的文件集合 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 4.8 查询异常类型 #### 请求URL ```properties ${环境}/app/driver/order/findExceptionTypeList ``` #### 请求方式 GET ##### 请求参数说明 - 无 #### 返回示例 ```json { "code": 10000, "data": [ { "id": "4707f9cede8e473c89d48d721b1f9edb", "name": "包装破损", "programme": "破损，请拨打任务列表中的 【调度员电话】进行报备！", "type": "装货异常" } ], "message": "" } ``` ##### 返回参数说明 - id：异常类型id - name：类型名称 - programme：建议方案 - type：所属类型 ### 4.9 异常上报 #### 请求URL ```properties ${环境}/app/driver/order/exceptionReport ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2", "typeId": "异常类型id", "explain": "异常说明", "enclosureInfoList": [ { "id":"文件id" } ] } ``` ##### 请求参数说明 - orderId：订单id - typeId：异常类型id - explain：异常说明 - enclosureInfoList：每个节点状态的文件集合 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 4.9 费用录入 #### 请求URL ```properties ${环境}/app/driver/order/costUpload ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2", "entranceFee": 1, "highFee": 2, "weighFee": 3, "loadFee": 4, "parkingFee": 5, "printFee": 6, "maintainFee": 7, "passingFee": 8, "refuelFee": 9, "otherFee": 10, "otherFeeRemark": "其他费用备注", "loadFeeRemark":"装卸费备注", "refuelVolume": 1, "currentDistance": 2, "enclosureInfoList": [ { "id": "文件id", "businessType": 7003 } ] } ``` ##### 请求参数说明 - orderId：订单id - entranceFee：报关/入仓费 - highFee：高速费 - weighFee：称重(过磅)费 - loadFee：装卸费 - parkingFee：停车费 - printFee：打印费 - maintainFee：维修费 - passingFee：现金过路费 - refuelFee：现金加油费 - otherFee：其他费 - otherFeeRemark：其他费用备注 - refuelCardFee：油卡费 - passingCardFee：粤通卡费 - loadFeeRemark：装卸费备注 - refuelVolume：加油升数 - currentDistance：当前车辆里程数 - enclosureInfoList：所有费用上传了图片的集合 - id：文件id - businessType：类型，参考文件类型说明 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 4.10 费用录入详情 #### 请求URL ```properties ${环境}/app/driver/order/getCostDetail ``` #### 请求方式 GET #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2" } ``` ##### 参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": { "orderId": "b17785ec383c4a959c5de49d711308b2", "entranceFee": 1, "highFee": 2, "weighFee": 3, "loadFee": 4, "parkingFee": 5, "printFee": 6, "maintainFee": 7, "passingFee": 8, "refuelFee": 9, "otherFee": 10, "otherFeeRemark": "其他费用备注", "loadFeeRemark": "装卸费备注", "refuelVolume": 1, "currentDistance": 2, "enclosureInfoList": [ { "id": "文件id", "businessType": 7003 } ] }, "message": "" } ``` ##### 参数说明 - orderId：订单id - entranceFee：报关/入仓费 - highFee：高速费 - weighFee：称重(过磅)费 - loadFee：装卸费 - parkingFee：停车费 - printFee：打印费 - maintainFee：维修费 - passingFee：现金过路费 - refuelFee：现金加油费 - otherFee：其他费 - otherFeeRemark：其他费用备注 - loadFeeRemark：装卸费备注 - refuelVolume：加油升数 - currentDistance：当前车辆里程数 - enclosureInfoList：所有费用上传了图片的集合 - id：文件id - businessType：类型，参考文件类型说明 ## 5.订单-已完成 ### 5.1订单列表 #### 请求URL ```properties ${环境}/app/driver/order/findSuccessOrderList ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - 费用确认查询条件 - confirmStatus：费用确认状态，费用统计时传入 - 1:待平台确认 - 2:待司机确认 - 3:司机已确认 - monthTime：查询时间戳 - 已完成列表查询条件 - searchDate：0:昨天,1:今天,2:明天,3:后天,4:自定义 - startDate：开始日期 - endDate：结束日期 - customerName：客户名称 - driverName：司机名称 - driverPhone：司机电话 - vehiclePlate：车牌号 - takeName：提货点 - giveName：卸货点 - takeFactoryName：提货工厂名称 - giveFactoryName：卸货工厂名称 #### 返回示例 ```json { "code": 10000, "data": { "total": 13728, "pageSize": 2, "list": [ { "confirmStatus": null, "distance": "58.2km", "driverScore": 5, "duration": "1小时7分", "giveRoute": "深圳盐田", "giveTime": "12月13日 22:00", "id": "8c09875b8cca48189971ab8456239e89", "incomeTotalFee": "130", "motorcadeCode": "ZYCD", "operateMode": 1, "orderNo": "ZCOD211210016", "orderType": "专车", "packType": "托盘 8件1.5吨0.1方", "remark": "", "status": 8, "successTime": "2021-12-13 14:19:52", "takeRoute": "惠州惠城", "takeTime": "12月13日 08:30", "vehiclePlanDto": { "driverName": "吴和乐", "id": "aac7368c793c4fddb26571b58a9ba61e", "vehiclePlate": "粤BLD208" }, "vehicleType": "6.8M/8吨车" }, { "confirmStatus": null, "distance": "6754.6km", "driverScore": 5, "duration": "76小时27分", "giveRoute": "深圳坪山", "giveTime": "12月13日 16:00", "id": "9e3f211a78e445158b2bd9cf8c43a3a3", "incomeTotalFee": "10", "motorcadeCode": "ZYCD", "operateMode": 1, "orderNo": "ZCOD211210029", "orderType": "专车", "packType": "托盘 1.7吨29方", "remark": "", "status": 8, "successTime": "2021-12-13 13:10:45", "takeRoute": "东莞横沥", "takeTime": "12月13日 08:00", "vehiclePlanDto": { "driverName": "梁定", "id": "dac195543ce045b3bfaf8890261c1351", "vehiclePlate": "粤BFX931" }, "vehicleType": "7.6M/10吨车", "mobilePhone": "跟单人员电话", "realName": "跟单人员姓名" } ], "currentPage": 1 }, "message": "" } ``` ##### 返回参数说明 - id：订单ID - confirmStatus：费用确认状态 - 1:待平台确认 - 2:待司机确认 - 3:已确认 - driverScore：司机评分 - distance：里程 - duration：耗时 - giveRoute：卸货点 - giveTime：卸货时间 - incomeTotalFee：总计费用 - motorcadeCode：车队编码，自营不显示费用 - operateMode：0:未分配,1:指派模式,2:报价模式,3:抢单模式 - orderNo：订单号，暂时没有用到 - orderType：订单类型，暂时没有用到 - packType：包装类型 - successTime：完成时间 - remark：订单备注 - status：订单状态，3接单，4已接单，详情看订单状态说明 - takeRoute：提货点 - takeTime：提货时间 - vehiclePlanDto：已分配的车辆 - driverName：司机名称 - id：调度id（暂时无用） - vehiclePlate：车牌 - vehicleType：订单车型 - mobilePhone：跟单人员电话 - realName：跟单人员名字 ### 5.2 已完成详情 #### 请求URL ```properties ${环境}/app/driver/order/getSuccessOrderInfo ``` #### 请求方式 GET #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": { "addressDtoList": [ { "contactName": "吴雅娟", "contactPhone": "13928312709", "fullAddress": "广东省惠州市惠城区沥林镇泮沥河背村", "id": "514a6aa772f343e9b3cf5e19e3d263ba", "requireTime": "12/13 08:30", "route": "惠州惠城", "type": 1 }, { "contactName": "", "contactPhone": "", "fullAddress": "广东省深圳市盐田区东海道432号永安北一街", "id": "a4ea070453e047b1be29e556adad1493", "requireTime": "12/13 22:00", "route": "深圳盐田", "type": 2 } ], "confirmStatus": null, "cushionFee": "130", "distance": "58.2km", "duration": "1小时7分", "goodsName": "1", "id": "8c09875b8cca48189971ab8456239e89", "incomeTotalFee": "130", "inputCushionFee": null, "inputPayFreightFee": null, "levelCaptain": 1, "loadGoodsTime": "2021-12-13 08:30", "motorcadeCode": "ZYCD", "operateMode": 1, "orderNo": "ZCOD211210016", "orderType": "专车", "packType": "托盘", "payFreightFee": null, "remark": "", "status": 8, "vehiclePlanDto": { "driverName": "吴和乐", "driverPhone": "18377816917", "id": "aac7368c793c4fddb26571b58a9ba61e", "motorcadeName": "自营车队", "vehiclePlate": "粤BLD208", "vehicleTypeName": "6.8M/8吨车" }, "vehicleType": "6.8M/8吨车", "volume": "8件1.5吨0.1方" }, "message": "" } ``` ##### 返回参数说明 - id：订单ID - addressDtoList - contactName：联系人 - contactPhone：联系电话 - fullAddress：地址全路径 - requireTime：要求到达/离场时间 - factoryName：工厂名称 - route：路线名称 - type：1=提货，2=卸货，3=报关 - confirmStatus：费用确认状态 - 1:待平台确认 - 2:待司机确认 - 3:已确认 - cushionFee：待支费(修改后的值) - distance：里程 - duration：耗时 - goodsName：货物名称 - incomeTotalFee：总计 - inputCushionFee：代支费(修改前的值) - inputPayFreightFee：运费(修改前的值)，自营返回null - levelCaptain：是否车队长 - 1=是，返回了vehiclePlanDto内容 - 2=否，显示异常、补录费用，显示下一步订单操作 - loadGoodsTime：装货时间 - orderNo：订单号 - orderType：订单类型 - packType：包装类型 - payFreightFee：运费(修改后的值) - status：订单状态，参考订单状态说明 - remark：订单备注 - vehicleType：订单车型 - volume：体积（件重体） - incomeTotalFee：总计 - cushionFee：代支费用 - motorcadeCode：车队类型 - ZYCD：自营车队 - 其他非自营 - vehiclePlanDto：分配的车辆信息 - driverName：司机名称 - driverPhone：司机电话 - id：调度id（暂时无用） - motorcadeName：车队名称 - vehiclePlate：指派车牌 - vehicleTypeName：指派车型 ### 5.3 确认费用 #### 请求URL ```properties ${环境}/app/driver/order/confirmCost ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 5.4 订单文件 #### 请求URL ```properties ${环境}/app/driver/order/getOrderUploadFile ``` #### 请求方式 GET #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": { "arrived": { "addressFullName": "广东省深圳市龙华区福城街道茜坑路44号铭峰大厦", "enclosureInfoList": [ { "businessType": 6012, "createId": "", "createTime": null, "id": "f970dc9aca7e2df6805d19b0b4b9ebca", "name": "tmp_493e03cc6157180f05fd2df03b12e3fee6b8e938595c7ca2.jpg", "size": null, "type": "image/jpeg", "url": "/small/tms/annex/2022-01/f970dc9aca7e2df6805d19b0b4b9ebca.jpg" }, { "businessType": 6012, "createId": "", "createTime": null, "id": "23e25fa5ee9ed102c0366fbda05362c5", "name": "tmp_df46c2b3ef7c7f41f404a048a3a7af21fa144179e722c810.jpg", "size": null, "type": "image/jpeg", "url": "/small/tms/annex/2022-01/23e25fa5ee9ed102c0366fbda05362c5.jpg" } ], "uploadTime": "2022-01-24 18:13:51" }, "orderId": "a36e79c7903f42ba8c603a38f7b221d6", "success": { "addressFullName": "广东省深圳市龙华区福城街道茜坑路26号铭峰大厦", "enclosureInfoList": [ { "businessType": 6010, "createId": "", "createTime": null, "id": "78d8e8346490f6244ccb6efd9cabbd30", "name": "tmp_37440fc4a3f556b684c88a5787321e292e722f8f2f3a0fe7.jpg", "size": null, "type": "image/jpeg", "url": "/small/tms/annex/2022-01/78d8e8346490f6244ccb6efd9cabbd30.jpg" }, { "businessType": 6010, "createId": "", "createTime": null, "id": "1792fc0959526d84eba01a46630506d2", "name": "tmp_5f19216315e9679f6917d4002568c97fd0c4bc5799a41328.jpg", "size": null, "type": "image/jpeg", "url": "/small/tms/annex/2022-01/1792fc0959526d84eba01a46630506d2.jpg" } ], "uploadTime": "2022-01-24 18:20:15" }, "goods": { "addressFullName": "广东省深圳市龙华区福城街道茜坑路26号铭峰大厦", "enclosureInfoList": [ { "businessType": 6011, "createId": "", "createTime": null, "id": "6fc1c4b82bc1a15225eb53ea1932810b", "name": "tmp_8a518a10e30fb20f6cdde020f7ef93f15c58202dd731027f.jpg", "size": null, "type": "image/jpeg", "url": "/small/tms/annex/2022-01/6fc1c4b82bc1a15225eb53ea1932810b.jpg" }, { "businessType": 6011, "createId": "", "createTime": null, "id": "25d02ad1c96504f39383f22729df64ee", "name": "tmp_d7b467f4c93dbbed80ee6bfbc35f555b5e945b1e6965e661.jpg", "size": null, "type": "image/jpeg", "url": "/small/tms/annex/2022-01/25d02ad1c96504f39383f22729df64ee.jpg" } ], "uploadTime": "2022-01-24 18:17:42" } }, "message": "" } ``` ##### 返回参数说明 - orderId：订单ID - arrived：已到达信息 - addressFullName：上传位置 - enclosureInfoList：文件集合 - uploadTime：上传时间 - goods：已装货 - success：已完成 ### 5.5 修改订单文件 #### 请求URL ```properties ${环境}/app/driver/order/updateOrderFile ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "orderId": "b17785ec383c4a959c5de49d711308b2", "enclosureInfoList": [ { "id":"", "businessType": 6012 } ] } ``` ##### 请求参数说明 - orderId：订单id - enclosureInfoList：所有文件集合 - businessType：与过程上传的类型一致 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ## 6.我的 ### 6.1 个人信息 #### 请求URL ```properties ${环境}/app/driver/me/getUserInfo ``` #### 请求方式 GET #### 返回示例 ```json { "code": 10000, "data": { "companyName": "", "contactPhone": "13247646405", "id": "4e8689f64e463174e96f3d442bff9a56", "levelCaptain": 0, "motorcadeId": "车队ID", "motorcadeCode": "ZYCD", "motorcadeName": "自营车队", "name": "文强", "entryDate": "2022-02-12" }, "message": "" } ``` ##### 返回参数说明 - id：司机id - contactPhone：联系电话 - levelCaptain：是否车队长 - 1=是 - 2=否 - motorcadeCode：车队类型 - ZYCD：自营车队 - 其他非自营 - motorcadeName：车队名称 - name：司机名称 - entryDate：入职日期 ### 6.2 按月份查询费用 #### 请求URL ```properties ${环境}/app/driver/me/getCostTotal ``` #### 请求方式 GET #### 请求示例 ```json { "monthTime": 12445 } ``` ##### 请求参数说明 - monthTime：要查询月份的时间戳 #### 返回示例 ```json { "code": 10000, "data": { "totalIncome": 1, "platformNoConfirm": 3, "driverNoConfirm": 2 }, "message": "" } ``` ##### 返回参数说明 - totalIncome：总收入 - platformNoConfirm：平台待确认 - driverNoConfirm：司机待确认 ### 6.3 车辆运力统计 #### 请求URL ```properties ${环境}/app/driver/me/getTransportTotal ``` #### 请求方式 GET #### 返回示例 ```json { "code": 10000, "data": { "driverCount": 1, "vehicleCount": 3 }, "message": "" } ``` ##### 返回参数说明 - driverCount：司机数量 - vehicleCount：车辆数量 ### 6.4 平台/司机待确认订单 参考5.1的已完成订单列表 ### 6.5 加油统计 #### 请求URL ```properties ${环境}/app/driver/me/refuelTotal ``` #### 请求方式 GET #### 请求示例 ```json { "monthTime": 12445 } ``` ##### 请求参数说明 - monthTime：要查询月份的时间戳 #### 返回示例 ```json { "code": 10000, "data": { "refuelVolume": 1, "distance": 3, "refuelAmount": 4, "vehicleTypeName": "车型", "standardConsumeOil": 1, "actualConsumeOil": 2 }, "message": "" } ``` ##### 返回参数说明 - refuelVolume：加油量 - distance：行驶里程 - refuelAmount：加油金额 - vehicleTypeName：车型名称 - 如果为空，车辆油耗标准下方不显示信息 - standardConsumeOil：标准油耗 - actualConsumeOil：实际油耗 ### 6.6 加油登记 #### 请求URL ```properties ${环境}/app/driver/me/refuelRegister ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "addTime": "2022-02-10 13:30", "currentDistance": 1000, "refuelVolume": 50, "refuelAmount": 400, "enclosureInfoList": [ { "id": "123", "businessType": 7059 } ] } ``` ##### 请求参数说明 - addTime：加油时间 - currentDistance：当前车辆里程数 - refuelVolume：加油量 - refuelAmount：加油金额 - enclosureInfoList：凭证 - businessType：7059 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.7 加油明细 #### 请求URL ```properties ${环境}/app/driver/me/refuelDetails ``` #### 请求方式 GET #### 请求示例 ```json { "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - 分页参数 #### 返回示例 ```json { "code": 10000, "data": { "total": 0, "pageSize": 20, "list": [], "currentPage": 1 }, "message": "" } ``` ##### 返回参数说明 - refuelVolume：加油量 - currentDistance：里程 - refuelAmount：加油金额 - id：id - addTime：加油时间 ### 6.7 加油量图表 #### 请求URL ```properties ${环境}/app/driver/me/refuelVolumeTotal ``` #### 请求方式 GET #### 返回示例 ```json { "code": 10000, "data": { "monthList": [ "2021-03", "2021-04", "2021-05", "2021-06", "2021-07", "2021-08", "2021-09", "2021-10", "2021-11", "2021-12", "2022-01", "2022-02" ], "refuelVolumeList": [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ] }, "message": "" } ``` ##### 返回参数说明 - refuelVolumeList：加油量 - monthList：显示月份 ### 6.8 请假申请 #### 请求URL ```properties ${环境}/app/driver/me/addDriverLeave ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "leaveType": "696659ceced74bd0bc5461bf37fd8a11", "leaveDesc": "测试请假", "leaveStart": "2022-02-11 09:00", "leaveEnd": "2022-02-21 18:00", "enclosureInfoList": [ ] } ``` ##### 请求参数说明 - leaveType：请假类型，数据字典，详情查看数据字典说明 - leaveDesc：请假理由 - leaveStart：开始时间，yyyy-MM-dd HH:mm - leaveEnd：结束时间，yyyy-MM-dd HH:mm - enclosureInfoList：附件信息 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.9 请假列表 #### 请求URL ```properties ${环境}/app/driver/me/findDriverLeaveList ``` #### 请求方式 GET #### 请求示例 ```json { "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - 分页参数 #### 返回示例 ```json { "code": 10000, "data": { "total": 1, "pageSize": 20, "list": [ { "auditStatus": 1, "id": "f7b3123d9b01e570ad40d352c152b02d", "leaveEnd": "2022-02-21 18:00", "leaveStart": "2022-02-11 09:00", "leaveTypeName": "事假", "requestTime": "2022-02-11 15:39:22", "status": 1 } ], "currentPage": 1 }, "message": "" } ``` ##### 返回参数说明 - id：id - leaveTypeName：请假类型名称 - requestTime：申请时间 - leaveStart：请假开始时间 - leaveEnd：请假结束时间 - auditStatus：审核状态 - 0：待审核 - 1：审核通过 - 2：审核拒绝 - 3：撤回 - status：生效状态 - 0：待生效 - 1：生效中 - 2：已结束 ### 6.10 请假单详情 #### 请求URL ```properties ${环境}/app/driver/me/getDriverLeaveDetail ``` #### 请求方式 GET #### 请求示例 ```json { "id": "请假单id" } ``` ##### 请求参数说明 - id：请假单id #### 返回示例 ```json { "code": 10000, "data": { "auditDesc": "同意", "auditName": "系统", "auditStatus": 1, "auditTime": "2022-02-11T12:00:00", "driverId": "", "driverName": "李厚兵", "enclosureInfoList": [], "id": "f7b3123d9b01e570ad40d352c152b02d", "leaveDesc": "测试请假", "leaveEnd": "2022-02-21 18:00", "leaveStart": "2022-02-11 09:00", "leaveType": "696659ceced74bd0bc5461bf37fd8a11", "leaveTypeName": "事假", "requestTime": "2022-02-11 15:39:22", "status": 1 }, "message": "" } ``` ##### 返回参数说明 - id：id - auditDesc：审核意见 - auditName：审核人名称 - auditTime：审核时间 - driverName：司机名称 - enclosureInfoList：附件信息 - leaveDesc：请假说明 - leaveType：请假类型id - leaveTypeName：请假类型名称 - requestTime：申请时间 - leaveStart：请假开始时间 - leaveEnd：请假结束时间 - auditStatus：审核状态 - 0：待审核 - 1：审核通过 - 2：审核拒绝 - 3：撤回 - status：生效状态 - 0：待生效 - 1：生效中 - 2：已结束 ### 6.11 撤销请假 #### 请求URL ```properties ${环境}/app/driver/me/cancelLeaveRequest ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "id": "请假id" } ``` ##### 请求参数说明 - id：请假id #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.12 离职申请 #### 请求URL ```properties ${环境}/app/driver/me/addDriverQuitRequest ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "quitType": "00d6c658429c4c12ab280be9002907a5", "quitDesc": "测试提交离职申请", "expectQuitDate": "2022-02-20", "enclosureInfoList": [ ] } ``` ##### 请求参数说明 - quitType：离职原因类型，数据字典，详情查看数据字典说明 - quitDesc：离职原因说明 - expectQuitDate：期望离职日期 - enclosureInfoList：附件信息 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.13 离职列表 #### 请求URL ```properties ${环境}/app/driver/me/findDriverQuitList ``` #### 请求方式 GET #### 请求示例 ```json { "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - 分页参数 #### 返回示例 ```json { "code": 10000, "data": { "total": 1, "pageSize": 20, "list": [ { "auditStatus": 0, "expectQuitDate": "2022-02-20", "id": "79209e372103c1a90895c4fbefe46acd", "quitTypeName": "个人原因", "requestTime": "2022-02-12 16:04:13", "status": 0 } ], "currentPage": 1 }, "message": "" } ``` ##### 返回参数说明 - id：id - quitTypeName：离职原因名称 - requestTime：申请时间 - expectQuitDate：期望离职日期 - auditStatus：审核状态 - 0：待审核 - 1：审核通过 - 2：审核拒绝 - 3：撤回 - status：生效状态 - 0：待生效 - 1：生效中 - 2：已结束 ### 6.14 撤销离职申请 #### 请求URL ```properties ${环境}/app/driver/me/cancelQuitRequest ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "id": "申请id" } ``` ##### 请求参数说明 - id：申请id #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.15 离职申请详情 #### 请求URL ```properties ${环境}/app/driver/me/getDriverQuitDetail ``` #### 请求方式 GET #### 请求示例 ```json { "id": "申请id" } ``` ##### 请求参数说明 - id：申请id #### 返回示例 ```json { "code": 10000, "data": { "auditDesc": "", "auditName": "", "auditStatus": 0, "auditTime": null, "driverId": "841ca30573ab4cd5a4f00bf72201e61f", "driverName": "李厚兵", "enclosureInfoList": [], "entryDate": "2021-09-01", "expectQuitDate": "2022-02-20", "id": "79209e372103c1a90895c4fbefe46acd", "quitDesc": "测试提交离职申请", "quitType": "00d6c658429c4c12ab280be9002907a5", "quitTypeName": "个人原因", "requestTime": "2022-02-12 16:04:13", "status": 0 }, "message": "" } ``` ##### 返回参数说明 - id：id - auditDesc：审核意见 - auditName：审核人名称 - auditTime：审核时间 - driverName：司机名称 - enclosureInfoList：附件信息 - quitDesc：离职原因说明 - quitType：离职原因id - quitTypeName：离职原因名称 - requestTime：申请时间 - entryDate：入职日期 - expectQuitDate：期望离职日期 - auditStatus：审核状态 - 0：待审核 - 1：审核通过 - 2：审核拒绝 - 3：撤回 - status：生效状态 - 0：待生效 - 1：生效中 - 2：已结束 ### 6.16 维修申请 #### 请求URL ```properties ${环境}/app/driver/me/addDriverRepair ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "requestType": "保养", "vehiclePlate": "1234B", "travelMileage": 2500, "repairItemList": [ { "repairName": "补胎", "repairDesc": "爆胎了", "enclosureInfoList": [ { "id": "1234567B" } ] }, { "repairName": "漏水", "repairDesc": "有个洞" } ] } ``` ##### 请求参数说明 - requestType：维修类型，中文名称 - vehiclePlate：车牌号，从个人信息中获取 - travelMileage：行驶里程 - repairItemList：维修项目 - repairName：维修名称 - repairDesc：维修说明 - enclosureInfoList：附件信息 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.17 维修列表 #### 请求URL ```properties ${环境}/app/driver/me/findDriverRepairList ``` #### 请求方式 GET #### 请求示例 ```json { "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - 分页参数 #### 返回示例 ```json { "code": 10000, "data": { "total": 2, "pageSize": 20, "list": [ { "id": "9608be17f84891e67e1d6f721abf85a9", "repairName": "补胎", "repairStatus": 0, "requestDate": "2022-02-14", "requestType": "保养", "successTime": null }, { "id": "b2c04dbc4d8edc654a218cb416e7000c", "repairName": "漏水", "repairStatus": 0, "requestDate": "2022-02-14", "requestType": "保养", "successTime": null } ], "currentPage": 1 }, "message": "" } ``` ##### 返回参数说明 - id：id - repairName：维修名称 - requestDate：申请日期 - requestType：维修类型 - successTime：完成时间 - repairStatus - 0：待审核 - 1：审核通过 - 2：已完成 ### 6.18 维修详情 #### 请求URL ```properties ${环境}/app/driver/me/findDriverRepairDetail ``` #### 请求方式 GET #### 请求示例 ```json { "id": "123" } ``` ##### 请求参数说明 - id：离职id #### 返回示例 ```json { "code": 10000, "data": { "analysis": "", "driverId": "841ca30573ab4cd5a4f00bf72201e61f", "enclosureInfoList": [], "id": "b2c04dbc4d8edc654a218cb416e7000c", "repairCost": null, "repairDesc": "有个洞", "repairItem": "", "repairName": "漏水", "repairRemark": "", "repairStatus": 0, "requestDate": "2022-02-14", "requestType": "保养", "successTime": null, "travelMileage": 2500.00, "vehiclePlate": "1234B" }, "message": "" } ``` ##### 返回参数说明 - id：id - analysis：督导分析 - repairCost：维保费用 - repairDesc：维修说明 - repairItem：维修点 - repairName：维修名称 - repairRemark：维保备注 - requestDate：申请日期 - requestType：维修类型 - successTime：完成时间 - travelMileage：行驶里程 - repairStatus - 0：待审核 - 1：审核通过 - 2：已完成 - enclosureInfoList：附件信息 - businessType - 5007：维修前 - 5008：维修后 ### 6.19 维修上报 #### 请求URL ```properties ${环境}/app/driver/me/reportDriverRepair ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "repairCost": 12345, "repairRemark": "备注", "id": "1234", "enclosureInfoList": [ { "id": "1234567B" } ] } ``` ##### 请求参数说明 - repairCost：维保费用 - repairRemark：维保备注 - id：id - enclosureInfoList：附件信息 #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.19 删除维修申请 #### 请求URL ```properties ${环境}/app/driver/me/deleteDriverRepair ``` #### 请求方式 DELETE，JSON（Content-Type=application/json） #### 请求示例 ```json { "id": "1234" } ``` ##### 请求参数说明 - id：id #### 返回示例 ```json { "code": 10000, "data": true, "message": "" } ``` ### 6.20 提成工资单 #### 请求URL ```properties ${环境}/app/driver/me/findRoyaltyOrderList ``` #### 请求方式 GET #### 请求示例 ```json { "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - 分页参数 - searchDate：1,本周,2:本月,3:上月,4:自定义 - startDate：开始日期，yyyy-MM-dd，自定义有效 - endDate：结束日期，yyyy-MM-dd，自定义有效 #### 返回示例 ```json { "code": 10000, "data": { "total": 1, "pageSize": 20, "currentPage": 1, "list": [ { "driverName": "李厚兵", "giveRoute": "深圳坪山", "giveTime": "2月22日 12:00", "id": "24b13ed548b84f4280f6098d9c675483", "orderRoyalty": 1758.00, "successTime": "2022-02-18 16:27:37", "takeRoute": "东莞横沥", "takeTime": "2月19日 16:09", "vehiclePlate": "粤B12345A", "writeStatus": 2 } ], "royaltyTotalDto": { "deductionsAmount": 0.00, "noPaidAmount": 1758.00, "paidAmount": 0.00, "totalAmount": 1758.00 } }, "message": "" } ``` ##### 返回参数说明 - list：分页数据 - driverName：司机名称 - giveRoute：卸货点 - giveTime：卸货时间 - id：订单id - orderRoyalty：订单提成金额 - successTime：完成时间 - takeRoute：提货点 - takeTime：提货时间 - vehiclePlate：车牌号 - writeStatus：结算状态 - 1：已结算 - 2：未结算 - 3：部分结算 - royaltyTotalDto：统计 - totalAmount：总计 - paidAmount：已结 - noPaidAmount：未结 ### 6.21提成工资单详情 #### 请求URL ```properties ${环境}/app/driver/me/findRoyaltyOrderDetail ``` #### 请求方式 GET #### 请求示例 ```json { "orderId": "24b13ed548b84f4280f6098d9c675483" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": { "addressDtoList": [ { "arrivedTime": "2/18 16:26", "contactName": "洪先生", "contactPhone": "15818370220", "departureTime": "2/18 16:27", "fullAddress": "广东省东莞市横沥镇水边村宝马路第六栋", "id": "d6506fd281edd1f2ceec09e49c33326b", "requireTime": "2/19 16:09", "route": "东莞横沥", "type": 1 }, { "arrivedTime": "2/18 16:27", "contactName": "仓库", "contactPhone": "", "departureTime": "2/18 16:27", "fullAddress": "广东省深圳市坪山新区兰竹西路10号（深圳市恒宜通物流有限公司B仓）", "id": "3c02daef75b3c826f3e7048087176093", "requireTime": "2/22 12:00", "route": "深圳坪山", "type": 2 } ], "distance": "75.9km", "duration": "1小时23分", "giveTime": "2月22日 12:00", "goodsName": "电子", "id": "24b13ed548b84f4280f6098d9c675483", "operateMode": 1, "orderNo": "ZCOD220218005", "orderRoyalty": 1758.00, "orderType": "专车", "packType": "托盘", "paidAmount": 0.00, "remark": "测试订单， 不要操作", "status": 8, "subjectList": [ { "label": "司机提成费", "payStatus": 1, "property": "royaltyFee", "value": 288.00 }, { "label": "装卸费", "payStatus": 1, "property": "loadFee", "value": 200.00 }, { "label": "加班费", "payStatus": 1, "property": "extraFee", "value": 130.00 }, { "label": "住宿费", "payStatus": 1, "property": "stayFee", "value": 90.00 }, { "label": "基本工资", "payStatus": 1, "property": "baseFee", "value": 300.00 }, { "label": "绩效工资", "payStatus": 1, "property": "meritsFee", "value": 200.00 }, { "label": "使用APP奖励", "payStatus": 1, "property": "appFee", "value": 250.00 }, { "label": "其他奖励1", "payStatus": 1, "property": "other1Fee", "value": 150.00 }, { "label": "其他奖励2", "payStatus": 1, "property": "other2Fee", "value": 150.00 }, { "label": "司机扣款", "payStatus": 1, "property": "deductionsFee", "value": 0 } ], "takeTime": "2月19日 16:09", "vehicleType": "9.6M/15吨车", "volume": "44件21.2吨9.9方", "writeStatus": 2 }, "message": "" } ``` ##### 返回参数说明 - id：订单ID - addressDtoList - arrivedTime：到场时间 - departureTime：离场时间 - contactName：联系人 - contactPhone：联系电话 - fullAddress：地址全路径 - requireTime：要求到达/离场时间 - route：路线名称 - type：1=提货，2=卸货，3=报关 - distance：里程 - duration：耗时 - goodsName：货物名称 - operateMode：订单模式 - orderNo：订单号 - orderType：订单类型 - orderRoyalty：订单提成（应付小计） - paidAmount：已结算 - packType：包装类型 - status：订单状态，参考订单状态说明 - remark：订单备注 - vehicleType：订单车型 - volume：体积（件重体） - writeStatus：结算状态： - 1：已结算 - 2：未结算 - 3：部分结算 - subjectList：订单费用提成明细 - label：显示名称 - value：显示值 - property：属性名称 - payStatus：结算状态 - 1：未结算 - 3：已结算 ### 6.22 自营代垫订单 #### 请求URL ```properties ${环境}/app/driver/me/findDriverBeforePayOrderList ``` #### 请求方式 GET #### 请求示例 ```json { "pageNum": 1, "pageSize": 20 } ``` ##### 请求参数说明 - 分页参数 - searchDate：1,本周,2:本月,3:上月,4:自定义 - startDate：开始日期，yyyy-MM-dd，自定义有效 - endDate：结束日期，yyyy-MM-dd，自定义有效 #### 返回示例 ```json { "code": 10000, "data": { "total": 1, "pageSize": 20, "currentPage": 1, "list": [ { "driverName": "李厚兵", "giveRoute": "深圳坪山", "giveTime": "2月22日 12:00", "id": "24b13ed548b84f4280f6098d9c675483", "orderRoyalty": 1335.00, "successTime": "2022-02-18 16:27:37", "takeRoute": "东莞横沥", "takeTime": "2月19日 16:09", "vehiclePlate": "粤B12345A", "writeStatus": 3 } ], "beforePayTotal": { "deductionsAmount": null, "noPaidAmount": 1335.00, "paidAmount": 0.00, "totalAmount": 1335.00 } }, "message": "" } ``` ##### 返回参数说明 - list：分页数据 - driverName：司机名称 - giveRoute：卸货点 - giveTime：卸货时间 - id：订单id - orderRoyalty：订单提成金额 - successTime：完成时间 - takeRoute：提货点 - takeTime：提货时间 - vehiclePlate：车牌号 - writeStatus：结算状态 - 1：已结算 - 2：未结算 - 3：部分结算 - beforePayTotal：统计 - totalAmount：总计 - paidAmount：已结 - noPaidAmount：未结 ### 6.23自营代垫订单详情 #### 请求URL ```properties ${环境}/app/driver/me/findBeforePayOrderDetail ``` #### 请求方式 GET #### 请求示例 ```json { "orderId": "24b13ed548b84f4280f6098d9c675483" } ``` ##### 请求参数说明 - orderId：订单id #### 返回示例 ```json { "code": 10000, "data": { "addressDtoList": [ { "arrivedTime": "2/18 16:26", "contactName": "洪先生", "contactPhone": "15818370220", "departureTime": "2/18 16:27", "fullAddress": "广东省东莞市横沥镇水边村宝马路第六栋", "id": "d6506fd281edd1f2ceec09e49c33326b", "requireTime": "2/19 16:09", "route": "东莞横沥", "type": 1 }, { "arrivedTime": "2/18 16:27", "contactName": "仓库", "contactPhone": "", "departureTime": "2/18 16:27", "fullAddress": "广东省深圳市坪山新区兰竹西路10号（深圳市恒宜通物流有限公司B仓）", "id": "3c02daef75b3c826f3e7048087176093", "requireTime": "2/22 12:00", "route": "深圳坪山", "type": 2 } ], "distance": "75.9km", "duration": "1小时23分", "giveTime": "2月22日 12:00", "goodsName": "电子", "id": "24b13ed548b84f4280f6098d9c675483", "operateMode": 1, "orderNo": "ZCOD220218005", "orderRoyalty": 1335.00, "orderType": "专车", "packType": "托盘", "paidAmount": 0, "remark": "测试订单， 不要操作", "status": 8, "subjectList": [ { "label": "代支过磅费", "payStatus": 1, "property": "weighFee", "value": 30.00 }, { "label": "代支装卸费", "payStatus": 1, "property": "loadFee", "value": 0 }, { "label": "代支入仓报关费", "payStatus": 1, "property": "entranceFee", "value": 100.00 }, { "label": "代支停车费", "payStatus": 1, "property": "parkingFee", "value": 20.00 }, { "label": "代支高速费", "payStatus": 1, "property": "highFee", "value": 200.00 }, { "label": "代支打印费", "payStatus": 1, "property": "printFee", "value": 5.00 }, { "label": "代支维修费", "payStatus": 1, "property": "maintainFee", "value": 50.00 }, { "label": "代支其他费", "payStatus": 1, "property": "otherFee", "value": 500.00 }, { "label": "代支现金加油费", "payStatus": 1, "property": "refuelFee", "value": 400.00 }, { "label": "代支现金过路费", "payStatus": 1, "property": "passingFee", "value": 30.00 } ], "takeTime": "2月19日 16:09", "vehicleType": "9.6M/15吨车", "volume": "44件21.2吨9.9方", "writeStatus": 3 }, "message": "" } ``` ##### 返回参数说明 - id：订单ID - addressDtoList - arrivedTime：到场时间 - departureTime：离场时间 - contactName：联系人 - contactPhone：联系电话 - fullAddress：地址全路径 - requireTime：要求到达/离场时间 - route：路线名称 - type：1=提货，2=卸货，3=报关 - distance：里程 - duration：耗时 - goodsName：货物名称 - operateMode：订单模式 - orderNo：订单号 - orderType：订单类型 - orderRoyalty：订单提成（应付小计） - paidAmount：已结算 - packType：包装类型 - status：订单状态，参考订单状态说明 - remark：订单备注 - vehicleType：订单车型 - volume：体积（件重体） - writeStatus：结算状态： - 1：已结算 - 2：未结算 - 3：部分结算 - subjectList：订单费用提成明细 - label：显示名称 - value：显示值 - property：属性名称 - payStatus：结算状态 - 1：未结算 - 3：已结算 ### 6.24提成顶部统计 #### 请求URL ```properties ${环境}/app/driver/me/findRoyaltyTopTotal ``` #### 请求方式 GET #### 返回示例 ```json { "code": 10000, "data": { "weekCount": 0, "monthCount": 0, "preMonthCount": 0 }, "message": "" } ``` ##### 返回参数说明 - weekCount：本周 - monthCount：本月 - preMonthCount：上月 ### 6.25代垫顶部统计 #### 请求URL ```properties ${环境}/app/driver/me/findBeforePayOrderTopTotal ``` #### 请求方式 GET #### 返回示例 ```json { "code": 10000, "data": { "weekCount": 0, "monthCount": 0, "preMonthCount": 0 }, "message": "" } ``` ##### 返回参数说明 - weekCount：本周 - monthCount：本月 - preMonthCount：上月 ## 7.验证码登录 ### 7.1获取验证码 #### 请求URL ```properties ${环境}/driver/auth/sendLoginVerificationCode ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "phone":"13712341234" } ``` ##### 请求参数说明 - phone：手机号 #### 返回示例 ```json { "code": 10000, "data": true } ``` ##### 返回参数说明 - data：true发送成功，false发送失败 ### 7.2验证码登录 #### 请求URL ```properties ${环境}/driver/auth/loginByVerificationCode ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "phone":"13712341234", "verificationCode":"123456" } ``` ##### 请求参数说明 - phone：手机号 - verificationCode：短信验证码，测试环境可以不填 #### 返回示例 ```json { "code": 100000, "data": { "id": "司机id", "registerStatus": 10, "contactPhone": "13113690059", "token": "1234", "levelCaptain":1 } } ``` ##### 返回参数说明 - code：全局code返回101004，则是未注册 - registerStatus：注册状态码 - 0：已提交信息，等待审核 - 1：已提交基本信息（第一步） - 2：已提交车辆信息（第二步） - 3：已提交照片信息（第三步） - 10：注册成功，或返回token - id：司机id - contactPhone：司机号码 - token：登录成功的token - levelCaptain：是否车队长，1是，2否 ## 8. 车队长 ### 8.1 车辆列表 #### 请求URL ```properties ${环境}/app/vehicle/findVehicleList ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "listType": 0, "queryText": "A6", "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "pageNum": 1, "pageSize": 3 } ``` ##### 请求参数说明 - listType：查询页面类型：0:全部,1:任务中,2:闲置中 - pageType：页面类型 - 1：我的模块 - motorcadeId：车队ID - queryText：车牌号模糊查询 #### 返回示例 ```json { "code": 100000, "data": { "total": 56, "pageSize": 20, "list": [ { "currentCity": "深圳龙华", "currentLatitude": 22.724717, "currentLongitude": 114.027110, "id": "feda86dc3e9e453bbf4e79ffc0ea6be9", "isTailstock": 2, "motorcadeTypeName": "自营", "orderNum": 0, "vehiclePlate": "粤B15W03", "vehicleType": "4.2M/3吨车" } ], "currentPage": 1 }, "message": "" } ``` ##### 返回参数说明 - id：车辆ID - motorcadeTypeName：车队类型名称 - orderNum：订单数，订单数大于0显示任务中 - isTailstock：是否有尾板 - 1：是 - 2：否 - vehiclePlate：车牌号 - vehicleType：车型 - currentCity：当前城市 - currentLongitude：当前经度 - currentLatitude：当前纬度 ### 8.2 车辆数字统计 #### 请求URL ```properties ${环境}/app/vehicle/findVehicleTotal ``` #### 请求方式 GET #### 请求示例 ```json { "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e" } ``` ##### 请求参数说明 - motorcadeId：车队ID #### 返回示例 ```json { "code": 100000, "data": { "allNum": 1056, "idleNum": 1036, "taskNum": 0 } } ``` ##### 返回参数说明 - allNum= 全部数量 - idleNum ： 闲置数量 - taskNum：任务数量 ### 8.3 司机列表 #### 请求URL ```properties ${环境}/app/vehicle/findDriverList ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "vehicleId": "455c8acb655f49d9942b2029f31a87ab", "queryText": "A6", "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "pageNum": 1, "pageSize": 3 } ``` ##### 请求参数说明 - vehicleId：车辆id - motorcadeId：车队ID - queryText：姓名/电话模糊查询 - pageType：页面类型 - 1：我的模块 #### 返回示例 ```json { "code": 100000, "data": { "total": 1, "pageSize": 20, "list": [ { "contactPhone": "13891689983", "id": "79cc7246ab44418ea037eefb8d844901", "motorcadeTypeName": "自营", "name": "梁文科", "orderNum": 3, "proofType": "A2" } ], "currentPage": 1 }, "message": "" } ``` ##### 返回参数说明 - id：司机id - motorcadeTypeName：车队类型名称 - orderNum：订单数，订单数大于0显示任务中 - proofType：驾驶证类型 - name：司机名称 - contactPhone：联系电话 ### 8.4 确认分配 #### 请求URL ```properties ${环境}/app/order/dispatchOrder ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "vehicleId": "455c8acb655f49d9942b2029f31a87ab", "orderId": "54f59dcb92c14806af86e537dbb4f68e", "driverId": "54f59dcb92c14806af86e537dbb4f68e" } ``` ##### 请求参数说明 - vehicleId：车辆id - orderId：订单 - driverId：司机id #### 返回示例 ```json { "code": 100000, "data": true, "message": "" } ``` ### 8.5 添加车辆 #### 接口说明 车辆列表新增车辆，我的车辆新增车辆 #### 请求URL ```properties ${环境}/app/vehicle/addVehicleInfo ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求参数示例 ```json { "driverId": "00bc61c466fd48ac9fe2b7deaf0d5d9f", "enclosureInfoList": [ { "businessType": 3001, "id": "2ed43f608abd44d0aa8fc17c79fc3863", "name": "57bb8e9becf869c41a77186c295cd3e.jpg", "type": "image/jpeg", "url": "/rtd/tms/annex/2020-11/2ed43f608abd44d0aa8fc17c79fc3863.jpg" }, { "businessType": 3000, "id": "639541d8e742405f8efbcacef72a2b98", "name": "21b22c8011a00e859d0f7974304d272.jpg", "type": "image/jpeg", "url": "/rtd/tms/annex/2020-11/639541d8e742405f8efbcacef72a2b98.jpg" } ], "energyType": "a52dd114712644a486c11c2e1984bcb8", "isTailstock": 1, "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "vehiclePlate": "粤BLS6567", "vehicleType": "ccad28c08b5543aeb1c42744e821842d" } ``` ##### 请求参数说明 - vehiclePlate：车牌号 - motorcadeId：车队id - driverId：司机id - vehicleType：车型id - energyType：能源类型id - isTailstock：是否有尾板，1有，2无(返回的字典只有两个) - enclosureInfoList：附件集合 - id：上传后的文件id - businessType：业务类型 #### 返回示例 ```json { "code": 100000, "data": true } ``` ### 8.6 修改车辆 #### 接口说明 与新增车辆参数一致多个id参数 #### 请求URL ```properties ${环境}/app/vehicle/updateVehicleInfo ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "driverId": "00bc61c466fd48ac9fe2b7deaf0d5d9f", "enclosureInfoList": [ { "businessType": 3001, "id": "2ed43f608abd44d0aa8fc17c79fc3863", "name": "57bb8e9becf869c41a77186c295cd3e.jpg", "type": "image/jpeg", "url": "/rtd/tms/annex/2020-11/2ed43f608abd44d0aa8fc17c79fc3863.jpg" }, { "businessType": 3000, "id": "639541d8e742405f8efbcacef72a2b98", "name": "21b22c8011a00e859d0f7974304d272.jpg", "type": "image/jpeg", "url": "/rtd/tms/annex/2020-11/639541d8e742405f8efbcacef72a2b98.jpg" } ], "energyType": "a52dd114712644a486c11c2e1984bcb8", "id": "0beb011a08994d62a65d73dc6c68cbf5", "isTailstock": 1, "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "vehiclePlate": "粤BLS6567", "vehicleType": "ccad28c08b5543aeb1c42744e821842d" } ``` ##### 请求参数说明 - vehiclePlate：车牌号 - id：车辆ID - motorcadeId：车队id - driverId：司机id - vehicleType：车型id - energyType：能源类型id - isTailstock：是否有尾板，1有，2无(返回的字典只有两个) - enclosureInfoList：附件集合 - id：上传后的文件id - businessType：业务类型 #### 返回示例 ```json { "code": 100000, "data": true } ``` ### 8.7 车辆详情 #### 接口说明 查看车辆详情 #### 请求URL ```properties ${环境}/app/vehicle/getVehicleInfo ``` #### 请求方式 GET #### 请求示例 ```json { "vehicleId": "1aa04493c2654eb2be2b3893131a0849" } ``` ##### 请求参数说明 - vehicleId：车辆ID #### 返回示例 ```json { "code": 100000, "data": { "driverId": "c019616e4dc240a8b0481c0e9c18a126", "enclosureInfoList": [ { "businessType": 3001, "id": "747214c21e3c4645a954a6b315b551fb", "name": "a9a4c0b484c9baa69e3aa335a3a4d31.jpg", "type": "image/jpeg", "url": "/rtd/tms/annex/2021-09/747214c21e3c4645a954a6b315b551fb.jpg" }, { "businessType": 3000, "id": "9c9f29461b814ac99e39ce5b0e4dc147", "name": "BGZ232.jpg", "type": "image/jpeg", "url": "/rtd/tms/annex/2021-09/9c9f29461b814ac99e39ce5b0e4dc147.jpg" } ], "energyType": "a52dd114712644a486c11c2e1984bcb8", "id": "1aa04493c2654eb2be2b3893131a0849", "isTailstock": 1, "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "status": 1, "vehiclePlate": "粤BGZ232", "vehicleType": "55413e7cf248483485dd75128b0d828b" } } ``` ##### 返回参数说明 - id：车辆id - vehiclePlate：车牌号 - motorcadeId：车队id - driverId：司机id - vehicleType：车型id - energyType：能源类型id - isTailstock：是否有尾板，1有，2无(返回的字典只有两个) - status：1：可用，2：不可用 - enclosureInfoList：附件集合 - id：上传后的文件id - businessType：业务类型 ### 8.8 添加驾驶员 #### 请求URL ```properties ${环境}/app/vehicle/addDriverInfo ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "name": "唐蕾", "contactPhone": "13412341234", "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "cardNo": "123456789012345680", "entryDate": "2021-11-15", "proofType": "af796cada32540b48a461e2cd00f3a34", "enclosureInfoList": [ { "id": "a4f9cb2648c643e68ee9581a6cf41743", "businessType": 6001 } ] } ``` ##### 请求参数说明 - name：司机姓名 - motorcadeId：车队id - contactPhone：联系电话 - cardNo：身份证号码 - entryDate：入职日期 - proofType：驾驶证类型 - enclosureInfoList：附件集合，类型详见上传文件接口 - id：上传后的文件id - businessType：业务类型 #### 返回示例 ```json { "code": 100000, "data": true } ``` ### 8.9 驾驶员详情 #### 请求URL ```properties ${环境}/app/vehicle/getDriverInfo ``` #### 请求方式 GET #### 请求示例 ```json { "driverId": "343d1f85dce249d78b7d02a329e6d304" } ``` ##### 请求参数说明 - driverId：驾驶员ID #### 返回示例 ```json { "code": 100000, "data": { "cardNo": "420682197805213036", "contactPhone": "13424258786", "enclosureInfoList": [ { "businessType": 5000, "id": "82cb390a5adf45e2ba6f408d506867f8", "name": "1595810846027336.jpeg", "type": "image/jpg", "url": "/rtd/tms/annex/2020-07/82cb390a5adf45e2ba6f408d506867f8.jpeg" }, { "businessType": 5010, "id": "2aa2dcd7d79043ad93fd460ec702479b", "name": "1595810856074219.jpeg", "type": "image/jpg", "url": "/rtd/tms/annex/2020-07/2aa2dcd7d79043ad93fd460ec702479b.jpeg" }, { "businessType": 5001, "id": "bac1bf0871154ecda94af944055bcab7", "name": "159581088461682.jpeg", "type": "image/jpg", "url": "/rtd/tms/annex/2020-07/bac1bf0871154ecda94af944055bcab7.jpeg" } ], "entryDate": "2020-07-29", "id": "343d1f85dce249d78b7d02a329e6d304", "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "name": "钱爱银", "proofType": "eb0fa9c059f946a18533d09ee0fbee63", "status": 1 } } ``` ##### 返回参数说明 - name：司机姓名 - motorcadeId：车队id - contactPhone：联系电话 - cardNo：身份证号码 - entryDate：入职日期 - proofType：驾驶证类型 - status：1：可用，2：不可用 - enclosureInfoList：附件集合，类型详见上传文件接口 - id：上传后的文件id - businessType：业务类型 ### 8.10 修改驾驶员 #### 请求URL ```properties ${环境}/app/vehicle/updateDriverInfo ``` #### 请求方式 POST，JSON（Content-Type=application/json） #### 请求示例 ```json { "name": "唐蕾", "id": "343d1f85dce249d78b7d02a329e6d304", "contactPhone": "13412341234", "motorcadeId": "54f59dcb92c14806af86e537dbb4f68e", "cardNo": "123456789012345680", "entryDate": "2021-11-15", "proofType": "af796cada32540b48a461e2cd00f3a34", "enclosureInfoList": [ { "id": "a4f9cb2648c643e68ee9581a6cf41743", "businessType": 6001 } ] } ``` ##### 请求参数说明 - name：司机姓名 - id：司机id - motorcadeId：车队id - contactPhone：联系电话 - cardNo：身份证号码 - entryDate：入职日期 - proofType：驾驶证类型 - enclosureInfoList：附件集合，类型详见上传文件接口 - id：上传后的文件id - businessType：业务类型 #### 返回示例 ```json { "code": 100000, "data": true } ``` ## 9.迁移调度端接口 ### 9.1 司机下拉列表 #### 请求URL ```properties ${环境}/app/vehicle/findDriverByMotorcadeId ``` #### 请求方式 GET #### 请求示例 ```json { "motorcadeId": "1aa04493c2654eb2be2b3893131a0849" } ``` ##### 请求参数说明 - motorcadeId：车队id ### 9.2 车辆订单列表 #### 请求URL ```properties ${环境}/app/order/vehicleOrderList/{vehicleId} ``` #### 请求方式 GET #### 请求示例 ```json { "vehicleId": "1aa04493c2654eb2be2b3893131a0849" } ``` ##### 请求参数说明 - vehicleId：车辆id #### 返回说明 原调度端的订单状态 **orderStatus** 变更为 **status** 原调度端的调度信息 **planDto** 变更为 **vehiclePlanDto** ### 9.3 司机订单列表 #### 请求URL ```properties ${环境}/app/order/driverOrderList/{driverId} ``` #### 请求方式 GET #### 请求示例 ```json { "driverId": "1aa04493c2654eb2be2b3893131a0849" } ``` ##### 请求参数说明 - driverId：司机id #### 返回说明 原调度端的订单状态 **orderStatus** 变更为 **status** 原调度端的调度信息 **planDto** 变更为 **vehiclePlanDto**