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

# Tribunales Tributarios y Aduaneros

> As sentenças dos tribunais tributários e aduaneiros do Chile: busque em cerca de 15.000 sentenças definitivas de primeira instância desde 2010 por RUC, RIT, tribunal, órgão ou data, e leia qualquer uma completa com seu PDF assinado original.

Os Tribunales Tributarios y Aduaneros (TTA) do Chile são os 18 tribunais de primeira instância que julgam as reclamações dos contribuintes contra o Servicio de Impuestos Internos (lançamentos, cobranças, avaliações de imóveis, multas) e contra o Servicio Nacional de Aduanas. Cada sentença chega aqui como uma sentença definitiva de primeira instância com o RUC e o RIT da causa, a carátula, o tribunal e sua região, o órgão cujo ato é reclamado, o procedimento e a matéria, as datas da sentença e de apresentação, o extrato do tribunal, se o TTA a publica em sua coleção de jurisprudência, o PDF assinado guardado byte a byte e seu texto.

A coleção é completa: cada sentença que o TTA publica desde 2010, cerca de 15.000, inclusive as que ele não lista como jurisprudência. Busque por RUC, RIT, tribunal, órgão, data ou com texto livre que alcança a própria sentença. Busque primeiro e depois leia uma sentença completa.

> [!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 sentenças

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

Uma única busca sobre todas as sentenças que os 18 tribunais do TTA publicaram desde 2010, filtrada por RUC, RIT, tribunal, órgão ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas na carátula, no RUC e no RIT, no tribunal, no procedimento, na matéria, no extrato e no texto da sentença, p. ex. `crédito fiscal`. Todas as palavras devem aparecer. |
| `case_ruc` | string | RUC opcional da causa, p. ex. `13-9-0000546-0`. |
| `registration_number` | string | RIT opcional da causa, p. ex. `GR-14-00071-2013`. Maiúsculas não importam. |
| `court_id` | integer | Número opcional do tribunal, como no `court_id` de um resultado, p. ex. `14` para Valparaíso ou de `15` a `18` para os quatro tribunais da Región Metropolitana. `0` busca em todos. Por padrão `0`. |
| `agency` | enum | Órgão opcional cujo ato é reclamado: `sii` (tributário) ou `sna` (aduaneiro). |
| `jurisprudence_only` | boolean | Com `true`, só as sentenças que o TTA publica em sua coleção de jurisprudência. Por padrão `false`. |
| `from_date` | string | Opcional: só sentenças desta data ou posteriores, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só sentenças desta data ou anteriores, `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/tta/rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "crédito fiscal", "agency": "sii" }'
```

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[]`, da sentença mais recente à mais antiga. Cada resultado é uma sentença: `id`, `case_file_id`, `case_ruc` (o rol único de causa) e `registration_number` (o RIT, p. ex. `GR-14-00071-2013`), `caption` (a carátula: o reclamante contra o órgão tributário ou aduaneiro, em minúsculas, como o TTA a lista), `court`, `court_id` e `region`, `agency` (`SII` ou `SNA`) e `agency_name`, `procedure` e `procedure_id`, `subject` (a matéria) e `subject_id`, `sentence_date`, `year`, `filing_date` (data de apresentação), `summary` (o extrato do tribunal, quando há), `jurisprudence` (se o TTA a publica em sua coleção de jurisprudência), `pages`, `bytes`, `text_status`, `text_truncated` (true só no raro texto de mais de 600.000 caracteres, cortado ali; o PDF está sempre completo), `document_url` (a cópia idêntica byte a byte da Croma do PDF assinado) e `source_document_url` (sempre null: o TTA não publica um link direto ao arquivo). Os campos que o tribunal não indica vêm como null.

> [!NOTE]
>
> Os resultados da busca não incluem o texto da sentença. `query` busca dentro dele; para ler o texto use o endpoint TTA Ruling.

> [!NOTE]
>
> Aqui está cada sentença definitiva de primeira instância que o TTA publica, cerca de 15.000 desde 2010, inclusive o quarto que ele não lista como jurisprudência. Envie `jurisprudence_only: true` para ficar só com a coleção de jurisprudência.

## Uma sentença, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `id` | string | **Obrigatório.** O `id` da sentença retornado pela busca, 32 caracteres hexadecimais, p. ex. `ff8080813ecc6f1d013ed1f2633c13b7`. |
| `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 das sentenças cabe em uma resposta. Por padrão `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/tta/ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "ff8080813ecc6f1d013ed1f2633c13b7" }'
```

Retorna `as_of`, `found`, `id` e `ruling`, que traz tudo o que a busca retorna mais `content` (uma janela sobre o texto da sentença, com `text`, `offset`, `total_length`, `has_more` e `next_offset`). Cada resultado é uma sentença: `id`, `case_file_id`, `case_ruc` (o rol único de causa) e `registration_number` (o RIT, p. ex. `GR-14-00071-2013`), `caption` (a carátula: o reclamante contra o órgão tributário ou aduaneiro, em minúsculas, como o TTA a lista), `court`, `court_id` e `region`, `agency` (`SII` ou `SNA`) e `agency_name`, `procedure` e `procedure_id`, `subject` (a matéria) e `subject_id`, `sentence_date`, `year`, `filing_date` (data de apresentação), `summary` (o extrato do tribunal, quando há), `jurisprudence` (se o TTA a publica em sua coleção de jurisprudência), `pages`, `bytes`, `text_status`, `text_truncated` (true só no raro texto de mais de 600.000 caracteres, cortado ali; o PDF está sempre completo), `document_url` (a cópia idêntica byte a byte da Croma do PDF assinado) e `source_document_url` (sempre null: o TTA não publica um link direto ao arquivo). Os campos que o tribunal não indica vêm como null.

> [!NOTE]
>
> As sentenças longas são lidas 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 o TTA 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.