> ## 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 > Ofícios, circulares, resoluções e jurisprudência judicial do SII: busque na jurisprudência administrativa, nas circulares e nas resoluções do Servicio de Impuestos Internos do Chile e na sua compilação de decisões tributárias, com o texto completo de cada um; leia qualquer um completo. O Servicio de Impuestos Internos (SII) é a autoridade tributária do Chile. Publica como interpreta as leis tributárias em quatro coleções, e esta fonte reúne todas: seus ofícios (as respostas às consultas dos contribuintes, a jurisprudência administrativa) desde 1994, cerca de 7.500 sobre Renta, IVA e outras normas; suas circulares desde 1975, cerca de 3.100; suas resoluções desde 1975, cerca de 4.200; e sua compilação de jurisprudência judicial tributária, cerca de 3.600 decisões da Corte Suprema, das Cortes de Apelaciones, dos Tribunales Tributarios y Aduaneros e do Tribunal Constitucional desde 2008. Cada documento chega com seu número, data, o resumo do SII, as normas que aplica, seu texto completo e uma cópia de cada arquivo que o SII publica com ele, idêntica byte a byte. Busque em cada coleção por número, ano ou data, ou com texto livre que alcança o corpo de cada documento. Busque primeiro e depois leia um documento 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 ofícios `POST /cl/sii/oficios-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) Uma única busca sobre o texto completo de cada ofício, filtrada por imposto, número, ano ou data. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palavras opcionais buscadas no resumo, nas normas citadas e no texto completo. | | `subject` | enum | Imposto opcional: `renta` (imposto de renda), `iva` ou `otras` (outras normas). `any` busca nos três. Por padrão `any`. | | `number` | string | Número opcional, p. ex. `41`. Pontos e zeros à esquerda são ignorados. A numeração recomeça a cada ano, então combine-o com `year`. | | `year` | integer | Ano opcional em que o SII arquiva o documento. 0 busca em todos os anos. Por padrão `0`. | | `from_date` | string | Opcional: só documentos emitidos nesta data ou depois, `yyyy-mm-dd`. | | `to_date` | string | Opcional: só documentos 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/sii/oficios-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "incobrables", "subject": "renta", "year": 2026 }' ``` 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 ofício mais recente ao mais antigo. Cada resultado traz `id`, `subject` (`renta`, `iva` ou `otras`), `number`, `document_type` (p. ex. `Oficio Ordinario`), `year`, `issued_at` (a data do ofício), `published_at` (desde 2019), `legal_references` (as normas que interpreta), `summary`, `text_status` (`ok`, `scanned` ou `missing`) e `official_url` (a lista do ano no SII). `document_url` é a cópia da Croma do documento principal, idêntica byte a byte à que o SII publicou, que continua disponível aconteça o que acontecer com o link do SII; `source_document_url` é o mesmo documento no site do SII; `documents[]` lista cada arquivo que o SII publica com ele (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Os resultados da busca não incluem o texto; `query` busca dentro dele, então uma frase do corpo encontra o documento. Para ler o texto use o endpoint SII Oficio. ## Um ofício, completo `POST /cl/sii/oficio/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `oficio_id` | string | **Obrigatório.** O `id` do ofício retornado pela busca, p. ex. `3109` ou `renta-2015-ja3298`. | | `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 documentos cabe em uma resposta. Por padrão `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" }' ``` Retorna `as_of`, `found`, `oficio_id` e `oficio`, 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`, `subject` (`renta`, `iva` ou `otras`), `number`, `document_type` (p. ex. `Oficio Ordinario`), `year`, `issued_at` (a data do ofício), `published_at` (desde 2019), `legal_references` (as normas que interpreta), `summary`, `text_status` (`ok`, `scanned` ou `missing`) e `official_url` (a lista do ano no SII). `document_url` é a cópia da Croma do documento principal, idêntica byte a byte à que o SII publicou, que continua disponível aconteça o que acontecer com o link do SII; `source_document_url` é o mesmo documento no site do SII; `documents[]` lista cada arquivo que o SII publica com ele (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Um id que a cópia da Croma não tem retorna `found: false` com HTTP 200, não um erro. ## Buscar circulares `POST /cl/sii/circulars-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) Uma única busca sobre o texto completo de cada circular, filtrada por número, ano ou data. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palavras opcionais buscadas no resumo, nas normas citadas e no texto completo. | | `number` | string | Número opcional, p. ex. `41`. Pontos e zeros à esquerda são ignorados. A numeração recomeça a cada ano, então combine-o com `year`. | | `year` | integer | Ano opcional em que o SII arquiva o documento. 0 busca em todos os anos. Por padrão `0`. | | `from_date` | string | Opcional: só documentos emitidos nesta data ou depois, `yyyy-mm-dd`. | | `to_date` | string | Opcional: só documentos 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/sii/circulars-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "unidad de fomento", "year": 2026 }' ``` 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` (ano e número, p. ex. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (a "Fuente" que o SII indica), `status` (a nota que o SII imprime ao lado, p. ex. `modificada`), `text_status` e `official_url` (a lista do ano no SII). `document_url` é a cópia da Croma do documento principal, idêntica byte a byte à que o SII publicou, que continua disponível aconteça o que acontecer com o link do SII; `source_document_url` é o mesmo documento no site do SII; `documents[]` lista cada arquivo que o SII publica com ele (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Os resultados da busca não incluem o texto; `query` busca dentro dele, então uma frase do corpo encontra o documento. Para ler o texto use o endpoint SII Circular. ## Uma circular, completa `POST /cl/sii/circular/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `circular_id` | string | **Obrigatório.** O ano e o número da circular, p. ex. `2026-41`. | | `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 documentos cabe em uma resposta. Por padrão `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" }' ``` Retorna `as_of`, `found`, `circular_id` e `circular`, 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` (ano e número, p. ex. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (a "Fuente" que o SII indica), `status` (a nota que o SII imprime ao lado, p. ex. `modificada`), `text_status` e `official_url` (a lista do ano no SII). `document_url` é a cópia da Croma do documento principal, idêntica byte a byte à que o SII publicou, que continua disponível aconteça o que acontecer com o link do SII; `source_document_url` é o mesmo documento no site do SII; `documents[]` lista cada arquivo que o SII publica com ele (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Um id que a cópia da Croma não tem retorna `found: false` com HTTP 200, não um erro. ## Buscar resoluções `POST /cl/sii/resolutions-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) Uma única busca sobre o texto completo de cada resolução, filtrada por número, ano ou data. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palavras opcionais buscadas no resumo, nas normas citadas e no texto completo. | | `number` | string | Número opcional, p. ex. `41`. Pontos e zeros à esquerda são ignorados. A numeração recomeça a cada ano, então combine-o com `year`. | | `year` | integer | Ano opcional em que o SII arquiva o documento. 0 busca em todos os anos. Por padrão `0`. | | `from_date` | string | Opcional: só documentos emitidos nesta data ou depois, `yyyy-mm-dd`. | | `to_date` | string | Opcional: só documentos 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/sii/resolutions-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "factura electrónica", "year": 2026 }' ``` 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` (ano e número, p. ex. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (a "Fuente" que o SII indica), `status` (a nota que o SII imprime ao lado, p. ex. `modificada`), `text_status` e `official_url` (a lista do ano no SII). `document_url` é a cópia da Croma do documento principal, idêntica byte a byte à que o SII publicou, que continua disponível aconteça o que acontecer com o link do SII; `source_document_url` é o mesmo documento no site do SII; `documents[]` lista cada arquivo que o SII publica com ele (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Os resultados da busca não incluem o texto; `query` busca dentro dele, então uma frase do corpo encontra o documento. Para ler o texto use o endpoint SII Resolution. ## Uma resolução, completa `POST /cl/sii/resolution/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `resolution_id` | string | **Obrigatório.** O ano e o número da resolução, p. ex. `2026-148`. | | `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 documentos cabe em uma resposta. Por padrão `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" }' ``` Retorna `as_of`, `found`, `resolution_id` e `resolution`, 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` (ano e número, p. ex. `2026-41`), `number`, `year`, `title`, `issued_at`, `summary`, `issuing_office` (a "Fuente" que o SII indica), `status` (a nota que o SII imprime ao lado, p. ex. `modificada`), `text_status` e `official_url` (a lista do ano no SII). `document_url` é a cópia da Croma do documento principal, idêntica byte a byte à que o SII publicou, que continua disponível aconteça o que acontecer com o link do SII; `source_document_url` é o mesmo documento no site do SII; `documents[]` lista cada arquivo que o SII publica com ele (`name`, `format`, `document_url`, `source_document_url`, `bytes`). > [!NOTE] > > Um id que a cópia da Croma não tem retorna `found: false` com HTTP 200, não um erro. ## Buscar decisões `POST /cl/sii/rulings-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) Uma única busca sobre a compilação de jurisprudência judicial do SII, filtrada por tribunal, número do processo, ano ou data. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palavras opcionais buscadas no número do processo, nas partes, na ementa e no extrato do SII e no texto da decisão. | | `court` | string | Tribunal opcional, p. ex. `Corte Suprema`, `Corte de Apelaciones de Santiago`, `Primer Tribunal Tributario y Aduanero`, comparado desde o início. Maiúsculas e acentos são ignorados. | | `registration_number` | string | ROL ou RIT opcional, p. ex. `5501-12`. Espaços e pontuação são ignorados. | | `year` | integer | Ano opcional da decisão. 0 busca em todos os anos. Por padrão `0`. | | `from_date` | string | Opcional: só decisões desta data ou posteriores, `yyyy-mm-dd`. | | `to_date` | string | Opcional: só decisões 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/sii/rulings-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "prescripción", "court": "Corte Suprema" }' ``` 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`, `code_type` (`ROL` ou `RIT`), `registration_number`, `case_ruc`, `ruling_date`, `year`, `court`, `court_group` (p. ex. `Corte Suprema`, `Tribunal Tributario y Aduanero`), `ruling_type`, `parties` (como a compilação do SII as nomeia), `summary` (a ementa do SII), `extract` (o extrato do SII), `norms[]` (`norm_body`, `articles[]`), `text_status`, `document_url` (a cópia da Croma do texto da decisão como o SII a publica) e `source_document_url` (o documento da decisão no SII, quando o vincula). > [!NOTE] > > Os resultados da busca não incluem o texto; `query` busca dentro dele, então uma frase do corpo encontra o documento. Para ler o texto use o endpoint SII Court Ruling. ## Uma decisão, completa `POST /cl/sii/ruling/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md) | Campo | Tipo | Notas | | - | - | - | | `ruling_id` | string | **Obrigatório.** O `id` da decisão retornado pela busca, p. ex. `3638`. | | `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 documentos cabe em uma resposta. Por padrão `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" }' ``` Retorna `as_of`, `found`, `ruling_id` e `ruling`, 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`, `code_type` (`ROL` ou `RIT`), `registration_number`, `case_ruc`, `ruling_date`, `year`, `court`, `court_group` (p. ex. `Corte Suprema`, `Tribunal Tributario y Aduanero`), `ruling_type`, `parties` (como a compilação do SII as nomeia), `summary` (a ementa do SII), `extract` (o extrato do SII), `norms[]` (`norm_body`, `articles[]`), `text_status`, `document_url` (a cópia da Croma do texto da decisão como o SII a publica) e `source_document_url` (o documento da decisão no SII, quando o vincula). > [!NOTE] > > Um id que a cópia da Croma não tem 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.