> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Caixa (FGTS)

> El certificado de regularidad del FGTS de Brasil (CRF) de cualquier empleador, por CNPJ: si la empresa está al día con el fondo de cesantías de los trabajadores, el número y la vigencia del certificado, y qué lo impide cuando no lo está, de la Caixa Econômica Federal.

La Caixa Econômica Federal opera el FGTS, el fondo de cesantías al que todo
empleador brasileño aporta cada mes, y certifica qué empleadores están al día
con él. La ley brasileña exige el certificado (Certificado de Regularidade do
FGTS, CRF) para tomar crédito de bancos públicos, participar en licitaciones y
recibir fondos públicos, lo que lo vuelve una verificación estándar al
incorporar clientes de crédito y proveedores.

Envía un CNPJ y obtén la situación del empleador: regular, con su certificado
vigente, o irregular, con el organismo que reporta el impedimento. Opcionalmente,
los certificados emitidos en los últimos 24 meses.

`POST /br/caixa/fgts-certificate/v1` Devuelve la situación de un empleador ante el FGTS y su certificado vigente.

| Campo             | Tipo    | Notas                                                                                                                                         |
| ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string  | **Obligatorio.** **Obligatorio.** El CNPJ de la empresa, con o sin puntuación, p. ej. `33.000.167/0001-01`. Solo empresas: un CPF se rechaza. |
| `include_history` | boolean | Opcional. `true` para recibir también `history`, los certificados emitidos en los últimos 24 meses. Por defecto `false`.                      |

```bash theme={"dark"}
curl https://api.croma.run/br/caixa/fgts-certificate/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "33.000.167/0001-01" }'
```

Devuelve `document_number`, `found`, `status` (`regular` o `irregular`), `status_label` (el veredicto como lo redacta la fuente), `impediments[]`, `company_name`, `certificate`, `history` (con `include_history`) y `checked_at` (ISO 8601, hora de Brasilia).

Cuando es `regular`, `certificate` es `{ number, valid_from, valid_until, address }`: el número del certificado, que cualquiera puede verificar con Caixa, el día en que se emitió, el día en que vence (30 días después) y la dirección del establecimiento como `{ street, number, complement, district, city, state, postal_code, full }`. Cuando es `irregular`, `certificate` es null y cada elemento de `impediments[]` es `{ agency, message }`: `PGFN` cuando hay deuda del FGTS inscrita ante la procuraduría de la Unión, `CAIXA` cuando la reporta el operador del fondo.

Cada elemento de `history[]` es `{ issued_on, valid_from, valid_until, number }`, del más reciente al más antiguo, y cubre los últimos 24 meses. Las entradas de principios de los 2000 no traen número.

<Note>
  Una empresa puede ser `regular` estando en recuperación judicial o en
  quiebra: el certificado habla solo del FGTS. Su situación se ve en
  `company_name` (p. ej. `EM RECUPERACAO JUDICIAL`). Un CNPJ que no está
  registrado como empleador responde `found: false`.
</Note>

<Note>
  El certificado se emite por empresa: el CNPJ de una sucursal devuelve el
  mismo número y vigencia que la matriz, con su propia dirección.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>
