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

> O avalúo fiscal de qualquer imóvel do Chile, por rol: consulte a avaliação total, tributável e isenta, o endereço, o destino, a área de terreno e construída, sua localização no mapa e o período de avaliação.

O Servicio de Impuestos Internos (SII) do Chile avalia cada imóvel do país para o imposto territorial (contribuciones) e publica o resultado no seu mapa de imóveis, Mapas SII, por rol: a comuna, a manzana e o predio. Esta fonte lê esse registro público de um rol por vez: o avalúo fiscal do semestre vigente com a parte tributável e a parte isenta, o endereço, o destino que o SII atribui, a área de terreno e construída, a localização no mapa e a área homogênea em que o terreno é avaliado com seu valor unitário.

A comuna é o código próprio do SII (Santiago é `13101`, Providencia `15103`; não são os códigos do INE) ou simplesmente seu nome. A primeira consulta de um rol lê o SII; as seguintes dentro de 30 dias respondem a partir da resposta guardada pela Croma, que é relida regularmente para acompanhar a reavaliação de cada semestre.

`POST /cl/sii-mapas/property/v1` [Lookup](https://docs.usecroma.com/pt/datasets.md#lookups)

O imóvel como o mapa do SII o tem hoje, avalúo fiscal incluído. O exemplo é a quadra da Biblioteca Nacional em Santiago.

> [!NOTE]
>
> Responde a partir da cópia da Croma quando ela tem uma resposta recente para a chave; caso contrário, lê a fonte e guarda a resposta. Cada resposta diz quando a fonte foi consultada pela última vez (`checked_at`) e de onde veio a resposta (`served_from`).

| Campo | Tipo | Notas |
| - | - | - |
| `comuna` | string | **Obrigatório.** A comuna: o código do SII (p. ex. `13101` Santiago, `15103` Providencia; não o código do INE) ou seu nome (`Providencia`). Maiúsculas e acentos são ignorados no nome. |
| `block` | integer | **Obrigatório.** A manzana: o primeiro número do rol, p. ex. `18` no rol `18-1`. |
| `lot` | integer | **Obrigatório.** O predio: o segundo número do rol, p. ex. `1` no rol `18-1`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/sii-mapas/property/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "comuna": "13101", "block": 18, "lot": 1 }'
```

Retorna `found`, `rol`, `checked_at` (quando o SII foi consultado pela última vez), `served_from` (`copy`, `upstream` ou `stale`) e `property`. `property` traz `rol` (`<código da comuna>-<manzana>-<predio>`), `comuna_code` (o do SII), `comuna`, `region`, `block`, `lot`, `address`, `zone` (`URBANA` ou `RURAL`), `land_use` (o destino, p. ex. `HABITACIONAL`, `COMERCIO`, `EDUCACION Y CULTURA`), `appraisal_total`, `appraisal_taxable` e `appraisal_exempt` (o avalúo fiscal total, afecto e exento, em pesos chilenos), `land_area` com `land_area_unit`, `built_area_m2`, `built_volume_m3`, `latitude`, `longitude`, `valuation_period` (o semestre do avalúo), `valuation_process` e `valuation_year` (a reavaliação de onde vem), `homogeneous_area` (`code`, `area_range`, `unit_value` em pesos, `median`, `samples`, `coefficient_of_variation`) e `checked_at`. Os proprietários não fazem parte do mapa público do SII.

> [!NOTE]
>
> Um rol sob o qual o mapa do SII não tem imóvel, ou uma comuna que o SII não lista, 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.