更新司机信息

更新时间：2025.01.09

更新司机信息，司机需有实名认证的微信号，否则新增失败，司机所在的公司必须已经成为服务商的特约商户，否则新增失败。

注意事项：

当更新司机信息后，如果涉及到营运资格证号，为保持数据一致，建议更新车辆信息中的主副班司机信息。
具体开车的司机以签到为准，签到期间司机在开哪辆车，即开车辆对应公司的发票。

接口说明

支持商户：【普通服务商】

请求方式：【POST】/v3/taxi-invoice/driver/update-driver

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数
折叠全部参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

Wechatpay-Serial 　必填　string

【微信支付公钥ID】或【微信支付平台证书序列号】请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

body 包体参数

driver_name 　必填 string(1024)

【司机姓名】司机姓名，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

id_card_number 　必填 string(1024)

【司机身份证号码】司机身份证号码，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

company_name 　必填 string(1024)

【公司名称(全称)】公司名称(全称)。首次更新时，从【新增出租车公司信息】返回报文中获取。

mchid 　必填 string(20)

【公司商户号】公司商户号

driver_license 　必填 string(128)

【营运资格证号】营运资格证号

driver_category 　必填 string(20)

【司机类别】司机类别：MAIN:主班，DEPUTY:副班，FLEXIBLE:机动司机，UNKNOWN:未知

driver_status 　必填 string(20)

【岗位状态】岗位状态：ON_DUTY:在岗 OFF_DUTY:离岗

driver_photo 　选填 object

【司机头像】司机头像

属性

photo_type 　选填 string(16)

【照片类型】照片类型，PHOTO_URL：url路径，PHOTO_ICON：icon图像

photo_digest 　选填 object

【司机头像摘要】司机头像摘要

属性

hash_type 　选填 string

【哈希类型】哈希类型，MD5：MD5算法，目前仅支持MD5

可选取值：

MD5: MD5算法

hash_value 　选填 string(512)

【哈希值】哈希值

photo_url 　选填 string(255)

【头像url】头像url

photo_icon 　选填 string(65000)

【头像icon】头像icon

region_id 　必填 integer

