> ## 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. # SII > Oficios, circulares, resoluciones y jurisprudencia judicial del SII: busca en la jurisprudencia administrativa, las circulares y las resoluciones del Servicio de Impuestos Internos de Chile y en su compilación de fallos tributarios, con el texto completo de cada uno; lee cualquiera completo. El Servicio de Impuestos Internos (SII) es la autoridad tributaria de Chile. Publica cómo interpreta las leyes tributarias en cuatro colecciones, y esta fuente las reúne todas: sus oficios (las respuestas a las consultas de los contribuyentes, la jurisprudencia administrativa) desde 1994, unos 7.500 sobre Renta, IVA y otras normas; sus circulares desde 1975, unas 3.100; sus resoluciones desde 1975, unas 4.200; y su compilación de jurisprudencia judicial tributaria, unos 3.600 fallos de la Corte Suprema, las Cortes de Apelaciones, los Tribunales Tributarios y Aduaneros y el Tribunal Constitucional desde 2008. Cada documento llega con su número, fecha, el resumen del SII, las normas que aplica, su texto completo y una copia de cada archivo que el SII publica con él, idéntica byte a byte. Busca en cada colección por número, año o fecha, o con texto libre que llega hasta el cuerpo de cada documento. Busca primero y luego lee un documento completo. > [!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 oficios `POST /cl/sii/oficios-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) Una sola búsqueda sobre el texto completo de cada oficio, filtrada por impuesto, número, año o fecha. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palabras opcionales que se buscan en el resumen, las normas citadas y el texto completo. | | `subject` | enum | Impuesto opcional: `renta`, `iva` u `otras` (otras normas). `any` busca en los tres. Por defecto `any`. | | `number` | string | Número opcional, p. ej. `41`. Se ignoran puntos y ceros a la izquierda. La numeración se reinicia cada año, así que combínalo con `year`. | | `year` | integer | Año opcional en que el SII archiva el documento. 0 busca en todos los años. Por defecto `0`. | | `from_date` | string | Opcional: solo documentos emitidos en esta fecha o después, `yyyy-mm-dd`. | | `to_date` | string | Opcional: solo documentos emitidos en esta fecha o antes, `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/sii/oficios-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "incobrables", "subject": "renta", "year": 2026 }' ``` 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[]`, del oficio más reciente al más antiguo. Cada resultado incluye `id`, `subject` (`renta`, `iva` u `otras`), `number`, `document_type` (p. ej. `Oficio Ordinario`), `year`, `issued_at` (la fecha del oficio), `published_at` (desde 2019), `legal_references` (las normas que interpreta), `summary`, `text_status` (`ok`, `scanned` o `missing`) y `official_url` (el listado del año en el SII). `document_url` es la copia de Croma del documento principal, idéntica byte a byte a la que publicó el SII, que sigue disponible pase lo que pase con el enlace del SII; `source_document_url` es el mismo documento en el sitio del SII; `documents[]` lista cada archivo que el SII publica con él (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Los resultados de búsqueda no incluyen el texto; `query` sí busca dentro de él, así que una frase del cuerpo encuentra el documento. Para leer el texto usa el endpoint SII Oficio. ## Un oficio, completo `POST /cl/sii/oficio/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `oficio_id` | string | **Obligatorio.** El `id` del oficio que devuelve la búsqueda, p. ej. `3109` o `renta-2015-ja3298`. | | `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 los documentos caben en una sola respuesta. Por defecto `200000`. | ```bash theme={"dark"} curl https://api.croma.run/cl/sii/oficio/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "oficio_id": "3109" }' ``` Devuelve `as_of`, `found`, `oficio_id` y `oficio`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id`, `subject` (`renta`, `iva` u `otras`), `number`, `document_type` (p. ej. `Oficio Ordinario`), `year`, `issued_at` (la fecha del oficio), `published_at` (desde 2019), `legal_references` (las normas que interpreta), `summary`, `text_status` (`ok`, `scanned` o `missing`) y `official_url` (el listado del año en el SII). `document_url` es la copia de Croma del documento principal, idéntica byte a byte a la que publicó el SII, que sigue disponible pase lo que pase con el enlace del SII; `source_document_url` es el mismo documento en el sitio del SII; `documents[]` lista cada archivo que el SII publica con él (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Un id que la copia de Croma no tiene devuelve `found: false` con HTTP 200, no un error. ## Buscar circulares `POST /cl/sii/circulars-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) Una sola búsqueda sobre el texto completo de cada circular, filtrada por número, año o fecha. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palabras opcionales que se buscan en el resumen, las normas citadas y el texto completo. | | `number` | string | Número opcional, p. ej. `41`. Se ignoran puntos y ceros a la izquierda. La numeración se reinicia cada año, así que combínalo con `year`. | | `year` | integer | Año opcional en que el SII archiva el documento. 0 busca en todos los años. Por defecto `0`. | | `from_date` | string | Opcional: solo documentos emitidos en esta fecha o después, `yyyy-mm-dd`. | | `to_date` | string | Opcional: solo documentos emitidos en esta fecha o antes, `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/sii/circulars-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "unidad de fomento", "year": 2026 }' ``` 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[]`, del más reciente al más antiguo. Cada resultado incluye `id` (año y número, p. ej. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (la "Fuente" que indica el SII), `status` (la nota que el SII imprime junto a ella, p. ej. `modificada`), `text_status` y `official_url` (el listado del año en el SII). `document_url` es la copia de Croma del documento principal, idéntica byte a byte a la que publicó el SII, que sigue disponible pase lo que pase con el enlace del SII; `source_document_url` es el mismo documento en el sitio del SII; `documents[]` lista cada archivo que el SII publica con él (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Los resultados de búsqueda no incluyen el texto; `query` sí busca dentro de él, así que una frase del cuerpo encuentra el documento. Para leer el texto usa el endpoint SII Circular. ## Una circular, completa `POST /cl/sii/circular/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `circular_id` | string | **Obligatorio.** El año y el número de la circular, p. ej. `2026-41`. | | `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 los documentos caben en una sola respuesta. Por defecto `200000`. | ```bash theme={"dark"} curl https://api.croma.run/cl/sii/circular/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "circular_id": "2026-41" }' ``` Devuelve `as_of`, `found`, `circular_id` y `circular`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (año y número, p. ej. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (la "Fuente" que indica el SII), `status` (la nota que el SII imprime junto a ella, p. ej. `modificada`), `text_status` y `official_url` (el listado del año en el SII). `document_url` es la copia de Croma del documento principal, idéntica byte a byte a la que publicó el SII, que sigue disponible pase lo que pase con el enlace del SII; `source_document_url` es el mismo documento en el sitio del SII; `documents[]` lista cada archivo que el SII publica con él (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Un id que la copia de Croma no tiene devuelve `found: false` con HTTP 200, no un error. ## Buscar resoluciones `POST /cl/sii/resolutions-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) Una sola búsqueda sobre el texto completo de cada resolución, filtrada por número, año o fecha. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palabras opcionales que se buscan en el resumen, las normas citadas y el texto completo. | | `number` | string | Número opcional, p. ej. `41`. Se ignoran puntos y ceros a la izquierda. La numeración se reinicia cada año, así que combínalo con `year`. | | `year` | integer | Año opcional en que el SII archiva el documento. 0 busca en todos los años. Por defecto `0`. | | `from_date` | string | Opcional: solo documentos emitidos en esta fecha o después, `yyyy-mm-dd`. | | `to_date` | string | Opcional: solo documentos emitidos en esta fecha o antes, `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/sii/resolutions-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "factura electrónica", "year": 2026 }' ``` 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[]`, del más reciente al más antiguo. Cada resultado incluye `id` (año y número, p. ej. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (la "Fuente" que indica el SII), `status` (la nota que el SII imprime junto a ella, p. ej. `modificada`), `text_status` y `official_url` (el listado del año en el SII). `document_url` es la copia de Croma del documento principal, idéntica byte a byte a la que publicó el SII, que sigue disponible pase lo que pase con el enlace del SII; `source_document_url` es el mismo documento en el sitio del SII; `documents[]` lista cada archivo que el SII publica con él (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Los resultados de búsqueda no incluyen el texto; `query` sí busca dentro de él, así que una frase del cuerpo encuentra el documento. Para leer el texto usa el endpoint SII Resolution. ## Una resolución, completa `POST /cl/sii/resolution/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `resolution_id` | string | **Obligatorio.** El año y el número de la resolución, p. ej. `2026-148`. | | `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 los documentos caben en una sola respuesta. Por defecto `200000`. | ```bash theme={"dark"} curl https://api.croma.run/cl/sii/resolution/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "resolution_id": "2026-148" }' ``` Devuelve `as_of`, `found`, `resolution_id` y `resolution`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (año y número, p. ej. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (la "Fuente" que indica el SII), `status` (la nota que el SII imprime junto a ella, p. ej. `modificada`), `text_status` y `official_url` (el listado del año en el SII). `document_url` es la copia de Croma del documento principal, idéntica byte a byte a la que publicó el SII, que sigue disponible pase lo que pase con el enlace del SII; `source_document_url` es el mismo documento en el sitio del SII; `documents[]` lista cada archivo que el SII publica con él (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Un id que la copia de Croma no tiene devuelve `found: false` con HTTP 200, no un error. ## Buscar fallos `POST /cl/sii/rulings-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) Una sola búsqueda sobre la compilación de jurisprudencia judicial del SII, filtrada por tribunal, rol, año o fecha. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palabras opcionales que se buscan en el rol, las partes, el sumario y el extracto del SII y el texto del fallo. | | `court` | string | Tribunal opcional, p. ej. `Corte Suprema`, `Corte de Apelaciones de Santiago`, `Primer Tribunal Tributario y Aduanero`, comparado desde el inicio. No importan mayúsculas ni tildes. | | `registration_number` | string | Rol o RIT opcional, p. ej. `5501-12`. Se ignoran espacios y puntuación. | | `year` | integer | Año opcional del fallo. 0 busca en todos los años. Por defecto `0`. | | `from_date` | string | Opcional: solo fallos de esta fecha o posteriores, `yyyy-mm-dd`. | | `to_date` | string | Opcional: solo fallos 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/sii/rulings-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "prescripción", "court": "Corte Suprema" }' ``` 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[]`, del más reciente al más antiguo. Cada resultado incluye `id`, `code_type` (`ROL` o `RIT`), `registration_number`, `case_ruc`, `ruling_date`, `year`, `court`, `court_group` (p. ej. `Corte Suprema`, `Tribunal Tributario y Aduanero`), `ruling_type`, `parties` (como las nombra la compilación del SII), `summary` (el sumario del SII), `extract` (el extracto del SII), `norms[]` (`norm_body`, `articles[]`), `text_status`, `document_url` (la copia de Croma del texto del fallo tal como lo publica el SII) y `source_document_url` (el documento del fallo en el SII, cuando lo enlaza). > [!NOTE] > > Los resultados de búsqueda no incluyen el texto; `query` sí busca dentro de él, así que una frase del cuerpo encuentra el documento. Para leer el texto usa el endpoint SII Court Ruling. ## Un fallo, completo `POST /cl/sii/ruling/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `ruling_id` | string | **Obligatorio.** El `id` del fallo que devuelve la búsqueda, p. ej. `3638`. | | `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 los documentos caben en una sola respuesta. Por defecto `200000`. | ```bash theme={"dark"} curl https://api.croma.run/cl/sii/ruling/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "ruling_id": "3638" }' ``` Devuelve `as_of`, `found`, `ruling_id` y `ruling`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id`, `code_type` (`ROL` o `RIT`), `registration_number`, `case_ruc`, `ruling_date`, `year`, `court`, `court_group` (p. ej. `Corte Suprema`, `Tribunal Tributario y Aduanero`), `ruling_type`, `parties` (como las nombra la compilación del SII), `summary` (el sumario del SII), `extract` (el extracto del SII), `norms[]` (`norm_body`, `articles[]`), `text_status`, `document_url` (la copia de Croma del texto del fallo tal como lo publica el SII) y `source_document_url` (el documento del fallo en el SII, cuando lo enlaza). > [!NOTE] > > Un id que la copia de Croma no tiene 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.