API do CRF do FGTS: a regularidade do empregador na Caixa
A API do CRF da Hath Data consulta a regularidade do empregador no portal da Caixa e devolve em JSON se o certificado saiu, o número, o período de validade de 30 dias e o PDF da Caixa. A regularidade é verificada por estabelecimento: cada filial com empregados tem o seu CRF, e a API aceita a lista inteira numa chamada. A Caixa não oferece API aberta à contratação.
- Fonte
- Caixa Econômica Federal
- Você envia
- CNPJ do estabelecimento
- Volta
- JSON e PDF oficial
- Situação
- Em produção
Trinta dias é a validade mais curta da pasta de habilitação. Num documento assim, emitir na mão é escolher deixar vencer.
Do portal da Caixa para o seu sistema
Você envia
- CNPJ do estabelecimento (matriz ou filial)
- Lista de CNPJs, para a rede inteira
RespostaJSONEm uma linha
CRF: REGULAR perante o FGTS · válido de 13/10/2026 a 11/11/2026 · certificado nº 0000000000000000000
{
"protocolo": "a1b2c3d4",
"status": "concluida",
"cnpj": "00.000.000/0001-00",
"certidao": "crf_fgts",
"orgao": "Caixa Econômica Federal",
"resultado": {
"situacao": "regular",
"resumo": "A empresa está regular perante o FGTS",
"certidao_emitida": true,
"abrangencia": "estabelecimento",
"numero": "0000000000000000000",
"valida_de": "2026-10-13",
"valida_ate": "2026-11-11",
"dias_de_validade": 30
},
"pdf_url": "https://…/certidao.pdf"
}Como ler
resultado.situacao- No CRF, a Caixa fala em regular e irregular; o campo usa a mesma palavra. Empresa sem empregado volta como nao_cadastrado, com a mensagem da Caixa, e não como irregular.
resultado.abrangencia- Sempre estabelecimento: o certificado da matriz não responde pela filial.
resultado.valida_de e valida_ate- O período impresso no certificado. Com 30 dias de prazo, é a data que manda na sua agenda.
status- concluida quando o órgão respondeu; em_andamento enquanto a fonte não libera (o resultado chega por webhook); fonte_indisponivel quando o portal está fora do ar, que nunca vira "nada consta".
pdf_url- O PDF emitido pelo órgão, com o código de validação dele. É o arquivo que vai para a pasta de habilitação.
Quatro coisas do CRF que quebram a integração ingênua
- Tratar o CNPJ básico como se fosse um só. A federal e a CNDT respondem pelo grupo; o CRF não. Rede com doze estabelecimentos com empregados tem doze certificados, e a pendência de um deles não aparece no da matriz.
- Ler "não cadastrado" como irregular. Empresa nova ou sem empregado recebe da Caixa o aviso de que o empregador não está cadastrado. É uma mensagem de cadastro, e a API a devolve como tal.
- Recusar quem parcelou. Parcelamento em dia mantém o empregador regular, e o certificado sai normalmente. O que derruba a regularidade é a parcela atrasada.
- Agendar como se fosse 180 dias. Trinta dias exigem reemissão mensal. A pasta de habilitação quase sempre vence por este documento, nunca pela federal.
As regras de cada esfera para matriz e filial estão em CND de filial.
Onde o CRF entra no fluxo
Licitação
Regularidade com o FGTS
A Lei nº 14.133/2021 pede regularidade com a seguridade social e com o FGTS na habilitação (art. 68, IV). Com 30 dias de validade, o certificado é emitido perto da sessão, não na montagem da pasta.
Terceirização
Prestador conferido todo mês
Quem contrata mão de obra confere o CRF do estabelecimento que presta o serviço antes de cada medição, e o histórico das emissões fica guardado.
Escritório contábil
Carteira em agenda mensal
Cada cliente e cada filial com empregados entram na rotina, e o aviso só chega quando um certificado não sai. Ver renovação de CND.
O CRF de cada estabelecimento, sem deixar vencer
Dúvidas frequentes
Fale direto com quem constrói o robô. A gente olha a fonte, o volume e o destino antes de qualquer proposta.
Falar com quem faz a coletaFontes e método
Os prazos e as regras citados vêm dos textos legais abaixo e da operação diária de emissão da Hath Data.
A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.