【行政区划ID】行政区划ID

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/taxi-invoice/driver/update-driver \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "driver_name" : "OpldWegML3fJ3/U5L6av0bU6GcIOaOhXf2UDYKD8aZByMIav4gGrxjcPPk/7rz7HJ1MOugpoI1KMG8nANKIGtyA75ZM7qM16j16CT0VUtmZMo2nV2/3x/058hpAOORYwkl2g/tOck3MgVwTj9ZTvq6s7wrWomyi+SY04APUv4dfFrUvfbktxSi9JI37tSIP5rXD0Lq35KCZLR0aIyVlBs/MqmAhdQ1klK+kKY2VvC2/DmIY0BmpV/o745eOjWwtlS0PzG7BQ3JYUqhtmz2SawsVeHk9sm1wwPUXFM1ssRN/t2DrNLxVUb77DCnz421UAD7US5TWiL5sVnQSz/wvsvQ==",
9    "id_card_number" : "OpldWegML3fJ3/U5L6av0bU6GcIOaOhXf2UDYKD8aZByMIav4gGrxjcPPk/7rz7HJ1MOugpoI1KMG8nANKIGtyA75ZM7qM16j16CT0VUtmZMo2nV2/3x/058hpAOORYwkl2g/tOck3MgVwTj9ZTvq6s7wrWomyi+SY04APUv4dfFrUvfbktxSi9JI37tSIP5rXD0Lq35KCZLR0aIyVlBs/MqmAhdQ1klK+kKY2VvC2/DmIY0BmpV/o745eOjWwtlS0PzG7BQ3JYUqhtmz2SawsVeHk9sm1wwPUXFM1ssRN/t2DrNLxVUb77DCnz421UAD7US5TWiL5sVnQSz/wvsvQ==",
10    "company_name" : "深圳市未来有限公司",
11    "mchid" : "1900000109",
12    "driver_license" : "6298416",
13    "driver_category" : "MAIN",
14    "driver_status" : "ON_DUTY",
15    "driver_photo" : {
16      "photo_type" : "PHOTO_URL",
17      "photo_digest" : {
18        "hash_type" : "MD5",
19        "hash_value" : "e10adc3949ba59abbe56e057f20f883e"
20      },
21      "photo_url" : "http://www.abc.com/driver.icon",
22      "photo_icon" : "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBT/wAARCABkAFEDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD4kooor88P7NCo7u6hsIvMuH2Keijlj9BTL68FjbmQLvkPCLkdfU+1bngz4IeMfiUhvrfSmkgGCJJRtV/pn+lelhsLGa9pVdo/mfD57xE8vn9Wwq5qnXsv+CcZceMI48+VaOwHdz/hUlr4tilUma12Addh5HvzXumkfsP/ABD1dZDLaWunQ9VMsoOf++c/yrkfFn7KXj7wlNtn0Yz27cCe3YMo65yOtex7DCWtZH5x/rBm3Pz+1f4W+45KC4t76PfbOXA+8O4paw9f8IeIPh3dRG8tpLeJuRIQcN3xWtZahFqdus0fXo6+hrxsThlTXtKbvE/Schz/APtF/VsQrVEvvJqKKK84+2CiiigAooooA3fBXhGPxR420a3mhaeJmXKdQ3zdK/Sjwv4dh0m2gSJBHGoCqiLgKAMDivjP9kPRDrnxKkklh8y3s7JnUkceZvAH6E1966Dpt07sxj3RxgkRIw/Dk969Rp1lGMeiPw7NV7HG15T3cn919DbsdNjeBSoPIJyfWud8ZabG9lKjnLMpAAAwTXd2H2aaEoUaBgOVc55rH8Q2kUyNFFbm6m64VgMVrKi2rLc8GNRJ3Z8Z/GrwTaal4cvoZLVLmMxnaMfMCM8j0NfFOg2j6fd31ttKopHBGDkHFfpb8QfDV15jRSQo8b5JhyC0eQe469q+CPiDokmg/EDWrfyykPysvGByM/41zwbhTnSl2ufSZSufMKFWHez9GmYNFFFecftYUUUUAFFFFAH3T+xrZ2MXgHSr+OFWuWluIJ3HciTcoPvgj8xXuviHwb4j8RaffDR/EFz4fuHOYZokDKp3KcsOGOQCuAw4b6V88fsT3DN4CdXZCkWrShQG5GYozyPwNfZ2l3Ze1KqVjRernr+FenhrM/EM9i442ou7f5nJ6LHqHh63t4NTum1KdUVXmfhnIABY4Axk5OO2cVz+t2ureN9L1fT9I1efQr+Qsomg++vTaQcgkDBBAIJz1FdTrEiXWsLbIwiQj/WSEDccZrlPD8v2Dx5dWUzbopV/dzRHIVxzj8q1vJTv0PH5E4PucvH4B1nwxLp/9o6rea35ESia4vMFnIXax9cMfm5Jx+VfMv7QWjW0uh+INUhhiH+mQRBzjeCM8fiH/Svt/wAeam8Fj5MreZuXAkAwTXwr+0I7Q+FpzubbPqYXBPB2qen5fyrkxCtLQ9/IlKWKp+q/M+daKKK4j9oCiiigAooooA9c/Zg8br4N+KmnpcTmKx1DNpIC2FDkgoxHruAGf9o1+l9hqKDT/MblAMketfkbpGkXc02kNbQNNd3+oQ2dqgOMsWGW+g/x9K/STwj4vksltrW+JEUygwXBPynj7p9676KlCKk9mfkXElfD18a4Un70FaX9fmdldeLPDouiNR2xXLAgPPEy4/4ERx+dYKeKPC9jrWdGSOW5lcBjbRsxJ6Ekgc8dSa63+yFv7ZZor9bcuPmIRWJ/A8VyXiSG08Nv/aF3feY6ZJlchdq98AcD8K65StG58vHkfe5H8SNYWDSzNM4iO0uN/GABX5v/ABO8SnxJ4tvpUld7RJCsSliVHqQPc19F/G/4oXnibTdYmsxIunW0LBXOd0jY+Vce5x+lfJ13ayWroJFKF0WQBuuGGRXnVry97ofdcLKjGtOMn79rpeV9SCiiiuY/SwooooAK1fDvhy78S3621qhIHLydkHqa6Xw78Lru/ZZdSc2cHXYMFz7eg/n7V6x4S8OWOg6Ywt7cKH+bPUn6mto029z43NOIqGGhKnhnzT79F/mSeCNFstE1zwzdSxo8ek38ciuRwgKlGb8AxNfZVh4UsL2wTT3iX7M4/cf7P+yD2I7e3418iaYFkhnVh35H1r6l+EniQeIPBVoZD5k1sPs0/PO5cYP4ja2fevqcupQxlKWGlutV+v6H4XmNaph6yxS1vpL87/mPvPBPiTS8xaZqriEfdjm6r+ODXF6p8IfEHim8Rdb1ORrZTkxoxIx9cAfpXusOrwvPFZXVwkdy6FoSzAGVRjP4jIz9ai1B1RGjik4PDyj+Q965fqNV1fY21OpY+nGl7a+n9fifMPxV8BWVjpH2eGFYdKsQcgD/AF9ww2xr77SS5/3B6183+PvD1tcSrGECOIi0bKORjHH0r6n+OuspdanY6RbcQ2ymaRQf4m4X8cbv++q8K16ySTU7N3A2bmjOR6jj9cVljqMaE/YLXl39X/SOvLcZVusXB8r6ei/z1+8+eLq1lsriSCdDHKhwyt1BqGvbPE/hS01G9hS6tgZpV2CVOGLDpg/TPX0riPEHwv1LSiXtlN1D1AH3wP6/54rxZU2tUfsmX8R4XFJQrPkn57P0f+ZxVFXf7F1D/nxuf+/Tf4UVlZn0v1ij/OvvPonUIQsYgVsrK67CT05/oRW5psW3TYs4P7sdPpXPhzdeHIJ8EtEwJPoCBW9oR36XHjkrlTg+9ehax/PW7INLTFxOD0b1rrvB3xTt/hSurX9/FPcaa8BPk267naZfuKo/2slc9ORngVzNvGY7xePlYVgeMfFvh/w7ay22r6jBEWX/AFAbdKR67Fyf0rswlaWHrRqR6HLi6Ua9GUJdTybxl+1H4/1Dxrq99cR2mmapHI0HlPb7pLWINkQAscbRgHOPmPPevpL9kH9p/VPihp2peHvE6B73Tk8y21FFISSPoY35I3r1HqD0GOfmL9ovUND1y28L63ZSSDW0i+xXquhX7RFjdHICQAcZK59wP4a9h+DfiDwv8LfgbbzwmKTVb5WmlY/MysBud39FQHHv8o719vTrKLdVyvFK/qfCSpSbVLl969jt/EGonWfEmpXZYuJJmCnttHA/lXIeIFLsIQQHJ3hj2I5H61mWfxW8LzPFF/aLxrj70ltIq/iSuBWlePb601teWVxFdQSA5khcMpGPUV8JXlKpOVSXV3Pv6ChCEYReysQ6xKs1jp97tAIZmwD0PluP51Yjj86SaPG9hhQO/QVV8Q4i0i1VVwFm2Y9OCKu2523lyD/G6R8duCT+lc5t1E/sh/7q/wDfdFWv7SH95fyoosO7Kvg6Nbrw/cRyDKlcfqR/SrPhOVn0hsnO12UfhRRT6C6nIfFvxTqPh5NKsdPm+zC+kaOSdRmVQP7pPQ++Ky9C8FaVp8El2sLT3b/M887b3YnrknrmiiumOkNDklrUdznfitoFkPC94vlnbbESwgn7hBXge3JFHw80S0l8J2jSIZN8PnMrHIZiWPI74xwKKK35n9X3+1+hzKK+t7fZ/U9Bg8P2L2ixmBdpTaRjtivPdOt28P3THTp5rXkjCNwRnoRjB/GiisYHRPc7WHV7jWvC32m42+ctyqZQYBx3I9a6GZisqMOCZXP4+STRRXMzqiZPmv8A3jRRRUFH/9k="
23    },
24    "region_id" : 510100
25  }'
26

应答参数
折叠全部参数

200 OK

driver_name 　选填 string(1024)

【司机姓名】司机姓名，需要使用API证书私钥解密敏感字段

id_card_number 　选填 string(1024)

【司机身份证号码】司机身份证号码，需要使用API证书私钥解密敏感字段