跳到主要内容

FGTS 授权查询手册

另请参阅

1. 受益人授权查询​

授权查询允许验证受益人是否已授权在 FGTS 中进行批注和余额查询（与特定 CPF 关联），以便与 Caixa Econômica Federal 进行操作。

查询特征​

  • 同步请求：立即返回结果
  • 业务规则：仅当受益人与最后一个有效绑定的合作伙伴查询时才会成功
  • 例外：如果受益人在过去 90 天内未进行任何操作，则查询将返回所有合作伙伴的数据

要求​

进行查询时，需要提供受益人的 CPF。

接口端点​

GET
/fgts_issuer_auth_manager/issuer/{CPF}
路径参数
字段类型描述必填格式
document_numberstring受益人的 CPF 号码是11 位数字，无标点符号

成功响应​

STATUS
200 (OK)
响应示例

已授权：

{
    "authorization_limit_date": "2026-01-01",
    "last_checked_at": "2025-10-01",
    "status": "authorized"
}

未授权：

{
    "authorization_limit_date": null,
    "last_checked_at": "2025-10-01",
    "status": "unauthorized"
}

错误响应​

STATUS
404 (Not Found)

当 CPF 未在数据库中找到时返回。

状态参考​

状态描述
authorized受益人已获授权
unauthorized受益人未获授权

响应字段​

字段类型描述
authorization_limit_datestring授权到期日期（格式：YYYY-MM-DD）
last_checked_atstring授权最后更新日期
statusstring当前授权状态