up

README.md

@@ -21,9 +21,11 @@
     - [司机相关接口](#%E5%8F%B8%E6%9C%BA%E7%9B%B8%E5%85%B3%E6%8E%A5%E5%8F%A3)
         - [批量创建司机接口](#%E6%89%B9%E9%87%8F%E5%88%9B%E5%BB%BA%E5%8F%B8%E6%9C%BA%E6%8E%A5%E5%8F%A3)
         - [修改司机信息接口](#%E4%BF%AE%E6%94%B9%E5%8F%B8%E6%9C%BA%E4%BF%A1%E6%81%AF%E6%8E%A5%E5%8F%A3)
+        - [根据身份证号查询司机](#%E6%A0%B9%E6%8D%AE%E8%BA%AB%E4%BB%BD%E8%AF%81%E5%8F%B7%E6%9F%A5%E8%AF%A2%E5%8F%B8%E6%9C%BA)
     - [车辆相关接口](#%E8%BD%A6%E8%BE%86%E7%9B%B8%E5%85%B3%E6%8E%A5%E5%8F%A3)
         - [批量创建车辆接口](#%E6%89%B9%E9%87%8F%E5%88%9B%E5%BB%BA%E8%BD%A6%E8%BE%86%E6%8E%A5%E5%8F%A3)
         - [修改车辆信息接口](#%E4%BF%AE%E6%94%B9%E8%BD%A6%E8%BE%86%E4%BF%A1%E6%81%AF%E6%8E%A5%E5%8F%A3)
+        - [根据车牌号查询车辆](#%E6%A0%B9%E6%8D%AE%E8%BD%A6%E7%89%8C%E5%8F%B7%E6%9F%A5%E8%AF%A2%E8%BD%A6%E8%BE%86)
     - [收款人相关接口](#%E6%94%B6%E6%AC%BE%E4%BA%BA%E7%9B%B8%E5%85%B3%E6%8E%A5%E5%8F%A3)
         - [批量创建收款人接口](#%E6%89%B9%E9%87%8F%E5%88%9B%E5%BB%BA%E6%94%B6%E6%AC%BE%E4%BA%BA%E6%8E%A5%E5%8F%A3)
         - [修改收款人信息接口](#%E4%BF%AE%E6%94%B9%E6%94%B6%E6%AC%BE%E4%BA%BA%E4%BF%A1%E6%81%AF%E6%8E%A5%E5%8F%A3)
@@ -43,6 +45,7 @@
     - [创建承运人合同接口](#%E5%88%9B%E5%BB%BA%E6%89%BF%E8%BF%90%E4%BA%BA%E5%90%88%E5%90%8C%E6%8E%A5%E5%8F%A3)
     - [创建委托代收合同接口](#%E5%88%9B%E5%BB%BA%E5%A7%94%E6%89%98%E4%BB%A3%E6%94%B6%E5%90%88%E5%90%8C%E6%8E%A5%E5%8F%A3)
     - [创建撮合单票承运人合同接口](#%E5%88%9B%E5%BB%BA%E6%92%AE%E5%90%88%E5%8D%95%E7%A5%A8%E6%89%BF%E8%BF%90%E4%BA%BA%E5%90%88%E5%90%8C%E6%8E%A5%E5%8F%A3)
+    - [创建自营单票承运人合同接口](#%E5%88%9B%E5%BB%BA%E8%87%AA%E8%90%A5%E5%8D%95%E7%A5%A8%E6%89%BF%E8%BF%90%E4%BA%BA%E5%90%88%E5%90%8C%E6%8E%A5%E5%8F%A3)
 - [实名认证类接口](#%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81%E7%B1%BB%E6%8E%A5%E5%8F%A3)
     - [实名认证接口](#%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81%E6%8E%A5%E5%8F%A3)
 - [位置信息类接口](#%E4%BD%8D%E7%BD%AE%E4%BF%A1%E6%81%AF%E7%B1%BB%E6%8E%A5%E5%8F%A3)
@@ -967,11 +970,11 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
       "driverLicenseIssuingAuthority": "机关",
       "driverLicenseNumber": "110101198803078738",
       "driverLicenseStartTime": 1603929600,
-      "driverLicenseUrl": "https://oss.ali.56fanyun.com/ttms/b0a06471d4434004b4543c4339431111.jpeg",
+      "driverLicenseUrl": "https://oss.56fanyun.com/1.jpeg",
       "idCard": "110101198803078738",
       "idCardAddress": "地址",
-      "idCardBackUrl": "https://oss.ali.56fanyun.com/ttms/5ca69f27c8844efc8de003cfbcbd4a30.jpg",
-      "idCardFrontUrl": "https://oss.ali.56fanyun.com/ttms/a80fa112d8764c08b7b40e90318e917d.jpeg",
+      "idCardBackUrl": "https://oss.56fanyun.com/2.jpg",
+      "idCardFrontUrl": "https://oss.56fanyun.com/3.jpeg",
       "name": "朱元璋",
       "note": "",
       "organizationName": "总部",
@@ -1021,11 +1024,11 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
   "driverLicenseIssuingAuthority": "机关",
   "driverLicenseNumber": "110101198803078738",
   "driverLicenseStartTime": 1603929600,
-  "driverLicenseUrl": "https://oss.ali.56fanyun.com/ttms/b0a06471d4434004b4543c4339431111.jpeg",
+  "driverLicenseUrl": "https://oss.56fanyun.com/1.jpeg",
   "idCard": "110101198803078738",
   "idCardAddress": "地址",
-  "idCardBackUrl": "https://oss.ali.56fanyun.com/ttms/5ca69f27c8844efc8de003cfbcbd4a30.jpg",
-  "idCardFrontUrl": "https://oss.ali.56fanyun.com/ttms/a80fa112d8764c08b7b40e90318e917d.jpeg",
+  "idCardBackUrl": "https://oss.56fanyun.com/2.jpg",
+  "idCardFrontUrl": "https://oss.56fanyun.com/3.jpeg",
   "name": "朱元璋",
   "note": "",
   "organizationName": "总部",
@@ -1048,6 +1051,69 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
 }
 ```
 
+
+### 根据身份证号查询司机
+
+**简要描述：** 根据身份证号查询司机
+
+**请求 URL：** `/driver/find_drivers_by_idCards`
+
+**请求方式：** POST
+
+**需要AccessToken：** 是
+
+**调用限制：** 5次/秒
+
+**请求参数：**
+
+|名称|说明|类型|
+|---|---|---|
+|**idCards**  <br>*必填*|司机身份证号，单次最多50个  <br>**长度** : `0 - 50`|< string > array|
+
+**请求参数示例**
+
+```json
+{
+    "idCards": ["110101199403071590"]
+}
+```
+
+**返回示例**
+
+```json
+{
+    "code": 200,
+    "message": null,
+    "data": {
+        //身份证号
+        "110101199403071590": {
+            "id": "5ea240703e6b54000a95bfc2",         //主键ID
+            "name": "王师傅",                          //姓名
+            "phoneNumber": "18012345671",             //手机号
+            "idCard": "110101199403071590",           //身份证
+            "idCardStartTime": 1610582400,            //身份证生效日期
+            "idCardEndTime": 1611273600,              //身份证失效日期
+            "idCardAddress": "计量大厦",               //身份证住址
+            "qualificationCertificateNumber": "110101199403071590",   //从业资格证
+            "driverLicenseNumber": "110101199403071590",              //驾驶证编号
+            "quasiDrivingModel": "A1,A3",                             //准驾车型
+            "driverLicenseStartTime": 1602547200,                     //驾驶证生效日期
+            "driverLicenseEndTime": 1918080000,                       //驾驶证失效日期
+            "driverLicenseIssuingAuthority": "政府",                   //驾驶证发证机关
+            "idCardFrontUrl": "https://oss.xiaokuaikeji.com/1.jpg",   //身份证正面图片地址
+            "idCardBackUrl": "https://oss.xiaokuaikeji.com/2.jpg",    //身份证背面图片地址
+            "driverLicenseUrl": "https://oss.xiaokuaikeji.com/3.jpg", //驾驶证图片地址
+            "qualificationCertificateUrlList": ["https://oss.xiaokuaikeji.com/4.jpg"], //从业资格证图片地址
+            "note": "司机备注1",     //备注
+            "verifyStatus": 0,      //审核状态 0: 通过 1: 不通过 2: 待审核
+            "created": 1587691633,  //创建时间
+            "updated": 1615965234   //更新时间
+        }
+    }
+}
+```
+
+
 ## 车辆相关接口
 
 ### 批量创建车辆接口
@@ -1082,7 +1148,7 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
     {
       "approvedLoadWeight": 20700,
       "drivingLicenseUrlList": [
-        "https://oss.56fanyun.com/ttms/fda0e5e00e6f4a87b662e9b6d807b706.jpeg"
+        "https://oss.56fanyun.com/1.jpeg"
       ],
       "fileNumber": "浙N99999",
       "issueDate": 1423440000,
@@ -1146,7 +1212,7 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
 {
   "approvedLoadWeight": 20700,
   "drivingLicenseUrlList": [
-    "https://oss.56fanyun.com/ttms/fda0e5e00e6f4a87b662e9b6d807b706.jpeg"
+    "https://oss.56fanyun.com/1.jpeg"
   ],
   "fileNumber": "浙N99999",
   "issueDate": 1423440000,
@@ -1185,6 +1251,78 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
 }
 ```
 
+
+### 根据车牌号查询车辆
+
+**简要描述：** 根据车牌号查询车辆
+
+**请求 URL：** `/vehicle/find_vehicles_by_plateNumbers`
+
+**请求方式：** POST
+
+**需要AccessToken：** 是
+
+**调用限制：** 5次/秒
+
+**请求参数：**
+
+|名称|说明|类型|
+|---|---|---|
+|**licensePlateNumbers**  <br>*必填*|车牌号，单次最多50个  <br>**长度** : `0 - 50`|< string > array|
+
+**请求参数示例**
+
+```json
+{
+    "licensePlateNumbers": ["晋B85118"]
+}
+```
+
+**返回示例**
+
+```json
+{
+    "code": 200,
+    "message": null,
+    "data": {
+        //车牌号
+        "晋B85118": {
+            "id": "5f99138716669a000a26cba3",  //主键ID
+            "licensePlateNumber": "晋B85118",  //车牌号
+            "vehicleOwner": "黄连银",  //车辆所有人
+            "vehicleType": "重型半挂牵引车",  //车辆类型
+            "vehicleTypeCode": "Q11",  //车辆类型代码
+            "licensePlateColor": "黄色",  //车牌颜色
+            "licensePlateColorCode": "2",  //车牌颜色代码
+            "natureOfUse": "货运",  //使用性质
+            "vehicleIDCode": "LFWRMUPH3F1F10155",  //车辆识别代号
+            "registrationDate": 1429488000,  //注册日期
+            "issueDate": 1561939200,  //发证日期
+            "issuingAuthority": "山西省大同市公安局交通警察支队",  //发证机关
+            "vehicleEnergyType": "柴油",  //车辆能源类型
+            "vehicleEnergyTypeCode": "B",  //车辆能源类型代码
+            "approvedLoadWeight": 101,  //核定载质量
+            "totalWeight": 200,  //总质量
+            "fileNumber": "48938934",  //档案编号
+            "outlineLength": 3,  //外廓长
+            "outlineWidth": 4,  //外廓宽
+            "outlineHeight": 5,  //外廓高
+            "trailerLicenseNumber": "",  //挂车牌照号
+            "roadTransportCertificate": "140213002622",  //道路运输证号
+            "merchantName": "黄连银",  //业户名称
+            "roadTransportLicenseNumber": "1402130000003",  //道路运输经营许可证号
+            "drivingLicenseUrlList": ["https://oss.xiaokuaikeji.com/1.jpg"],  //行驶证照片
+            "roadTransportPermitUrlList": ["https://oss.xiaokuaikeji.com/2.png"],  //道路运输证照片
+            "note": "车辆备注",  //备注
+            "verifyStatus": 0,  //审核状态 0: 通过 1: 不通过 2: 待审核
+            "created": 1603867527,  //创建时间
+            "updated": 1615980914  //更新时间
+        }
+    }
+}
+```
+
+
 ## 收款人相关接口
 
 ### 批量创建收款人接口
@@ -1309,8 +1447,8 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
   "middleman": {
     "idCard": "110101198603073270",
     "idCardAddress": "浙江省杭州市西湖区xxxx",
-    "idCardFrontUrl": "https://oss.56fanyun.com/ttms/0192b934087e4e3c9c00a6533e98be24.jpg",
-    "idCardReverseUrl": "https://oss.56fanyun.com/ttms/ae7cace46e074456864f7959b418955b.jpg",
+    "idCardFrontUrl": "https://oss.56fanyun.com/1.jpg",
+    "idCardReverseUrl": "https://oss.56fanyun.com/2.jpg",
     "name": "李四三",
     "phoneNumber": "18058718162",
     "remark": ""
@@ -1969,6 +2107,54 @@ https://openapi.wlhy.pre.kuaihuoyun.com/order/create_order?access_token=fe12047e
 ```
 
 
+## 创建自营单票承运人合同接口
+
+**简要描述：** 创建自营单票承运人合同接口
+
+**请求 URL：** `/contract/single_contract/create`
+
+**请求方式：** POST
+
+**需要AccessToken：** 是
+
+**调用限制：** 3次/秒
+
+**请求参数：**
+
+|名称|说明|类型|
+|---|---|---|
+|**orderNumber**  <br>*必填*|运单编号|string|
+|**number**  <br>*必填*|合同编号|string|
+|**name**  <br>*必填*|承运人姓名|string|
+|**phone**  <br>*必填*|承运人电话|string|
+|**certNo**  <br>*必填*|承运人身份证号|string|
+|**contractDate**  <br>*必填*|签约日期，格式`yyyy-MM-dd` <br>**样例** : `2020-01-01`|string|
+|**fileUrl**  <br>*必填*|合同文件地址 <br>**样例** : `https://www.a.com/z.pdf`|string|
+
+**请求参数示例**
+
+```json
+{
+  "orderNumber": "S2011181700651710",
+  "number": "HT00001",
+  "name": "冯测",
+  "phone": "13064797352",
+  "certNo": "110101196603072412",
+  "contractDate": "2020-01-01",
+  "fileUrl": "https://www.a.com/z.pdf"
+}
+```
+
+**返回示例**
+
+```json
+{
+    "code": 200,
+    "data": true,
+    "message": null
+}
+```
+
 
 # 实名认证类接口