Leer el saldo consignable FGTS de un trabajador
Esta operación actúa como proxy de consultar-saldo-fgts (Manual 002 §3.4): el saldo FGTS consignable del trabajador y la porción de penalización por rescisión, el origen de los valores de garantía que lleva una averbação o una oferta de subasta. POST, no GET, porque la lectura está controlada por consentimiento: la evidencia de autorización grupo-1 del trabajador es un objeto anidado y CPF nunca debe aparecer en una ruta o cadena de consulta. El token de consentimiento que la gateway acuña o reutiliza nunca se devuelve. El dinero es una cadena decimal, nunca un flotante.
VENTANA DE CONSENTIMIENTO (Manual 002 v1.15 §5.6). DataHoraAutorizacaoDigital pone en marcha dos relojes, medidos en días calendario a partir de la firma del trabajador: la autorización puede ser CONSULTADA por 30 días, y una solicitud puede ser PRESENTADA en su contra por 45. Ambos límites son inclusivos: el instante exactamente 30 o 45 días después de que la firma todavía está dentro de su ventana, y solo el siguiente nanosegundo está afuera.
fuera de cualquiera de las ventanas, la gateway rechaza localmente, antes de que un byte llegue a la red: 422 con el código MYS-0006 y un detalle que le indica que obtenga una nueva autorización de trabajador. Esa negativa es no REINTENTABLE. Al repetir la solicitud se realiza la misma lectura de la autorización caducada y retirada; sólo nueva evidencia de autorización hace que tenga éxito. Un dataHoraAutorizacaoDigital que lleva un desplazamiento que no es UTC, o que tiene una fecha anterior al reloj de la gateway, es el mismo 422 con un detalle diferente: corrija la marca de tiempo; el consentimiento del trabajador no está en duda.
compare el rechazo de consentimiento propio de la red (Dataprev ex/iv en un tokenAutorizacao obsoleto): es 503 y se puede volver a intentar, porque la gateway descarta el token almacenado en caché y el siguiente intento abre un nuevo consentimiento a partir de la misma evidencia.
Autorizaciones
JWT bearer token issued by the identity provider.
Cuerpo
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"
Respuesta
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"

