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

# Dirección del Trabajo

> A doutrina trabalhista da Dirección del Trabajo do Chile: busque em cerca de 13.000 dictámenes, ordinarios, circulares, órdenes de servicio e resoluciones por tipo, número, data ou texto, e leia qualquer um completo com seu arquivo original.

A Dirección del Trabajo (DT) é a autoridade trabalhista do Chile: fiscaliza os locais de trabalho e interpreta a legislação trabalhista para empregadores, trabalhadores e sindicatos. Essa interpretação é publicada como doutrina administrativa, e é o que há aqui:

* **Dictámenes**: cerca de 5.000 desde 1990, os pronunciamentos que fixam a doutrina da DT, numerados `<número>/<correlativo>` (p. ex. `388/32`).
* **Ordinarios**: cerca de 7.900, as respostas da DT a consultas concretas, que aplicam sua doutrina.
* **Circulares, órdenes de servicio e resoluciones**: as instruções e resoluções da DT que incidem em como a lei trabalhista é aplicada.

Cada um chega com seu número e data, suas matérias e seu resumo, as partes rotuladas de seu texto (atuação, antecedentes, fontes, concordâncias, quem assina e a quem se dirige), o índice próprio da DT de pronunciamentos concordantes e de normas citadas, o texto completo e cada arquivo que a DT publicou com ele, guardado byte a byte. Busque primeiro e depois leia um 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 pronunciamentos

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

Uma única busca sobre todos os dictámenes, ordinarios, circulares, órdenes de servicio e resoluciones que a Dirección del Trabajo publica, filtrada por tipo, número, ano ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais em espanhol, buscadas no título, nas matérias, no resumo, nos descritores e no texto completo, p. ex. `registro de asistencia`. Todas as palavras devem aparecer. |
| `type` | enum | Tipo opcional: `dictamen` (fixa doutrina), `ordinario` (responde a uma consulta), `circular`, `orden_de_servicio` ou `resolucion`. |
| `number` | string | Número opcional: `388/32` para um dictamen com seu correlativo, ou `388` para todos os pronunciamentos com esse número. Pontos, espaços e zeros à esquerda não importam. |
| `year` | integer | Ano de emissão opcional. 0 busca em todos os anos. Por padrão `0`. |
| `from_date` | string | Opcional: só os emitidos nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só os emitidos nesta data ou antes, `yyyy-mm-dd`. |
| `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/dt-cl/pronouncements-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "registro de asistencia", "type": "dictamen" }'
```

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 mais recente ao mais antigo. Cada resultado traz `id` (o id permanente da DT, p. ex. `129643`), `type` (`dictamen`, `ordinario`, `circular`, `orden_de_servicio` ou `resolucion`), `title` (p. ex. ORD.N°388/32), `number` (normalizado, p. ex. `388/32`) e `correlative` (a parte de um dictamen depois de `/`), `issued_at` e `year`, `subjects` (as matérias), `summary` (o resumo), `keywords` (os descritores da DT), as partes rotuladas do texto: `action` (ACTUACIÓN), `background` (ANTECEDENTES), `legal_sources` (FUENTES), `concordances` (CONCORDANCIA), `sender` (DE) e `recipient` (A), e cada parte em ordem em `sections` (cada uma com `label` e `text`), `concordance_tags` e `legal_references` (o índice próprio da DT de pronunciamentos concordantes e de normas citadas), `related` (os pronunciamentos que a DT lista como concordantes, cada um com `id`, `type`, `title` e `issued_at`), `documents` (cada arquivo que a DT publica com ele, cada um com `name`, `label`, `format`, `size_kb`, `document_url`, a cópia idêntica byte a byte da Croma, e `source_document_url`), `document_url` e `source_document_url` (os do primeiro arquivo) e `text_source`. Os campos que a DT não indica vêm como null ou vazios.

> [!NOTE]
>
> Os resultados da busca não incluem o texto completo. `query` busca dentro dele; para ler o texto use o endpoint Dirección del Trabajo Chile Pronouncement.

## Um pronunciamento, completo

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

| Campo | Tipo | Notas |
| - | - | - |
| `pronouncement_id` | string | **Obrigatório.** O `id` do pronunciamento retornado pela busca, p. ex. `129643`. |
| `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. A maioria dos pronunciamentos cabe em uma resposta. Por padrão `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/dt-cl/pronouncement/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "pronouncement_id": "129643" }'
```

Retorna `as_of`, `found`, `pronouncement_id` e `pronouncement`, 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 da DT, p. ex. `129643`), `type` (`dictamen`, `ordinario`, `circular`, `orden_de_servicio` ou `resolucion`), `title` (p. ex. ORD.N°388/32), `number` (normalizado, p. ex. `388/32`) e `correlative` (a parte de um dictamen depois de `/`), `issued_at` e `year`, `subjects` (as matérias), `summary` (o resumo), `keywords` (os descritores da DT), as partes rotuladas do texto: `action` (ACTUACIÓN), `background` (ANTECEDENTES), `legal_sources` (FUENTES), `concordances` (CONCORDANCIA), `sender` (DE) e `recipient` (A), e cada parte em ordem em `sections` (cada uma com `label` e `text`), `concordance_tags` e `legal_references` (o índice próprio da DT de pronunciamentos concordantes e de normas citadas), `related` (os pronunciamentos que a DT lista como concordantes, cada um com `id`, `type`, `title` e `issued_at`), `documents` (cada arquivo que a DT publica com ele, cada um com `name`, `label`, `format`, `size_kb`, `document_url`, a cópia idêntica byte a byte da Croma, e `source_document_url`), `document_url` e `source_document_url` (os do primeiro arquivo) e `text_source`. Os campos que a DT não indica vêm como null ou vazios.

> [!NOTE]
>
> Os textos 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 Dirección del Trabajo 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.