Appearance
提示：开通小号无需短信验证
使用H5链接操作
说明: 数电发票开具需要开票员连接税局、人脸认证，将设置账号接口返回的certifyUrl，提供给开票员进行连接认证操作。
操作方法
- 连接税局：录入短信验证码
- 人脸认证：H5展示电子税务局APP或个人所得税APP二维码（可切换），开票员使用对应APP的扫一扫功能，扫码进行人脸认证。
使用接口
说明: 除了使用我司H5链接进行开票员身份认证，还可使用以下接口。
获取验证码接口
说明: 用于获取连接税局的短信验证码。
请求地址: /api/v3/sendSms
请求方式: POST
请求参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| digitAccount | string | 是 | 电子税局个人手机号 |
返回参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| digitAccount | string | 是 | 电子税局个人手机号 |
| taskId | string | 是 | 任务ID |
| connState | int | 是 | 连接状态 0: 未连接, 1: 已连接(1表示已是连接状态，无需再发验证码) |
提交验证码接口
说明: 用于提交短信验证码以完成连接税局。
请求地址: /api/v3/pushSms
请求方式: POST
请求参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| digitAccount | string | 是 | 电子税局个人手机号 |
| taskId | string | 是 | 任务ID |
| smsCode | string | 是 | 短信验证码 |
返回参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| connState | int | 是 | 连接状态（1: 连接成功） |
查询连接状态接口（短信验证状态）
说明: 如您需要主动查询开票员连接（短信验证）状态，可调用本接口。另调用开票接口失败时，可根据返回的错误码知晓开票员认证状态，720006：连接（短信验证）状态失效。
请求地址: /api/v3/connState
请求方式: POST
请求参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| digitAccount | string | 是 | 电子税局个人手机号 |
返回参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| connState | bool | 是 | true连接有效；false连接失效，开票员需要重新进行短信验证 |
获取人脸二维码接口
说明: 用于获取人脸认证的二维码字符，需把字符生成二维码，两个APP二选一扫码做人脸认证。
请求地址: /api/v3/getAuthQr
请求方式: POST
请求参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| digitAccount | string | 是 | 电子税局个人手机号 |
返回参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| name | string | 是 | 开票员姓名 |
| etaxQr | string | 是 | 电子税务局APP二维码 |
| etaxAuthId | string | 是 | 电子税务局APP认证ID |
| nationQr | string | 是 | 国家网络身份认证APP二维码 |
| nationAuthId | string | 是 | 国家网络身份认证APP认证ID |
人脸结果提交接口
说明: 用于扫脸完成以后提交人脸认证结果。
请求地址: /api/v3/pushAuthQr
请求方式: POST
请求参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| digitAccount | string | 是 | 电子税局个人手机号 |
| authId | string | 是 | 认证ID |
返回参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| qrState | string | 是 | 二维码状态 1：二维码未扫脸 2：扫脸成功 3：二维码已过期 |
查询人脸状态接口
说明: 如您需要主动查询开票员人脸认证状态，可调用本接口（需连接状态有效才能查询）。另调用开票接口失败时，可根据返回的错误码知晓开票员认证状态，720007：人脸认证状态失效。
请求地址: /api/v3/authState
请求方式: POST
请求参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| taxNo | string | 是 | 企业税号 |
| digitAccount | string | 是 | 电子税局个人手机号 |
返回参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| authState | bool | 是 | true认证有效；false认证失效，需要重新进行人脸验证 |
| setScanTime | int | 否 | 本企业当前设置的扫脸认证有效时长(单位：分钟) |
| maxScanTime | int | 否 | 本企业能设置的最大扫脸认证有效时长(单位：分钟) |
| lastScanTime | string | 否 | 通过本接口上次认证成功时间 yyyy-MM-dd HH:mm:ss |