Supersubsidio: afiliações a caixas de compensação

Todo empregador formal na Colômbia afilia seus trabalhadores a uma Caja de Compensación Familiar (CCF) e paga todo mês uma contribuição sobre a folha. A Superintendencia del Subsidio Familiar, que supervisiona as caixas, mantém o histórico de afiliação de todas elas. Este endpoint retorna o histórico de uma pessoa nos últimos quatro anos, mês a mês, com a caixa e o empregador que a afiliou: uma visão do seu emprego formal, que credores, empregadores e equipes de verificação de antecedentes usam para confirmar onde alguém trabalha e já trabalhou. Precisa do número do documento, do primeiro sobrenome e da data de nascimento da pessoa, e guarda uma cópia do PDF do relatório. POST /co/ssf/affiliation-history/v1 Live Uma pessoa, por três dados que devem todos corresponder ao registro. Não é preciso indicar a caixa: todas as caixas chegam em uma só consulta.

Campo	Tipo	Notas
`document_number`	string	Obrigatório. A cédula de ciudadanía da pessoa, só dígitos.
`first_surname`	string	Obrigatório. O primeiro sobrenome exatamente como no registro. Não diferencia maiúsculas de minúsculas.
`birth_date`	string	Obrigatório. Data de nascimento, `aaaa-mm-dd`.

curl https://api.croma.run/co/ssf/affiliation-history/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "document_number": "1234567890",
        "first_surname": "PEREZ",
        "birth_date": "1990-01-01"
      }'

A resposta repete o número do documento e traz o histórico da pessoa:

Campo	Notas
`found`	`false` quando nenhuma pessoa corresponde ao mesmo tempo ao número do documento, ao primeiro sobrenome e à data de nascimento. Um sobrenome ou uma data que não correspondem ao registro respondem igual a um documento desconhecido.
`full_name`, `document_type`	A pessoa, como impressa no relatório.
`affiliate_type`	O tipo de afiliado (dependente, por exemplo), como impresso. O relatório pode cortar este texto.
`affiliations`	Uma linha por mês, caixa e empregador, da mais antiga à mais recente, nos últimos quatro anos registrados: `period` (`aaaa-mm`), `fund` (a Caja de Compensación Familiar) e `employer` (`null` quando o relatório não nomeia nenhum). Um mês com dois empregadores tem duas linhas, e o histórico cobre todas as caixas às quais a pessoa esteve afiliada.
`document_url`	Nossa cópia do PDF do histórico de afiliação, idêntica byte a byte à emitida pela fonte.
`source_document_url`	Sempre `null`: a fonte emite o relatório na consulta e não publica um link para ele.

O relatório orienta o pedido de um certificado; não é uma certificação oficial. Para um certificado de afiliação, ou para histórico com mais de quatro anos, procure a Caja de Compensación Familiar ou a Superintendencia del Subsidio Familiar.

Guardar o PDF do relatório leva um momento, por isso esta consulta é um trabalho assíncrono. Por padrão a solicitação aguarda e retorna { data }, ou você pode fazer polling ou enviar um callback_url. A maioria das consultas termina em alguns segundos.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Feedback

Países

Supersubsidio: afiliações a caixas de compensação

Referência completa