跳到主要内容

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当前授权状态