获取司机信息

更新时间:2024.11.18

获取司机信息

接口说明

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

请求方式:【GET】/v3/taxi-invoice/drivers/{driver_license}

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

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

请求参数

Header HTTP头参数

Authorization  必填 string

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


Accept  必填 string

请设置为application/json


path 路径参数

driver_license  必填 string(128)

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


query 查询参数

region_id  必填 integer

【行政区划代码】行政区划代码

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/taxi-invoice/drivers/6298416?region_id=510100 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

driver_name  必填 string(1024)

【司机姓名】司机姓名,需要用微信支付平台证书中的公钥,对其进行加密


company_name  必填 string(64)

【公司名称(全称)】公司名称(全称)


company_mchid  必填 string(20)

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


driver_license  必填 string(128)

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


driver_category  必填 string

【司机类别】司机类别

可选取值:

  • MAIN: 主班司机,一般是出租车的承包人

  • DEPUTY: 副班司机

  • FLEXIBLE: 机动司机


driver_photo  选填 object

【司机照片】司机照片

属性

region_id  必填 integer

【行政区划代码】行政区划代码


driver_state  必填 string

【司机状态】司机状态

可选取值:

  • ACTIVE: 表示司机在职

  • INACTIVE: 表示司机已离职

应答示例

200 OK

1{
2  "driver_name" : "OpldWegML3fJ3/U5L6av0bU6GcIOaOhXf2UDYKD8aZByMIav4gGrxjcPPk/7rz7HJ1MOugpoI1KMG8nANKIGtyA75ZM7qM16j16CT0VUtmZMo2nV2/3x/058hpAOORYwkl2g/tOck3MgVwTj9ZTvq6s7wrWomyi+SY04APUv4dfFrUvfbktxSi9JI37tSIP5rXD0Lq35KCZLR0aIyVlBs/MqmAhdQ1klK+kKY2VvC2/DmIY0BmpV/o745eOjWwtlS0PzG7BQ3JYUqhtmz2SawsVeHk9sm1wwPUXFM1ssRN/t2DrNLxVUb77DCnz421UAD7US5TWiL5sVnQSz/wvsvQ==",
3  "company_name" : "深圳市未来有限公司",
4  "company_mchid" : "1900000109",
5  "driver_license" : "6298416",
6  "driver_category" : "MAIN",
7  "driver_photo" : {
8    "photo_type" : "PHOTO_URL",
9    "photo_digest" : {
10      "hash_type" : "MD5",
11      "hash_value" : "e10adc3949ba59abbe56e057f20f883e"
12    },
13    "photo_url" : "http://www.abc.com/driver.icon",
14    "photo_data" : "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"
15  },
16  "region_id" : 510100,
17  "driver_state" : "ACTIVE"
18}
19

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

请检查参数格式是否符合要求

请使用正确的参数重新调用

403

NO_AUTH

出租车公司不属于服务商

请检查出租车经营主体商户号,确认是【新增出租车公司】接口返回的商户号

403

NO_AUTH

服务商无权限

请检查是否已经开通出租车电子发票产品相关功能权限

404

NOT_FOUND

所查询的出租车不存在

请检查营运资格证号和行政区划代码

404

NOT_FOUND

未找到指定的出租车经营主体信息

请检查出租车经营主体商户号和行政区划代码,确认公司存在且没有下线

 

 

反馈
咨询
目录
置顶