> ## 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.

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

> O histórico de afiliação de uma pessoa às Cajas de Compensación Familiar da Colômbia nos últimos quatro anos, da Superintendencia del Subsidio Familiar: mês, caixa e empregador, todas as caixas em uma consulta, mais o PDF.

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](https://docs.usecroma.com/pt/live-lookups.md)

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`. |

```bash theme={"dark"}
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. |

> [!NOTE]
>
> 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.

> [!NOTE]
>
> Guardar o PDF do relatório leva um momento, por isso esta consulta é um
> [trabalho assíncrono](https://docs.usecroma.com/pt/async-jobs.md). 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.

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.