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

> Las sentencias de los tribunales tributarios y aduaneros de Chile: busca en unas 15.000 sentencias definitivas de primera instancia desde 2010 por RUC, RIT, tribunal, servicio o fecha, y lee cualquiera completa con su PDF firmado original.

Los Tribunales Tributarios y Aduaneros (TTA) de Chile son los 18 tribunales de primera instancia que conocen los reclamos de los contribuyentes contra el Servicio de Impuestos Internos (liquidaciones, giros, avalúos, multas) y contra el Servicio Nacional de Aduanas. Cada sentencia llega aquí como una sentencia definitiva de primera instancia con el RUC y el RIT de la causa, la carátula, el tribunal y su región, el servicio cuyo acto se reclama, el procedimiento y la materia, las fechas de la sentencia y de presentación, el extracto del tribunal, si el TTA la publica en su colección de jurisprudencia, el PDF firmado guardado byte a byte y su texto.

La colección es completa: cada sentencia que publica el TTA desde 2010, unas 15.000, incluidas las que no lista como jurisprudencia. Busca por RUC, RIT, tribunal, servicio, fecha o con texto libre que llega hasta la propia sentencia. Busca primero y luego lee una sentencia completa.

> [!NOTE]
>
> La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](https://docs.usecroma.com/es/datasets.md).

## Buscar sentencias

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

Una sola búsqueda sobre todas las sentencias que los 18 tribunales del TTA han publicado desde 2010, filtrada por RUC, RIT, tribunal, servicio o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en la carátula, el RUC y el RIT, el tribunal, el procedimiento, la materia, el extracto y el texto de la sentencia, p. ej. `crédito fiscal`. Todas las palabras deben aparecer. |
| `case_ruc` | string | RUC opcional de la causa, p. ej. `13-9-0000546-0`. |
| `registration_number` | string | RIT opcional de la causa, p. ej. `GR-14-00071-2013`. No importan las mayúsculas. |
| `court_id` | integer | Número opcional del tribunal, como en el `court_id` de un resultado, p. ej. `14` para Valparaíso o de `15` a `18` para los cuatro tribunales de la Región Metropolitana. `0` busca en todos. Por defecto `0`. |
| `agency` | enum | Servicio opcional cuyo acto se reclama: `sii` (tributario) o `sna` (aduanero). |
| `jurisprudence_only` | boolean | Con `true`, solo las sentencias que el TTA publica en su colección de jurisprudencia. Por defecto `false`. |
| `from_date` | string | Opcional: solo sentencias de esta fecha o posteriores, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo sentencias de esta fecha o anteriores, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la sentencia más reciente a la más antigua. Cada resultado es una sentencia: `id`, `case_file_id`, `case_ruc` (el rol único de causa) y `registration_number` (el RIT, p. ej. `GR-14-00071-2013`), `caption` (la carátula: el reclamante contra el servicio tributario o aduanero, en minúsculas, como la lista el TTA), `court`, `court_id` y `region`, `agency` (`SII` o `SNA`) y `agency_name`, `procedure` y `procedure_id`, `subject` (la materia) y `subject_id`, `sentence_date`, `year`, `filing_date` (fecha de presentación), `summary` (el extracto del tribunal, cuando lo da), `jurisprudence` (si el TTA la publica en su colección de jurisprudencia), `pages`, `bytes`, `text_status`, `text_truncated` (true solo en el raro texto de más de 600.000 caracteres, que se corta ahí; el PDF siempre está completo), `document_url` (la copia idéntica byte a byte de Croma del PDF firmado) y `source_document_url` (siempre null: el TTA no publica un enlace directo al archivo). Los campos que el tribunal no indica vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto de la sentencia. `query` sí busca dentro de él; para leer el texto usa el endpoint TTA Ruling.

> [!NOTE]
>
> Aquí está cada sentencia definitiva de primera instancia que publica el TTA, unas 15.000 desde 2010, incluido el cuarto que no lista como jurisprudencia. Envía `jurisprudence_only: true` para quedarte solo con la colección de jurisprudencia.

## Una sentencia, completa

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

| Campo | Tipo | Notas |
| - | - | - |
| `id` | string | **Obligatorio.** El `id` de la sentencia que devuelve la búsqueda, 32 caracteres hexadecimales, p. ej. `ff8080813ecc6f1d013ed1f2633c13b7`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las sentencias caben en una sola respuesta. Por defecto `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" }'
```

Devuelve `as_of`, `found`, `id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content` (una ventana sobre el texto de la sentencia, con `text`, `offset`, `total_length`, `has_more` y `next_offset`). Cada resultado es una sentencia: `id`, `case_file_id`, `case_ruc` (el rol único de causa) y `registration_number` (el RIT, p. ej. `GR-14-00071-2013`), `caption` (la carátula: el reclamante contra el servicio tributario o aduanero, en minúsculas, como la lista el TTA), `court`, `court_id` y `region`, `agency` (`SII` o `SNA`) y `agency_name`, `procedure` y `procedure_id`, `subject` (la materia) y `subject_id`, `sentence_date`, `year`, `filing_date` (fecha de presentación), `summary` (el extracto del tribunal, cuando lo da), `jurisprudence` (si el TTA la publica en su colección de jurisprudencia), `pages`, `bytes`, `text_status`, `text_truncated` (true solo en el raro texto de más de 600.000 caracteres, que se corta ahí; el PDF siempre está completo), `document_url` (la copia idéntica byte a byte de Croma del PDF firmado) y `source_document_url` (siempre null: el TTA no publica un enlace directo al archivo). Los campos que el tribunal no indica vienen en null.

> [!NOTE]
>
> Las sentencias largas se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que el TTA no ha publicado devuelve `found: false` con HTTP 200, no un error.

> **[Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)**
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


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