# 获取企业刷脸有效期配置

# 接口说明

获取当前企业全电发票扫码认证的刷脸有效期配置信息。该接口用于查询企业刷脸认证的有效时长,以便业务系统在合适的时机提醒用户重新进行刷脸认证。

# 地址

/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 纳税人授权校验失败