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

# Contraloría General de la República

> Os dictámenes da Contraloría do Chile: busque em cerca de 158.000 pareceres de direito administrativo desde 1949, e leia qualquer um completo com sua situação e os dictámenes sobre os quais atua.

A Contraloría General de la República do Chile emite dictámenes, pareceres obrigatórios sobre como os órgãos públicos devem aplicar o direito administrativo: remuneração, férias e aposentadorias dos servidores, compras públicas, atribuições municipais, obras públicas. Sua jurisprudência está publicada desde 1949, cerca de 158.000 dictámenes. Cada um chega aqui com seu número, ano e data, a matéria que decide, os descritores da Contraloría e as fontes legais em que se baseia, se gera ou aplica jurisprudência, suas situações (reconsiderado, aplicado, esclarecido e as demais, que mudam quando um dictamen posterior atua sobre ele), os dictámenes anteriores sobre os quais atua, a quem é dirigido, a unidade de onde vem, seu texto completo e links para sua página e seu PDF na Contraloría.

Busque por número, ano, data, critério, situação ou o dictamen sobre o qual um posterior atua, ou com texto livre que alcança a matéria 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/contraloria-cl/dictamenes-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

Uma única busca sobre todos os dictámenes que a Contraloría publica desde 1949, filtrada por número, ano, data, critério, situação ou o dictamen sobre o qual um posterior atua.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no número, na matéria, nos descritores, nas fontes legais e no texto completo, p. ex. `pensión de retiro` ou `feriado legal`. Todas as palavras devem aparecer. |
| `number` | string | Número do dictamen opcional, com seu prefixo de letras quando tiver, p. ex. `428`, `E152884`. Zeros à esquerda são ignorados. Adicione `year` para identificar um só dictamen. |
| `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`. |
| `criterion` | enum | Opcional: `generates` (gera jurisprudência) ou `applies` (aplica jurisprudência). |
| `status` | enum | Situação opcional: `new`, `applied`, `reconsidered` (reconsiderado), `partially_reconsidered`, `clarified` (esclarecido), `altered`, `confirmed`, `complemented` ou `reactivated`. |
| `references` | string | `id` de dictamen opcional, p. ex. `022127N09`: só os dictámenes que atuam sobre 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/contraloria-cl/dictamenes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "pensión de retiro", "criterion": "generates" }'
```

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, p. ex. `E152884N21`), `number` (como a Contraloría o cita, p. ex. `E152884`) e `year`, `issued_date`, `subject` (a matéria), `descriptors`, `legal_sources`, `criterion` (`generates` se gera jurisprudência ou `applies` se a aplica), `statuses` e `status_flags` (`new`, `applied`, `reconsidered`, `partially_reconsidered`, `clarified`, `altered`, `confirmed`, `complemented`, `reactivated`), `related` (os dictámenes anteriores sobre os quais atua, cada um com sua `action`, `dictamen_id`, `number` e `year`) e `action_text` (a frase da própria Contraloría sobre eles), `recipients`, `attorneys`, `origin` e `origins` (a unidade da Contraloría), `character`, `protection_appeal`, `topic`, `relevant`, `bulletin`, `official_url` (a página do dictamen na Contraloría), `source_document_url` (seu PDF na Contraloría) e `document_url` (sempre null: a Contraloría publica o dictamen como texto, e o texto está aqui). Os campos que a Contraloría 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 Contraloría Chile Dictamen.

> [!NOTE]
>
> As situações mudam quando um dictamen posterior aplica, reconsidera ou esclarece um anterior. A Croma volta a ler os dictámenes sobre os quais cada dictamen novo atua no dia em que aparece, e a coleção inteira uma vez por mês.

## Um dictamen, completo

`POST /cl/contraloria-cl/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. `E152884N21`, sua `official_url`, ou seu número e ano, p. ex. `E152884/2021`. |
| `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/contraloria-cl/dictamen/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "dictamen_id": "E152884N21" }'
```

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`) e `referenced_by` (os dictámenes posteriores que atuam sobre este, cada um com seu `id`, `number`, `year`, `issued_date` e `actions`, do mais recente ao mais antigo). Cada resultado traz `id` (o id permanente do dictamen, p. ex. `E152884N21`), `number` (como a Contraloría o cita, p. ex. `E152884`) e `year`, `issued_date`, `subject` (a matéria), `descriptors`, `legal_sources`, `criterion` (`generates` se gera jurisprudência ou `applies` se a aplica), `statuses` e `status_flags` (`new`, `applied`, `reconsidered`, `partially_reconsidered`, `clarified`, `altered`, `confirmed`, `complemented`, `reactivated`), `related` (os dictámenes anteriores sobre os quais atua, cada um com sua `action`, `dictamen_id`, `number` e `year`) e `action_text` (a frase da própria Contraloría sobre eles), `recipients`, `attorneys`, `origin` e `origins` (a unidade da Contraloría), `character`, `protection_appeal`, `topic`, `relevant`, `bulletin`, `official_url` (a página do dictamen na Contraloría), `source_document_url` (seu PDF na Contraloría) e `document_url` (sempre null: a Contraloría publica o dictamen como texto, e o texto está aqui). Os campos que a Contraloría 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 Contraloría 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.