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

> El avalúo fiscal de cualquier propiedad de Chile, por rol: consulta el avalúo total, afecto y exento, la dirección, el destino, la superficie de terreno y construida, su ubicación en el mapa y el período de valuación.

El Servicio de Impuestos Internos (SII) de Chile avalúa cada propiedad del país para el impuesto territorial (contribuciones) y publica el resultado en su mapa de propiedades, Mapas SII, por rol: la comuna, la manzana y el predio. Esta fuente lee ese registro público de un rol a la vez: el avalúo fiscal del semestre vigente con la parte afecta al impuesto y la parte exenta, la dirección, el destino que asigna el SII, la superficie de terreno y construida, la ubicación en el mapa y el área homogénea en que se valúa el terreno con su valor unitario.

La comuna es el código propio del SII (Santiago es `13101`, Providencia `15103`; no son los códigos del INE) o simplemente su nombre. La primera consulta de un rol lee el SII; las siguientes dentro de 30 días responden desde la respuesta guardada por Croma, que se vuelve a leer con regularidad para seguir el reavalúo de cada semestre.

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

La propiedad tal como la tiene hoy el mapa del SII, avalúo fiscal incluido. El ejemplo es la manzana de la Biblioteca Nacional en Santiago.

> [!NOTE]
>
> Responde desde la copia de Croma cuando tiene una respuesta reciente para la llave; si no, lee la fuente y guarda la respuesta. Cada respuesta dice cuándo se consultó la fuente por última vez (`checked_at`) y de dónde salió la respuesta (`served_from`).

| Campo | Tipo | Notas |
| - | - | - |
| `comuna` | string | **Obligatorio.** La comuna: el código del SII (p. ej. `13101` Santiago, `15103` Providencia; no el código del INE) o su nombre (`Providencia`). No importan mayúsculas ni tildes en el nombre. |
| `block` | integer | **Obligatorio.** La manzana: el primer número del rol, p. ej. `18` en el rol `18-1`. |
| `lot` | integer | **Obligatorio.** El predio: el segundo número del rol, p. ej. `1` en el 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 }'
```

Devuelve `found`, `rol`, `checked_at` (cuándo se consultó al SII por última vez), `served_from` (`copy`, `upstream` o `stale`) y `property`. `property` incluye `rol` (`<código de comuna>-<manzana>-<predio>`), `comuna_code` (el del SII), `comuna`, `region`, `block`, `lot`, `address`, `zone` (`URBANA` o `RURAL`), `land_use` (el destino, p. ej. `HABITACIONAL`, `COMERCIO`, `EDUCACION Y CULTURA`), `appraisal_total`, `appraisal_taxable` y `appraisal_exempt` (el avalúo fiscal total, afecto y exento, en pesos), `land_area` con `land_area_unit`, `built_area_m2`, `built_volume_m3`, `latitude`, `longitude`, `valuation_period` (el semestre del avalúo), `valuation_process` y `valuation_year` (el reavalúo del que viene), `homogeneous_area` (`code`, `area_range`, `unit_value` en pesos, `median`, `samples`, `coefficient_of_variation`) y `checked_at`. Los propietarios no forman parte del mapa público del SII.

> [!NOTE]
>
> Un rol bajo el cual el mapa del SII no tiene propiedad, o una comuna que el SII no lista, 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.