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

# Superintendencia de Seguridad Social

> Os dictámenes da SUSESO do Chile: busque em cerca de 16.100 pareceres de seguridade social desde 1971, e leia qualquer um completo com seus temas, dictámenes relacionados e arquivos.

A Superintendencia de Seguridad Social (SUSESO) fiscaliza a seguridade social do Chile: as licenças médicas e as COMPIN, os acidentes de trabalho e as doenças ocupacionais da Ley 16.744 e as mutualidades, o salário-família, as caixas de compensação (CCAF) e seu crédito social, os serviços de bem-estar, entre outros. Seus dictámenes fixam como essas normas se aplicam, muitos em resposta a um trabalhador, um empregador ou uma instituição. Há cerca de 16.100 publicados, de 1971 até hoje. Cada um chega aqui com seu número e data, a quem é dirigido, o resumo da SUSESO, seus temas e descritores, as fontes legais em que se baseia, as unidades que o emitiram, os dictámenes, circulares e normas que a SUSESO relaciona a ele, os arquivos que anexa, seu texto completo e uma cópia exata de sua página na SUSESO.

Busque por número, ano, data, tema ou um dictamen relacionado, ou com texto livre que alcança o resumo e o corpo de cada dictamen. Busque primeiro e depois leia um dictamen completo.

> [!NOTE]
>
> A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](https://docs.usecroma.com/pt/datasets.md).

## Buscar dictámenes

`POST /cl/suseso/dictamenes-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

Uma única busca sobre todos os dictámenes que a SUSESO publica desde 1971, filtrada por número, ano, data, tema ou um dictamen relacionado.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no número, no destinatário, no resumo, nos temas, nos descritores, nas fontes legais e no texto completo, p. ex. `licencia médica rechazo` ou `crédito social`. Todas as palavras devem aparecer. |
| `number` | string | Número do dictamen opcional, como a SUSESO o publica, com seu ano, p. ex. `150250-2026` ou `O-01-S-04558-2026`. |
| `year` | integer | Ano do dictamen opcional. 0 busca em todos os anos. Por padrão `0`. |
| `from_date` | string | Opcional: só dictámenes emitidos nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só dictámenes emitidos nesta data ou antes, `yyyy-mm-dd`. |
| `topic` | string | Tema opcional, exatamente como aparece em `topics` de um resultado, p. ex. `Licencias médicas` ou `Seguro laboral (Ley 16.744)`. |
| `related_to` | string | `id` de dictamen opcional, p. ex. `758965`: só os dictámenes que a SUSESO lista como relacionados a ele. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/suseso/dictamenes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "licencia médica", "topic": "Licencias médicas" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, do dictamen mais recente ao mais antigo. Cada resultado traz `id` (o id permanente do dictamen na SUSESO, p. ex. `758965`), `number` (como a SUSESO o publica, p. ex. `O-01-S-00582-2025` ou `4268-1988`), `title`, `year`, `issued_date`, `recipient` (a quem é dirigido), `summary` (o resumo da SUSESO, que a maioria dos dictámenes anteriores a 2019 não tem), `topics`, `descriptors`, `legal_sources`, `departments` (as unidades da SUSESO que o emitiram), `action`, `criterion` e `validity` (quando a SUSESO os indica), `related_circulars_text` e `related_oficios_text` (as circulares e ofícios com que concorda, como escritos), `other_fields` (qualquer outro campo rotulado), `related_dictamenes` e `related_circulars` (cada um com seu `id`, `title` e `issued_date`), `related_legislation`, `attachments` (cada arquivo com seu `title`, `name`, `content_type`, `bytes`, `document_url` e `source_document_url`), `official_url` (a página do dictamen na SUSESO), `document_url` (a cópia exata dessa página que a Croma guarda), `source_document_url` e `document_versions`. Os campos que a SUSESO não indica vêm como null.

> [!NOTE]
>
> Os resultados da busca não incluem o texto. `query` busca dentro dele, então uma frase do corpo encontra o dictamen; para ler o texto use o endpoint SUSESO Dictamen.

> [!NOTE]
>
> A SUSESO acrescenta dictámenes e circulares relacionados a um dictamen à medida que surgem novos. A Croma lê os dictámenes novos todos os dias e volta a ler todos uma vez por mês.

## Um dictamen, completo

`POST /cl/suseso/dictamen/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

| Campo | Tipo | Notas |
| - | - | - |
| `dictamen_id` | string | **Obrigatório.** O `id` do dictamen retornado pela busca, p. ex. `758965`, sua `official_url`, ou seu número, p. ex. `O-01-S-00582-2025`. |
| `offset` | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. |
| `limit` | integer | Quantos caracteres do texto retornar. Quase todos os dictámenes cabem em uma resposta. Por padrão `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/suseso/dictamen/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "dictamen_id": "758965" }'
```

Retorna `as_of`, `found`, `dictamen_id` e `dictamen`, que traz tudo o que a busca retorna mais `content`, uma janela sobre o texto completo com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o id permanente do dictamen na SUSESO, p. ex. `758965`), `number` (como a SUSESO o publica, p. ex. `O-01-S-00582-2025` ou `4268-1988`), `title`, `year`, `issued_date`, `recipient` (a quem é dirigido), `summary` (o resumo da SUSESO, que a maioria dos dictámenes anteriores a 2019 não tem), `topics`, `descriptors`, `legal_sources`, `departments` (as unidades da SUSESO que o emitiram), `action`, `criterion` e `validity` (quando a SUSESO os indica), `related_circulars_text` e `related_oficios_text` (as circulares e ofícios com que concorda, como escritos), `other_fields` (qualquer outro campo rotulado), `related_dictamenes` e `related_circulars` (cada um com seu `id`, `title` e `issued_date`), `related_legislation`, `attachments` (cada arquivo com seu `title`, `name`, `content_type`, `bytes`, `document_url` e `source_document_url`), `official_url` (a página do dictamen na SUSESO), `document_url` (a cópia exata dessa página que a Croma guarda), `source_document_url` e `document_versions`. Os campos que a SUSESO não indica vêm como null.

> [!NOTE]
>
> Os dictámenes longos são lidos por intervalos: envie `offset` e `limit`, depois passe o `next_offset` da resposta como `offset` até que `has_more` seja falso.

> [!NOTE]
>
> Um id que a SUSESO não publicou retorna `found: false` com HTTP 200, não um erro.

> **[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.