Ler o saldo FGTS consignável de um trabalhador
Atua como proxy de consultar-saldo-fgts (Manual 002 §3.4) e retorna o saldo FGTS consignável e a parcela da multa rescisória usados como fonte dos valores de garantia em uma averbação ou proposta. É POST, não GET, porque a leitura depende de consentimento: a evidência de autorização do grupo 1 é um objeto aninhado e o CPF não deve aparecer no caminho ou na query string. O token de consentimento criado ou reutilizado pelo gateway nunca é retornado. Valores monetários são strings decimais, nunca floats.
Janela de consentimento (Manual 002 v1.15 §5.6): dataHoraAutorizacaoDigital inicia dois prazos em dias corridos a partir da assinatura. A autorização pode ser consultada por 30 dias e uma solicitação pode usá-la por 45 dias. Ambos os limites são inclusivos.
Fora das janelas, o gateway recusa localmente antes de chamar a rede: 422, código MYS-0006, com orientação para obter nova autorização. Essa recusa não deve ser repetida com a mesma evidência expirada. Um dataHoraAutorizacaoDigital com offset diferente de UTC ou no futuro também retorna 422, com detalhe específico para correção do timestamp.
Uma rejeição de consentimento emitida pela própria Dataprev para um token obsoleto retorna 503 e pode ser repetida: o gateway descarta o token em cache e a próxima tentativa abre um novo consentimento com a mesma evidência.
Autorizações
JWT bearer token issued by the identity provider.
Corpo
Worker grupo-1 digital-authorization evidence used to open or reuse the data-consult consent.
Employer inscription type. Manual 003 §3.1.1 p.10 and Manual 002 §3.3.1 p.14 publish exactly two codes: 1 = CNPJ, 2 = CPF.
1, 2 "1"
Worker CPF, exactly 11 digits (Manual 002 §3.2.2 p.12: Número, 11 algarismos). In the BODY, never a path or query parameter.
^[0-9]{11}$"99999999999"
Employment registration at the employer.
1"99999999999-A"
Employer inscription number matching codigoInscricaoEmpregador.
1"42422253000101"
Resposta
OK
Instant the rail computed the balance, RFC 3339 UTC. It is the balance's as-of moment, not the moment you called.
"2026-07-30T12:00:00Z"
Rescission-penalty portion (decimal string, BRL).
"400.25"
Consignable FGTS balance (decimal string, BRL).
"1000.50"

