# 获取企业刷脸有效期配置
# 接口说明
获取当前企业全电发票扫码认证的刷脸有效期配置信息。该接口用于查询企业刷脸认证的有效时长,以便业务系统在合适的时机提醒用户重新进行刷脸认证。
# 地址
/tax-api/invoice/auth/validity-conf/v1
# 请求参数
| 参数名称 | 类型 | 必填 | 最大长度(字节) | 描述 | 示例 |
|---|---|---|---|---|---|
| tax_code | string | 是 | 20 | 销方纳税人识别号(即统一社会信用代码,一般是15、17、18、20位长度位数字或大写字母,字母I、O、S、V、Z除外) | 91469027MA5RH09M0R |
| terminal_no | string | 是 | 20 | 税盘编号: 全电发票传销方税号(系统默认生成的全电设备号),若不传则默认取税号 | 91469027MA5RH09M0R |
# 请求示例
{
"tax_code": "91469027MA5RH09M0R",
"terminal_no": "91469027MA5RH09M0R"
}
# 响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | int32 | 响应码:0表示成功,非0表示失败 |
| message | string | 响应消息 |
| log_id | string | 请求日志ID,用于问题排查 |
| data | object | 响应数据 |
| data.validity_duration | int32 | 刷脸有效期时长(单位:分钟) |
# 响应示例
{
"code": 0,
"message": "success",
"log_id": "abc123def456",
"data": {
"validity_duration": 1440
}
}
# 错误码说明
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| -1 | 业务处理失败 |
| 10001 | 参数校验失败(税号或税盘编号为空) |
| 10002 | 税盘未绑定 |
| 10003 | 资源包已过期 |
| 10004 | 纳税人授权校验失败 |